Konfiguratory 3D Problem i rozwiązanie
Jak dodać model 3D do sklepu WooCommerce - galeria produktu, AR i szybkość krok po kroku
W skrócie
- Objaw: sklep na WooCommerce ma tylko zdjęcia produktów, a próba dodania modelu 3D kończy się błędem wgrywania pliku, modelem wstawionym poza galerią albo wolniejszą kartą produktu.
- Przyczyna: WooCommerce w podstawowej wersji obsługuje w galerii obrazy, a nie modele 3D, WordPress domyślnie blokuje wgrywanie plików GLB i USDZ, a model ładowany razem ze stroną spowalnia sklep.
- Rozwiązanie: przygotuj lekkie pliki GLB i USDZ, zezwól na ich wgrywanie albo trzymaj je na serwerze plików, osadź przeglądarkę 3D w galerii produktu ze zdjęciem jako podglądem i ładowaniem po kliknięciu, a warianty sklepu połącz z wariantami materiałów modelu.
Nie masz czasu? Zrobimy to za Ciebie - Konfigurator 3D na stronę od 3 500 zł netto
Model 3D w WooCommerce dodaje się przez wtyczkę albo kod w motywie, który osadza przeglądarkę 3D, np. komponent model-viewer, w galerii produktu obok zdjęć. Podstawowa wersja WooCommerce obsługuje w galerii tylko obrazy, a WordPress domyślnie nie pozwala wgrać plików GLB i USDZ do biblioteki mediów, więc trzeba to przewidzieć. Najważniejsze jest, żeby model był lekki, ładował się dopiero po kliknięciu i działał w AR na iPhonie i Androidzie.
Jak to wygląda
- przy próbie wgrania pliku .glb WordPress pokazuje błąd, że ten typ pliku jest niedozwolony,
- model wyświetla się pod opisem produktu zamiast w galerii, obok zdjęć,
- karta produktu ładuje się wolniej, a wynik PageSpeed spadł,
- przycisk AR działa na Androidzie, ale nie na iPhonie,
- po wyborze innego koloru w wariantach produktu model zostaje w poprzednim kolorze.
Dlaczego to nie działa od razu?
WooCommerce nie ma pola na model 3D
Galeria produktu w WooCommerce przechowuje obrazy. Model trzeba więc zapisać w osobnym polu produktu (np. adresy plików GLB i USDZ) i dodać do galerii jako dodatkowy element, z poziomu wtyczki albo motywu. Rozwiązania, które wstawiają model w treść opisu, działają, ale model ląduje daleko od zdjęć, gdzie klient go nie szuka.
WordPress blokuje pliki GLB i USDZ
Lista domyślnie dozwolonych typów plików w WordPressie nie obejmuje rozszerzeń glb, gltf ani usdz. Dodaje się je filtrem w kodzie (dokumentacja WordPressa wskazuje do tego filtry mime_types i upload_mimes) albo przez wtyczkę. Alternatywą jest trzymanie modeli na osobnym serwerze plików lub w CDN i zapisanie w produkcie tylko ich adresów.
Serwer wysyła pliki z niewłaściwym typem
Nawet wgrany plik USDZ nie otworzy się w AR na iPhonie, jeśli serwer wysyła go bez typu model/vnd.usdz+zip. To częsta przyczyna sytuacji, w której AR działa na Androidzie, a na iPhonie nie. Szczegóły opisujemy we wpisie model 3D nie działa w AR na iPhonie.
Model ładuje się razem ze stroną
Karta produktu to strona, na której liczy się szybkość. Jeśli biblioteka 3D i plik modelu ładują się od razu, klient czeka na kilka megabajtów danych, zanim zobaczy zdjęcia i cenę.
Jak dodać model 3D do karty produktu krok po kroku
| Etap | Co zrobić |
|---|---|
| Pliki | Lekki GLB (strona i Android) i USDZ (iPhone) z jednego modelu źródłowego |
| Przechowywanie | Zezwolenie na wgrywanie GLB i USDZ albo serwer plików z adresami zapisanymi w produkcie |
| Typy MIME | model/gltf-binary dla GLB i model/vnd.usdz+zip dla USDZ |
| Osadzenie | Przeglądarka 3D jako element galerii produktu, obok zdjęć |
| Szybkość | Zdjęcie produktu jako podgląd, model ładowany po kliknięciu |
| AR | Przycisk AR widoczny na telefonach, które go obsługują |
| Warianty | Wybór wariantu w sklepie przełącza wariant materiału w modelu |
| Test | iPhone w Safari, telefon z Androidem, komputer, PageSpeed Insights |
Wygodnym sposobem wyświetlania modelu jest komponent model-viewer, który obsługuje podgląd 3D, AR na obu systemach i odsłanianie modelu na żądanie. Przykład osadzenia z podglądem i AR:
<model-viewer src="pergola.glb" ios-src="pergola.usdz"
poster="pergola.webp" reveal="manual" ar camera-controls
alt="Pergola aluminiowa z dachem lamelowym, model 3D"></model-viewer>
Przy reveal="manual" klient widzi zdjęcie podglądu, dopóki skrypt strony nie odsłoni modelu, np. po kliknięciu przycisku „Zobacz w 3D”. Żeby plik modelu w ogóle nie był pobierany przed kliknięciem, adres src można też ustawić dopiero w tym momencie. Opis w atrybucie alt czytają czytniki ekranu, więc warto opisać w nim produkt, a nie wpisywać samego „model 3D”.
Warianty produktu a model
Jeśli produkt ma warianty kolorystyczne, zapisz je w jednym pliku GLB jako warianty materiałów (rozszerzenie glTF KHR_materials_variants) i przełączaj je w model-viewer atrybutem variant-name, gdy klient wybierze wariant w sklepie. Osobne pliki dla każdego koloru oznaczają wielokrotne pobieranie tej samej geometrii.
Model 3D nie zastępuje zdjęć ani opisu. Zostaw w galerii zdjęcia produktu, a parametry, wymiary i opis w treści strony, bo z nich korzystają wyszukiwarki, porównywarki i klienci, którzy nie obracają modelu.
Gdy klient ma sam wybierać wymiary i opcje
Model 3D w galerii pokazuje gotowy produkt albo kilka jego wariantów. Jeśli klient ma ustawiać własny wymiar, kolor i dodatki, a cena ma się przeliczać na bieżąco, potrzebny jest konfigurator produktu połączony z koszykiem, z ceną liczoną po stronie serwera i specyfikacją zapisaną w zamówieniu. Takie rozwiązania opisujemy na stronie konfiguratora produktu w WooCommerce, a sprzedaż produktów na wymiar w sklepie we wpisie sprzedaż produktów na wymiar przez internet.
Pliki GLB i USDZ, przeglądarkę 3D w galerii produktu, przycisk AR i rendery wariantów przygotowujemy w ramach usługi wizualizacje 3D produktu. Jak odchudzić model przed wgraniem do sklepu, opisujemy we wpisie za duży plik GLB. Ten problem jest jednym z naszej listy 30 problemów z modelem 3D i AR na stronie.
Jak to rozwiązać krok po kroku
Jak dodać model 3D do sklepu WooCommerce - galeria produktu, AR i szybkość krok po kroku - https://codescriptum.pl/blog/jak-dodac-model-3d-do-sklepu-woocommerce/
- Przygotuj z jednego modelu źródłowego lekki plik GLB i plik USDZ, w metrach i z osią Y skierowaną w górę.
- Zdecyduj, gdzie trzymać pliki: w bibliotece mediów (po dodaniu typów glb i usdz do dozwolonych) albo na serwerze plików lub w CDN.
- Ustaw na serwerze typy MIME: model/gltf-binary dla GLB i model/vnd.usdz+zip dla USDZ.
- Dodaj w produkcie pola na adresy plików i osadź przeglądarkę 3D jako element galerii, obok zdjęć, wtyczką albo kodem w motywie.
- Ustaw zdjęcie produktu jako podgląd i ładowanie modelu dopiero po kliknięciu.
- Jeśli produkt ma warianty kolorystyczne, zapisz je jako warianty materiałów w jednym pliku i połącz z wyborem wariantu w sklepie.
- Przetestuj kartę produktu na iPhonie w Safari, na telefonie z Androidem i na komputerze oraz sprawdź wynik w PageSpeed Insights.
Jak sprawdzić, że zadziałało
Model wyświetla się w galerii produktu obok zdjęć, pojawia się po kliknięciu i nie spowalnia pierwszego wczytania strony. Przycisk AR otwiera produkt na iPhonie i na Androidzie, a wybór wariantu w sklepie zmienia kolor modelu.
Usługa CodeScriptum
Konfigurator 3D na stronę
od 3 500 zł netto
- Model 3D produktu z wymiarami, kolorami i dodatkami
- Cena na żywo z Twojego cennika i zapytanie z konfiguracją
- Pełny kod u Ciebie, bez abonamentu
Najczęściej zadawane pytania
Czy do modelu 3D w WooCommerce potrzebna jest płatna wtyczka?
Nie musi. Model można osadzić darmowym komponentem model-viewer z poziomu motywu albo własnej wtyczki. Gotowe wtyczki przyspieszają start, ale warto sprawdzić, czy ładują model dopiero po kliknięciu i czy obsługują USDZ.
Czy WordPress pozwala wgrać plik GLB?
Domyślnie nie, bo rozszerzeń glb, gltf i usdz nie ma na liście dozwolonych typów. Można je dodać filtrem w kodzie albo wtyczką, ewentualnie trzymać modele na osobnym serwerze plików.
Czy model 3D spowolni sklep?
Nie, jeśli w pierwszym widoku jest zdjęcie podglądu, a model i biblioteka 3D ładują się dopiero po kliknięciu. Sklep spowalnia model ładowany od razu, razem ze stroną.
Źródła
- WordPress: wp_get_mime_types(), domyślne typy plików (otwiera się w nowej karcie) developer.wordpress.org
- WordPress: filtr upload_mimes (otwiera się w nowej karcie) developer.wordpress.org
- model-viewer: dokumentacja komponentu (otwiera się w nowej karcie) modelviewer.dev
- KHR_materials_variants: warianty materiałów w jednym pliku glTF (otwiera się w nowej karcie) github.com
- WebKit: Viewing Augmented Reality Assets in Safari for iOS (otwiera się w nowej karcie) webkit.org
Podobne problemy
Konfiguratory 3D
Model 3D i AR na stronie: 30 problemów i jak je rozwiązać (2026)
Przy każdym z 30 problemów podajemy przyczynę i rozwiązanie; większość da się wychwycić przed publikacją, testując model na prawdziwych telefonach z iOS i Androidem.
Konfiguratory 3D
Model 3D nie działa w AR na iPhonie - plik USDZ, typ MIME i przycisk AR krok po kroku
Rozwiązanie Przygotuj plik USDZ, ustaw na serwerze typ model/vnd.usdz+zip, popraw link albo użyj model-viewer z atrybutem ios-src i testuj na prawdziwym iPhonie w Safari.
Konfiguratory 3D
Sprzedaż produktów na wymiar przez internet - jak to zorganizować, gdy każdy produkt jest inny
Rozwiązanie Podział produktów na sprzedawane od razu i wymagające pomiaru, konfigurator z ceną liczoną po stronie serwera i specyfikacją w zamówieniu, płatność całości lub…
Konfiguratory 3D
Ile kosztuje konfigurator 3D produktu? Od czego zależy cena i co obejmuje
Rozwiązanie Przygotuj listę produktów, opcji i cennik, poproś o wycenę z rozbiciem na składniki i porównuj łączny koszt w horyzoncie kilku lat. U nas konfigurator 3D zaczyna się…