PS PrestaShop Średnio zaawansowany

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.

Zaktualizowano Wersja modułu 2.0.0

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.

DataFirefly Soczewki okularowe: blok soczewek korekcyjnych na karcie produktu oprawki
Blok soczewek korekcyjnych na karcie produktu oprawki

Instalacja i aktualizacja

  1. W Moduły > Menedżer modułów kliknij Załaduj moduł i prześlij plik dfopticlens-2.0.0.zip.
  2. Instalacja tworzy menu Sprzedaż > Optyka: Pulpit, Recepty, Oprawki, Soczewki i indeksy, Powłoki. Wspólny pasek nawigacji łączy te strony i ustawienia.
  3. 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.
  4. 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.
DataFirefly Soczewki okularowe: pulpit z zamówionymi parami, przychodem z soczewek, kolejką weryfikacji i wykresem 12 tygodni
Pulpit z zamówionymi parami, przychodem z soczewek, kolejką weryfikacji i wykresem 12 tygodni

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.

DataFirefly Soczewki okularowe: ustawienia: zgoda na dane o zdrowiu, przechowywanie i szyfrowanie plików
Ustawienia: zgoda na dane o zdrowiu, przechowywanie i szyfrowanie plików

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.

DataFirefly Soczewki okularowe: soczewki i indeksy z cenami dla każdego rodzaju i kolejnością przez przeciąganie
Soczewki i indeksy z cenami dla każdego rodzaju i kolejnością przez przeciąganie

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

  1. W Oprawki kliknij Dodaj oprawkę albo na stronie produktu, w zakładce Moduły, kliknij Dodaj wymiary oprawki.
  2. Wyszukaj produkt po nazwie, indeksie lub ID, a następnie wybierz Wszystkie kombinacje lub konkretną kombinację. Oprawka zdefiniowana dla kombinacji ma pierwszeństwo.
  3. 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.
  4. Opcjonalnie: średnica efektywna ED (w przeciwnym razie szacowana) i maksymalna moc akceptowana przez oprawkę.
  5. 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.

DataFirefly Soczewki okularowe: formularz oprawki z szerokością soczewki, mostkiem, wysokością, średnicą efektywną i typem
Formularz oprawki z szerokością soczewki, mostkiem, wysokością, średnicą efektywną i typem

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.
DataFirefly Soczewki okularowe: oprawki z wymiarami, rodzajami soczewek i importem CSV
Oprawki z wymiarami, rodzajami soczewek i importem CSV

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

  1. 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.
  2. 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.
  3. Soczewka: karty z ceną za parę, przekrojem soczewki w skali, szacowaną grubością i polecaną soczewką. Niewykonalne soczewki są wyszarzone z podaniem powodu.
  4. Powłoki: powłoki niedostępne dla wybranej soczewki są wyszarzone, barwienia wykluczają się wzajemnie.
  5. 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.

DataFirefly Soczewki okularowe: konfigurator soczewek krok 1: jednoogniskowe lub progresywne, z podsumowaniem na żywo
Konfigurator soczewek krok 1: jednoogniskowe lub progresywne, z podsumowaniem na żywo
DataFirefly Soczewki okularowe: wpisywanie recepty z pomocą w odczytaniu i przesłaniem pliku
Wpisywanie recepty z pomocą w odczytaniu i przesłaniem pliku
DataFirefly Soczewki okularowe: wybór indeksu z oszacowaniem grubości w skali i rekomendacją
Wybór indeksu z oszacowaniem grubości w skali i rekomendacją
DataFirefly Soczewki okularowe: powłoki: antyrefleks, filtr światła niebieskiego, fotochrom, barwienia
Powłoki: antyrefleks, filtr światła niebieskiego, fotochrom, barwienia
DataFirefly Soczewki okularowe: podsumowanie z wykonalnością, szczegółami ceny i zgodą
Podsumowanie z wykonalnością, szczegółami ceny i zgodą
DataFirefly Soczewki okularowe: konfigurator soczewek na telefonie
Konfigurator soczewek na telefonie

Zasady wykonalności

KontrolaSkutek
Sfera lub cylinder poza zakresem soczewkiSoczewka niedostępna
Potrzebna średnica półfabrykatu (ED + 2 × decentracja + naddatek) większa niż półfabrykat soczewkiSoczewka 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 progresywnejBlokada (lub ostrzeżenie)
Wysokość B poniżej progu krótkiego kanałuInformacja
Moc większa niż maksimum oprawkiBlokada (lub ostrzeżenie)
Różnica między oczami, duża decentracja, wysoka moc dodatnia w oprawce żyłkowej, stara recepta, nieznany rozstaw źrenicOstrzeż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).
DataFirefly Soczewki okularowe: koszyk z podsumowaniem soczewek pod oprawką
Koszyk z podsumowaniem soczewek pod oprawką

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.

DataFirefly Soczewki okularowe: karta recepty z weryfikacją przez optyka i podglądem zaszyfrowanego pliku
Karta recepty z weryfikacją przez optyka i podglądem zaszyfrowanego pliku
DataFirefly Soczewki okularowe: lista recept z zamówieniem, soczewką, plikiem, kontrolą optyka i wykonalnością
Lista recept z zamówieniem, soczewką, plikiem, kontrolą optyka i wykonalnością
DataFirefly Soczewki okularowe: e-mail z prośbą o czytelniejszą receptę
E-mail z prośbą o czytelniejszą receptę

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ą.
DataFirefly Soczewki okularowe: karta recepty na stronie zamówienia w panelu
Karta recepty na stronie zamówienia w panelu
DataFirefly Soczewki okularowe: karta warsztatowa do druku z receptą, centrowaniem i wymiarami oprawki
Karta warsztatowa do druku z receptą, centrowaniem i wymiarami oprawki

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.

DataFirefly Soczewki okularowe: strona Moje recepty ze statusem weryfikacji i przesyłaniem pliku
Strona Moje recepty ze statusem weryfikacji i przesyłaniem pliku

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.

Czy ta strona była pomocna?

Nadal utknąłeś? Napisz do wsparcia