Grawer na produktach Pro moduł dla PrestaShop

Konfigurator grawerowania na karcie produktu

• Przycisk z ceną od: na karcie produktu pojawia się przycisk personalizacji z najniższą ceną spośród włączonych rodzajów grawerowania, a gdy ceny się różnią, cena poprzedzona jest słowem „od”.
• Grawer gratis z przekreśloną kwotą: jeżeli którykolwiek rodzaj grawerowania ma cenę zero, obok przycisku wyświetlana jest etykieta informująca o bezpłatnej personalizacji, a kwota regularna pozostaje widoczna jako przekreślona.
• Okno konfiguratora: personalizacja odbywa się w oknie modalnym na tej samej stronie, bez przenoszenia klienta na osobny formularz i bez utraty wybranej wcześniej kombinacji produktu.
• Trzy rodzaje personalizacji: grawer poziomy, grawer pionowy oraz symbol lub ikona, każdy z własną ceną, własnym limitem znaków i własnym rozmiarem czcionki zapisanym w presecie.
• Dwie pozycje grawerowania: klient wybiera układ „od dołu” albo „na środku” wyznaczonego obszaru, co pozwala obsłużyć zarówno napis pod istniejącym nadrukiem, jak i napis centralny.
• Kolejność kroków wymuszona przez interfejs: pole tekstu, wybór czcionki i przycisk zatwierdzenia odsłaniają się dopiero po wskazaniu rodzaju grawerowania, a przycisk zatwierdzenia pozostaje nieaktywny, dopóki personalizacja nie jest kompletna.
• Licznik znaków: pole tekstowe pokazuje na bieżąco liczbę wpisanych znaków w stosunku do limitu obowiązującego dla wybranego rodzaju grawerowania.

Podgląd na zdjęciu produktu rysowany w przeglądarce

• Render na elemencie canvas: podgląd powstaje po stronie klienta, w rozdzielczości zdjęcia użytego jako mockup, i aktualizuje się po każdej zmianie tekstu, czcionki, pozycji, rodzaju grawerowania lub wybranej ikony.
• Tekst układany na powierzchni przedmiotu: moduł liczy układ liter osobno dla każdego znaku, uwzględniając krzywiznę powierzchni, dzięki czemu napis na kubku, butelce czy innym obłym przedmiocie nie wygląda jak płaska nakładka.
• Podgląd zgodny z tym, co trafia do zamówienia: ten sam mechanizm rysujący tworzy obraz zapisywany przy zamówieniu, więc klient i pracownia widzą ten sam efekt.
• Czcionki ładowane na żądanie: pliki czcionek pobierane są dopiero przy otwarciu konfiguratora, a nie przy każdym wejściu na kartę produktu, co nie obciąża wczytywania strony u klientów, którzy z personalizacji nie korzystają.
• Zasoby wczytywane warunkowo: arkusz stylów i skrypty modułu trafiają wyłącznie na karty produktów z włączonym grawerowaniem – na pozostałych stronach sklepu moduł nie dokłada żadnych plików.

Presety – obszar grawerowania i wygląd napisu

• Zdjęcie bazowe personalizacji: do presetu wgrywa się zdjęcie w formacie JPG, PNG lub WebP, na którym klient zobaczy swój grawer; może to być zdjęcie katalogowe produktu.
• Obszar zaznaczany myszą na zdjęciu: prostokąt grawerowania rysuje się bezpośrednio na podglądzie – przeciągnięciem po tle, chwytem za środek do przesunięcia i za narożnik do zmiany rozmiaru.
• Te same wartości dostępne z klawiatury: cztery pola liczbowe pozwalają wpisać położenie i rozmiar obszaru bez używania myszy, co udostępnia najważniejsze ustawienie modułu również obsłudze klawiaturowej.
• Obszar zapisany procentowo: położenie i wymiary przechowywane są jako procent szerokości i wysokości zdjęcia, więc zaznaczenie pozostaje poprawne niezależnie od rozdzielczości podglądu.
• Osobne rozmiary czcionki: preset przechowuje rozmiar dla grawerowania poziomego i osobny dla pionowego, ponieważ ten sam napis w obu układach wymaga innej skali.
• Kolor napisu ustalany przez sklep: barwę grawerowania definiuje właściciel sklepu w presecie, tak aby odpowiadała efektowi uzyskiwanemu na danym materiale; klient jej nie zmienia.
• Kolejność presetów metodą przeciągnij i upuść: lista presetów w panelu obsługuje ręczne ustalanie kolejności oraz włączanie i wyłączanie poszczególnych pozycji.

