Languages: (Add your language)

Description

Returns the excerpt of the post. Ez vagy a felhasználó által megadott kivonat, amelyet változatlanul ad vissza, vagy a teljes bejegyzés tartalmának automatikusan generált, szavakkal megszámolt, lecsupaszított változata.

Az automatikusan generált kivonatokból minden rövidkódot és taget eltávolítanak, ami azt jelenti, hogy ez csak egy formázatlan karakterlánc, amely semmilyen formában nem látna sortörést a kimeneten, mivel a nyers szövegben lévő tényleges sortörések is eltávolításra kerülnek.

A the_excerpt()-on keresztül történő meghívás esetén ez azt jelenti, hogy az automatikus generálású kivonatok csak nyers szövegek, amelyek köré alapvetően <p></p> címkéket tekernek.

Az automatikus generálású kivonatokhoz egy “more” címkét csatolnak. Ez a tag alapértelmezés szerint ”. Ezt az excerpt_more szűrővel lehet megváltoztatni.

Az alapértelmezett szóhossz 55 szó. Ez megváltoztatható az excerpt_length szűrőn keresztül.

Használat

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

Ezt a funkciót a cikluson belül kell használni, ha nincs $post vagy ID paraméter átadva.

Ha ezt a funkciót a cikluson kívül használjuk, és a bejegyzésnek nincs egyéni kivonata, ez a funkció a wp_trim_excerpt()-t fogja használni a kivonat létrehozásához. Ez a függvény a get_the_content() függvényt használja, amelyet a The Looppal együtt kell használni, és problémákat okoz, ha a get_the_excerpt() függvényt a The Loopon kívül használja. A problémák elkerülése érdekében a get_the_excerpt() hívása előtt használja a setup_postdata() funkciót a globális $post objektum beállításához.

Paraméterek

$post (integer|WP_Post) (opcionális) Post ID vagy WP_Post objektum. Az alapértelmezett érték a globális $post. Alapértelmezett: null

Return Values

• A meglévő kivonatot változatlanul adja vissza (alapértelmezés szerint), de a get_the_excerpt szűrőket alkalmazza rá.
• A teljes poszt tartalmának a leírtak szerint lecsupaszított változatát adja vissza, ráadásul wp_trim_excerpt szűrőket alkalmazva rá. A ‘wp_trim_excerpt’ a ‘get_the_excerpt’-hez kapcsolódik, ami azt jelenti, hogy a saját get_the_excerpt szűrőd a trimmelés előtt vagy után kerül meghívásra, a szűrőd prioritásától függően. Ha előtte hívod, akkor a $text paramétered egy üres karakterlánc lesz, ha nincs a felhasználó által megadott kivonat, míg ha utána hívod, akkor a teljes bejegyzés lecsupaszított változata lesz. Az utóbbi esetben hasznos vagy értelmesebb lehet a ‘wp_trim_excerpt’ használata, mivel van egy második paramétere, amely a wp_trim_excerpt függvénynek a vágatlan bemenetet adja, vagyis ez a második paraméter egyszerűen a nyers $post->post_excerpt.
• Jelszóval védett oldalak esetén egy stringet ad vissza, amelynek alapértelmezett értéke “There is no excerpt because this is a protected post”. Ez a szöveg a függvény definíciójában megváltoztatható.

Példák

get_the_excerpt() használható az érték kinyerésére és egy változóban való tárolására, anélkül, hogy az oldalra kiírnánk.

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

A get_the_excerpt() segítségével egy kivonatot nyomtathat ki a maximális karakterszám megadásával.

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

Change Log

Since: 0.71