Språk: 関数リファレンス/get the excerpt 日本語 (Add your language)

Description

Returnerar utdraget ur inlägget. Detta är antingen ett användarvänligt utdrag, som returneras oförändrat, eller en automatiskt genererad ordräknad, trimmad version av hela inläggets innehåll.

De automatiskt genererade utdragen har alla kortkoder och taggar borttagna, vilket innebär att det bara är en oformaterad sträng som inte skulle se några radbrytningar i någon form av utdata, eftersom de faktiska radbrytarna i den råa texten också är borttagna.

När det anropas via the_excerpt() innebär detta att auto-gen-utdragen bara är rå text med <p></p>-taggar lindade runtomkring, i princip.

Auto-gen-utdragen har en ”more”-tagg som bifogats till dem. Denna tagg är ” som standard. Den kan ändras genom filtret excerpt_more.

Den förvalda ordlängden är 55 ord. Den kan ändras genom filtret excerpt_length.

Användning

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

Denna funktion måste användas inom The Loop när ingen $post– eller ID-parameter överlämnats.

Om den här funktionen används utanför The Loop och inlägget inte har ett anpassat utdrag, kommer den här funktionen att använda wp_trim_excerpt() för att skapa ett utdrag. Den funktionen använder get_the_content(), som måste användas med The Loop och kommer att orsaka problem om get_the_excerpt() används utanför The Loop. För att undvika problemen bör du använda setup_postdata() innan du anropar get_the_excerpt() för att konfigurera det globala objektet $post.

Parameters

$post (heltal|WP_Post) (valfritt) Post-ID eller WP_Post-objekt. Standardvärdet är global $post. Standard: null

Returvärden

• Returnerar ett befintligt utdrag oförändrat (som standard), men tillämpar get_the_excerpt-filter på det.
• Returnerar en trimmad version av det fullständiga inläggsinnehållet enligt beskrivningen, och tillämpar dessutom wp_trim_excerpt-filter på det. ”wp_trim_excerpt” är kedjad från ”get_the_excerpt”, vilket innebär att ditt eget get_the_excerpt-filter anropas före eller efter trimningen beroende på hur prioriterat ditt filter är. Om den anropas före kommer parametern $text att vara en tom sträng om det inte finns något användarinformat utdrag, medan den kommer att vara den trimmade versionen av det fullständiga inlägget om den anropas efter. I det senare fallet kan det vara användbart eller mer meningsfullt att använda ”wp_trim_excerpt” eftersom den har en andra parameter som ger dig den otrimmade indata till wp_trim_excerpt-funktionen, vilket innebär att den andra parametern helt enkelt är den obearbetade $post->post_excerpt.
• För sidor som är skyddade av ett lösenord returneras en sträng, som har standardvärdet ”Det finns inget utdrag eftersom detta är ett skyddat inlägg”. Denna text kan ändras i funktionsdefinitionen.

Exempel

get_the_excerpt() kan användas för att hämta och lagra värdet i en variabel, utan att det skrivs ut på sidan.

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

Använd get_the_excerpt() för att skriva ut ett utdrag genom att ange ett maximalt antal tecken.

<?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;}}?>

Förändringslogg

Sedan: 0.71