Galeria czcionek zarządzana w panelu

• Własne pliki czcionek: panel przyjmuje pliki w formatach WOFF2, WOFF, TTF i OTF, więc sklep może udostępnić dokładnie te kroje, które potrafi wykonać w pracowni.
• Dwanaście krojów po instalacji: moduł instaluje gotowy zestaw dwunastu czcionek, między innymi Caveat, Dancing Script, Pacifico, Roboto Slab, Libre Baskerville, Montserrat, Oswald, Courgette, Lobster, Alfa Slab One, Josefin Sans i Comfortaa.
• Podgląd kroju na przycisku wyboru: każdy przycisk czcionki w konfiguratorze wyświetla własną nazwę tym właśnie krojem, więc klient widzi wybór, zanim go zatwierdzi.
• Włączanie, wyłączanie i kolejność: każdą czcionkę można ukryć bez usuwania pliku, a kolejność na liście ustala się przeciąganiem.
• Katalog czcionek zabezpieczony: moduł zakłada w miejscu przechowywania czcionek reguły dostępu ograniczające sposób pobierania plików.

Ikony i symbole z kontrolą bezpieczeństwa plików

• Grafika wektorowa SVG: symbole wgrywa się jako pliki SVG, dzięki czemu skalują się bez utraty jakości niezależnie od rozdzielczości podglądu.
• Oczyszczanie wgranego pliku: przed zapisaniem w sklepie plik SVG jest przetwarzany i pozbawiany elementów wykonywalnych – skryptów, atrybutów zdarzeń, odwołań zewnętrznych, zakodowanych encjami adresów javascript oraz importów w stylach.
• Oznaczenie „nowość”: wybrane ikony można wyróżnić w galerii etykietą nowości, co pozwala kierować uwagę klienta na świeżo dodane wzory.
• Cztery symbole po instalacji: moduł instaluje zestaw startowy zawierający serce, gwiazdę, górę i łapę.
• Automatyczne ukrycie kroku: jeżeli w sklepie nie ma aktywnych ikon, rodzaj personalizacji „symbol” nie jest w ogóle pokazywany klientowi.

Ustawienia grawerowania dla pojedynczego produktu

• Osobna zakładka na karcie produktu: grawerowanie włącza się bezpośrednio w edycji produktu w panelu, bez przechodzenia do konfiguracji modułu.
• Preset wybierany z listy: produkt wskazuje jeden preset, więc ten sam obszar i te same rozmiary czcionek można wykorzystać w całej grupie podobnych produktów.
• Sześć pól cenowych: dla każdego produktu ustawia się cenę grawerowania poziomego, pionowego i symbolu oraz odpowiadające im ceny promocyjne.
• Cena promocyjna widoczna dla klienta: gdy cena promocyjna jest ustawiona, konfigurator pokazuje ją obok przekreślonej ceny regularnej przy danym rodzaju grawerowania.
• Włączenie bez usuwania ustawień: personalizację produktu można wyłączyć, zachowując preset i ceny na później.

Warianty – inne zdjęcie i inny kolor dla odmiany produktu

• Mockup przypisany do wartości atrybutu: dla poszczególnych odmian produktu można wgrać osobne zdjęcie bazowe, żeby klient widział grawer na wybranym przez siebie wariancie.
• Zdjęcie kombinacji z katalogu: moduł potrafi użyć zdjęcia kombinacji już istniejącego w sklepie, o ile zachowuje ono kadr, względem którego wyznaczono obszar grawerowania.
• Kolor napisu per wariant: obok zdjęcia można nadpisać kolor grawerowania, co odpowiada realnej różnicy efektu na różnych materiałach i kolorach.
• Nadpisanie na poziomie całego produktu: gdy każdy kolor jest w sklepie osobnym produktem, wystarczy jedno nadpisanie zdjęcia i koloru zamiast tworzenia osobnego presetu.

Kontrola treści wpisywanej przez klienta

• Lista dozwolonych znaków: konfiguracja modułu zawiera zbiór znaków akceptowanych w grawerze, dzięki czemu do pracowni nie trafi napis zawierający znak niemożliwy do wykonania.
• Limity długości osobno dla każdego rodzaju: domyślnie dziesięć znaków dla grawerowania poziomego, dwadzieścia dla pionowego i dziesięć dla symbolu; wartości można zmienić w ustawieniach.
• Walidacja po stronie serwera: limit znaków i lista dozwolonych znaków sprawdzane są ponownie przy zapisie, a nie wyłącznie w przeglądarce.
• Zapis chroniony tokenem: zapisanie i usunięcie personalizacji odbywa się przez punkt końcowy modułu wymagający poprawnego tokenu sesji.

Koszyk, zamówienie i komunikacja z klientem

• Standardowa personalizacja PrestaShop: zatwierdzony grawer zapisywany jest jako personalizacja produktu, więc przechodzi przez koszyk i proces składania zamówienia mechanizmami samego sklepu.
• Miniatura zastąpiona obrazem z grawerem: w koszyku, w podsumowaniu zamówienia i na kartach zamówień w panelu zdjęcie produktu zastępowane jest wygenerowanym podglądem personalizacji.
• Czytelny opis przy pozycji zamówienia: do pozycji dopisywany jest opis zawierający rodzaj grawerowania, treść, pozycję i nazwę czcionki, przygotowany tak, aby zmieścić się w limicie długości pola personalizacji PrestaShop.
• Szczegóły grawerowania w e-mailu: moduł uzupełnia wiadomość z potwierdzeniem zamówienia o informacje o zamówionej personalizacji.
• Doliczenie ceny personalizacji: koszt grawerowania jest uwzględniany w wartości pozycji zamówienia zgodnie z cennikiem ustawionym dla danego produktu.

Obsługa zamówień w panelu administracyjnym

• Panel grawerów na karcie zamówienia: osobna tabela zestawia podgląd, nazwę produktu, rodzaj grawerowania, treść, czcionkę, pozycję, ikonę i cenę – komplet danych potrzebnych do wykonania zlecenia.
• Kolumna „Grawer” na liście zamówień: lista zamówień w panelu zyskuje kolumnę oznaczającą zamówienia zawierające personalizację, umieszczoną obok kolumny płatności.
• Podgląd przy pozycji zamówienia: przy spersonalizowanej pozycji pojawia się odnośnik do obrazu podglądu grawerowania.
• Odnośnik ograniczony do plików modułu: adres podglądu budowany jest wyłącznie na podstawie nazw plików wygenerowanych przez ten moduł, zapisanych w bazie personalizacji.

Utrzymanie danych i porządek w sklepie

• Zadanie porządkujące uruchamiane cyklicznie: moduł udostępnia adres dla harmonogramu CRON, który usuwa obrazy podglądów pochodzące z porzuconych koszyków oraz osierocone dane personalizacji.
• Token wygenerowany dla sklepu: punkt końcowy porządkujący wymaga tokenu ustalanego przy instalacji i porównywanego metodą odporną na analizę czasu odpowiedzi, więc sama znajomość adresu nie wystarczy do uruchomienia zadania.
• Konfigurowalny wiek usuwanych danych: minimalny wiek plików przeznaczonych do usunięcia przekazuje się parametrem wywołania, co pozwala dopasować sprzątanie do długości typowej ścieżki zakupowej.
• Data ostatniego uruchomienia: moduł zapisuje moment ostatniego wykonania zadania porządkującego.
• Sprzątanie po usunięciu produktu: skasowanie produktu w sklepie usuwa powiązaną z nim konfigurację grawerowania i dane wariantów.
• Ograniczenia dla obrazów: moduł przyjmuje pliki graficzne do dwóch megabajtów i krawędzi do 2400 pikseli, a zapisywane podglądy uzupełnia miniaturą o krawędzi 600 pikseli.

