Jazyky:

Popis

Vrátí úryvek příspěvku: English – 関数リファレンス/get the excerpt 日本語 (Add your language)

Popis

Vrátí úryvek příspěvku. Jedná se buď o výňatek zadaný uživatelem, který je vrácen beze změny, nebo o automaticky vygenerovanou slovně ořezanou verzi celého obsahu příspěvku.

U automaticky vygenerovaných výňatků jsou odstraněny všechny zkratky a značky, což znamená, že se jedná pouze o neformátovaný řetězec, který by v žádné formě výstupu neviděl žádné zalomení řádků, protože skutečné zalomení řádků v surovém textu je také odstraněno.

Při volání přes funkci the_excerpt() to znamená, že úryvky automatického generování jsou v podstatě jen surový text s obalenými značkami <p></p>.

Úryvky automatického generování mají připojenou značku „more“. Tento tag je ve výchozím nastavení “. Lze jej změnit pomocí filtru excerpt_more.

Výchozí délka slova je 55 slov. Lze ji změnit pomocí filtru excerpt_length.

Použití

<?php $excerpt = get_the_excerpt( int|WP_Post $post ) ?>

Tato funkce musí být použita v rámci Smyčky, pokud není předán parametr $post nebo ID.

Pokud je tato funkce použita mimo Smyčku a příspěvek nemá vlastní úryvek, použije tato funkce k vygenerování úryvku funkci wp_trim_excerpt(). Tato funkce používá funkci get_the_content(), která musí být použita se smyčkou The Loop a způsobí problémy, pokud je funkce get_the_excerpt() použita mimo smyčku The Loop. Abyste se vyhnuli problémům, použijte před voláním funkce get_the_excerpt() funkci setup_postdata(), která nastaví globální objekt $post.

Parametry

$post (integer|WP_Post) (nepovinné) ID příspěvku nebo objektu WP_Post. Výchozí hodnota je globální $post. Výchozí: null

Vrácené hodnoty

• Vrátí existující výpis beze změny (ve výchozím nastavení), ale použije na něj filtry get_the_excerpt.
• Vrátí ořezanou verzi celého obsahu příspěvku, jak je popsáno, a navíc na něj použije filtry wp_trim_excerpt. ‚wp_trim_excerpt‘ je zřetězený z ‚get_the_excerpt‘, což znamená, že váš vlastní filtr get_the_excerpt bude zavolán před nebo za trim v závislosti na prioritě vašeho filtru. Pokud bude zavolán před, bude váš parametr $text prázdný řetězec, pokud není žádný uživatelem zadaný výpis, zatímco pokud bude zavolán po, bude to ořezaná verze celého příspěvku. V druhém případě by mohlo být užitečnější nebo smysluplnější použít funkci ‚wp_trim_excerpt‘, protože má druhý parametr, který vám poskytne neořezaný vstup do funkce wp_trim_excerpt, což znamená, že tento druhý parametr je jednoduše surový $post->post_excerpt.
• Pro stránky chráněné heslem vrací řetězec, který má výchozí hodnotu „Není žádný výpis, protože se jedná o chráněný příspěvek.“. Tento text lze změnit v definici funkce.

Příklady

get_the_excerpt() lze použít k získání a uložení hodnoty do proměnné, aniž by se vypisovala na stránku.

<?php$my_excerpt = get_the_excerpt();if ( '' != $my_excerpt ) {// Some string manipulation performed}echo $my_excerpt; // Outputs the processed value to the page?>

Pomocí funkce get_the_excerpt() lze vypsat úryvek zadáním maximálního počtu znaků.

<?phpthe_excerpt_max_charlength(140);function the_excerpt_max_charlength($charlength) {$excerpt = get_the_excerpt();$charlength++;if ( mb_strlen( $excerpt ) > $charlength ) {$subex = mb_substr( $excerpt, 0, $charlength - 5 );$exwords = explode( ' ', $subex );$excut = - ( mb_strlen( $exwords ) );if ( $excut < 0 ) {echo mb_substr( $subex, 0, $excut );} else {echo $subex;}echo '';} else {echo $excerpt;}}?>

Záznam změn

Od: 0.71

.