WP-DownloadManager

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í

  1. 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.
  2. 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ů.
  3. 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.
    1. Příklad: [download id="2" stream_limit="4"]
    2. 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í.
  4. Chcete-li seřadit vložená soubory ke stažení, použijte možnosti sort_by a sort_order.
    1. Příklad: [download id="2" sort_by="file_id" sort_order="asc"]
    2. Tím se vložená soubory ke stažení seřadí podle ID souboru ve vzestupném pořadí.
    3. Platné hodnoty pro sort_by jsou: file_id, file, file_name, file_size, file_date a file_hits
  5. 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.
  6. 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í.
  7. 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í souboru http://yoursite.com/download/2/, kde yoursite.com je adresa vašeho webu WordPress a 2 je ID souboru.
  8. 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í.
  9. 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í.
  10. 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í

  1. Přejděte na WP-Admin -> Stránky -> Přidat novou
  2. Do pole pro název příspěvku zadejte libovolný název
  3. Pokud POUŽÍVÁTE pě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“.
  4. Klikněte na „Upravit“, do textového pole zadejte downloads a klikněte na „Uložit“.
  5. Do oblasti obsahu příspěvku zadejte [page_download].
  6. Můžete také použít [page_download category="1"]; tímto se zobrazí všechny soubory ke stažení v kategorii s ID 1.
  7. 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)

  1. Přejděte na WP-Admin -> Vzhled -> Widgety
  2. 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

  1. Nainstalujte a aktivujte plugin.
  2. Znovu uložte své permalinky na WP-Admin –> Nastavení –> Permalinky –> Uložit změny, aby byly zaregistrovány odkazy /download/.
  3. Přidejte svůj první soubor na stránce WP-Admin –> Soubory ke stažení –> Přidat soubor.
  4. 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_options slouč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

26. 7. 2025
The plugin is way too complex for an average user. The protection for download takes too many steps. I found not ever get the preview option only to display. I ask for a refund within the first 14 days after 13 messages from support. They refused. The free version does not have enough features to validate that the extra features are worth the money
26. 8. 2024
This is what i was looking for. Works great with external file
8. 4. 2021 1 odpověď
NOT ONLY THAT THEY DID NOT REFUND THE MONEY THAT THEY WERE LEGALLY OBLIGATED TO DO DURING 14DAYS PERIOD AFTER PURCHASING, AFTER THEIR PLUGINS HAD PROBLEMS TO FUNCTION, THEY asked for logins to fix it and they messed the whole website up. Will never do business again with them they just take your money and run away, Plugins are coded by idiots, it’s impossible to combine it to modern plugins or themes, they keep telling you to buy more plugins to make it work as it should. Seriously stay away from them.
Přečtěte si všech 38 recenzí

Autoři

WP-DownloadManager je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.

Spolupracovníci

Plugin „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.css v 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 — example v uloženém odkazu na example.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 funkce sanitize_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/ i http://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_public je ú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_page se nyní jmenuje wp_downloadmanager_page a filtr download_embedded se nyní jmenuje wp_downloadmanager_embedded. Původní názvy již neexistují.
  • AKTUÁLNÍ ZPRÁVA: Devatenáct řádků s volbami download_* bylo sloučeno do tabulky wp_downloadmanager_options a značka schématu do tabulky wp_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_, a DownloadManager_Templates se změnilo na WP_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_display a stats_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 filtru wp_stats_sections.
  • NOVINKA: Příkaz wp downloadmanager pro WP-CLI: list, get, stats, reset-hits a delete, přičemž poslední dva vyžadují potvrzení a příkaz delete --delete-file soubor 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_Table s 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_capability urč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-scheme a prefers-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 funkce switch_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.php a odstraněn třetí argument funkce add_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ě.