Moduł Optyka PrestaShop: instalacja i konfiguracja
Instalacja modułu, ustawienia soczewek, powłok i oprawek, zasady wykonalności, weryfikacja recept i obsługa zamówień okularów korekcyjnych.
Wprowadzenie
Moduł dfopticlens pozwala sprzedawać okulary korekcyjne w PrestaShop 8 i 9. Na stronie oprawki klient wybiera przeznaczenie, wpisuje receptę, porównuje soczewki z ich szacowaną grubością, dodaje powłoki i zatwierdza podsumowanie. Serwer sprawdza każdą wartość, oblicza cenę i weryfikuje, czy korekcję da się wykonać w oprawce. Cena soczewek jest doliczana do pozycji oprawki dzięki natywnej personalizacji PrestaShop, a recepta towarzyszy zamówieniu aż do faktury.
Wersja 2.0.0 dodaje weryfikację przez optyka, pulpit, szyfrowanie plików recept, wyraźną zgodę klienta, całkowicie przeprojektowany konfigurator i podsumowanie soczewek w koszyku.

Instalacja i aktualizacja
- W Moduły > Menedżer modułów kliknij Załaduj moduł i prześlij plik
dfopticlens-2.0.0.zip. - Instalacja tworzy menu Sprzedaż > Optyka: Pulpit, Recepty, Oprawki, Soczewki i indeksy, Powłoki. Wspólny pasek nawigacji łączy te strony i ustawienia.
- Tworzonych jest pięć soczewek (1.50, 1.59 poliwęglan, 1.60, 1.67, 1.74) i siedem powłok z przykładowymi cenami i opisami w 8 językach. Dostosuj je przed uruchomieniem sprzedaży.
- Tworzony i zabezpieczany jest folder
upload/dfopticlens/. Każdy plik recepty jest w nim zapisywany w postaci zaszyfrowanej, pod losową nazwą.
Aktualizacja z wersji 1.x: prześlij ZIP 2.0.0 na zainstalowany moduł. Skrypt aktualizacji dodaje nowe kolumny i nowe ustawienia, szyfruje na miejscu już otrzymane pliki i umieszcza zamówienia z ostatnich 14 dni w kolejce weryfikacji. Żadna recepta, oprawka, soczewka ani powłoka nie jest usuwana.
Wyłączenie modułu usuwa ukryte pole personalizacji z oprawek: można je nadal normalnie kupić. Pole jest tworzone ponownie po włączeniu modułu.
Pulpit
Sprzedaż > Optyka > Pulpit podsumowuje ostatnie 30 dni w porównaniu z 30 dniami wcześniej:
- zamówione pary, przychód z soczewek netto (soczewki, powłoki i dopłaty) i średnio na parę;
- wskaźnik „Od konfiguratora do zamówienia”: zamówione recepty podzielone przez recepty dodane do koszyka;
- recepty do sprawdzenia (w tym te z uwagami o wykonalności) i recepty oczekujące na klienta;
- kolejka weryfikacji, wykres zamówionych par z 12 tygodni i podział według typu soczewek;
- najczęściej zamawiane soczewki, wybrane powłoki i lista konfiguracji: aktywne soczewki i powłoki, oprawki, chroniony folder, szyfrowanie, zgoda, automatyczne usuwanie.

Konfiguracja modułu
Strona konfiguracji grupuje ustawienia w pięciu zakładkach.
Wprowadzanie recepty
- Zapis cylindra wysyłany do laboratorium: cylinder ujemny, dodatni lub zachowany tak, jak wpisano. Klient zawsze wpisuje wartości ze swojej recepty, transpozycja odbywa się przy zapisie.
- Przesyłanie pliku recepty: wyłączone, opcjonalne lub wymagane, z maksymalnym rozmiarem w MB.
- Ostrzegaj, gdy recepta jest starsza niż X lat (0 wyłącza).
- Przesyłanie pliku z konta po złożeniu zamówienia: dodaje stronę Moje recepty do konta klienta.
- Opcja „Nie znam swojego rozstawu źrenic” i używany średni rozstaw źrenic (domyślnie 63 mm). Zamówienie jest wtedy oznaczane.
Zasady wykonalności
- Blokuj soczewki, których nie można wykonać: domyślnie włączone. Po wyłączeniu zamówienie jest przyjmowane z ostrzeżeniem.
- Naddatek na szlifowanie i naddatek średnicy efektywnej, gdy ED oprawki jest nieznane (szacowane ED = A + naddatek).
- Minimalna wysokość dla soczewek progresywnych (28 mm) i krótki kanał poniżej (32 mm).
- Progi ostrzeżeń: różnica między oczami, decentracja na oko, moc dodatnia w oprawce żyłkowej.
- Docelowa grubość polecanej soczewki, grubość środka soczewek ujemnych i krawędzi soczewek dodatnich (w oprawkach bezramkowych lub nie).
Ceny
- Ceny wpisywane z podatkiem lub bez. Do soczewek stosowana jest reguła podatkowa produktu oprawki.
- Dopłaty za wysoką moc i wysoki cylinder: próg w dioptriach i kwota (0 wyłącza).
Prywatność i dane
- Proś o wyraźną zgodę przed zapisaniem recepty (domyślnie włączone). Recepta to dane o zdrowiu w rozumieniu art. 9 RODO. Data zgody jest zapisywana i wyświetlana w zamówieniu.
- Strona prywatności podlinkowana w treści zgody (strona CMS).
- Usuwaj recepty z porzuconych koszyków po X dniach.
- Usuwaj pliki recept X dni po zamówieniu (0 je zachowuje). Wpisane wartości pozostają przy zamówieniu.
- Zachowaj dane przy odinstalowaniu: oprawki, soczewki, powłoki, recepty i pliki są zachowywane.
Wyświetlanie
- Kolor akcentu konfiguratora (przyciski, zaznaczenie, pasek postępu).
- Podsumowanie soczewek pod każdą oprawką w koszyku.
Wartości spoza zakresu są odrzucane z komunikatem podającym dopuszczalny zakres.

Soczewki i indeksy
W Soczewki i indeksy każda soczewka ma:
- nazwę i krótki opis widoczne dla klienta, w każdym języku;
- współczynnik załamania, używany do szacowania grubości, oraz materiał na potrzeby zlecenia warsztatowego;
- typy soczewek, dla których jest oferowana, i cenę za parę dla każdego z nich: jednoogniskowe, progresywne, bez korekcji;
- minimalną i maksymalną sferę oraz maksymalny cylinder (w zapisie z cylindrem ujemnym, jak zakresy producentów);
- największą dostępną średnicę półfabrykatu (0 wyłącza tę kontrolę) i możliwość wiercenia dla oprawek bezramkowych.
Kolejność wyświetlania zmienia się, przeciągając wiersze na liście.

Powłoki
Każda powłoka ma nazwę, krótki opis i cenę za parę. Cena 0 sprawia, że powłoka jest wyświetlana jako wliczona w cenę i zawsze zaznaczona. Grupa wykluczająca uniemożliwia łączenie dwóch powłok: te z tym samym kodem, na przykład tint dla fotochromowej, barwienia przeciwsłonecznego i polaryzacji, wykluczają się wzajemnie. Możesz też ograniczyć powłokę do wybranych soczewek, na przykład polaryzację do indeksów 1.50 i 1.60. Kolejność zmienia się, przeciągając wiersze.
Oprawki
Oprawka łączy produkt, lub jedną z jego kombinacji, z jego wymiarami. Blok soczewek pojawia się tylko na produktach z włączoną oprawką.
Tworzenie oprawki
- W Oprawki kliknij Dodaj oprawkę albo na stronie produktu, w zakładce Moduły, kliknij Dodaj wymiary oprawki.
- Wyszukaj produkt po nazwie, indeksie lub ID, a następnie wybierz Wszystkie kombinacje lub konkretną kombinację. Oprawka zdefiniowana dla kombinacji ma pierwszeństwo.
- Podaj typ (pełna, żyłkowa, bezramkowa), szerokość soczewki A, mostek DBL i wysokość soczewki B. To liczby nadrukowane na zauszniku: 52□18 oznacza A = 52 i DBL = 18.
- Opcjonalnie: średnica efektywna ED (w przeciwnym razie szacowana) i maksymalna moc akceptowana przez oprawkę.
- Zaznacz oferowane typy soczewek i w razie potrzeby Sprzedawaj tylko z soczewkami.
Przy opcji „Sprzedawaj tylko z soczewkami” natywny przycisk koszyka otwiera wybór soczewek. Jeśli bezpośrednie wywołanie koszyka mimo to doda samą oprawkę, moduł usunie ją z koszyka.

