Przejdź do treści
Darmowy audyt

Konfiguratory 3D Problem i rozwiązanie

Jak dodać model 3D do sklepu WooCommerce - galeria produktu, AR i szybkość krok po kroku

Autor: Bartosz Gromek Zaktualizowano: 5 min czytania

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/

  1. Przygotuj z jednego modelu źródłowego lekki plik GLB i plik USDZ, w metrach i z osią Y skierowaną w górę.
  2. 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.
  3. Ustaw na serwerze typy MIME: model/gltf-binary dla GLB i model/vnd.usdz+zip dla USDZ.
  4. Dodaj w produkcie pola na adresy plików i osadź przeglądarkę 3D jako element galerii, obok zdjęć, wtyczką albo kodem w motywie.
  5. Ustaw zdjęcie produktu jako podgląd i ładowanie modelu dopiero po kliknięciu.
  6. Jeśli produkt ma warianty kolorystyczne, zapisz je jako warianty materiałów w jednym pliku i połącz z wyborem wariantu w sklepie.
  7. 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

  1. WordPress: wp_get_mime_types(), domyślne typy plików (otwiera się w nowej karcie) developer.wordpress.org
  2. WordPress: filtr upload_mimes (otwiera się w nowej karcie) developer.wordpress.org
  3. model-viewer: dokumentacja komponentu (otwiera się w nowej karcie) modelviewer.dev
  4. KHR_materials_variants: warianty materiałów w jednym pliku glTF (otwiera się w nowej karcie) github.com
  5. WebKit: Viewing Augmented Reality Assets in Safari for iOS (otwiera się w nowej karcie) webkit.org

Podobne problemy

O autorze

Bartosz Gromek

Założyciel CodeScriptum, technologia i rozwój

Założyciel CodeScriptum - firmy technologicznej z Łodzi, działającej od 2022 roku. Odpowiada za technologię i rozwój, a projekty realizuje razem z zespołem specjalistów od stron, sklepów internetowych, systemów CRM, integracji, AI i marketingu. Na blogu opisuje problemy, z którymi zgłaszają się klienci CodeScriptum, i sprawdzone sposoby ich rozwiązania.

Newsletter

Konkretne porady raz na jakiś czas

Nowe problemy i rozwiązania z bloga, zmiany w przepisach dla sklepów i stron oraz sprawdzone sposoby na więcej klientów z internetu. Bez spamu, wypis jednym kliknięciem.