WooCommerce · Personalizare temă
Repararea galeriei de produs WooCommerce
Galeria de produs pare goală sau fără zoom, de obicei pentru că JavaScript-ul ei nu pornește sau tema nu declară funcțiile.
- Galeria ascunsă cu opacity 0
- Eroare JavaScript
- Zoom, slider, lightbox prin theme support
- Minificare și combinare JS
- Teste fără plugin
Răspuns în aceeași zi lucrătoare Ofertă fixă Fără parole
Răspuns rapid
În șablonul WooCommerce product-image.php containerul galeriei are stil inline opacity: 0, iar JavaScript-ul single-product îl pune la 1 după inițializare. Dacă scriptul nu rulează (eroare JS, jQuery lipsă, fișier blocat de minificare sau combinare), galeria rămâne invizibilă. Zoom-ul, slider-ul și lightbox-ul sunt pornite doar dacă tema declară add_theme_support pentru wc-product-gallery-zoom, wc-product-gallery-slider și wc-product-gallery-lightbox; filtrele woocommerce_single_product_zoom_enabled, _photoswipe_enabled și _flexslider_enabled le pot controla.
Ce ai nevoie
- Consola browserului (F12)
- Acces la tema copil
- Posibilitatea de a dezactiva temporar pluginuri de optimizare
- Un produs cu 3+ imagini
Pașii, pe rând
- 1Deschide consolaF12 → Console: caută erori JavaScript la încărcarea paginii de produs. O eroare dintr-un alt script poate opri celelalte.
- 2Verifică încărcarea scripturilorÎn Network trebuie să se încarce jQuery și scriptul single-product; un 404 sau un script blocat explică galeria invizibilă.
- 3Dezactivează optimizărileOprește minificarea, combinarea și amânarea JS din pluginul de cache; dacă galeria apare, excluzi scripturile WooCommerce și jQuery.
- 4Testează cu o temă implicităPe staging activează o temă standard și dezactivează pluginurile; reactivezi pe rând ca să găsești vinovatul.
- 5Declară funcțiile galerieiDacă lipsesc zoom, glisare sau lightbox, adaugi add_theme_support-ul corespunzător în tema copil.
- 6Verifică dimensiunile imaginilorImagini prea mici nu fac zoom. Regenerează miniaturile dacă dimensiunile s-au schimbat.
- 7Golește cache-ulDupă fiecare schimbare, golești cache-ul de pagină, CDN și browser.
Activează zoom, lightbox și slider în temă
php<?php
add_action( 'after_setup_theme', function () {
add_theme_support( 'wc-product-gallery-zoom' );
add_theme_support( 'wc-product-gallery-lightbox' );
add_theme_support( 'wc-product-gallery-slider' );
} );Fragmentele de cod sunt scheleturi: le pui într-o temă copil sau într-un plugin propriu și le testezi întâi pe un mediu de test (staging).
Hook-urile și șabloanele sunt cele din codul WooCommerce la data verificării; o temă sau un constructor vizual poate înlocui șabloanele implicite, așa că verifică ce folosește tema ta.
Mai multe detalii
Cauze frecvente și greșeli de evitatDacă pașii de mai sus nu au rezolvat problema
Spațiu gol în loc de galerie
De ce: Opacity rămâne 0 pentru că JavaScript-ul nu rulează.
Ce faci: Rezolvă eroarea din consolă sau exclude scripturile din optimizare.
Fără zoom sau lightbox
De ce: Tema nu declară funcțiile sau un filtru le dezactivează.
Ce faci: add_theme_support sau verifică filtrele.
Miniaturile sunt greșite
De ce: Dimensiuni de imagine modificate sau cache vechi.
Ce faci: Regenerează miniaturile și golește cache-ul.
Întrebări frecvente4 răspunsuri
De ce e galeria invizibilă?
Containerul pornește cu opacity 0 și devine vizibil doar după ce scriptul rulează.
Cum pornesc zoom-ul?
Cu add_theme_support('wc-product-gallery-zoom') în tema copil.
Poate vinovatul să fie pluginul de cache?
Da, dacă minifică sau combină scripturi; exclude jQuery și scripturile WooCommerce.
Mă ajutați să reparați galeria?
Da. Cere ofertă fixă.
Subiecte acoperite pe această pagină
- galerie produs WooCommerce nu se vede
- WooCommerce zoom imagine nu merge
- wc-product-gallery-zoom
- imaginea produsului nu apare
- lightbox WooCommerce
Ghiduri apropiate
- Personalizarea paginii de produs cu hooks WooCommerce
- Crearea unui șablon de categorie cu Elementor pentru WooCommerce
- Adăugarea unui buton fix de cumpărare pe mobil în WooCommerce
- Personalizarea paginii de mulțumire WooCommerce
- Personalizarea secțiunilor Contul meu WooCommerce
- Adăugarea etichetelor comerciale pe cardurile de produs WooCommerce
- WooCommerce: imagini diferite pentru fiecare variantă
- Toate ghidurile
Surse și verificare
- WooCommerce: single-product/product-image.php
- WooCommerce: wc-template-functions.php
- WordPress: add_theme_support()
Verificat pe 5 noiembrie 2026. Denumirile din setări și pașii pot diferi între versiuni.
