---
title: "Instalacja modułu"
description: "STYRTA Product Configurator instaluje się jak standardowy moduł PrestaShop — przez wgranie otrzymanej paczki ZIP w panelu administracyjnym sklepu."
url: "https://docs.styrta.com/pl/product-configurator/getting-started/installation"
language: "pl"
section: "Pierwsze kroki"
---

# Instalacja modułu

STYRTA Product Configurator instaluje się jak standardowy moduł PrestaShop — przez wgranie otrzymanej paczki ZIP w panelu administracyjnym sklepu.

> W przypadku już funkcjonujących sklepów zalecamy wykonywanie instalacji oraz aktualizacji modułu w środowisku deweloperskim (localhost/dev/staging). Każda licencja obejmuje 1 aktywację w środowisku produkcyjnym oraz 3 aktywacje w środowisku deweloperskim.

## Przygotowanie

Przed instalacją:

1. sprawdź [wymagania techniczne](https://docs.styrta.com/pl/product-configurator/getting-started/requirements),
2. wykonaj kopię zapasową sklepu,
3. przygotuj oficjalną paczkę ZIP modułu.

## Instalacja krok po kroku

1. Zaloguj się do panelu administracyjnego Twojego sklepu PrestaShop.
2. Otwórz zakładkę Zainstalowane moduły.
3. Wybierz opcję Załaduj moduł i wgraj paczkę ZIP.
4. Po instalacji wybierz **Konfiguruj**.

Po poprawnej instalacji zobaczysz panel licencji.

## Co zmienia instalacja?

STYRTA Product Configurator integruje się z istniejącym katalogiem i procesem zakupowym PrestaShop. Instalacja modułu nie zmienia automatycznie sposobu działania istniejących produktów — po instalacji konfigurator jest domyślnie wyświetlany tylko dla wybranego asortymentu.

Moduł:

- dodaje własną stronę konfiguracji i aktywacji licencji w Back Office,
- rozszerza formularze grup atrybutów, atrybutów i produktów o ustawienia potrzebne do obsługi produktów konfigurowalnych,
- dodaje narzędzia do tworzenia i edycji kombinacji używanych przez konfigurator,
- integruje konfigurację produktu ze stroną produktu, koszykiem, checkoutem i zamówieniami,
- w zależności od posiadanego planu udostępnia dodatkowe funkcje związane m.in. z obsługą koszyka, zamówień i zarządzaniem konfiguracjami,
- instaluje wymagane rozszerzenia klas PrestaShop (override), opisane poniżej.

Szczegółowy opis narzędzi dostępnych podczas konfiguracji produktu znajdziesz w sekcji [Konfiguracja produktu](https://docs.styrta.com/pl/product-configurator/product-configuration/overview).

## Pliki override PrestaShop

Konfigurator integruje się z PrestaShop przede wszystkim za pomocą standardowych mechanizmów rozszerzeń — hooków, rozszerzeń formularzy Symfony oraz API udostępnianych przez PrestaShop.

Pliki `override` są wykorzystywane tylko w kilku miejscach, w których standardowe punkty rozszerzeń PrestaShop nie pozwalają na poprawną obsługę produktów konfigurowalnych. Ich zakres został ograniczony do minimum. Żadna klasa nie jest przepisywana w całości (kod woła `parent::`), a logika STYRTA jest uruchamiana wyłącznie dla produktów w trybie konfiguratora.

Podczas instalacji moduł dodaje override czterech klas PrestaShop:

- `Product` — pozwala na poprawne przełączanie produktu pomiędzy standardowymi wariantami PrestaShop a Konfiguratorem STYRTA.
- `Cart` — zapewnia poprawną obsługę skonfigurowanych produktów w koszyku, w tym wielu różnych konfiguracji tego samego produktu.
- `Link` — usuwa numer kombinacji (`id_product_attribute`) z adresów URL dla produktów korzystających z konfiguratora,
- `CartRule` — zapewnia prawidłową współpracę reguł koszyka z produktami z konfiguratorem.

Jeżeli sklep posiada własne modyfikacje tych samych klas lub korzysta z innego modułu, który również je rozszerza, przed instalacją warto sprawdzić zgodność na środowisku testowym.

## Domyślne ustawienia

Po instalacji:

- produkty pozostają domyślnie przy standardowych wariantach PrestaShop,
- konfigurator nie jest automatycznie włączany dla istniejącego katalogu - wymagane jest ręczne włączanie konfiguratora na wybranych produktach lub włączenie trybu konfiguratora dla całego katalogu w ustawieniach modułu,
- tryb debugowania modułu jest wyłączony.

Dzięki temu instalacja modułu nie powinna sama zmienić sposobu sprzedaży istniejących produktów.

## Aktywacja modułu po instalacji

Bez aktywnego klucza konfigurator nie jest dostępny dla klientów.

Po instalacji przejdź do panelu **Licencja** i aktywuj otrzymany klucz.

→ [Aktywacja licencji](https://docs.styrta.com/pl/product-configurator/getting-started/license-activation)

## Kontrola poprawności instalacji

Jeżeli moduł wykryje problem z instalacją, w Back Office pojawi się odpowiednie ostrzeżenie.

→ [Problemy instalacji](https://docs.styrta.com/pl/product-configurator/troubleshooting/install-health)

## Najczęstsze problemy podczas instalacji

- brak lub niezgodna wersja ionCube Loader,
- nieobsługiwana wersja PHP lub PrestaShop,
- ograniczenia hostingu uniemożliwiające instalację modułu,
- konflikt z innym rozszerzeniem modyfikującym te same elementy PrestaShop,
- uszkodzona albo niekompletna paczka ZIP.

W pierwszej kolejności sprawdź komunikat wyświetlany przez moduł i porównaj środowisko z [wymaganiami technicznymi](https://docs.styrta.com/pl/product-configurator/getting-started/requirements).

## Następny krok

[Aktywacja licencji](https://docs.styrta.com/pl/product-configurator/getting-started/license-activation)