Articles

WordPress.org

Languages: English – 関数リファレンス/get the excerpt 日本語 (Adaugă limba ta)

Description

Întoarce extrasul postării. Acesta este fie un extras furnizat de utilizator, care este returnat neschimbat, fie o versiune redusă a conținutului complet al postării, generată automat, cu numărul de cuvinte numărate și tăiate.

Extraselor generate automat li s-au eliminat toate codurile scurte și etichetele, ceea ce înseamnă că este doar un șir de caractere neformatat, care nu ar vedea nici o întrerupere de linie în orice formă de ieșire, deoarece întreruperile de linie reale din textul brut sunt, de asemenea, eliminate.

Când este apelat prin intermediul the_excerpt(), acest lucru implică faptul că extrasele auto-gen sunt doar text brut cu etichete <p></p> înfășurate în jurul lui, practic.

Extrasele auto-gen au o etichetă „more” atașată la ele. Această etichetă este ” în mod implicit. Poate fi schimbat prin filtrul excerpt_more.

Lungimea implicită a cuvintelor este de 55 de cuvinte. Poate fi schimbată prin filtrul excerpt_length.

Utilizare

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

Această funcție trebuie utilizată în cadrul The Loop atunci când nu este trecut niciun parametru $post sau ID.

Dacă această funcție este utilizată în afara The Loop și postarea nu are un extras personalizat, această funcție va utiliza wp_trim_excerpt() pentru a genera un extras. Această funcție utilizează get_the_content(), care trebuie să fie utilizată cu The Loop și va cauza probleme dacă get_the_excerpt() este utilizată în afara The Loop. Pentru a evita problemele, utilizați setup_postdata() înainte de a apela get_the_excerpt() pentru a configura obiectul global $post.

Parametri

$post (integer|WP_Post) (opțional) ID-ul postului sau obiectul WP_Post. Valoarea implicită este globală $post. Default: null

Return Values

  • Returnează un extras existent neschimbat (în mod implicit), dar îi aplică filtrele get_the_excerpt.
  • Returnează o versiune redusă a conținutului complet al postării, așa cum este descris, aplicându-i în plus filtrele wp_trim_excerpt. ‘wp_trim_excerpt’ este înlănțuit de la ‘get_the_excerpt’, ceea ce înseamnă că propriul filtru get_the_excerpt va fi apelat înainte sau după trim, în funcție de prioritatea filtrului dumneavoastră. Dacă este apelat înainte, parametrul $text va fi un șir de caractere gol dacă nu există un extras furnizat de utilizator, în timp ce va fi versiunea redusă a mesajului complet dacă este apelat după. În acest din urmă caz, ar putea fi util sau mai semnificativ să folosiți „wp_trim_excerpt”, deoarece are un al doilea parametru care vă oferă intrarea netăiată a funcției wp_trim_excerpt, ceea ce înseamnă că acest al doilea parametru este pur și simplu $post->post_excerpt.
  • Pentru paginile protejate prin parolă returnează un șir de caractere, care are o valoare implicită de „Nu există niciun extras deoarece aceasta este o postare protejată”. Acest text poate fi modificat în definiția funcției.

Exemple

get_the_excerpt() poate fi folosit pentru a prelua și stoca valoarea într-o variabilă, fără a o afișa în pagină.

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

Utilizați get_the_excerpt() pentru a tipări un extras specificând un număr maxim de caractere.

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

Jurnal de modificări

De la: 0.71

.