Ce dimensiune ar trebui să aibă o imagine reprezentativă în WordPress?

Cifra pe care o caută majoritatea este 1200 x 630 pixeli. Acesta este raportul folosit de Facebook, LinkedIn și X pentru previzualizarea linkurilor (1.91:1) și este dimensiunea pe care ar trebui să o aibă o imagine Open Graph. Dacă setezi o imagine reprezentativă în principal pentru ca linkurile distribuite să arate bine, folosește 1200 x 630 și oprește-te aici.

Dar acea cifră nu este ceea ce afișează efectiv tema ta în articol. WordPress arată rareori imaginea reprezentativă la dimensiunea originală. Tema solicită o anumită dimensiune de imagine înregistrată, iar WordPress livrează varianta pregenerată care se potrivește. De aceea o imagine care arată perfect pe Facebook poate apărea neclară, întinsă sau tăiată greșit în șablonul articolului. Dimensiunea „corectă” depinde de temă, nu de o regulă universală.

De ce tema anulează cifra

Când încarci o imagine, WordPress nu stochează un singur fișier. Rulează wp_generate_attachment_metadata() și creează o variantă pentru fiecare dimensiune de imagine înregistrată: cele trei implicite (thumbnail, medium, large), dimensiunea medium_large a editorului de blocuri (768px lățime), plus orice dimensiune înregistrată de temă sau de un plugin prin add_image_size().

O temă care vrea un antet lat 16:9 va face ceva de genul acesta în functions.php:

add_theme_support( 'post-thumbnails' );
add_image_size( 'hero-featured', 1200, 675, true );

Al patrulea argument, true, înseamnă decupare fixă (hard crop). WordPress îți va decupa imaginea exact la 1200 x 675, eliminând tot ce nu încape în caseta 16:9. Dacă subiectul se află aproape de marginea de sus sau de jos a cadrului, va fi tăiat. Setat pe false (sau omis), imaginea se scalează proporțional, iar dimensiunile finale pot diferi de cele solicitate.

Apoi șablonul decide ce dimensiune să extragă:

the_post_thumbnail( 'hero-featured' );

Orice nume este transmis către the_post_thumbnail() este varianta decupată care se afișează. Așadar, dimensiunea reală a imaginii reprezentative de pe site-ul tău este definită în două locuri pe care nu le-ai scris tu: apelul add_image_size() și apelul the_post_thumbnail() din temă. Încărcarea unui fișier mai mare nu schimbă niciunul dintre ele.

Mai există un nivel. WordPress livrează un srcset, deci pe ecrane mai mici browserul poate încărca varianta medium sau large în loc de decuparea completă. Dimensiunea pe care o vezi în DevTools deseori nu este cea pe care ai încărcat-o.

Cum rezolvi problema, pas cu pas

1. Află ce solicită de fapt tema ta. Înainte să ghicești, vezi fiecare dimensiune pe care WordPress o generează din imaginea ta și care dintre ele este antetul decupat. Încarcă imaginea în instrumentul pentru dimensiuni de imagini WordPress — îți arată fiecare variantă pe care WP ar crea-o, la dimensiuni exacte în pixeli, ca să poți potrivi sursa cu ținta reală în loc de miticul 1200x630.

2. Încarcă suficient de mare cât să acoperi cea mai mare decupare. Dacă antetul temei este 1200 x 675, încarcă cel puțin atât și, ideal, 2x pentru retina (2400 x 1350). WordPress micșorează curat; niciodată nu mărește. O sursă prea mică este cea mai frecventă cauză a unei imagini reprezentative neclare.

3. Potrivește raportul de aspect cu decuparea temei. Dacă tema decupează fix la 16:9, oferă-i 16:9. Compune cu subiectul centrat, ca o decupare fixă să nu decapiteze pe nimeni.

4. Dacă dimensiunea înregistrată este greșită, schimb-o și regenerează. Modifică valorile add_image_size() într-o temă copil, apoi reconstruiește miniaturile existente — noile dimensiuni se aplică doar încărcărilor viitoare până când faci:

wp media regenerate --yes

Nu ai WP-CLI? Pluginul Regenerate Thumbnails face același lucru din panoul de administrare.

Ce să nu faci

Nu încărca pur și simplu o imagine de 1200x630 presupunând că totul e rezolvat. Dacă dimensiunea înregistrată a temei este 16:9, WordPress îți decupează fix imaginea 1.91:1 și pierzi partea de sus și de jos. Cifra Open Graph și cifra de afișare sunt sarcini diferite.

Nu dezactiva dimensiunile de imagine din WordPress ca să „păstrezi originalul”. Găsești sfaturi care recomandă setarea dimensiunilor intermediare pe 0 sau dezlegarea the_post_thumbnail. Atunci tema recurge la livrarea fișierului la dimensiune completă, scalat în browser — un JPEG de 4000px trimis către un telefon. Asta îți distruge timpul de încărcare și Core Web Vitals. Variantele există dintr-un motiv.

Nu avea încredere în „dimensiunea recomandată” a unui plugin în detrimentul dimensiunii reale înregistrate de tema ta. Pluginurile SEO recomandă 1200x630 pentru eticheta OG, ceea ce este corect pentru acea etichetă. Nu spune însă nimic despre ce decupează șablonul articolului tău.

Nu sări peste wp media regenerate după ce schimbi dimensiunile. Modificarea add_image_size() nu are niciun efect asupra imaginilor deja încărcate. Acesta este pasul pe care oamenii îl uită, apoi concluzionează că nu a funcționat codul.

Tot blocat?

Dacă imaginea este în continuare greșită după ce ai potrivit dimensiunile și ai regenerat, problema este de obicei modul de decupare (true vs false) sau un srcset care livrează o variantă mai mică decât te aștepți. Încarcă fișierul în instrumentul pentru dimensiuni de imagini ca să vezi exact ce decupări produce configurația ta, apoi compară asta cu ce încarcă browserul în DevTools. Potrivește cele două și gata cu ghicitul.