Articles

WordPress.org

Mai multe informații #Mai multe informații

Afișează extrasul postării curente după ce i s-au aplicat mai multe filtre, inclusiv formatarea auto-p, care transformă salturile de linie duble în paragrafe HTML. Folosește get_the_excerpt() pentru a genera mai întâi o versiune redusă a conținutului complet al postării, în cazul în care nu există un extras explicit pentru această postare.

Versiunea redusă conține o etichetă „more” la sfârșit care, în mod implicit, este simbolul sau „hellip”. Un extras furnizat de utilizator NU primește în mod implicit un astfel de simbol. Pentru a-l adăuga, trebuie fie să modificați manual în șablonul dumneavoastră $post->post_excerpt brut înainte de a apela the_excerpt(), fie să adăugați un filtru pentru „get_the_excerpt” cu o prioritate mai mică de 10, fie să adăugați un filtru pentru „wp_trim_excerpt” (comparând primul și al doilea parametru, deoarece un extras furnizat de utilizator nu este modificat în niciun fel de această funcție).

Vezi get_the_excerpt() pentru mai multe detalii.

Un excerpt generat automat va avea, de asemenea, toate shortcodes și tag-urile eliminate. Acesta este tăiat până la o limită de cuvinte, iar lungimea implicită este de 55 de cuvinte. Pentru limbile în care cuvintele sunt (sau pot fi) descrise cu un singur caracter (de exemplu, limbile est-asiatice), cuvântul-limită este de fapt caracterul.

Nota: Dacă postarea curentă este un atașament, cum ar fi în buclele de șabloane attachment.php și image.php, atunci este afișată legenda atașamentului. Legendele nu includ textul „”.

Comparare cu quicktag-ul <!-more-> #Comparare cu quicktag-ul <!-more->

Extragerile oferă o alternativă la utilizarea quicktag-ului <!–more–>. În timp ce acest tag more necesită ca autorul unei postări să creeze manual o „divizare” în conținutul postării, care este apoi utilizată pentru a genera un link „citește mai mult” pe paginile de index, extrasele necesită, dar nu neapărat cer autorului unei postări să furnizeze un „teaser” pentru întregul conținut al postării.

Eticheta <!–more–> quicktag-ul necesită ca șabloanele să utilizeze the_content(), în timp ce utilizarea extraselor necesită și permite autorilor de șabloane să aleagă în mod explicit dacă să afișeze posturile complete (utilizând the_content()) sau extrasele (utilizând the_excerpt()).

Alegerea de a afișa o postare completă sau un extras se poate baza apoi pe factori precum șablonul utilizat, tipul de pagină, categoria postului etcetera. Cu alte cuvinte, cu un quicktag <!–more–> autorul postării decide ce se întâmplă, în timp ce autorul șablonului deține controlul în cazul extraselor. Mai mult decât atât, deși <!–more–> poate fi folosit pentru a crea o adevărată divizare folosind parametrul $stripteaser, ar fi greu și complicat să se facă apoi diferențierea în funcție de caracteristici, ceea ce face ca aceasta să devină practic o alegere la nivelul întregului site.