Mehr Informationen #Mehr Informationen

Zeigt den Auszug des aktuellen Beitrags an, nachdem mehrere Filter darauf angewendet wurden, einschließlich der Auto-P-Formatierung, die doppelte Zeilenumbrüche in HTML-Absätze umwandelt. Es verwendet get_the_excerpt(), um zunächst eine gekürzte Version des vollständigen Beitragsinhalts zu generieren, falls es keinen expliziten Auszug für den Beitrag gibt.

Die gekürzte Version enthält einen „more“-Tag am Ende, der standardmäßig das Symbol „hellip“ ist. Ein vom Benutzer eingegebener Auszug erhält NICHT standardmäßig ein solches Symbol. Um es hinzuzufügen, muss man entweder den rohen $post->post_excerpt manuell in der Vorlage ändern, bevor man the_excerpt() aufruft, einen Filter für ‚get_the_excerpt‘ mit einer Priorität kleiner als 10 hinzufügen oder einen Filter für ‚wp_trim_excerpt‘ hinzufügen (indem man den ersten und zweiten Parameter vergleicht, da ein vom Benutzer gelieferter Auszug in keiner Weise von dieser Funktion verändert wird).

Siehe get_the_excerpt() für weitere Details.

Bei einem automatisch generierten Auszug werden auch alle Shortcodes und Tags entfernt. Er wird auf eine Wortgrenze zurechtgestutzt und die Standardlänge beträgt 55 Wörter. Für Sprachen, in denen Wörter mit einzelnen Zeichen beschrieben werden (oder werden können) (z.B. ostasiatische Sprachen), ist die Wortgrenze tatsächlich das Zeichen.

Hinweis: Wenn der aktuelle Beitrag ein Anhang ist, wie z.B. in den Schleifen der Vorlagen attachment.php und image.php, dann wird die Beschriftung des Anhangs angezeigt. Beschriftungen enthalten nicht den „“-Text.

Vergleich mit dem <!-more-> quicktag #Vergleich mit dem <!-more-> quicktag

Auszüge bieten eine Alternative zur Verwendung des <!–more–> quicktag. Während das „more“-Tag erfordert, dass der Autor eines Beitrags manuell einen „Split“ im Inhalt des Beitrags erstellt, der dann verwendet wird, um einen „Weiterlesen“-Link auf den Indexseiten zu generieren, erfordern die „excerpts“, dass der Autor eines Beitrags einen „Teaser“ für den vollständigen Inhalt des Beitrags bereitstellt, müssen dies aber nicht unbedingt tun.

Das <!–more–> verlangt von den Templates die Verwendung von the_content(), wohingegen die Verwendung von excerpts von den Template-Autoren verlangt und ihnen erlaubt, explizit zu wählen, ob sie einen vollständigen Beitrag (mit the_content()) oder einen Auszug (mit the_excerpt()) anzeigen wollen.

Die Entscheidung, ob ein vollständiger Beitrag oder ein Auszug angezeigt werden soll, kann dann auf Faktoren wie dem verwendeten Template, der Art der Seite, der Kategorie des Beitrags usw. beruhen. Mit anderen Worten: Bei einem <!–more–>-Quicktag entscheidet der Autor des Beitrags, was geschieht, während der Verfasser der Vorlage die Kontrolle über die Auszüge hat. Darüber hinaus kann <!–more–> zwar verwendet werden, um mit dem Parameter $stripteaser einen echten Split zu erzeugen, aber es wäre schwierig und kompliziert, dann nach Merkmalen zu differenzieren, was dazu führt, dass dies im Grunde eine Site-weite Wahl wird.