Wdrożenie, wielosklepowość i aktualizacje

• Dane rozdzielone na sklepy: presety, czcionki, ikony, ustawienia produktów i warianty przechowywane są z przypisaniem do sklepu, co pozwala prowadzić różne oferty personalizacji w środowisku multistore.
• Zestaw startowy po instalacji: instalacja zakłada strukturę katalogów na pliki, kopiuje czcionki i ikony oraz ustawia wartości domyślne limitów i listy dozwolonych znaków.
• Własna sekcja w menu panelu: moduł dodaje sekcję z trzema ekranami zarządzania – presetami, czcionkami i ikonami.
• Ścieżka aktualizacji: pakiet zawiera trzynaście skryptów aktualizacyjnych prowadzących instalację od pierwszych wydań do wersji bieżącej, bez ręcznych zmian w bazie danych.
• Czyste odinstalowanie: deinstalacja usuwa tabele modułu, jego ustawienia oraz katalog z plikami czcionek, ikon i zdjęć bazowych.
• Brak zależności zewnętrznych: moduł nie wymaga Composera, zewnętrznych bibliotek PHP ani usług sieciowych – działa wyłącznie na kodzie dostarczonym w pakiecie i na API PrestaShop.

Korzyści dla sklepu internetowego

• Wyższa wartość koszyka: personalizacja jest płatnym dodatkiem do produktu, którego cenę sklep ustala osobno dla każdego rodzaju grawerowania i każdego produktu.
• Mniej pytań przed zakupem: klient widzi swój napis na zdjęciu produktu przed dodaniem do koszyka, więc rzadziej pyta obsługę, jak będzie wyglądał efekt.
• Mniej pomyłek w pracowni: zamówienie trafia do panelu z podglądem i pełnym opisem – rodzajem, treścią, czcionką i pozycją – zamiast z notatką w komentarzu do zamówienia.
• Personalizacja jako argument marketingowy: darmowy grawer można wyeksponować na karcie produktu etykietą i przekreśloną ceną regularną.
• Konfiguracja raz, użycie wielokrotne: jeden preset obsługuje całą grupę produktów o zbliżonym kształcie i kadrze zdjęcia.
• Kontrola nad tym, co da się wykonać: lista dozwolonych znaków i limity długości ograniczają zamówienia do napisów możliwych do zrealizowania.
• Brak rosnącego bałaganu w plikach: zadanie porządkujące usuwa podglądy z koszyków, które nigdy nie stały się zamówieniami.

Kompatybilność

PD Grawer na produktach Pro jest przygotowany dla PrestaShop od wersji 1.7.8.2 przez 8.x do 9.x oraz dla PHP 7.0–8.5, a dane przechowuje w MySQL 5.6+ lub MariaDB 10.x+. Moduł nie wymaga Composera ani zewnętrznych bibliotek, a podgląd grawerowania powstaje w przeglądarce klienta bez odwołań do usług zewnętrznych. Interfejs klienta i panelu jest przetłumaczony na język polski, a moduł obsługuje środowisko wielosklepowe, przypisując presety, czcionki, ikony i ustawienia produktów do konkretnego sklepu.

Link do demo modułu:

Demo panel administracyjny:
https://moduly-prestashop.eu/grawer-na-produktach/admin-dev

Demo panel przedni:
https://moduly-prestashop.eu/grawer-na-produktach

Przykładowy produkt demonstracyjny na froncie:
https://moduly-prestashop.eu/grawer-na-produktach/home-accessories/19-customizable-mug.html