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
.