Popis
WP-DownloadManager spravuje knihovnu souborů ke stažení, počítá, jak často je každý
z nich stažen, a poskytuje vám stránku se soubory ke stažení, RSS kanál, widget a shortcode,
abyste je mohli zpřístupnit svým čtenářům. Soubory mohou být uloženy ve složce na vašem serveru
nebo kdekoli jinde na webu a přístup k nim lze omezit na konkrétní uživatelské role.
Funkce
- Stránka se soubory ke stažení, která obsahuje kategorie, vyhledávání, třídění a stránkování.
- Zkratka
[stáhnout]a tlačítko v editoru „Vizuální“ i „Textovém“. - Oprávnění pro jednotlivé soubory, od „všichni“ až po „pouze správci“.
- Místní soubory, nahrané soubory a vzdálené URL adresy v jedné knihovně.
- RSS kanál se soubory ke stažení.
- Widget zobrazující nejčastěji stahované soubory, poslední stažené soubory a soubory podle kategorií.
- Každý úsek značkovacího kódu představuje šablonu, kterou můžete upravit.
Dary
Většinu svého volného času jsem věnoval tvorbě, aktualizaci, údržbě a podpoře
těchto pluginů. Pokud se vám moje pluginy opravdu líbí a mohli byste mi věnovat pár
dolarů, budu vám za to velmi vděčný. Pokud ne, můžete je klidně používat bez jakýchkoli
závazků.
Použití
- Chcete-li do příspěvku nebo stránky vložit konkrétní soubor ke stažení, použijte
[download id="2"], kde 2 představuje ID vašeho souboru. - Chcete-li do příspěvku nebo stránky vložit více souborů ke stažení, použijte kód
[download id="1,2,3"], kde 1, 2, 3 jsou identifikátory vašich souborů. - Chcete-li omezit počet zobrazených vložených souborů ke stažení u každého příspěvku v seznamu příspěvků, použijte možnost
stream_limit.- Příklad:
[download id="2" stream_limit="4"] - Tím se při zobrazení v seznamu příspěvků zobrazí pouze první 4 soubory ke stažení k danému příspěvku, zatímco při zobrazení jednotlivého příspěvku se zobrazí celý seznam souborů ke stažení.
- Příklad:
- Chcete-li seřadit vložená soubory ke stažení, použijte možnosti
sort_byasort_order.- Příklad:
[download id="2" sort_by="file_id" sort_order="asc"] - Tím se vložená soubory ke stažení seřadí podle ID souboru ve vzestupném pořadí.
- Platné hodnoty pro
sort_byjsou:file_id,file,file_name,file_size,file_dateafile_hits
- Příklad:
- Chcete-li vybrat, co se má v rámci vloženého souboru zobrazit, použijte
[download id="1" display="both"], kde 1 je ID vašeho souboru a parametr „both“ zobrazí jak název souboru, tak jeho popis, zatímco parametr „name“ zobrazí pouze název souboru. Upozorňujeme, že tímto krokem přepíšete šablonu „Stáhnout vložený soubor“, kterou máte na kartě Šablony. - Chcete-li vložit soubory i kategorie, použijte
[download id="1,2,3" category="4,5,6"], kde 1, 2, 3 jsou ID vašich souborů a 4, 5, 6 jsou ID vašich kategorií. - Pokud používáte výchozí permalinky, bude odkaz na přímé stažení souboru vypadat takto:
http://yoursite.com/index.php?dl_id=2. Pokud používáte „Pěkné permalinky“, bude přímý odkaz ke stažení souboruhttp://yoursite.com/download/2/, kde yoursite.com je adresa vašeho webu WordPress a 2 je ID souboru. - Odkaz na kategorii pro přímé stažení bude
http://yoursite.com/downloads/?dl_cat=3, kde yoursite.com je adresa vašeho webu WordPress, „downloads“ je název stránky „Downloads“ a 3 je ID kategorie pro stažení. - Aby bylo možné soubory nahrávat přímo do složky pro stahování, musí mít webový server k této složce oprávnění k zápisu. Složku, která bude sloužit jako složka pro stahování, můžete určit v
WP-Admin –> Stahování –> Nastavení. - Všechno ostatní můžete nastavit v
WP-Admin -> Soubory ke stažení -> Nastavenína záložkách „Nastavení“ a „Šablony“.
Stránka ke stažení
- Přejděte na
WP-Admin -> Stránky -> Přidat novou - Do pole pro název příspěvku zadejte libovolný název
- Pokud
POUŽÍVÁTEpěkné trvalé odkazy, WordPress po zadání názvu vygeneruje trvalý odkaz na danou stránku. Hned vedle trvalého odkazu se zobrazí odkaz „Upravit“. - Klikněte na „Upravit“, do textového pole zadejte
downloadsa klikněte na „Uložit“. - Do oblasti obsahu příspěvku zadejte
[page_download]. - Můžete také použít
[page_download category="1"]; tímto se zobrazí všechny soubory ke stažení v kategorii s ID 1. - Klikněte na „Zveřejnit“
Zobrazení stažených souborů v bloku
V editoru jsou k dispozici dva bloky v části Widgety:
- Stáhnout — jeden nebo více souborů vložených do příspěvku. ID souborů a ID kategorií v postranním panelu přijímají buď jedno ID, nebo seznam oddělený čárkami, a dohromady obsahují veškeré informace
[stáhnout]znamená: Zobrazit volí mezi názvem s popisem a samotným názvem, a panel Seřadit obsahuje sloupec pro seřazení, směr a limit, který se použije v případě, že je příspěvek jedním z mnoha v proudu. - Stránka ke stažení — celá knihovna s kategoriemi, vyhledávacím polem a stránkováním; stejný výpis, jaký generuje
[page_download]. ID kategorie zúží výběr na jednu kategorii, zatímco hodnota nula zobrazí všechny.
Oba se vykreslují na serveru, takže náhled bloku v editoru představuje skutečný výpis, nikoli pouze přibližný náhled, a přidání souboru aktualizuje všechny příspěvky, ve kterých se tento soubor zobrazuje, aniž by bylo nutné cokoli znovu ukládat.
Krátké kódy stále fungují a nikam nezmizí. [download], [download=2], [page_download] a [page_downloads] se chovají přesně tak, jak vždy, a příspěvek, který již některý z nich obsahuje, není třeba měnit. Bloky volají stejný kód jako zkrácené kódy, takže se oba vykreslují identicky — použijte ten, který se k danému příspěvku hodí.
Pro [page_downloads] neexistuje žádný třetí blok. Množné i jednotné číslo představují jeden a tentýž shortcode zaregistrovaný pod dvěma značkami, takže blok pro každou z těchto variant by byl vlastně jedním blokem pod dvěma názvy – a na rozdíl od shortcode se název bloku zapíše do příspěvku a zůstane tam. Blok obaluje [page_download]; množné číslo zůstává zkráceným kódem, který můžete i nadále používat.
Statistiky stahování (s widgety)
- Přejděte na
WP-Admin -> Vzhled -> Widgety - Název widgetu je
Stahování.
WP-CLI
wp downloadmanager list
wp downloadmanager list --category=3 --orderby=file_hits --order=desc --limit=10
wp downloadmanager get 3
wp downloadmanager stats
wp downloadmanager reset-hits 3 --yes
wp downloadmanager delete 3 --yes
wp downloadmanager delete 3 --delete-file --yes
list and `stats` report what the Downloads screen shows, including the files whose permission is Hidden — this is the library's own inventory, not what a visitor can see. Sizes are in bytes rather than the rounded units the screen prints, because a figure a script is going to compare is worth having exact.
reset-hits is the "Reset the hit count to zero" checkbox on Edit File, and touches the counter and nothing else. **`delete --delete-file` deletes the file from the server as well**, which is the checkbox the Delete File screen offers; without it only the row goes. Both ask before doing anything, so a script has to pass `--yes`.
Neexistuje žádná funkce create ani update: při přidávání a úpravách souboru máte na výběr ze čtyř zdrojů – zachovat aktuální soubor, vybrat soubor, který se již nachází v adresáři „downloads“, nahrát soubor nebo zadat vzdálenou URL – a ve dvou z těchto případů se jedná o prohlížeč, který předává vícečástečné tělo zprávy.
Snímky obrazovky






