{"id":90185,"date":"2026-10-28T17:25:00","date_gmt":"2026-10-28T16:25:00","guid":{"rendered":"https:\/\/codescriptum.pl\/blog\/jak-dodac-model-3d-do-sklepu-woocommerce\/"},"modified":"2026-10-28T17:25:00","modified_gmt":"2026-10-28T16:25:00","slug":"jak-dodac-model-3d-do-sklepu-woocommerce","status":"publish","type":"post","link":"https:\/\/codescriptum.pl\/blog\/jak-dodac-model-3d-do-sklepu-woocommerce\/","title":{"rendered":"Jak doda\u0107 model 3D do sklepu WooCommerce - galeria produktu, AR i szybko\u015b\u0107 krok po kroku"},"content":{"rendered":"<p>Model 3D w WooCommerce dodaje si\u0119 przez wtyczk\u0119 albo kod w motywie, kt\u00f3ry osadza przegl\u0105dark\u0119 3D, np. komponent model-viewer, w galerii produktu obok zdj\u0119\u0107. Podstawowa wersja WooCommerce obs\u0142uguje w galerii tylko obrazy, a WordPress domy\u015blnie nie pozwala wgra\u0107 plik\u00f3w GLB i USDZ do biblioteki medi\u00f3w, wi\u0119c trzeba to przewidzie\u0107. Najwa\u017cniejsze jest, \u017ceby model by\u0142 lekki, \u0142adowa\u0142 si\u0119 dopiero po klikni\u0119ciu i dzia\u0142a\u0142 w AR na iPhonie i Androidzie.<\/p>\n<h2>Jak to wygl\u0105da<\/h2>\n<ul>\n<li>przy pr\u00f3bie wgrania pliku .glb WordPress pokazuje b\u0142\u0105d, \u017ce ten typ pliku jest niedozwolony,<\/li>\n<li>model wy\u015bwietla si\u0119 pod opisem produktu zamiast w galerii, obok zdj\u0119\u0107,<\/li>\n<li>karta produktu \u0142aduje si\u0119 wolniej, a wynik PageSpeed spad\u0142,<\/li>\n<li>przycisk AR dzia\u0142a na Androidzie, ale nie na iPhonie,<\/li>\n<li>po wyborze innego koloru w wariantach produktu model zostaje w poprzednim kolorze.<\/li>\n<\/ul>\n<h2>Dlaczego to nie dzia\u0142a od razu?<\/h2>\n<h3>WooCommerce nie ma pola na model 3D<\/h3>\n<p>Galeria produktu w WooCommerce przechowuje obrazy. Model trzeba wi\u0119c zapisa\u0107 w osobnym polu produktu (np. adresy plik\u00f3w GLB i USDZ) i doda\u0107 do galerii jako dodatkowy element, z poziomu wtyczki albo motywu. Rozwi\u0105zania, kt\u00f3re wstawiaj\u0105 model w tre\u015b\u0107 opisu, dzia\u0142aj\u0105, ale model l\u0105duje daleko od zdj\u0119\u0107, gdzie klient go nie szuka.<\/p>\n<h3>WordPress blokuje pliki GLB i USDZ<\/h3>\n<p>Lista domy\u015blnie dozwolonych typ\u00f3w plik\u00f3w w WordPressie nie obejmuje rozszerze\u0144 glb, gltf ani usdz. Dodaje si\u0119 je filtrem w kodzie (dokumentacja WordPressa wskazuje do tego filtry mime_types i upload_mimes) albo przez wtyczk\u0119. Alternatyw\u0105 jest trzymanie modeli na osobnym serwerze plik\u00f3w lub w CDN i zapisanie w produkcie tylko ich adres\u00f3w.<\/p>\n<h3>Serwer wysy\u0142a pliki z niew\u0142a\u015bciwym typem<\/h3>\n<p>Nawet wgrany plik USDZ nie otworzy si\u0119 w AR na iPhonie, je\u015bli serwer wysy\u0142a go bez typu model\/vnd.usdz+zip. To cz\u0119sta przyczyna sytuacji, w kt\u00f3rej AR dzia\u0142a na Androidzie, a na iPhonie nie. Szczeg\u00f3\u0142y opisujemy we wpisie <a href=\"\/blog\/model-3d-nie-dziala-w-ar-na-iphonie\/\">model 3D nie dzia\u0142a w AR na iPhonie<\/a>.<\/p>\n<h3>Model \u0142aduje si\u0119 razem ze stron\u0105<\/h3>\n<p>Karta produktu to strona, na kt\u00f3rej liczy si\u0119 szybko\u015b\u0107. Je\u015bli biblioteka 3D i plik modelu \u0142aduj\u0105 si\u0119 od razu, klient czeka na kilka megabajt\u00f3w danych, zanim zobaczy zdj\u0119cia i cen\u0119.<\/p>\n<h2>Jak doda\u0107 model 3D do karty produktu krok po kroku<\/h2>\n<table>\n<thead>\n<tr>\n<th>Etap<\/th>\n<th>Co zrobi\u0107<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Pliki<\/td>\n<td>Lekki GLB (strona i Android) i USDZ (iPhone) z jednego modelu \u017ar\u00f3d\u0142owego<\/td>\n<\/tr>\n<tr>\n<td>Przechowywanie<\/td>\n<td>Zezwolenie na wgrywanie GLB i USDZ albo serwer plik\u00f3w z adresami zapisanymi w produkcie<\/td>\n<\/tr>\n<tr>\n<td>Typy MIME<\/td>\n<td>model\/gltf-binary dla GLB i model\/vnd.usdz+zip dla USDZ<\/td>\n<\/tr>\n<tr>\n<td>Osadzenie<\/td>\n<td>Przegl\u0105darka 3D jako element galerii produktu, obok zdj\u0119\u0107<\/td>\n<\/tr>\n<tr>\n<td>Szybko\u015b\u0107<\/td>\n<td>Zdj\u0119cie produktu jako podgl\u0105d, model \u0142adowany po klikni\u0119ciu<\/td>\n<\/tr>\n<tr>\n<td>AR<\/td>\n<td>Przycisk AR widoczny na telefonach, kt\u00f3re go obs\u0142uguj\u0105<\/td>\n<\/tr>\n<tr>\n<td>Warianty<\/td>\n<td>Wyb\u00f3r wariantu w sklepie prze\u0142\u0105cza wariant materia\u0142u w modelu<\/td>\n<\/tr>\n<tr>\n<td>Test<\/td>\n<td>iPhone w Safari, telefon z Androidem, komputer, PageSpeed Insights<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Wygodnym sposobem wy\u015bwietlania modelu jest komponent model-viewer, kt\u00f3ry obs\u0142uguje podgl\u0105d 3D, AR na obu systemach i ods\u0142anianie modelu na \u017c\u0105danie. Przyk\u0142ad osadzenia z podgl\u0105dem i AR:<\/p>\n<pre><code>&lt;model-viewer src=\"pergola.glb\" ios-src=\"pergola.usdz\"\n  poster=\"pergola.webp\" reveal=\"manual\" ar camera-controls\n  alt=\"Pergola aluminiowa z dachem lamelowym, model 3D\"&gt;&lt;\/model-viewer&gt;<\/code><\/pre>\n<p>Przy reveal=\"manual\" klient widzi zdj\u0119cie podgl\u0105du, dop\u00f3ki skrypt strony nie ods\u0142oni modelu, np. po klikni\u0119ciu przycisku \u201eZobacz w 3D\u201d. \u017beby plik modelu w og\u00f3le nie by\u0142 pobierany przed klikni\u0119ciem, adres src mo\u017cna te\u017c ustawi\u0107 dopiero w tym momencie. Opis w atrybucie alt czytaj\u0105 czytniki ekranu, wi\u0119c warto opisa\u0107 w nim produkt, a nie wpisywa\u0107 samego \u201emodel 3D\u201d.<\/p>\n<h3>Warianty produktu a model<\/h3>\n<p>Je\u015bli produkt ma warianty kolorystyczne, zapisz je w jednym pliku GLB jako warianty materia\u0142\u00f3w (rozszerzenie glTF KHR_materials_variants) i prze\u0142\u0105czaj je w model-viewer atrybutem variant-name, gdy klient wybierze wariant w sklepie. Osobne pliki dla ka\u017cdego koloru oznaczaj\u0105 wielokrotne pobieranie tej samej geometrii.<\/p>\n<div class=\"csb-note csb-note--tip\">\n<p>Model 3D nie zast\u0119puje zdj\u0119\u0107 ani opisu. Zostaw w galerii zdj\u0119cia produktu, a parametry, wymiary i opis w tre\u015bci strony, bo z nich korzystaj\u0105 wyszukiwarki, por\u00f3wnywarki i klienci, kt\u00f3rzy nie obracaj\u0105 modelu.<\/p>\n<\/div>\n<h2>Gdy klient ma sam wybiera\u0107 wymiary i opcje<\/h2>\n<p>Model 3D w galerii pokazuje gotowy produkt albo kilka jego wariant\u00f3w. Je\u015bli klient ma ustawia\u0107 w\u0142asny wymiar, kolor i dodatki, a cena ma si\u0119 przelicza\u0107 na bie\u017c\u0105co, potrzebny jest konfigurator produktu po\u0142\u0105czony z koszykiem, z cen\u0105 liczon\u0105 po stronie serwera i specyfikacj\u0105 zapisan\u0105 w zam\u00f3wieniu. Takie rozwi\u0105zania opisujemy na stronie <a href=\"https:\/\/codescriptum.pl\/konfigurator-produktu-woocommerce\/\">konfiguratora produktu w WooCommerce<\/a>, a sprzeda\u017c produkt\u00f3w na wymiar w sklepie we wpisie <a href=\"\/blog\/sprzedaz-produktow-na-wymiar-przez-internet\/\">sprzeda\u017c produkt\u00f3w na wymiar przez internet<\/a>.<\/p>\n<p>Pliki GLB i USDZ, przegl\u0105dark\u0119 3D w galerii produktu, przycisk AR i rendery wariant\u00f3w przygotowujemy w ramach us\u0142ugi <a href=\"https:\/\/codescriptum.pl\/wizualizacje-3d-produktu\/\">wizualizacje 3D produktu<\/a>. Jak odchudzi\u0107 model przed wgraniem do sklepu, opisujemy we wpisie <a href=\"\/blog\/plik-glb-za-duzy-strona-sie-zacina\/\">za du\u017cy plik GLB<\/a>. Ten problem jest jednym z naszej listy <a href=\"\/blog\/30-problemow-z-modelem-3d-i-ar-na-stronie\/\">30 problem\u00f3w z modelem 3D i AR na stronie<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Model 3D w WooCommerce dodaje si\u0119 przez wtyczk\u0119 albo kod w motywie, kt\u00f3ry osadza przegl\u0105dark\u0119 3D, np. komponent model-viewer, w galerii produktu obok zdj\u0119\u0107. Podstawowa wersja WooCommerce obs\u0142uguje w galerii\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[102],"tags":[],"class_list":["post-90185","post","type-post","status-publish","format-standard","hentry","category-konfiguratory-3d"],"_links":{"self":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts\/90185","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/comments?post=90185"}],"version-history":[{"count":0,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts\/90185\/revisions"}],"wp:attachment":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/media?parent=90185"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/categories?post=90185"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/tags?post=90185"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}