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 ż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.

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.

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.