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.
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.
- 01Ukrywanie wybranych cech w sklepie
Reguły widoczności zarządzane w Katalog › Widoczność cech, z listą, filtrami i akcjami masowymi.
- 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.
- 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.
- 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.
- 05Ukryte cechy zostają w bazie i w panelu
Moduł niczego nie usuwa. Filtruje wyłącznie dane przekazywane do szablonów sklepu.
- 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.
- 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
78,3 ms
75,7 ms
52,2 ms
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”


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


04 / rozwiązanie
Najbardziej szczegółowa reguła wygrywa
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ć.


06 / wdrożenie
Od pustego serwera do przetestowanego modułu
Ś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.
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.
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.
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.
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
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.