# Personalizacja produktu (grawer, tekst, obraz): kompletny przewodnik > Wprowadzenie Moduł Personalizacja produktu pozwala Twoim klientom spersonalizować artykuł bezpośrednio z karty produktu: wpisać tekst lub grawer (z czcionką i kolorem) albo przesłać obraz. Personalizacja wyświetla się w podglądzie na… - Strona: - Język: pl - Zaktualizowano: 2026-07-31 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfcustomizer/index.md), [en](https://www.datafirefly.com/en/documentation/dfcustomizer/index.md), [es](https://www.datafirefly.com/es/documentation/dfcustomizer/index.md), [de](https://www.datafirefly.com/de/documentation/dfcustomizer/index.md), [it](https://www.datafirefly.com/it/documentation/dfcustomizer/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcustomizer/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcustomizer/index.md) - Indeks: ## Wprowadzenie Moduł **Personalizacja produktu** pozwala Twoim klientom spersonalizować artykuł bezpośrednio z karty produktu: wpisać **tekst lub grawer** (z czcionką i kolorem) albo **przesłać obraz**. Personalizacja wyświetla się w **podglądzie na żywo na zdjęciu produktu**, z umieszczaniem metodą przeciągnij i upuść oraz regulacją rozmiaru i obrotu, a każda opcja może dodawać **dopłatę do ceny** (kwota stała albo procent), naliczaną automatycznie w koszyku. Moduł jest zgodny z **PrestaShop 8.x i 9.x**. Tworzy własne tabele i nie nadpisuje istniejących kart produktów: personalizacją sterują opcje, które tworzysz, przypisane do kategorii i doprecyzowane produkt po produkcie. ## Instalacja 1. Spakuj katalog `dfcustomizer` (albo użyj bezpośrednio dostarczonego archiwum `dfcustomizer.zip`). 2. W panelu administracyjnym otwórz **Moduły > Menedżer modułów**. 3. Kliknij **Zainstaluj moduł** i wgraj archiwum ZIP. 4. Po zakończeniu instalacji kliknij **Konfiguruj**, aby utworzyć swoje opcje. Przy instalacji moduł tworzy potrzebne tabele (`dfc_option` wraz z tabelami powiązanymi, `dfc_product_override`, `dfc_customization`) i rejestruje hooki wyświetlania na karcie produktu, w koszyku i w zamówieniu. ## Konfiguracja: tworzenie opcji Przejdź do **Moduły > dfcustomizer > Konfiguruj**, aby tworzyć opcje personalizacji i nimi zarządzać. Każda opcja definiuje rodzaj personalizacji, jej wpływ na cenę oraz zakres stosowania. ### Rodzaj personalizacji - **Tekst / grawer**: klient wpisuje tekst. Możesz udostępnić wybór **czcionki** i **koloru** (oba opcjonalne). - **Przesyłanie obrazu**: klient wysyła plik w formacie **JPG, PNG albo WEBP**. ### Wpływ na cenę Każda opcja może doliczać dopłatę do ceny produktu: - **kwotę stałą netto**, albo - **procent** ceny produktu. Dopłata wyświetla się na żywo po stronie klienta i jest przenoszona do koszyka (zobacz sekcję Koszyk i ceny). ### Przypisywanie do kategorii Zaznacz **kategorie**, do których opcja ma się stosować: opcja pojawi się tylko na produktach z tych kategorii. Jeśli **nie zaznaczysz żadnej kategorii**, opcja obejmuje **cały katalog**. ### Nadpisanie per produkt W **karcie produktu** (zakładka **Moduły**) każdy produkt ma własne ustawienie nadpisania. Może ono: - **dziedziczyć** opcje wynikające z kategorii (zachowanie domyślne); - **wybrać własne opcje** specjalnie dla tego produktu; - **całkowicie wyłączyć** personalizację dla tego produktu. ## Po stronie klienta (front) Na karcie produktu klient wpisuje swój tekst (czcionka, kolor) albo przesyła obraz. Personalizacja od razu wyświetla się w **podglądzie na żywo na zdjęciu produktu**: - **umieszczanie** metodą przeciągnij i upuść na zdjęciu; - **suwaki rozmiaru i obrotu** do dopracowania efektu. Dopłata wynikająca z wybranych opcji wyświetla się na bieżąco. Przy dodaniu do koszyka zapisywana jest personalizacja oraz **spłaszczony podgląd w formacie PNG**, dostępny później przy zamówieniu. ## Koszyk i ceny Dopłata jest doliczana do ceny artykułu w koszyku przez regułę cenową powiązaną z koszykiem (`SpecificPrice` przypisany do `id_cart`). Ta dopłata jest **przeliczana przy każdym zapisie koszyka** i **usuwana automatycznie**, gdy produkt zostanie wycofany z koszyka. **Uwaga:** możliwa jest jedna personalizacja na parę _produkt / wariant_ i na koszyk. ## Po stronie zamówienia ### Panel administracyjny Na stronie zamówienia sekcja **„Personalizacje produktu”** podsumowuje każdą personalizację: wpisany tekst, **plik klienta do pobrania** oraz wygenerowany podgląd. Masz w ten sposób wszystko, czego potrzebuje produkcja (grawer, nadruk i tak dalej). ### Front Klient znajduje przypomnienie swoich personalizacji w **szczegółach zamówienia**. ## Uwagi techniczne - **Tworzone tabele:** `dfc_option` (oraz `dfc_option_lang` i `dfc_option_category`), `dfc_product_override`, `dfc_customization`. - **Dopłata do ceny:** stosowana przez `SpecificPrice` powiązany z koszykiem (`id_cart`), przeliczana przy każdym zapisie koszyka i usuwana po wycofaniu produktu. - **Pliki klientów:** przechowywane w `modules/dfcustomizer/uploads/`, w katalogu, w którym wykonywanie kodu PHP jest zablokowane plikiem `.htaccess` ze względów bezpieczeństwa. **Ograniczenie:** jedna personalizacja na parę produkt/wariant i na koszyk. ## Rozwiązywanie problemów ### Opcja personalizacji nie pojawia się na karcie produktu Sprawdź, czy opcja jest aktywna i czy jej **kategorie** obejmują kategorię produktu (albo czy żadna kategoria nie jest zaznaczona, co oznacza cały katalog). Następnie zweryfikuj **nadpisanie per produkt** (zakładka Moduły w karcie): personalizacja nie może być wyłączona dla tego produktu. Na koniec wyczyść pamięć podręczną PrestaShop. ### Dopłata nie pojawia się w koszyku Dopłata jest przeliczana przy zapisie koszyka. Sprawdź, czy opcja rzeczywiście ma zdefiniowany wpływ na cenę (kwota stała albo procent) i przeładuj koszyk. Jeśli produkt został wycofany, a potem dodany ponownie, personalizację trzeba wykonać od nowa. ### Przesyłanie obrazu jest odrzucane Akceptowane są wyłącznie formaty **JPG, PNG i WEBP**. Sprawdź format pliku oraz maksymalny rozmiar przesyłanych plików dopuszczony przez Twój hosting (`upload_max_filesize` i `post_max_size` w PHP). ## Deinstalacja Deinstalacja usuwa hooki i konfigurację modułu. Wykonaj wcześniej kopię plików klientów z katalogu `modules/dfcustomizer/uploads/` oraz danych personalizacji z zamówień, jeśli chcesz je zachować. ## FAQ ### Czy moduł jest zgodny z PrestaShop 9? Tak, moduł jest zgodny z PrestaShop 8.x i 9.x. ### Czy mogę pobierać opłatę za personalizację? Tak. Każda opcja może naliczać dopłatę w postaci kwoty stałej netto albo procentu ceny produktu, dodawaną automatycznie w koszyku. ### Czy można ograniczyć opcję do wybranych produktów? Tak, na dwa sposoby: przez **przypisanie opcji do kategorii** oraz przez **nadpisanie per produkt**, które pozwala każdej karcie dziedziczyć, wybrać własne opcje albo wyłączyć personalizację. ### Czy klient może dodać kilka personalizacji do jednego artykułu? Zapisywana jest jedna personalizacja na parę produkt/wariant i na koszyk.