Get_the_post_thumbnail () - returnează miniaturile postărilor WordPress

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.
Pentru a face mai clară, voi da un exemplu. Să presupunem că, ca argument, am specificat matricea (50, 30). Cea mai apropiată dimensiune este 125 × 125 (thumbnail) - URL-ul acestei imagini și va fi inserată în atributul src. Bine, cum rămâne cu proporțiile? Deoarece 125 × 125 este un pătrat, iar miniatura noastră va fi pătrați, se va potrivi în cel mai mic parametru, adică rezultatul va fi de 30 × 30.
  • Una dintre dimensiunile personalizate ale imaginilor înregistrate prin intermediul funcției add_image_size ().
  • $ attr (array) de atribute de etichete suprascrise . Prin aceasta, puteți suprascrie următoarele atribute HTML:





    • 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:

    Get_the_post_thumbnail () - returnează miniaturile postărilor WordPress

    Misha Rudrashy







    Articole similare

    Trimiteți-le prietenilor: