case study · moduł PrestaShop

Cechy produktu, które klient widzi tylko wtedy, gdy powinien

Moduł do PrestaShop 8 i 9, który ukrywa wybrane cechy lub ich wartości na stronie sklepu. Dane zostają nietknięte w bazie i w panelu.

Platforma
PrestaShop 8.2 · 9.2
Zakres
Środowisko, moduł, testy
Moduł
hidefeatures 1.0.0
Integracja
1 hook frontu, 0 nadpisań rdzenia

01 / założenia

Brief: cechy jako dane wewnętrzne i publiczne jednocześnie

Sklepy często trzymają w cechach informacje dla siebie: kod magazynowy, dostawcę hurtowego, kraj pochodzenia przed negocjacjami. PrestaShop nie pozwala ich ukryć. Każda cecha przypisana do produktu trafia na kartę produktu. Usunięcie cechy niszczy dane, z których korzystają import, eksport, filtry i integracje.

  1. 01Ukrywanie wybranych cech w sklepie

    Reguły widoczności zarządzane w Katalog › Widoczność cech, z listą, filtrami i akcjami masowymi.

  2. 02Ukrywanie pojedynczych cech lub ich wartości

    Reguła obejmuje całą cechę albo jedną wartość, np. tylko „Stal” w cesze Materiał. Wartości własne produktu ukrywa się w edycji produktu.

  3. 03Zarządzanie z panelu administracyjnego

    Osobna zakładka w menu Katalog oraz przełączniki Dziedzicz / Ukryj / Pokaż w edycji każdego produktu, zapisywane od razu.

  4. 04Globalnie, dla kategorii i produktów

    Trzy zakresy, kategorie z podkategoriami lub bez. Reguła „Pokaż” działa jako wyjątek od reguły ogólniejszej.

  5. 05Ukryte cechy zostają w bazie i w panelu

    Moduł niczego nie usuwa. Filtruje wyłącznie dane przekazywane do szablonów sklepu.

  6. 06Brak wpływu na pozostałe funkcje

    Bez nadpisań klas rdzenia. Filtry wyszukiwania, import, eksport i API pracują na pełnych danych. Reguły czyszczą się same po usunięciu produktu, kategorii lub cechy.

  7. 07Kompatybilność z PrestaShop 8 i 9

    Ten sam kod sprawdzony na 8.2.9 (Classic) i 9.2.1 (Hummingbird), uruchomionych obok siebie.

02 / wskaźniki

Liczby z działających sklepów testowych

2
wersje PrestaShop 8.2.9 i 9.2.1, dwa różne motywy, jeden kod modułu
0
nadpisań rdzenia integracja przez jeden hook frontu, bez override
~3,5ms
narzut na karcie produktu przy 6 aktywnych regułach, mediana z 3 × 40 żądań
42/42
testy panelu 21 automatycznych sprawdzeń na każdą wersję sklepu
12
rodzajów reguł 3 zakresy × cecha lub wartość × ukryj lub pokaż
1
zapytanie o reguły na żądanie, potem pamięć podręczna procesu
75
tekstów przetłumaczonych źródła po angielsku, pełne tłumaczenie PL w XLF
~1 200
linii kodu PHP, Smarty, JS i CSS, bez zależności zewnętrznych
moduł wyłączonymoduł włączony, 6 regułczas generowania strony przez PHP, bez sieci i TLS
PS 9 · karta produktu75,0
78,3 ms
PS 9 · kategoria71,6
75,7 ms
PS 8 · karta produktu48,3
52,2 ms
PS 8 · kategoria60,9
58,9 ms

Skala: pełna szerokość = 100 ms. Wynik na listingu PS 8 mieści się w szumie pomiaru (wariant z modułem wyszedł szybszy).

03 / efekt w sklepie

Ta sama koszulka, te same dane, inna karta produktu

Produkt demo z dodanymi cechami wewnętrznymi. Dwie reguły globalne ukrywają kod magazynowy i dostawcę hurtowego. Gwarancja i kraj produkcji zostają, bo żadna reguła ich nie obejmuje w tej kategorii.

PrestaShop 9.2.1 motyw Hummingbird, akordeon „Dane techniczne”

Karta produktu w PrestaShop 9 przed: sześć cech, w tym kod magazynowy i dostawca hurtowy
Przed6 cech, w tym kod magazynowy i dostawca hurtowy.
Karta produktu w PrestaShop 9 po: cztery cechy, bez danych wewnętrznych
Po4 cechy. Dane wewnętrzne nie trafiają do HTML strony.

PrestaShop 8.2.9 motyw Classic, zakładka „Szczegóły produktu”

Karta produktu w PrestaShop 8 przed: lista cech z kodem magazynowym
PrzedTen sam zestaw cech w starszym motywie.
Karta produktu w PrestaShop 8 po: lista cech bez danych wewnętrznych
PoIdentyczny wynik bez zmian w szablonie motywu.

04 / rozwiązanie

Najbardziej szczegółowa reguła wygrywa

Kolejność rozstrzygania reguł Reguła produktu wygrywa z regułą kategorii, a ta z regułą globalną. W obrębie zakresu reguła dla wartości wygrywa z regułą dla całej cechy. ogólna szczegółowa Produkt wartość cechy · priorytet 7 cała cecha · priorytet 6 np. Pokaż Kod magazynowy na Laptop Pro 16 Kategoria wartość cechy · priorytet 5 cała cecha · priorytet 4 np. Ukryj Materiał: Stal w Meble + podkat. Globalna wartość cechy · priorytet 3 cała cecha · priorytet 2 np. Ukryj Kod magazynowy w całym sklepie

Jedna reguła na decyzję

Dla każdej pary cecha i wartość moduł wybiera najwyżej ocenioną pasującą regułę. Przy remisie, np. dwie kategorie produktu z przeciwnymi akcjami, wygrywa ukrycie. Panel pokazuje przy każdej cesze, która reguła o niej zdecydowała.

Filtr w miejscu, przez które przechodzi każdy produkt

Hook actionGetProductPropertiesAfter obejmuje kartę produktu, listingi, szybki podgląd i moduły z produktami. W PS 8 lista cech już tam jest. W PS 9 cechy ładują się leniwie, więc moduł wstawia gotową, przefiltrowaną listę, z której ProductLazyArray buduje też grouped_features.

Panel i dane bez zmian

Filtr działa tylko w kontekście frontu. Edycja produktu, import, eksport, API i ps_facetedsearch widzą pełne dane, więc ukrycie cechy nie psuje filtrowania ani integracji.

05 / panel administracyjny

Reguły w jednym miejscu, wyjątki tam, gdzie się edytuje produkt

Kliknij zrzut, aby go powiększyć.

admin / katalog / widoczność cech
Lista reguł widoczności cech w panelu: cecha, wartość, zakres, cel, akcja i status
Katalog › Widoczność cech. Lista z filtrowaniem, sortowaniem i akcjami masowymi. Kolumna „Dotyczy” pokazuje produkt lub kategorię i to, czy reguła obejmuje podkategorie.
Formularz reguły: cecha, wartość, zakres, drzewo kategorii, akcja
Formularz reguły. Lista wartości zmienia się po wyborze cechy, a pola celu po wyborze zakresu. Walidacja odrzuca duplikaty i wartości spoza wybranej cechy.
Zakładka modułu w edycji produktu: każda cecha ze statusem w sklepie i przełącznikiem reguły
Edycja produktu › Moduły. Wszystkie cechy produktu ze statusem w sklepie i powodem, np. „reguła #3: kategoria Elektronika”. Przełącznik zapisuje się od razu przez AJAX.

06 / wdrożenie

Od pustego serwera do przetestowanego modułu

  1. Środowisko

    Dwa sklepy w Dockerze na VPS: PrestaShop 9.2.1 na PHP 8.4 i PrestaShop 8.2.9 na PHP 8.1, wspólna baza MariaDB 11.4 w sieci wewnętrznej. HTTPS i subdomeny przez Caddy. Kod modułu podmontowany do obu sklepów naraz, więc każda zmiana od razu działa w obu wersjach.

  2. Dane testowe

    Skrypt tworzący 5 kategorii z podkategoriami, 8 cech w dwóch językach i 12 produktów z cechami jedno- i wielowartościowymi oraz wartościami własnymi. Te same ID w obu sklepach, żeby wyniki dało się porównać jeden do jednego.

  3. Analiza rdzenia

    Przed pisaniem kodu: przegląd, jak PS 8 i PS 9 budują listę cech. Kluczowa różnica to leniwe ładowanie cech w PS 9. Wspólnym punktem okazał się hook wywoływany dla każdego prezentowanego produktu.

  4. Testy

    Scenariusze frontu sprawdzane na HTML stron w obu sklepach: reguła globalna, kategoria z podkategoriami, wyjątek na produkcie, ukrycie jednej wartości. W panelu 21 automatycznych sprawdzeń na wersję: render listy, formularza i zakładki, walidacja, zapis, sprzątanie po usunięciu cechy. Do tego czysta reinstalacja modułu i pomiar wydajności.

  5. Poprawki po odbiorze

    Przycisk „Rozwiń wszystkie” w drzewie kategorii gubił gałęzie. Przyczyną był błąd w skrypcie drzewa w rdzeniu PrestaShop, który dotyczy każdego drzewa z jednym wyborem. Formularz modułu dostaje teraz od razu całe drzewo, więc rozwijanie działa bez zapytania do serwera.

technologie

  • PHP 8.1–8.4
  • PrestaShop 8 / 9
  • ObjectModel
  • ModuleAdminController
  • HelperForm · HelperList
  • Smarty
  • Vanilla JS
  • XLIFF
  • MariaDB 11.4
  • Docker Compose
  • Caddy
  • Playwright

Zrzuty sklepu pochodzą z działających instalacji testowych. Widoki panelu to prawdziwy kod modułu wyrenderowany z oryginalnymi arkuszami stylów panelu PrestaShop 9, bez ramki nawigacji panelu. Czasy zmierzono wewnątrz kontenera aplikacji, bez sieci i TLS.

następny krok

Masz podobne wyzwanie?

Opisz, co chcesz osiągnąć. Wrócę z konkretną propozycją, wyceną i planem wdrożenia.