Import i eksport CSV
Przycisk Eksportuj CSV daje plik we właściwym formacie. Import akceptuje średnik lub przecinek oraz kolumny:
product;combination;frame_type;lens_width;lens_height;bridge;ed;max_power;vision_types;lens_required;active
product: ID lub indeks produktu;combination: ID lub indeks kombinacji, puste lub 0 dla wszystkich.frame_type: full, semi lub rimless;vision_types: single|progressive|plano.- Istniejąca oprawka (ten sam produkt i ta sama kombinacja) jest aktualizowana. Odrzucone wiersze są wymieniane z ich numerem.

Ścieżka klienta
Na stronie oprawki blok „Dodaj swoje soczewki korekcyjne” pokazuje cenę początkową soczewek, typ i rozmiar oprawki. Otwiera on panel w pięciu krokach, z kolumną „Twój wybór” aktualizowaną na bieżąco i sumą za oprawkę i soczewki w stopce.
- Użycie: jednoogniskowe, progresywne lub bez korekcji, zależnie od tego, co oferuje oprawka, z ceną „od” dla każdego typu. Przy soczewkach bez korekcji krok recepty jest pomijany.
- Recepta: tabela OP / OL, rozstaw źrenic jako jedna lub dwie wartości, data, plik metodą przeciągnij i upuść oraz uwaga dla optyka. Przycisk Jak odczytać receptę pokazuje przykładową receptę z opisami. Zalogowany klient może ponownie użyć recepty z poprzedniego zamówienia.
- Soczewka: karty z ceną za parę, przekrojem soczewki w skali, szacowaną grubością i polecaną soczewką. Niewykonalne soczewki są wyszarzone z podaniem powodu.
- Powłoki: powłoki niedostępne dla wybranej soczewki są wyszarzone, barwienia wykluczają się wzajemnie.
- Podsumowanie: status wykonalności, uwagi, recepta, szczegóły ceny, suma i zgoda.
Błędy pojawiają się pod danym polem i znikają, gdy tylko zostaną poprawione. Wpisane dane są zachowywane, gdy klient odświeży stronę, i usuwane po dodaniu do koszyka. Panel można obsługiwać klawiaturą i dostosowuje się do urządzeń mobilnych.






Zasady wykonalności
| Kontrola | Skutek |
|---|---|
| Sfera lub cylinder poza zakresem soczewki | Soczewka niedostępna |
| Potrzebna średnica półfabrykatu (ED + 2 × decentracja + naddatek) większa niż półfabrykat soczewki | Soczewka niedostępna, jeśli blokowanie jest włączone |
| Oprawka bezramkowa i materiał, którego nie można wiercić | Soczewka niedostępna, jeśli blokowanie jest włączone |
| Wysokość B poniżej minimum dla soczewki progresywnej | Blokada (lub ostrzeżenie) |
| Wysokość B poniżej progu krótkiego kanału | Informacja |
| Moc większa niż maksimum oprawki | Blokada (lub ostrzeżenie) |
| Różnica między oczami, duża decentracja, wysoka moc dodatnia w oprawce żyłkowej, stara recepta, nieznany rozstaw źrenic | Ostrzeżenie |
Obliczenia wykonywane są na zapisie z cylindrem ujemnym. Grubość jest szacowana wzorem na strzałkę: to punkt odniesienia do porównania indeksów, a nie obliczenia laboratorium.
Koszyk, e-maile i faktura
Cena soczewek jest zapisywana netto w personalizacji pozycji koszyka. PrestaShop dolicza ją do ceny oprawki i stosuje VAT produktu. Jeśli oprawka ma rabat procentowy, PrestaShop stosuje go także do soczewek: panel pokazuje to z przekreśloną ceną, aby podana suma zgadzała się z koszykiem.
- Koszyk: pod każdą oprawką podsumowanie podaje typ soczewek, soczewkę, wartości OP / OL, rozstaw źrenic, powłoki, cenę soczewek i otrzymanie pliku.
- E-maile zamówienia i faktura PDF: recepta pojawia się pod produktem, jeden wiersz na informację (soczewka, OP, OL, rozstaw źrenic, powłoki).

