Excerpt je funkce, která zobrazuje část výpisu článku a můžete se s ní setkat při výpisu článků na hlavní straně, v archívech a kategoriích. Délka výpisu je v základu nastavená na padesát pět slov a všechny html tagy jsou z něj odstraněny. Proto se v perexu, který je vytvořený pomocí the_excerpt a ne pomocí tagu more, nezobrazí žádné odkazy.
Funkce the_excerpt() rovnou vrací výpis z článku, není potřeba použít echo, pokud potřebujete získat výpis jako řetězec, použijte get_the_excerpt(). Funkce musí být použita uvnitř Loopu.
Použití
Změna délky excerpt
function custom_excerpt_length( $length ) {
return 20;
}
add_filter( 'excerpt_length', 'custom_excerpt_length', 999 );
Pro změnu délky excerpt je použit filtr excerpt_lenght. Délku ovlivníte hodnotou, kterou vrací funkce custom_excerpt_length, pokud použijete podmiňovací funkce, můžete měnit délku excerptu v závislosti na kategorii, zda jde o homepage, či archív autora.
Odstranění […] z excerpt
function new_excerpt_more( $more ) {
return '';
}
add_filter('excerpt_more', 'new_excerpt_more');
Opět je použit filtr, tentokrát excerpt_more a díky return “, se nezobrazí nic. Pokud to změníme na return ‚Článek pokračuje‘, tak se na konci excerptu zobrazí uvedený řetězec.
Stejně tak, můžeme pomocí excerpt_more vytvořit na konci excerptu odkaz „Číst více“.
function new_excerpt_more( $more ) {
return ' Číst více';
}
add_filter( 'excerpt_more', 'new_excerpt_more' );
Pozn. pro popis funkce byl použit originální kód z WordPress.org Codexu.