Returnează o imagine (împreună cu o etichetă HTML și atributele sale), care este stabilit ca un post miniatural. Dacă postul specificat nu are o miniatură, atunci funcția returnează un șir gol.
$ post_id (integer) ID-ul postului, miniatură de care trebuie să obținem, implicit - ID-ul postului curent din buclă. $ size (string | array) în acest parametru specifică dimensiunea miniaturii. Pot avea următoarele valori:
- miniatură / mediu / mare - una dintre dimensiunile standard înregistrate în WordPress în mod prestabilit, aceste dimensiuni pot fi personalizate în Setări> Media,
- full - rezoluția originală a imaginii - așa că a fost încărcat pe site,
- Puteți specifica parametrii de lățime și înălțime ai miniaturii ca matrice, de exemplu, array (50, 30). Vă rugăm să rețineți, WordPress nu va crea o imagine duplicat pentru această dimensiune - va fi în schimb utilizate pentru a rezolva cea mai apropiată dimensiune a imaginii înregistrate, adaptate pentru a se potrivi parametrii menținând în același timp raportul de aspect original.
- src - dacă aveți nevoie, puteți chiar să înlocuiți adresa URL a imaginii.
- clasă - clasă a etichetei
. Implicit, are următoarele clase de imagine wp-post și clase de atașament.
- alt - în mod prestabilit, trim (strip_tags ($ attachment-> post_title)) - este indicat în panoul de administrare atunci când se încarcă / editează un fișier media.
- titlu - în mod implicit trim (strip_tags ($ attachment-> post_excerpt)).
Un exemplu simplu este pur și simplu afișarea unei postări miniatură cu ID = 5:
În acest exemplu, am folosit și funcția has_post_thumbnail () pentru a vă asigura că, în absența unei miniaturi, codul nu a lansat o etichetă suplimentară .
Exemplu 3. Cum pot face versiunea completă a imaginii deschise când fac clic pe o miniatură?
Codul din acest exemplu este grozav pentru utilizarea în unele plugin-uri jQuery, cum ar fi fancybox sau destul de fotografie. În acest caz, poate fi necesar să adăugați și o clasă pentru link.
De asemenea, puteți citi documentația pentru funcțiile wp_get_attachment_image_src () și get_post_thumbnail_id () pe blogul meu.
Exemplu 4. Utilizați al treilea parametru $ attr pentru a schimba clasa de miniaturi
Să adăugăm un tip aliniere-stânga la miniaturile noastre, astfel încât să curgă în jurul textului din stânga:
Numărul de parametri ai acestui filtru nu se poate bucura, ceea ce înseamnă că putem crea tot ce ne dorim cu codul HTML returnat.
$ HTML (string) HTML-cod returnat de funcția implicit, $ POST_ID (număr întreg) post-ID-ul, care au nevoie de o miniatură pentru a obține, $ post_thumbnail_id (număr întreg) miniaturile ID, dimensiunea $ (string | matrice) dimensiunea miniatură, $ attr ( array) de atribute HTML care au fost specificate atunci când funcția a fost apelată, dacă nu este specificată, o matrice goală;
Și acum câteva exemple interesante.
Exemplul 1. Postarea automată a legăturilor la postare
Răcoros, nu? Și cel mai important - totul este foarte simplu.
Exemplul 2. Revenind numai la adresa URL a miniaturilor
Un alt lucru util care se poate face cu filtrul post_thumbnail_html. Să presupunem că nu avem nevoie de codul HTML cu o etichetă . De exemplu, avem nevoie doar de o adresă URL. În acest caz:
