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+
• 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.

Bezpośrednie odnośniki muszą być włączone

Bezpośrednie odnośniki muszą być włączone w WordPressie. Przejdź do:

Panel WordPress → Ustawienia → Bezpośrednie odnośniki

Upewnij się, że opcja nie jest ustawiona na Proste — wszystkie pozostałe ustawienia są poprawne.

Kroki instalacji i konfiguracji

1. Zaloguj się do panelu administracyjnego WordPress.
2. Przejdź do Wtyczki → Dodaj nową i zainstaluj Alter Product – 3D Configurator for WooCommerce albo wgraj paczkę ZIP do /wp-content/plugins/.
3. Kliknij Aktywuj plugin.
4. Przejdź w Alter Product do strony ustawień API i utwórz klucze API.
5. W WordPressie otwórz Alter Product → Settings → API, wklej Access Key oraz Access Token, a następnie kliknij Save.
6. Przejdź w Alter Product do ustawień osadzania i dodaj domenę swojego sklepu, np. https://twojsklep.pl.
7. W WordPressie otwórz Alter Product → Settings → Embedding i ustaw strony osadzania.
8. Przejdź do edycji produktu w WooCommerce i użyj sekcji Alter Product, aby zmapować produkt WooCommerce z zasobami Alter Product oraz ustawić styl.
9. W edytorze stron WordPress dodaj bloki lub embed Alter Product do szablonów produktu, zależnie od używanego motywu.

Po konfiguracji

Po skonfigurowaniu możesz:

• osadzać Viewer, Configurator lub Customizer na stronach produktów WooCommerce albo zwykłych stronach WordPress
• mapować produkty WooCommerce do modeli 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.
• Iframe jest pusty albo brak komunikacji: upewnij się, że domena sklepu została dodana w Alter Product w E-commerce Settings → Integration.
• Problem z permalinkami: sprawdź, czy WordPress Ustawienia → Bezpośrednie odnośniki nie są ustawione na Proste. Czasem wystarczy ponownie zapisać ustawienia.
• Dodanie do koszyka nie działa: upewnij się, że mapowanie produktu jest kompletne, a osadzone narzędzie ma włączone akcje e-commerce.