Instrukcja instalacji [WooCommerce]

Zanim zaczniesz

Upewnij się, że Twój sklep spełnia minimalne wymagania:

  • WordPress: 6.4+
  • WooCommerce: 6.0+ (zainstalowany i aktywny)
  • PHP: 8.0+
  • Wymagany jest serwer z włączonym HTTPS / SSL ze względów bezpieczeństwa
  • Wymagane jest konto Alter Product — użyjesz Access Key oraz Access Token

Ważne: plugin uruchamia customizer, configurator albo viewer w izolowanym iframe, więc nie modyfikuje podstawowego działania checkoutu WooCommerce.

Kroki instalacji i konfiguracji

  1. Zaloguj się do panelu administracyjnego WordPress.
  2. W panelu WordPress przejdź do Wtyczki → Dodaj nową, wyszukaj w wyszukiwarce wtyczek Alter Product – 3D Configurator for WooCommerce, zainstaluj ją i aktywuj wtyczkę.* Opcjonalnie: wgraj paczkę ZIP ręcznie i aktywuj ją.
  3. W panelu WordPress otwórz Alter Product i kliknij Connect w sekcji Auto Connect.* Opcjonalna konfiguracja ręczna: utwórz klucze na stronie ustawień API Alter Product, skopiuj Access Key oraz Access Token, a następnie dodaj domenę sklepu w ustawieniach osadzania.
  4. Postępuj zgodnie z wyświetlanymi krokami instalacji, aby dokończyć konfigurację.
  5. Stwórz pierwszy design - przejdź do edycji produktu w WooCommerce. W zakładce Alter Product stwórz nowy design (lub wskaż istniejący). Design zostanie zmapowany z produktem. Zdefiniuj warianty zgodne z produktem WooCommerce, opcjonalnie aktywuj Customizer i zapisz projekt.

Po konfiguracji

Po skonfigurowaniu możesz:

  • zarządzać assetami, w tym Products, Variants, Mockups, Graphic Library, Logos, Design Templates, Backgrounds, Environments i Fonts
  • importować projekty z Alter Product storage
  • tworzyć i zarządzać designami produktów
  • wyświetlać przycisk wybranego narzędzia e-commerce na publicznych stronach sklepu WooCommerce lub stronach produktu
  • osadzać Viewer, Configurator lub Customizer na stronach produktów WooCommerce albo zwykłych stronach WordPress
  • mapować produkty WooCommerce do designów Alter Product
  • pozwolić klientom personalizować produkty: teksty, obrazy, układy, kody QR itd.
  • synchronizować wybraną konfigurację z koszykiem WooCommerce

Rozwiązywanie problemów

  • Test API kończy się błędem: sprawdź Access Key, Access Token oraz połączenie serwera z https://alterproduct.com/public-api w Alter Product → Status.
  • Problemy z pobieraniem assetów: przejdź do Alter Product → Status i sprawdź, czy serwer spełnia wymagania z tabeli Server resources.
  • Iframe jest pusty albo brak komunikacji: upewnij się, że domena sklepu została dodana w Alter Product w E-commerce Settings → Integration lub sprawdź, czy serwer na pewno używa HTTPS z poprawnym certyfikatem SSL.
  • Problem z permalinkami: jeśli strony Customizera, Configuratora lub Viewera pokazują Not found, przejdź do Ustawienia → Bezpośrednie odnośniki i kliknij Zapisz zmiany, aby odświeżyć reguły rewrite.
  • Dodanie do koszyka nie działa: upewnij się, że mapowanie produktu jest kompletne, a osadzone narzędzie ma włączone akcje e-commerce.