Pozycje Produktów — Kompletny przewodnik
Instalacja i obsługa Pozycji produktów 2.0: siatka merchandisingu, przeciąganie i upuszczanie wielu produktów, sortowanie automatyczne, przypięcia, historia, import CSV, reguły automatyczne z podkategoriami zawsze na początku lub na końcu, zadanie cykliczne i pulpit.
Wprowadzenie
Pozycje produktów zarządza kolejnością produktów w kategoriach PrestaShop, czyli natywną kolumną category_product.position, której sklep używa przy sortowaniu „Trafność” / „Pozycja w kategorii”. Kategorię układasz jak tablicę merchandisingu: siatka kart produktów, przeciąganie i upuszczanie kilku produktów naraz, sortowanie automatyczne, przypięcia chroniące strategiczne pozycje przed importami, historia z możliwością cofania i reguły automatyczne stosowane codziennie.
Moduł nie zmienia Twojego motywu: kolejność ustawiona w zapleczu to ta, którą widzą Twoi klienci, zarówno w motywie Classic, jak i Hummingbird.

Zgodność i wymagania
- PrestaShop od 1.7.8 do 9.x: jeden pakiet, przetestowany na 1.7.8.11, 8.2.1 i 9.1.5.
- PHP od 7.4 do 8.5.
- Motywy Classic, Hummingbird i motywy własne (moduł niczego nie wyświetla na froncie sklepu).
- Pojedynczy sklep i multistore, wszystkie języki sklepu.
- Żadnych usług zewnętrznych. Biblioteka przeciągania i upuszczania (SortableJS, licencja MIT) jest dostarczana w module.
- Zalecane: rozszerzenie PHP
intl, aby sortować nazwy według kolejności alfabetycznej każdego języka (bez niego sortowanie po prostu pomija znaki diakrytyczne).
Instalacja i aktualizacja
- Otwórz Moduły > Menedżer modułów, kliknij Załaduj moduł i upuść plik
dfproductpositions-2.1.0.zip. - W menu pojawia się pozycja Katalog > Pozycje produktów, przetłumaczona na język każdego pracownika.
- Przycisk Konfiguruj w menedżerze modułów otwiera bezpośrednio moduł.
Aby zaktualizować moduł z wersji 1.x, wgraj nowe archiwum na poprzednie: migracja uruchamia się automatycznie. Kolejność Twoich kategorii nie zmienia się, a każde przypięcie zajmuje miejsce, na którym znajduje się jego produkt w momencie aktualizacji.
Moduł ma cztery ekrany dostępne z paska nawigacji: Układaj, Reguły automatyczne, Pulpit i Ustawienia. Po otwarciu wybierz kategorię w drzewie po lewej stronie.

Układanie kategorii
Drzewo po lewej stronie pokazuje wszystkie kategorie sklepu z liczbą produktów, pomarańczową kropką, gdy kategoria zawiera przypięte produkty, i fioletową błyskawicą, gdy ma regułę automatyczną. Pole wyszukiwania filtruje drzewo i podświetla znalezione nazwy.
Po prawej stronie kategoria wyświetla się w kolejności ze sklepu:
- Widok Siatka: jedna karta na produkt z pozycją, miniaturą, nazwą, indeksem, ID, ceną netto, stanem (zielony, pomarańczowy poniżej progu niskiego stanu, czerwony przy braku) i liczbą sprzedanych sztuk w wybranym okresie. Etykiety oznaczają produkty nowe, w promocji, nieaktywne lub nieobecne w bieżącym sklepie.
- Widok Lista: te same informacje w zwartych wierszach, z datą dodania.
- Pokaż strony: separator „Strona 2 · pozycje od 13 do 24” pokazuje, gdzie zaczyna się każda strona kategorii, zgodnie z liczbą produktów na stronę w Twoim sklepie.
- Wyszukiwanie po nazwie, indeksie lub ID (skrót /).
- Przełącznik języka zmienia język wyświetlanych nazw, a ikona obok tytułu otwiera kategorię w sklepie.
Każda zmiana jest zapisywana automatycznie; wskaźnik w prawym górnym rogu potwierdza „Wszystkie zmiany zapisane”.

