Sprachen: Englisch – 関数リファレンス/get the excerpt 日本語 (Füge deine Sprache hinzu)

Beschreibung

Gibt den Auszug des Beitrags zurück. Dabei handelt es sich entweder um einen vom Benutzer eingegebenen Auszug, der unverändert zurückgegeben wird, oder um eine automatisch generierte, wortgezählte, gekürzte Version des vollständigen Beitragsinhalts.

Bei den automatisch generierten Auszügen wurden alle Shortcodes und Tags entfernt, was bedeutet, dass es sich nur um eine unformatierte Zeichenkette handelt, die in der Ausgabe keine Zeilenumbrüche aufweisen würde, da die tatsächlichen Zeilenumbrüche im Rohtext ebenfalls entfernt wurden.

Wenn es durch the_excerpt() aufgerufen wird, bedeutet dies, dass die automatisch generierten Auszüge nur roher Text sind, der mit <p></p> Tags umwickelt ist.

Automatisch generierte Auszüge haben ein „more“-Tag angehängt. Dieser Tag ist standardmäßig “. Er kann durch den Filter excerpt_more geändert werden.

Die Standardwortlänge beträgt 55 Wörter. Sie kann durch den excerpt_length-Filter geändert werden.

Verwendung

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

Diese Funktion muss innerhalb der Schleife verwendet werden, wenn kein $post– oder ID-Parameter übergeben wird.

Wenn diese Funktion außerhalb der Schleife verwendet wird und der Beitrag keinen benutzerdefinierten Auszug hat, wird diese Funktion wp_trim_excerpt() verwenden, um einen Auszug zu erzeugen. Diese Funktion verwendet get_the_content(), das mit The Loop verwendet werden muss und Probleme verursacht, wenn get_the_excerpt() außerhalb von The Loop verwendet wird. Um die Probleme zu vermeiden, verwenden Sie setup_postdata() vor dem Aufruf von get_the_excerpt(), um das globale $post-Objekt einzurichten.

Parameter

$post (integer|WP_Post) (optional) Post-ID oder WP_Post-Objekt. Standard ist global $post. Standard: null

Rückgabewerte

• Gibt einen bestehenden Auszug unverändert zurück (standardmäßig), wendet aber get_the_excerpt-Filter darauf an.
• Gibt eine gekürzte Version des vollständigen Beitragsinhalts wie beschrieben zurück, wobei zusätzlich wp_trim_excerpt-Filter darauf angewendet werden. ‚wp_trim_excerpt‘ ist mit ‚get_the_excerpt‘ verkettet, was bedeutet, dass Ihr eigener get_the_excerpt-Filter vor oder nach dem Trim-Filter aufgerufen wird, je nach Priorität Ihres Filters. Wenn er vor dem Filter aufgerufen wird, ist Ihr $text-Parameter ein leerer String, wenn es keinen vom Benutzer gelieferten Auszug gibt, während er die gekürzte Version des vollständigen Beitrags ist, wenn er danach aufgerufen wird. Im letzteren Fall könnte es nützlich oder sinnvoller sein, „wp_trim_excerpt“ zu verwenden, da es einen zweiten Parameter hat, der Ihnen die ungekürzte Eingabe für die wp_trim_excerpt-Funktion liefert, d.h. dieser zweite Parameter ist einfach der rohe $post->post_excerpt.
• Für passwortgeschützte Seiten gibt es einen String zurück, der den Standardwert „Es gibt keinen Auszug, da dies ein geschützter Beitrag ist.“ hat. Dieser Text kann in der Funktionsdefinition geändert werden.

Beispiele

get_the_excerpt() kann verwendet werden, um den Wert abzurufen und in einer Variablen zu speichern, ohne ihn auf der Seite auszugeben.

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

Mit get_the_excerpt() kann man einen Auszug ausgeben, indem man eine maximale Anzahl von Zeichen angibt.

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

Seit: 0.71