Więcej informacji #Więcej informacji

Wyświetla fragment bieżącego postu po zastosowaniu kilku filtrów do niego, w tym formatowania auto-p, które zamienia podwójne łamanie linii na akapity HTML. Używa get_the_excerpt() do wygenerowania najpierw okrojonej wersji pełnej zawartości postu, jeśli nie ma wyraźnego fragmentu dla tego postu.

Przycięta wersja zawiera znacznik 'more’ na końcu, który domyślnie jest symbolem „hellip”. Dostarczony przez użytkownika fragment NIE ma domyślnie takiego symbolu. Aby go dodać, musisz albo zmodyfikować surowy $post->post_excerpt ręcznie w swoim szablonie przed wywołaniem the_excerpt(), dodać filtr dla 'get_the_excerpt’ z priorytetem niższym niż 10, lub dodać filtr dla 'wp_trim_excerpt’ (porównując pierwszy i drugi parametr, ponieważ fragment dostarczony przez użytkownika nie jest w żaden sposób zmieniany przez tę funkcję).

Zobacz get_the_excerpt() po więcej szczegółów.

Automatycznie wygenerowany fragment będzie miał również usunięte wszystkie shortcodes i tagi. Jest on przycinany do granicy słów, a jego domyślna długość to 55 słów. Dla języków, w których słowa są (lub mogą być) opisane pojedynczymi znakami (np. języki wschodnioazjatyckie), granica słowa jest w rzeczywistości znakiem.

Uwaga: Jeśli bieżący post jest załącznikiem, takim jak w pętlach szablonów attachment.php i image.php, wtedy wyświetlany jest podpis załącznika. Podpisy nie zawierają tekstu „”.

Porównanie z tagiem <!-more-> quicktag #Porównanie z tagiem <!-more-> quicktag

Wstępy zapewniają alternatywę dla użycia tagu <!–more–> quicktag. Podczas gdy ten znacznik more wymaga od autora postu ręcznego utworzenia „podziału” w treści postu, który jest następnie używany do generowania linku „czytaj więcej” na stronach indeksu, fragmenty wymagają, ale nie muszą wymagać od autora postu dostarczenia „zapowiedzi” pełnej treści postu.

The <!–more–> quicktag wymaga od szablonów użycia the_content() podczas gdy użycie excerpts wymaga, i pozwala, autorom szablonów na wyraźny wybór czy wyświetlać pełne posty (używając the_content()) czy excerpts (używając the_excerpt()).

Wybór czy wyświetlać pełny post czy excerpt może być oparty na czynnikach takich jak używany szablon, typ strony, kategoria postu, etcetera. Innymi słowy, z <!–more–> quicktagiem autor postu decyduje o tym, co się stanie, podczas gdy autor szablonu ma kontrolę nad fragmentami. Ponadto, chociaż <!–more–> może być użyty do stworzenia prawdziwego podziału przy użyciu parametru $stripteaser, byłoby trudno i skomplikowane, aby następnie zróżnicować na podstawie cech, powodując, że stałoby się to w zasadzie wyborem site-wide.

.