Popis
WP-Print přidává do vašich příspěvků a stránek odkaz pro tisk. Po jeho kliknutí se čtenáři zobrazí přehledný dokument určený k tisku: váš obsah, případně i komentáře, pokud je chcete zahrnout, a nic jiného – bez šablony, postranního panelu ani navigačních prvků.
Každý odkaz v tištěném článku je očíslován a jeho URL adresa je uvedena na konci, protože čtenář, který drží v ruce list papíru, nemůže na nic kliknout.
Funkce
- Verze k tisku jakéhokoli příspěvku, stránky nebo vlastního typu příspěvku je k dispozici na adrese
/your-post/print/ - Každý odkaz je označen číslem v poznámce pod čarou a uveden na konci dokumentu
- Volitelné komentáře, obrázky, vložená videa a úvodní obrázek
[donotprint]pro obsah, který by se nikdy neměl objevit na tištěné stránce- Jeden stylový list pro oba směry psaní, s tmavým režimem pro čtení před tiskem
- Šablony a styly, které můžete v rámci svého motivu přepsat
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ů, velmi bych to ocenil. Pokud ne, můžete je klidně používat bez jakýchkoli závazků.
Použití
Vložte odkaz na tisk do svého šablony uvnitř smyčky, a to na místo, kde se má zobrazit:
if ( function_exists( 'wp_print' ) ) {
print_link();
}
print_link( $post_text, $page_text, $display ) takes whether to print or return as its third argument. The first two used to override the link text and no longer do anything: the link is one HTML template on the settings screen, under Templates, and `%POST_TYPE%` in it becomes Post, Page or the name of whatever custom post type is being printed. They stay in the signature so that a theme still passing them keeps working.
Pokud nechcete, aby se odkaz zobrazoval u každého příspěvku, nechte šablonu beze změny a vložte kód [print_link] do toho jednoho příspěvku nebo stránky, kde je to potřeba.
Zkrácené kódy
[print_link]— odkaz pro tisk, tak jak je zadaný v příspěvku nebo na stránce.[donotprint]Není určeno pro tisk[/donotprint]— uvedený obsah se z tisknutelné verze vynechá, jinde však zůstane beze změny. Plugin WP-Email tento tag respektuje, takže text, který vyloučíte z tisku, bude vyloučen i z e-mailu.
Šablonové značky
print_link( $post_text, $page_text, $display )— funkce pro vypsání odkazu. Pouze třetí argument má nějaký účinek.print_content( $display )— obsah příspěvku připravený k tisku.print_comments_content( $display )— obsah aktuálního komentáře.print_categories( $before, $after )— kategorie, z nichž každá je obalena vaším značkovacím kódem.print_comments_number()— počet komentářů ve formě věty.print_links( $heading )— souhrnný seznam URL adres.print_can( $type )— zda je některá z možností zapnutá.print_disclaimer()— prohlášení o vyloučení odpovědnosti nebo řádek s informacemi o autorských právech.
Odkaz na tisk
Odkaz na tisk představuje jednu šablonu HTML, která se nachází na adrese WP-Admin -> Nastavení -> WP-Print -> Šablony. Při vykreslení se nahradí tři zástupné symboly:
%PRINT_URL%— adresa URL verze určené k tisku.%POST_TYPE%— co se zobrazuje, v jednotném čísle: příspěvek, stránka nebo název vlastního typu příspěvku.%PRINT_ICON%— symbol tiskárny ve formě vloženého SVG, jehož barva se odvíjí od vašeho motivu.
Všechno ostatní zůstane v kódu přesně tak, jak jste to zadali. Funkce „Obnovit výchozí šablonu“ vrátí zpět původní šablonu.
Vlastní šablona
WP-Print načítá soubory print-posts.php, print-comments.php a print-css.css z adresáře vaší šablony, pokud existují – nejprve z dceřiné šablony, poté z nadřazené a nakonec kopie dodané s pluginem. Zkopírujte jeden z těchto souborů do svého šablony, abyste mohli upravit vzhled tisknutelné stránky, aniž byste při aktualizaci přišli o provedené změny.
Soubory dodávané v balíčku byly přesunuty ve verzi 3.0.0 – šablony se nacházejí v includes/ a stylový list je v css/wp-print.css – názvy, kterými je vaše téma přepisuje, však zůstaly beze změny.
Filtry
wp_print_capability— oprávnění, které vyžaduje obrazovka nastavení. Výchozí hodnota jemanage_options.wp_print_allowed_html— značky, které může obsahovat vytištěný dokument, ve formátuwp_kses(). Doplňte jej, pokud nějaký blok na vašem webu tiskne značky, které výchozí seznam nezahrnuje.
Snímky obrazovky
Instalace
- Nainstalujte a aktivujte plugin.
- Znovu uložte své permalinky na
WP-Admin -> Nastavení -> Permalinky -> Uložit změny, aby byl zaregistrován koncový bod/print/. Dokud tak neučiníte, stránka pro tisk bude vracet chybu 404. - Přidejte odkaz pro tisk: zadejte do příspěvku
[print_link]nebo ve svém šabloně zavolejte funkciprint_link(). Níže uvedený příklad pokrývá obě možnosti. - Šablony a možnosti najdete na adrese
WP-Admin –> Nastavení –> WP-Print.
Nejčastější dotazy
-
Jak do svého šablony přidám odkaz na tisk?
-
Otevřete
wp-content/themes/<NÁZEV VAŠEHO MOTIVU>/index.php, dále soubory single.php, page.php a všechny ostatní šablony, ve kterých se spouští smyčka. Najděte<?php while ( have_posts() ) : the_post(); ?>a přidejte toto kdekoli pod něj:if ( function_exists( 'wp_print' ) ) { print_link(); } -
Odkaz na tisk vykazuje chybu 404
-
Znovu uložte své permalinky na
WP-Admin -> Nastavení -> Permalinky. WP-Print přidává koncový bod/print/a WordPress pravidla pro přepisování zapíše až po uložení této obrazovky. -
Jak mohu zajistit, aby se část příspěvku na tištěné stránce neobjevila?
-
Zadejte toto do příspěvku:
[donotprint]Text within this tag will not be displayed when printing[/donotprint]Přiložený text je v tisknutelné verzi vynechán, zatímco jinde se zobrazuje normálně.
-
Mohu změnit vzhled vytištěné stránky?
-
Ano, existují dva způsoby. Zkopírujte soubor
print-css.cssdo svého šablony a nahraďte jím původní stylový list, nebo nastavte libovolnou z vlastních vlastností, které tento stylový list používá —--wp-print-font-family,--wp-print-font-size,--wp-print-line-height,--wp-print-text,--wp-print-background,--wp-print-rulea--wp-print-gap— a přizpůsobit jej tak, aniž byste museli soubor rozvětvovat. -
Je ikona tisku stále obrázek, který si mohu vybrat?
-
Ne. Tyto dva sloučené soubory GIF tvoří jeden vložený soubor SVG, který přebírá barvy z vašeho motivu a zachovává si ostrost při jakékoli velikosti, takže již není z čeho vybírat a nastavení „Ikona tisku“ bylo odstraněno.
-
Kam se poděly odkazy „Vytisknout text“ pro příspěvek, pro stránku a styl odkazu „Vytisknout text“?
-
Jedná se o jednu HTML šablonu, která se nachází na záložce „Šablony“. Rozbalovací nabídka stylů nabízela tři předdefinované šablony a jednu vlastní šablonu; ty tři byly také šablony, napsané v PHP namísto v „boxu“, takže všechny čtyři jsou nyní v „boxu“. Zadejte do ní požadovaný text a použijte
%POST_TYPE%tam, kde se dříve lišily výrazy „Příspěvek“ nebo „Stránka“. Vaše stávající nastavení se při aktualizaci převede. -
Co nahradilo %PRINT_TEXT%?
-
Nic, protože už to nemá žádný význam: vložilo se příslušné označení odkazu z těch dvou a text je nyní obsažen přímo v šabloně. Pro část, která se liší mezi příspěvkem a stránkou, použijte
%POST_TEXT%. Šablona, která stále obsahuje%PRINT_TEXT%, ji na stránce vykreslí přesně tak, jak je napsána, což je záměrné — právě tak poznáte, které části je třeba upravit.
Recenze
Autoři
WP-Print je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
Spolupracovníci
Plugin „WP-Print“ byl přeložen do 10 jazyků. Děkujeme všem překladatelům za jejich pomoc.
Přeložte “WP-Print” 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
3.0.0
- OPRAVENO: U příspěvku chráněného heslem se zobrazoval jeho hlavní obrázek. Tělo příspěvku, komentáře i počet komentářů byly skryty, ale funkce
get_the_post_thumbnail()sama o sobě neprovádí kontrolu hesla — proto každá klasická základní šablona provádí tuto kontrolu sama a tato šablona nahrazuje šablonu tématu, takže nic tuto kontrolu neprovádělo - OPRAVENO: Funkce „Tisk obrázků“ a „Tisk videí“ selhávaly kvůli znaku nového řádku. Šablony neobsahovaly modifikátor
s, takže tag<img>rozložený na dva řádky nebo tag<iframe>s uzavíracím tagem na dalším řádku — což je běžný tvar ručně psaného nebo formátovaného vloženého obsahu — přežil deaktivaci a prohlížeč čtenáře jej stejně načítal. Holý tag<embed>nebyl nikdy odstraněn, protože byl vyžadován uzavírací tag a jedná se o prázdný prvek. Nyní je odstraněn i tag<img>, který obsahuje pouze atributsrcset. - AKTUÁLNÍ ZPRÁVA: Vyžaduje WordPress 6.8 a PHP 8.2, místo dosavadních verzí 6.0 a 7.4.
- AKTUÁLNÍ ZPRÁVA: Nastavení se přesouvají z řádku
print_optionsdowp_print_optionsaprint_db_versionje nahrazenowp_print_version. Stávající nastavení se automaticky převedou při prvním načtení stránky pro správu po aktualizaci. - AKTUÁLNÍ ZPRÁVA: Třídy
Print_Admin,Print_Content,Print_Core,Print_Link,Print_OptionsaPrint_Templatebyly přejmenovány naWP_Print_Admin,WP_Print_Content,WP_Print,WP_Print_Link,WP_Print_OptionsaWP_Print_Template. - AKTUÁLNÍ ZPRÁVA: Nastavení ikony tisku a dva přiložené soubory GIF byly odstraněny a nahrazeny jedním vloženým souborem SVG. Vlastní šablona odkazu využívající
%PRINT_ICON_URL%se automaticky přepíše na%PRINT_ICON%. - AKTUÁLNÍ ZPRÁVA: Funkce „Vytisknout textový odkaz pro příspěvek“, „Vytisknout textový odkaz pro stránku“ a „Styl textového odkazu pro tisk“ byly odstraněny. Odkaz pro tisk je nyní představován jednou HTML šablonou s novým zástupným symbolem
%POST_TYPE%, do které jsou stávající nastavení automaticky převedena. Zkratka%PRINT_TEXT%byla zrušena a první dva argumenty funkceprint_link()již nemají žádný účinek. - AKTUÁLNÍ ZPRÁVA: Soubor
print-css-rtl.cssbyl odstraněn. Tento jediný stylový list nyní pokrývá oba směry psaní. - AKTUÁLNÍ ZPRÁVA: Soubor
print-posts.phpv šabloně musí mít v tagu<body>atributclass="wp-print", aby se na něj vztahoval nový stylový list. - NOVINKA: Ikona tisku je vložený soubor SVG, který přebírá barvu odkazů z vašeho motivu a zůstává ostrý na jakékoli obrazovce.
- NOVINKA: Stránka určená k tisku nabízí tmavý režim pro prohlížení před tiskem a v obou případech se tiskne černou barvou na bílém pozadí.
- NOVINKA: Stylový list lze přizpůsobit pomocí vlastních vlastností CSS, aniž by bylo nutné vytvářet jeho odvozenou verzi.
- NOVINKA: Funkce
wp_print_capabilityfiltruje oprávnění požadovaná obrazovkou nastavení; funkcewp_print_allowed_htmlfiltruje tagy, které může vytištěný dokument obsahovat. - NOVINKA: Přepracováno do podoby tříd v adresáři
includes/, v souladu se strukturou adresářů uvedenou v Příručce k pluginům. - NOVINKA: Obrazovka nastavení se skládá ze dvou záložek – „Nastavení“ a „Šablony“ – které se nacházejí nad stejnou řadou voleb.
- NOVINKA: Obrazovka nastavení nyní využívá rozhraní API nastavení WordPressu. Její adresa se mění z
options-general.php?page=wp-print/print-options.phpnaoptions-general.php?page=wp-print— položka nabídky Nastavení -> Tisk zůstává beze změny a na obrazovce Pluginy se nyní nachází odkaz Nastavení. Aktualizujte všechny záložky. - NOVINKA: Už žádné jQuery. Obrazovka nastavení a náhled pro tisk využívají čistý JavaScript a všechny inline atributy
onclickbyly odstraněny. - NOVINKA: Možnosti tisku se ukládají bez lomítek. Stávající instalace se převede automaticky, a to při prvním načtení stránky pro správu po aktualizaci.
- ZMĚNA: Vytisknutý dokument je při odeslání filtrován funkcí
wp_kses(), která zachovává všechny tagy, které by tělo příspěvku mohlo obsahovat, včetně těch, v nichž jsou vloženy externí prvky, a pole pro heslo ve formuláři u chráněného příspěvku. Funkcewp_print_allowed_htmlpak pokryje vše, co tato funkce přehlédla. - ZMĚNA: Odkaz na tisk je filtrován prostřednictvím seznamu povolených položek pluginu, ať už je generován kdekoli – ať už se jedná o zkrácený kód
[print_link], nebo o šablonový tagprint_link(). Šablona odkazu obsahující tag, který není na tomto seznamu, nebo inline obslužná funkce, o tento odkaz přijde. - ZMĚNA: Náhled tisku již nestahuje webové písmo z webu fonts.googleapis.com, pokud je web v uspořádání zprava doleva.
- ZMĚNA: Třetí argument funkce
print_link()se nyní nazývá$display, což odpovídá ostatním šablonovým značkám. Změna se týká pouze volajícího, který jej předává podle jména. - OPRAVENO: U příspěvku chráněného heslem se komentáře zobrazovaly každému, kdo navštívil jeho URL adresu
/print/. Tělo příspěvku nebylo zobrazeno, u počtu komentářů se zobrazovalo „Komentáře skryty“ a pod oběma údaji se zobrazovalo celé vlákno v plném znění. - OPRAVENO: Číslované a odrážkové seznamy v příspěvku si zachovaly odsazení, ale na vytištěné stránce zmizely jejich značky.
- OPRAVENO: Nastavení tisku provedené předtím, než klíč existoval, již nezpůsobuje varování „Undefined array key“ ani nevytváří odkaz na tisk bez textu a ikony.
- OPRAVENO: První odkaz v příspěvku nebyl očíslován u šablon, které mají vypnutou funkci
wpautop. - OPRAVENO: Oddělovač v seznamu kategorií přišel o mezeru a funkce
print_categories( $before, $after )obalila celý seznam namísto jednotlivých kategorií. - OPRAVENO: V náhledu pro tisk se u národních prostředí bez regionu, jako je například
ca, zobrazovalolang="". - OPRAVENO: Detekce psaní zprava doleva v šabloně komentářů se nikdy nespouštěla a v náhledu pro tisk se při každém načtení zobrazovalo upozornění na zastaralou funkci.
- OPRAVENO: Adresy URL odkazů převzaté z obsahu příspěvku jsou při zápisu zpět na stránku určenou k tisku escapovány.
- OPRAVENO: Odkaz na tisk, který se zobrazoval pouze jako ikona, neměl přístupný název; nyní jej má.
- OPRAVENO: Při odinstalaci v síti s více než 100 weby zůstávaly nastavení zachovány na všech webech nad stým a proces selhával úplně ve WordPressu 5.1 a novějších verzích.
- POZNÁMKA: Globální funkce
remove_image(),remove_video()astr_replace_one()byly odstraněny. Nebyly zdokumentovány a používaly názvy, které mohly kolidovat s názvy jiných pluginů. - POZNÁMKA: Podpora pluginu Polyglot byla ukončena. Tento plugin již není k dispozici více než deset let.
- POZNÁMKA: Každá zdokumentovaná šablonová značka —
print_link(),print_content(),print_categories(),print_comments_content(),print_comments_number(),print_links(),print_can()— si zachovává svůj název, argumenty i chování, a[print_link]a[donotprint]zůstávají beze změny. Stejně tak i URL/print/každé stránky určené k tisku. - POZNÁMKA: Údaje o autorech komentářů byly sestaveny z jednotlivých přeložených slov – „Autor:“, jméno autora, „Dne:“, datum – a z názvu vlákna, který se skládá z počtu komentářů, „K:“ a názvu v uvozovkách ASCII. Každý z nich nyní tvoří jeden řetězec s očíslovanými zástupnými symboly, takže o pořadí slov a uvozovkách rozhoduje překlad. Tyto msgidy se změnily, takže stávající překlady těchto komentářů se do doby, než budou znovu přeloženy, zobrazují v angličtině.