Języki: English – 関数リファレンス/get the excerpt 日本語 (Dodaj swój język)

Description

Przywraca fragment postu. Jest to albo fragment podany przez użytkownika, który zostanie zwrócony bez zmian, albo automatycznie wygenerowana, przycięta wersja pełnej treści postu.

Automatycznie wygenerowane fragmenty mają usunięte wszystkie shortcodes i tagi, co oznacza, że jest to tylko niesformatowany ciąg znaków, który nie będzie miał żadnych przerw między wierszami w żadnej formie, ponieważ rzeczywiste przerwy między wierszami w tekście są również usunięte.

Kiedy wywołane przez the_excerpt() oznacza to, że fragmenty auto-gen są po prostu surowym tekstem z <p></p> tagami owiniętymi wokół niego, w zasadzie.

Wypisy auto-gen mają dołączony tag „more”. Domyślnie ten znacznik ma wartość ”. Można go zmienić poprzez filtr excerpt_more.

Domyślna długość słowa to 55 słów. Można ją zmienić za pomocą filtra excerpt_length.

Usage

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

Ta funkcja musi być używana wewnątrz The Loop, gdy nie jest przekazywany parametr $post lub ID.

Jeśli ta funkcja jest używana poza The Loop, a post nie ma niestandardowego fragmentu, ta funkcja użyje wp_trim_excerpt() do wygenerowania fragmentu. Ta funkcja używa get_the_content(), która musi być używana z The Loop i spowoduje problemy, jeśli get_the_excerpt() jest używana poza The Loop. Aby uniknąć tych problemów, użyj setup_postdata() przed wywołaniem get_the_excerpt(), aby ustawić globalny obiekt $post.

Parametry

$post (integer|WP_Post) (opcjonalne) Identyfikator postu lub obiekt WP_Post. Domyślnie jest to globalny $post. Default: null

Return Values

• Zwraca istniejący fragment bez zmian (domyślnie), ale stosuje do niego filtry get_the_excerpt.
• Zwraca przyciętą wersję pełnej treści postu zgodnie z opisem, dodatkowo stosując do niej filtry wp_trim_excerpt. 'wp_trim_excerpt’ jest połączony łańcuchowo z 'get_the_excerpt’, co oznacza, że twój własny filtr get_the_excerpt zostanie wywołany przed lub po przycięciu, w zależności od priorytetu twojego filtra. Jeśli zostanie wywołany przed, twój parametr $text będzie pustym ciągiem, jeśli nie ma żadnego fragmentu dostarczonego przez użytkownika, podczas gdy będzie to przycięta wersja pełnego postu, jeśli zostanie wywołany po. W tym ostatnim przypadku może być użyteczne lub bardziej znaczące użycie 'wp_trim_excerpt’, ponieważ ma drugi parametr dający ci nieprzycięte dane wejściowe do funkcji wp_trim_excerpt, co oznacza, że ten drugi parametr jest po prostu surowym $post->post_excerpt.
• Dla stron chronionych hasłem zwraca ciąg, który ma domyślną wartość „Nie ma fragmentu, ponieważ jest to chroniony post.” Tekst ten można zmienić w definicji funkcji.

Przykłady

get_the_excerpt() może być użyta do pobierania i przechowywania wartości w zmiennej, bez wyprowadzania jej na stronę.

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

Użyj get_the_excerpt() do wydrukowania fragmentu, określając maksymalną liczbę znaków.

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

Dziennik zmian

Od: 0.71

.