Weryfikacja przez optyka
Każda zamówiona recepta trafia do kolejki weryfikacji ze statusem Do sprawdzenia. Zarówno na karcie recepty, jak i na stronie zamówienia blok Weryfikacja przez optyka pozwala:
- zmienić status na Sprawdzona lub Oczekuje na klienta;
- napisać notatkę wewnętrzną, nigdy niewidoczną dla klienta;
- wyświetlić podgląd pliku recepty, odszyfrowanego w locie, lub go pobrać;
- poprosić klienta o informacje: e-mail w języku zamówienia wysyłany jest z Twoją wiadomością i linkiem do strony Moje recepty. Status zmienia się na „Oczekuje na klienta”.
Gdy klient ponownie prześle plik, status wraca do „Do sprawdzenia”. Wyświetlany jest autor i data ostatniej zmiany. Listę Recepty można filtrować według statusu weryfikacji i wykonalności, a lista wskazuje recepty z dołączonym plikiem.



Zamówienia i zlecenie warsztatowe
- Strona zamówienia w panelu administracyjnym pokazuje blok dla każdej recepty: transponowane wartości, soczewkę, powłoki, wymiary oprawki, decentrację i minimalny półfabrykat dla każdego oka, uwagi o wykonalności, szczegóły ceny, zgodę i weryfikację.
- Drukuj zlecenie warsztatowe otwiera stronę A4 gotową do druku, z polami na kontrolę, szlifowanie i kontrolę końcową.


Konto klienta: Moje recepty
Klient, który zamówił soczewki, widzi na swoim koncie link Moje recepty, z licznikiem, gdy optyk czeka na informację. Strona pokazuje każdą receptę z oprawką, zamówieniem i statusem weryfikacji: otrzymana, sprawdzona lub poproszono o informacje. Klient może tam przesłać swój plik albo go zastąpić, gdy optyk o to poprosi.

Dane o zdrowiu i RODO
- Wyraźna zgoda przed zapisaniem, z zachowaną datą.
- Obrazy są ponownie kodowane (usunięte metadane EXIF i GPS), pliki PDF są sprawdzane, a każdy plik jest szyfrowany AES-256-GCM w chronionym folderze. Podgląd i pobieranie są możliwe tylko w panelu administracyjnym.
- Recepty z koszyków, z których nigdy nie złożono zamówienia, są usuwane po ustawionym czasie. Pliki mogą być automatycznie usuwane po zamówieniu.
- Klient usunięty w panelu administracyjnym traci swoje recepty z koszyków; recepty z jego zamówień tracą plik i powiązanie z klientem.
- Z oficjalnym modułem psgdpr eksport i usuwanie danych klienta obejmują jego recepty.
Rozwiązywanie problemów
Blok soczewek nie pojawia się na stronie produktu
Sprawdź, czy moduł jest włączony, czy produkt ma włączoną oprawkę i czy motyw wyświetla hook displayProductAdditionalInfo. Wyczyść pamięć podręczną PrestaShop.
Natywny przycisk koszyka nie otwiera panelu na oprawce „tylko z soczewkami”
Moduł przechwytuje przyciski z atrybutem data-button-action="add-to-cart". Jeśli Twój motyw używa innego atrybutu, blokada po stronie serwera nadal działa: sama oprawka jest usuwana z koszyka.
E-mail z prośbą o informacje nie dociera
Sprawdź konfigurację e-maili PrestaShop (Zaawansowane > E-mail). W razie niepowodzenia status zostaje zapisany, a komunikat informuje o tym na karcie.
Suma w panelu różni się od koszyka
Rabat kwotowy dotyczy tylko oprawki, a reguła koszyka dotyczy całego koszyka: nie są one widoczne w panelu soczewek.