Przenoszenie produktów
Przeciąganie i upuszczanie
Chwyć kartę i upuść ją w wybranym miejscu; strona przewija się automatycznie, gdy zbliżysz się do krawędzi. Podczas wyszukiwania przeciąganie i upuszczanie jest wyłączone, aby uniknąć pomyłek, ale zaznaczanie i akcje pozostają dostępne.
Zaznaczanie wielu produktów
Klikaj kolejne karty, aby je zaznaczyć, Shift + kliknięcie, aby zaznaczyć zakres, Ctrl + A, aby zaznaczyć wszystko, Esc, aby wyczyścić zaznaczenie. Na dole ekranu pojawia się pasek akcji: Przenieś na początek, Przenieś na koniec, Przenieś na pozycję…, Przypnij i Odepnij. Zaznaczone produkty są umieszczane jeden po drugim, w ich obecnej kolejności.

Przeciąganie kilku produktów naraz
Gdy zaznaczonych jest kilka produktów, przeciągnij jeden z nich: pozostałe podążają za nim, a etykieta „+2” wskazuje, ile produktów jest przenoszonych. Po upuszczeniu zostają zgrupowane w tym miejscu.

Wpisywanie pozycji
Kliknij numer pozycji na karcie, wpisz nowe miejsce i zatwierdź klawiszem Enter. Przyciski pojawiające się po najechaniu na kartę również przenoszą produkt na początek lub na koniec, przypinają go albo otwierają jego kartę produktu.
Sortowanie automatyczne
Przycisk Sortuj automatycznie porządkuje całą kategorię według wybranego kryterium:
- Bestsellery z 7, 30, 90, 180 lub 365 dni (ważne zamówienia bieżącego sklepu);
- Data dodania (najnowsze najpierw);
- Stan;
- Cena (cena bazowa netto);
- Marża (cena sprzedaży minus cena zakupu);
- Nazwa (kolejność alfabetyczna danego języka);
- Indeks (kolejność naturalna: REF-2 przed REF-10);
- Promocje na początku;
- Bieżąca kolejność, Odwróć bieżącą kolejność i Wymieszaj.
Opcje: Niedostępne na końcu, Nieaktywne produkty na końcu, Sortuj też podkategorie oraz, jeśli kategoria ma podkategorie, Podkategorie osobno (zobacz „Podkategorie zawsze na początku lub na końcu”). Pole Utrzymuj sortowanie: zapisz jako regułę automatyczną zamienia sortowanie w regułę stosowaną codziennie.
Przypięte produkty zachowują swoje miejsce, a każde sortowanie można cofnąć jednym kliknięciem.

Przypinanie pozycji
Przypięcie utrwala produkt na jego obecnym miejscu w kategorii. Przypięty produkt ma pomarańczową plakietkę z numerem pozycji.
- Sortowania automatyczne, reguły i importy CSV nigdy nie przesuwają przypiętego produktu: pozostałe produkty układają się wokół niego.
- Jeśli sam przeniesiesz przypięty produkt, zostanie on przypięty ponownie na nowym miejscu.
- Nieprzypięty produkt upuszczony na miejsce przypięcia ustawia się tuż za nim.
Przypięcie czasowe
Przypinając zaznaczenie, możesz podać datę zakończenia, na przykład koniec promocji. Przypięcie zostaje automatycznie usunięte w tym dniu przez zadanie cykliczne, a data jest widoczna na karcie.

Przypinanie całej kategorii
Menu Przypięcia oferuje Przypnij całą kategorię (każdy produkt zachowuje swoje miejsce, nawet po imporcie), Usuń wszystkie przypięcia (kolejność się nie zmienia) i Przywróć przypięcia.
Automatyczne przywracanie na miejsce
Gdy opcja jest włączona (domyślnie), przypięte produkty wracają na swoje miejsce po zapisaniu, dodaniu lub usunięciu produktu, po zmianie pozycji w natywnym zapleczu lub przez webservice (ERP) oraz przy każdym uruchomieniu zadania cyklicznego. Jeśli inne narzędzie przesunęło przypięte produkty, przy otwarciu kategorii pojawia się komunikat z przyciskiem Przywróć na miejsce.
Skrypt, który zapisuje bezpośrednio w bazie danych, nie wywołuje żadnego zdarzenia PrestaShop. W takim przypadku zadanie cykliczne przywróci przypięcia przy następnym uruchomieniu, możesz też zrobić to od razu z menu Przypięcia.
Cofanie i historia
Przyciski Cofnij i Ponów (Ctrl + Z / Ctrl + Y) przywracają dokładnie poprzednią kolejność i przypięcia. Powiadomienia po sortowaniu lub przeniesieniu również proponują „Cofnij”.
Menu Więcej > Historia wyświetla zmiany w kategorii (przeciąganie i upuszczanie, sortowania, reguły, przypięcia, importy, zadanie cykliczne) z datą, autorem i liczbą przeniesionych produktów. Przywróć ustawia kategorię w kolejności sprzed wybranej zmiany. Liczbę wersji przechowywanych na kategorię ustawia się w ustawieniach (domyślnie 30).

Import i eksport CSV
Więcej > Eksportuj kolejność (CSV) pobiera kategorię z pozycją, ID, indeksem, nazwą i stanem przypięcia (separator średnik, UTF-8).
Więcej > Importuj kolejność (CSV) wczytuje plik z jednym produktem w wierszu, identyfikowanym przez id_product lub reference; odczytywana jest też opcjonalna kolumna position. Najpierw kliknij Sprawdź plik: moduł pokaże, ile produktów kategorii znaleziono, i wyświetli listę nieznanych indeksów. Produkty z listy trafiają na początek, pozostałe idą za nimi w obecnej kolejności, a przypięte produkty zachowują swoje miejsce. Import można cofnąć.

Reguły automatyczne i zadanie cykliczne
Reguła sama utrzymuje kategorię posortowaną: bestsellery z ostatnich 30 dni, najnowsze najpierw, niedostępne na końcu… Każda kategoria może mieć jedną regułę, aktywną lub wstrzymaną. Ekran Reguły automatyczne pokazuje dla każdej z nich ostatnie uruchomienie i liczbę przeniesionych produktów, z przyciskami Zastosuj teraz, Edytuj i Usuń.
Reguły są stosowane przez zadanie cykliczne: wywołuj podany adres URL raz dziennie (lub co godzinę) ze swojego serwera albo z panelu hostingu. Ekran udostępnia przycisk Kopiuj i przykładowy wiersz crontab:
15 4 * * * curl -fsS "https://twoj-sklep.pl/module/dfproductpositions/cron?token=…" > /dev/null
Przy każdym uruchomieniu zadanie usuwa wygasłe przypięcia, stosuje aktywne reguły i przywraca przypięte produkty na miejsce. Adres URL jest chroniony tajnym kluczem, który możesz odnowić w ustawieniach.

Tworzenie lub edycja reguły
Wybierz kategorię, kryterium, kierunek oraz, w przypadku bestsellerów, okres. Dostępne są opcje „niedostępne na końcu”, „nieaktywne produkty na końcu” i „sortuj też podkategorie”, a także listy Zawsze na początku i Zawsze na końcu opisane poniżej. Zapisz i zastosuj od razu sortuje kategorię.

