Rozwiązywanie problemów

Ta strona zbiera najczęściej spotykane problemy. Dla głębszej diagnostyki każde wywołanie API jest rejestrowane w logach Shopware, a moduł admina Mediaverse pokazuje błędy subskrypcji / API na dashboardzie.

Moduł “Mediaverse” nie pojawia się w panelu admina

• Potwierdź, że plugin jest aktywowany pod Extensions → My extensions.
• Wyczyść cache admina: bin/console cache:clear.
• Hard-reload admina (Ctrl+Shift+R).
• Sprawdź, czy twoja rola użytkownika ma dostęp do nowych kluczy ACL.

Wideo nie odtwarza się w storefroncie

• Otwórz stronę szczegółów produktu w karcie incognito, żeby pominąć stan zgody na cookies.
• Sprawdź konsolę przeglądarki w poszukiwaniu błędów CORS lub blokowania third-party.
• Dla osadzeń: spróbuj innej przeglądarki, żeby wykluczyć ad-blocker.
• Dla lokalnego HTML5: zweryfikuj, że plik jest faktycznie w bibliotece mediów i nie został usunięty.

Cover video nie odtwarza się automatycznie w listingach

• Potwierdź Muted = on dla wpisu cover. Nowoczesne przeglądarki wymagają wyciszonego autoplay.
• Potwierdź, że źródło jest włączone w Settings → Plugins → Mediaverse → Video → Display in product listings.
• Sprawdź, czy lazy loading nie unmountuje wideo, zanim zdąży zagrać.

Brak miniatur dla YouTube / Vimeo / TikTok

• Automatyczne pobieranie odbywa się podczas zapisywania wpisu mediów. Jeśli URL źródła był nieprawidłowy w momencie zapisu, miniatura nie jest pobierana.
• Wklej ponownie URL i zapisz ponownie, żeby ponownie wyzwolić pobieranie.
• Dla Facebook i G-Core automatyczne miniatury nie są obsługiwane — wgraj ręcznie.

Subskrypcja mówi “expired”, ale zapłaciłem

• Status subskrypcji jest pobierany z twojego konta Shopware okresowo. Odśwież dashboard Mediaverse.
• Jeśli wciąż wygasły po kilku minutach, zaloguj się do konta Shopware i zweryfikuj, że subskrypcja jest aktywna.
• Reaktywuj plugin (deactivate → activate), żeby wymusić ponowne sprawdzenie.

Import CSV zawodzi na wierszu N

• Widok importu na dashboardzie pokazuje numer wiersza i komunikat błędu.
• Częste przyczyny: nie znaleziono product number, nie rozpoznano źródła, ISO języka nie istnieje w sklepie.
• Popraw wiersz i uruchom import ponownie — już zaimportowane wiersze są aktualizowane, nie duplikowane.

Panorama 360° jest rozmazana lub zniekształcona

• Obraz prawdopodobnie nie jest equirectangular. Panoramy potrzebują proporcji 2:1 (np. 6000×3000).
• Wyeksportuj ponownie z kamery 360° lub narzędzia stitchingowego.

Model 3D jest ogromny / wolno się ładuje

• Skompresuj model: glTF Draco compression często zmniejsza pliki 5–10x.
• Przełącz tryb ładowania na manual, żeby klienci wyraźnie wybierali.
• Przenieś modele na CDN, jeśli twoje origin jest wolne.

Przycisk AR nie pojawia się

• AR jest dostępny tylko na urządzeniach mobilnych, które go wspierają (nowoczesny iOS + iOS Quick Look, nowoczesny Android + Scene Viewer).
• Przeglądarki desktopowe celowo nie pokazują przycisku AR.
• Potwierdź, że AR jest włączony w Settings → Mediaverse → Model Viewer → AR.

Hotspoty są w złej pozycji po zmianie obrazu

• Hotspoty są zakotwiczone do koordynatów obrazu. Zastąpienie obrazu innym o innej proporcji przesuwa kropki.
• Otwórz ponownie edytor hotspotów i przeciągnij kropki z powrotem na właściwe pozycje.

Storefront nie podnosi zmian ustawień

• Wyczyść cache storefrontu: bin/console cache:clear.
• Dla zmian assetów również przebuduj bundle storefrontu, jeśli self-hostujesz (bin/build-storefront.sh).
• Hard-reload przeglądarki.

Gdzie szukać najpierw

• Plugin Dashboard — status subskrypcji, quick-jump kafelki do każdej sekcji konfiguracji.
• Browser DevTools — dla problemów storefrontu konsola JS zwykle wskazuje przyczynę.
• Logi Shopware — dla błędów backendu var/log/dev.log (lub prod.log).
• Support konta — skontaktuj się ze wsparciem P2Lab przez konto Shopware w sprawie subskrypcji.

Powiązane

• Subskrypcja
• Przegląd modułu admina