Bloky
Tento plugin poskytuje 2 bloky.
- Downloads Page The whole download library, with its categories, search and paging.
- Download One or more files from the download library, embedded in a post.
Instalace
- Nainstalujte a aktivujte plugin.
- Znovu uložte své permalinky na
WP-Admin –> Nastavení –> Permalinky –> Uložit změny, aby byly zaregistrovány odkazy/download/. - Přidejte svůj první soubor na stránce
WP-Admin –> Soubory ke stažení –> Přidat soubor. - Chcete-li soubory nahrávat přímo do složky „Downloads“, musí mít webový server k této složce oprávnění k zápisu. Složku vyberte na adrese
WP-Admin -> Downloads -> Settings.
Nejčastější dotazy
-
Kam se poděly možnosti stahování a šablony ke stažení?
-
Nyní jsou na jedné stránce:
WP-Admin -> Soubory ke stažení -> Nastavení, kde najdete záložku „Nastavení“
a záložku „Šablony“. WordPress umožňuje každému pluginu pouze jednu stránku nastavení a dvě
položky v nabídce pro jednu sadu nastavení byly o jednu navíc. Vaše nastavení se
přenese automaticky; nic není třeba zadávat znovu. Aktualizujte si prosím všechny záložky, které máte uložené. -
Můj vlastní kód, který načítal volbu typu „download_*“, přestal fungovat
-
Ve verzi 2.0.0 bylo devatenáct řádků
wp_optionssloučeno do jediného
řádku wp_downloadmanager_options obsahujícího vnořené pole a staré
řádky byly odstraněny. Místo toho je načtěte prostřednictvím pluginu:WP_DownloadManager_Options::get( 'page_url' ); WP_DownloadManager_Options::get( 'sort.perpage' ); WP_DownloadManager_Options::template( 'header' ); WP_DownloadManager_Options::template( 'listing', 1 ); // the no-permission variant -
V mé šabloně se na místě, kde dříve byla ikona souboru, zobrazuje nefunkční obrázek
-
%FILE_ICON% nyní představuje celou ikonu, nikoli název souboru GIF, který se má vložit do
. Při aktualizaci se ve vašich uložených šablonách přepíše standardní<img src="...%FILE_ICON%" />ve vašich
uložených šablonách za vás, ale pokud jste kolem něj napsali vlastní obal, smažte tento
obal a nechte%FILE_ICON%samostatně. -
Zobrazit nejčastěji stahované
-
<?php if (function_exists('get_most_downloaded')): ?> <?php get_most_downloaded(); ?> <?php endif; ?>- První hodnota, kterou zadáte, představuje maximální počet souborů, které chcete načíst.
- Výchozí nastavení:
get_most_downloaded(10);
-
Zobrazení posledních stažených souborů
-
<?php if (function_exists('get_recent_downloads')): ?> <?php get_recent_downloads(); ?> <?php endif; ?>- První hodnota, kterou zadáte, představuje maximální počet souborů, které chcete načíst.
- Výchozí nastavení:
get_recent_downloads(10);
-
Zobrazení stažených souborů podle kategorií
-
<?php if (function_exists('get_downloads_category')): ?> <?php get_downloads_category(1); ?> <?php endif; ?>- První hodnota, kterou zadáte, je identifikátor kategorie.
- Druhou hodnotou, kterou zadáte, je maximální počet souborů, které chcete načíst.
- Výchozí nastavení:
get_downloads_category(1, 10);
Recenze
Autoři
WP-DownloadManager je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
SpolupracovníciPlugin „WP-DownloadManager“ byl přeložen do 5 jazyků. Děkujeme všem překladatelům za jejich pomoc.
Přeložte “WP-DownloadManager” do svého jazyka.
Zajímá vás vývoj?
Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.
Přehled změn
2.0.1
- NOVINKA: Odkaz „Nastavení“ v řádku pluginu na obrazovce „Pluginy“
- ZMĚNA: Stylový list s názvem
wp-downloadmanager.cssv nadřazeném šabloně nyní přepisuje i kopii tohoto pluginu; kopie v podřízeném šabloně má však stále přednost před oběma - ZMĚNA: Migrace aktualizací se spouští při každém požadavku, nikoli pouze při načtení stránky pro správu, takže web aktualizovaný automatickou aktualizací na pozadí již nezobrazuje uživatelské rozhraní s nemigrovanými nastaveními, dokud se někdo nepřihlásí.
- OPRAVENO: Při nové instalaci se jedna kategorie, „Obecné“, zobrazovala v očíslovaném poli, které znamenalo „žádná kategorie“, takže rozevírací nabídka „Přidat soubor“ ji nabízela jako kategorii 0 a každý přidaný soubor byl zařazen právě tam. Při prvním uložení záložky „Nastavení“ – z jakéhokoli důvodu – došlo k přečíslování seznamu kategorií a kategorie „Obecné“ se stala kategorií 1, zatímco vaše soubory zůstaly v kategorii 0 a přestaly se zobrazovat s kategorií na stránce stažených souborů, ve feedu, ve widgetu a v části „Správa stažených souborů“. Na to vás nic neupozornilo a jediným způsobem, jak se vrátit zpět, bylo znovu vybrat kategorii u každého souboru. Seznam je nyní dodáván s tímto slotem prázdným a při aktualizaci se vaše kategorie posunou o jednu nahoru a všechny soubory se posunou s nimi, takže soubor zařazený do kategorie „Obecné“ se stále zobrazuje jako „Obecné“.
- OPRAVENO: V sekci „Správa stažených souborů“ se u souboru, který nebyl zařazen do žádné kategorie nebo byl zařazen do kategorie, kterou jste smazali, zobrazovalo „N/A“, zatímco v okně s potvrzením smazání téhož souboru zůstalo pole pro kategorii prázdné – a to jen jedno kliknutí od místa, na které jste právě klikli
2.0.0
- OPRAVENO:
%FILE%a%FILE_DOWNLOAD_URL%byly do šablon vloženy bez únikových znaků, zatímco%FILE_NAME%a%FILE_DESCRIPTION%jsou filtrovány. Právě do těchto dvou polí má majitel webu vkládat značky; cesta k souboru a URL adresa k tomu určeny nejsou. Standardní šablony vkládají URL adresu do atributu v uvozovkách, což je jediný důvod, proč to nikdy nefungovalo — vlastní šablona používající jednoduché uvozovky za sebou nic neměla - OPRAVENO: Zvýraznění při vyhledávání přepisovalo již vykreslený kód, takže pokud se vyhledávaný výraz náhodou objevil uvnitř atributu —
examplev uloženém odkazu naexample.com— zvýraznění se vložilo uprostřed atributu a předčasně skončilo. Kdokoli mohl prostřednictvím vyhledávacího pole poškodit kód záznamu. Nyní se zvýrazňuje pouze text mezi značkami. - OPRAVENO: Funkce „Procházet zdroj“ ukládala jakýkoli zadaný název souboru a koncový bod pro stahování jej načítal. Název souboru, který přesahoval adresář pro stahování —
/../../../wp-config.php— byl přijat funkcí „Přidat soubor“ a poskytnut komukoli, protože uložený název je relativní cesta a ani funkcesanitize_text_field(), ani následný filtr znaků nezasahuje do.ani/. Funkce „Přidat soubor“ nyní takový název odmítá a koncový bod před načtením jakéhokoli bajtu vyhodnotí cestu a ověří, zda se nachází uvnitř adresáře pro stahování, takže řádek zapsaný jakýmkoli jiným způsobem je rovněž odmítnut - OPRAVENO: U URL vzdáleného souboru se kontrolovalo pouze schéma a port, nic jiného, takže
http://169.254.169.254/latest/meta-data/ihttp://127.0.0.1/byly přijaty — a koncový bod zprostředkovává vzdálený soubor pomocíreadfile(), což neníwp_safe_remote_get()a neprovádí žádné z kontrol, které by jinak WordPress provedl. Hostitel musí být nyní vyřešen mimo tuto síť, kontrola se provádí znovu při poskytnutí souboru, nikoli pouze při jeho uložení, a přesměrování se již nesledují.wp_downloadmanager_host_is_publicje úniková cesta pro zrcadlo, které se skutečně nachází v místní síti - AKTUÁLNÍ ZPRÁVA: Vyžaduje WordPress 6.8 a PHP 8.2.
- AKTUÁLNÍ ZPRÁVA: Filtr
downloads_pagese nyní jmenujewp_downloadmanager_pagea filtrdownload_embeddedse nyní jmenujewp_downloadmanager_embedded. Původní názvy již neexistují. - AKTUÁLNÍ ZPRÁVA: Devatenáct řádků s volbami
download_*bylo sloučeno do tabulkywp_downloadmanager_optionsa značka schématu do tabulkywp_downloadmanager_version. Nastavení se migrují automaticky a staré řádky se odstraní. - AKTUÁLNÍ ZPRÁVA: Možnosti stahování a Šablony stahování jsou dvě záložky na jedné stránce Nastavení, takže se změnily jejich správcovské URL adresy.
- AKTUÁLNÍ ZPRÁVA: Všechny třídy získaly předponu
WP_DownloadManager_, aDownloadManager_Templatesse změnilo naWP_DownloadManager_Template. - AKTUÁLNÍ ZPRÁVA:
%FILE_ICON%je kompletní prvek ikony, nikoli název souboru GIF, a plugin neobsahuje vůbec žádné obrázky. - AKTUÁLNÍ ZPRÁVA: Řádky
stats_displayastats_mostlimit, které jsou sdíleny s pluginem WP-Stats, jsou nahrazeny vlastními nastaveními tohoto pluginu a WP-Stats shromažďuje sekce prostřednictvím filtruwp_stats_sections. - NOVINKA: Příkaz
wp downloadmanagerpro WP-CLI:list,get,stats,reset-hitsadelete, přičemž poslední dva vyžadují potvrzení a příkazdelete --delete-filesoubor také odstraní ze serveru. - NOVINKA: Dva bloky editoru, Stáhnout a Stránka ke stažení, které obklopují
[download]a[page_download]. Zkrácené kódy zůstávají beze změny, jsou stále registrovány a podporovány —[download],[download=2],[page_download]a[page_downloads]– všechny fungují přesně jako dříve, není třeba nic znovu ukládat a bloky se vykreslují pomocí stejného kódu, takže jsou oba identické. - NOVINKA: „Spravovat soubory ke stažení“ je skutečná
WP_List_Tables možnostmi třídění sloupců, akcemi pro jednotlivé řádky, hromadným mazáním, vyhledávacím polem a nastavením počtu řádků na stránku pro každého uživatele. - NOVINKA: Jeden inline SVG sprite s ikonami, vykreslený v barvě daného motivu a pokrývající moderní typy souborů, které sada GIF nikdy neobsahovala.
- NOVINKA: Struktura byla přepracována na
includes/class-wp-downloadmanager-*.php, přičemž v kořenovém adresáři pluginu již nejsou žádné volně uložené soubory. - NOVINKA: Filtr
wp_downloadmanager_capabilityurčuje, komu se jednotlivé obrazovky zobrazí. - NOVINKA: Widget podporuje selektivní aktualizaci v nástroji pro přizpůsobení.
- ZMĚNA: jQuery bylo zcela odstraněno. Rychlá značka, tlačítko editoru, přepínač časového razítka a tlačítka pro resetování šablony jsou nyní napsány v čistém JavaScriptu a inline obslužné funkce
onclick=byly odstraněny. - ZMĚNĚNO: Styly neobsahují žádné nastavení písma ani barev, využívají logické vlastnosti CSS, takže jeden soubor pokrývá oba směry psaní, a respektují atributy
prefers-color-schemeaprefers-reduced-motion. - OPRAVENO: Chyba typu SQL injection ve funkci
get_downloads_category(), ke které měl přístup kdokoli s oprávněním k úpravám widgetu, což mohlo vést k odhalení souborů označených jako „Skryté“. - OPRAVENO: Chyba typu SQL injection ve vyhledávacím poli v sekci „Správa stahování“.
- OPRAVENO: Sloupce pro řazení v seznamu a kanálu obsahovaly neplatný příkaz
ORDER BY. - OPRAVENO: Podsložka pro nahrávání nebyla omezena na adresář pro stahování.
- OPRAVENO: Název souboru nebo popis obsahující značky se dostal na stránku ke stažení a zkrácený kód
[download]nebyl odeskapován, zatímco widget a sekce WP-Stats jej vždy filtrovaly. Nyní všech pět prvků tento kód prochází jedním seznamem povolených položek. - OPRAVENO: Vyhledávací výraz obsahující metaznaky regulárního výrazu vyprázdnil název souboru, který byl právě zvýrazněn.
- OPRAVENO: Funkce
wp_get_sites()byla ve WordPressu 5.1 odstraněna, takže aktivace či odinstalace v síti vedla k fatální chybě; odinstalace se navíc zastavila na 100 webech a funkceswitch_to_blog()se vrátila o jeden krok zpět. - OPRAVENO: Nastavení widgetu „Zobrazit odkaz na stránku ke stažení?“ se nikdy nezobrazovalo jako vybrané a bez upozornění se vracelo do původního stavu, přičemž úpravy widgetu provedené v editoru blokových widgetů nebo v nástroji pro přizpůsobení byly zrušeny.
- OPRAVENO: Soubory v kategorii „smazané“ již v PHP 8 nevyvolávají varování „Undefined array key“.
- OPRAVENO: Adresář pro stahování se nyní při aktivaci skutečně vytvoří.
- OPRAVENO: Uložení obrazovky s nastavením již nevynuluje cestu ke stažení, pokud daný adresář ještě neexistuje.
- OPRAVENO: Zastaralé zahrnutí souboru
upgrade-functions.phpa odstraněn třetí argument funkceadd_option(). - OPRAVENO: Byl odstraněn soubor
download-admin-css.css, stylový list o velikosti nula bajtů, který byl od roku 2010 zařazován do fronty na každé administrační obrazovce pluginu. - POZNÁMKA: Některé přeložené řetězce obsahují nyní očíslované zástupné symboly (
%1$s), což mění jejich msgid. Tyto řetězce je třeba přeložit znovu. - POZNÁMKA: Název RSS kanálu pro soubory ke stažení je vytvořen pomocí zástupného symbolu, místo aby byl název webu vložen do přeloženého řetězce začínajícího mezerou. Překladatelé tuto mezeru neviděli, takže název kanálu byl ve všech jazycích kromě angličtiny napsán jako jeden celek. Hodnota msgid se změnila, takže stávající překlad se do doby, než bude znovu přeložen, zobrazuje v angličtině.
- POZNÁMKA: Samotné slovo „to“ mezi výběrem souboru a výběrem složky nyní nese překladatelský kontext. Tento msgid se změnil, takže stávající překlad tohoto textu se do doby, než bude znovu přeložen, zobrazuje v angličtině.