Podkategorie zawsze na początku lub na końcu
W kategorii głównej, która grupuje produkty kilku podkategorii, sekcja Podkategorie osobno umieszcza produkty wybranych podkategorii przed wszystkimi innymi lub po nich, niezależnie od wybranego kryterium. Na przykład: akcesoria zawsze na końcu kategorii „Rowery” albo nowości zawsze na początku.
- Zawsze na początku i Zawsze na końcu przyjmują każda do 10 podkategorii, wybieranych z listy „Dodaj podkategorię…”. Kolejność podkategorii na liście jest zachowywana.
- Produkt należy do podkategorii, jeśli jest do niej przypisany albo do jednej z jej własnych podkategorii. Produkt obecny na obu listach trafia na początek.
- W obrębie każdego bloku obowiązuje kryterium reguły (sprzedaż, nazwa, cena…), a następnie opcje „niedostępne na końcu” i „nieaktywne produkty na końcu”. Przypięte produkty zachowują swoją pozycję.
- Na tablicy merchandisingu takie produkty mają plakietkę Na początku lub Na końcu, a po najechaniu na nią widać nazwę podkategorii.
Gdy reguła jest aktywna, umieszczanie jest natychmiastowe: przy każdym zapisie produktu (karta produktu, import CSV, webservice lub ERP) moduł umieszcza go w jego bloku. Produkt dodany do podkategorii „na końcu” trafia od razu na dół kategorii głównej, a nowy produkt kategorii głównej ustawia się tuż przed tym blokiem. Zadanie cykliczne codziennie stosuje następnie ponownie całą regułę.
Produkty muszą być też przypisane do kategorii głównej: PrestaShop układa kategorię według pozycji przypisanych do niej produktów. Jeśli kategoria główna wyświetla te produkty tylko dzięki opcji „Pokaż produkty z podkategorii” wyszukiwania fasetowego, zobacz „Co widzą Twoi klienci”.
Pulpit
Pulpit podsumowuje aktywność: ułożone kategorie, przypięte produkty (oraz przypięcia kończące się w ciągu 7 dni), aktywne reguły, produkty przeniesione w ciągu 7 dni i problemy z numeracją.
Kontrole sklepu sprawdzają ustawienia, od których zależy, czy Twoi klienci widzą ustawioną tu kolejność: domyślne sortowanie sklepu według „Pozycja w kategorii”, opcje wyszukiwania fasetowego, numerację pozycji, uruchamianie zadania cyklicznego i liczbę produktów na stronę.
Sekcja Spójność pozycji wyświetla kategorie, w których produkty mają tę samą pozycję. Ich kolejność jest wtedy przypadkowa, a produkt może pojawić się na dwóch stronach albo na żadnej. Napraw numeruje pozycje od nowa 1, 2, 3… bez zmiany wyświetlanej kolejności.

Ustawienia
- Automatycznie przywracaj przypięte produkty na miejsce (domyślnie włączone).
- Okres sprzedaży wyświetlany na kartach i domyślnie używany przez sortowanie „Bestsellery” (90 dni).
- Próg niskiego stanu (5).
- Wersje przechowywane na kategorię w historii (30).
- Domyślnie pokazuj podział na strony sklepu.
- Powiadamiaj inne moduły po każdej zmianie (
actionCategoryUpdate), aby moduły przechowujące listy produktów w pamięci podręcznej je odświeżyły. - Adres URL zadania cyklicznego i odnowienie jego tajnego klucza.

Co widzą Twoi klienci
Moduł zapisuje dane w natywnej pozycji PrestaShop: strona kategorii wyświetla produkty w ustawionej kolejności, bez żadnych zmian w motywie. Dwa ustawienia sklepu wymagają uwagi, a pulpit je sprawdza:
- w Preferencje > Ustawienia produktów domyślne sortowanie musi mieć wartość „Pozycja w kategorii”, rosnąco;
- przy wyszukiwaniu fasetowym z opcją „Pokaż produkty z podkategorii” kategoria nadrzędna miesza pozycje swoich podkategorii. Aby w pełni kontrolować kategorię nadrzędną, sortuj ją razem z podkategoriami lub wyłącz tę opcję.

Uprawnienia pracowników i multistore
Dostęp opiera się na natywnych uprawnieniach PrestaShop (Zaawansowane > Zespół > Uprawnienia). Profil, który ma tylko uprawnienie „Wyświetl” do zakładki Pozycje produktów, przegląda kategorie, historię i pulpit w trybie tylko do odczytu; wszystkie zmiany wymagają uprawnienia „Edytuj”. Wszystkie żądania są chronione tokenem administratora PrestaShop.
W trybie multistore kolejność kategorii jest wspólna dla wszystkich sklepów (tak działa PrestaShop, pozycja nie istnieje osobno dla każdego sklepu). Moduł wyświetla więc wszystkie produkty kategorii i oznacza etykietą te, które nie są sprzedawane w bieżącym sklepie. Przypięcia również są wspólne; wyświetlana sprzedaż, ceny i stan dotyczą wybranego sklepu.
Aktualizacja z wersji 1.x i odinstalowanie
Migracja do wersji 2.0.0 dodaje tabele reguł i historii, zachowuje kolejność wszystkich kategorii i ustawia każde przypięcie na rzeczywistym miejscu jego produktu. Przy okazji koryguje przesunięcie przypięć o jedno miejsce, występujące w wersji 1.x.
Aktualizacja do wersji 2.1.0 dodaje podkategorie zawsze na początku lub na końcu. Twoje reguły, przypięcia i kolejność kategorii nie zmieniają się.
Odinstalowanie usuwa przypięcia, reguły, historię, ustawienia i pozycję menu. Kolejność Twoich kategorii zostaje zachowana, ponieważ jest przechowywana w natywnej pozycji PrestaShop.
FAQ
Czy muszę przypiąć wszystkie produkty, aby zachować swoją kolejność?
Nie. Ustawiona kolejność pozostaje bez zmian, dopóki nie zmieni jej żadne sortowanie, reguła ani narzędzie zewnętrzne. Przypinaj produkty, których miejsce jest strategiczne, albo całą kategorię, jeśli ERP zmienia kolejność Twoich produktów.
Jak ustawić produkty polecane na początku i automatycznie posortować resztę?
Ustaw produkty polecane na początku, przypnij je, a następnie uruchom sortowanie (lub utwórz regułę) „Bestsellery”. Produkty polecane zostają na pierwszych miejscach, a reszta sortuje się za nimi.
Jak wyświetlać produkty podkategorii zawsze na końcu kategorii głównej?
Utwórz regułę dla kategorii głównej, dodaj podkategorię do listy Zawsze na końcu, a następnie kliknij Zapisz i zastosuj. Nowe produkty tej podkategorii trafiają potem od razu na dół, bez żadnej interwencji.
Czy sortowanie jest przeliczane przy każdej wizycie?
Nie. Sortowanie lub reguła zapisuje pozycje jeden raz; strony sklepu nie wykonują żadnych dodatkowych obliczeń.
A przy dużym katalogu?
W kategorii z 5 000 produktów (PrestaShop 9.1, PHP 8.5) zmierzyliśmy 0,56 s na załadowanie i wyświetlenie siatki, 0,44 s na sortowanie według nazwy i 0,24 s od upuszczenia karty do zapisu.
Produkt pojawia się na dwóch stronach mojej kategorii albo go brakuje. Dlaczego?
Kilka produktów ma prawdopodobnie tę samą pozycję, co zdarza się po niektórych importach. Otwórz Pulpit: sekcja Spójność pozycji wyświetla takie kategorie i naprawia je bez zmiany wyświetlanej kolejności.
Kolejność w mojej kategorii nadrzędnej nie odpowiada temu, co ustawiłem.
Wyszukiwanie fasetowe prawdopodobnie wyświetla produkty podkategorii w kategorii nadrzędnej. Zobacz sekcję „Co widzą Twoi klienci”.
Nie widzę przycisków edycji.
Twój profil ma tylko uprawnienie „Wyświetl” do zakładki Pozycje produktów. Administrator może dodać uprawnienie „Edytuj” w Zespół > Uprawnienia.
Reguły nie są stosowane.
Sprawdź, czy zadanie cykliczne rzeczywiście wywołuje adres URL modułu: pulpit pokazuje datę jego ostatniego uruchomienia. Wstrzymane reguły nie są stosowane.