DataFirefly Product Order: kompletny przewodnik

DataFirefly Product Order dodaje dedykowaną stronę administracyjną, na której prostym przeciągnij i upuść definiujesz kolejność wyświetlania produktów WooCommerce. Możesz ustawić kolejność globalną dla całego sklepu albo niezależną kolejność dla każdej kategorii. Własna kolejność obowiązuje na froncie tylko wtedy, gdy klient korzysta z sortowania domyślnego: sortowania po cenie, popularności czy ocenie pozostają nienaruszone. Ten przewodnik obejmuje instalację, ekran sortowania, różnicę między kolejnością globalną a kolejnością per kategoria, działanie na froncie, regułę „brak w magazynie na dole”, wydajność, zgodność i rozwiązywanie problemów.

Instalacja

1. Pobierz archiwum df-product-order.zip ze swojego konta DataFirefly.
2. Panel WordPressa → Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer → prześlij ZIP, następnie Włącz.
3. Przy aktywacji wtyczka tworzy tabelę pozycji (wp_dfpord_order) i dodaje pozycję menu Produkty → Kolejność produktów.

Start w dwie minuty

1. Otwórz Produkty → Kolejność produktów.
2. W menu Zakres zostaw „Kolejność globalna (sklep)” albo wybierz kategorię.
3. Przeciągaj i upuszczaj produkty w wybranej kolejności za pomocą uchwytu po lewej stronie każdego wiersza. Każde upuszczenie zapisuje się automatycznie.
4. Odwiedź sklep: produkty pojawiają się w nowej kolejności, gdy tylko aktywne sortowanie to „domyślne”.

Ekran „Kolejność produktów”

Całe zarządzanie odbywa się w Produkty → Kolejność produktów. Ekran składa się z paska narzędzi i sortowalnej listy.

Pasek narzędzi

• Zakres: wybierz „Kolejność globalna (sklep)” albo konkretną kategorię produktów. Zmiana zakresu przeładowuje odpowiednią listę.
• Szukaj: filtruje listę po nazwie produktu, przydatne przy szybkim odnajdywaniu artykułu w dużej kategorii.
• Produkty bez stanu na dole: przełącznik włączający automatyczną regułę po stronie sklepu (patrz niżej). Jego stan zapisuje się od razu po zmianie.

Sortowalna lista

Każdy wiersz pokazuje uchwyt przenoszenia, miniaturę produktu, jego nazwę (z odznaką Brak w razie braku stanu) oraz cenę. Chwyć wiersz za uchwyt, przenieś, puść: kolejność zapisuje się w tle, a komunikat „Kolejność zapisana” potwierdza operację.

Kolejność globalna czy kolejność per kategoria

Oba zakresy są niezależne i współistnieją bez konfliktu.

Kolejność globalna (sklep)

Określa kolejność używaną na stronie sklepu i wszędzie tam, gdzie produkty wyświetlane są bez kontekstu kategorii. Dla zgodności z motywem i innymi wtyczkami kolejność globalna synchronizuje natywne pole menu_order każdego produktu.

Kolejność per kategoria

Każda kategoria zachowuje własną kolejność, przechowywaną w dedykowanej tabeli wp_dfpord_order. Ten sam produkt może więc być na czele jednej kategorii i niżej w innej. Ta kolejność obowiązuje na stronach archiwum kategorii produktów.

Działanie na froncie

Własna kolejność nigdy nie zastępuje wyboru sortowania dokonanego przez odwiedzających. Obowiązuje wyłącznie wtedy, gdy aktywne sortowanie to sortowanie domyślne sklepu. Gdy tylko klient wybierze „Sortuj po cenie”, „po popularności” albo „po średniej ocenie”, jego wybór ma pierwszeństwo, a własna kolejność jest dla tej strony ignorowana.

• Strona Sklep i listy bez kategorii: kolejność globalna.
• Strony archiwum kategorii: kolejność danej kategorii (w razie braku, powrót do kolejności globalnej, a następnie tytułu).

Reguła „brak w magazynie na dole”

Włączana przełącznikiem w pasku narzędzi, ta reguła automatycznie spycha produkty bez stanu na koniec listy po stronie sklepu, zachowując przy tym Twoją własną kolejność dla produktów dostępnych. Nakłada się na sortowanie domyślne, nie wpływając na sortowania wybierane przez klienta.

Wolumen, wydajność i limity

• Pozycje są cache’owane (cache obiektowy), co unika powtarzanych zapytań i utrzymuje szybkie strony sklepu.
• Ekran administracyjny ładuje maksymalnie 200 produktów per zakres; deweloper może podnieść ten limit, dostosowując limit ładowania w kodzie.
• Zapis nowej kolejności aktualizuje pozycje danego zakresu, a przy kolejności globalnej także pole menu_order odpowiednich produktów.

Zgodność i uwagi techniczne

• WordPress 6.4+, PHP 8.0 do 8.3, WooCommerce 7.0+, multisite.
• Zadeklarowana zgodność z HPOS (wydajny magazyn zamówień).
• Kolejność globalna przechowywana w natywnym polu menu_order; kolejność per kategoria w tabeli wp_dfpord_order (klucz unikalny produkt + kategoria).
• Działanie na froncie przez filtrowanie klauzul zapytania, wyłącznie na sortowaniu domyślnym.
• Wielojęzyczność: dostarczony szablon tłumaczeń .pot (zgodny z Polylang, WPML, Loco Translate).
• Architektura PSR-4 z autoloaderem, bez zależności Composera i bez wywołań usług zewnętrznych.

Deinstalacja

Usunięcie wtyczki z ekranu wtyczek wykonuje pełne czyszczenie: tabela wp_dfpord_order jest usuwana, a opcje wtyczki kasowane. Pole menu_order produktów, jako natywna dana WooCommerce, jest zachowywane. Samo wyłączenie wtyczki nie usuwa żadnych danych.

FAQ i rozwiązywanie problemów

Kolejność nie pojawia się w sklepie. Sprawdź, czy wybrane jest sortowanie domyślne (a nie po cenie czy dacie). Skontroluj też ustawienie WooCommerce → Produkty → Wyświetlanie i wyczyść cache, jeśli używasz wtyczki cache stron.

Kolejność per kategoria nie jest uwzględniana. Upewnij się, że przed sortowaniem wybrano właściwą kategorię w menu „Zakres” i że na froncie oglądasz stronę archiwum tej kategorii (a nie stronę sklepu).

Przeciągnij i upuść nie reaguje. Wymuś przeładowanie strony (cache przeglądarki) i sprawdź, czy żadna wtyczka minifikująca albo blokująca JavaScript nie uniemożliwia załadowania skryptów administracyjnych.

Produkt nie pojawia się na liście. Lista jest ograniczona do 200 produktów per zakres i pokazuje wyłącznie produkty opublikowane. Użyj pola wyszukiwania albo sortuj per kategoria, żeby zmniejszyć wolumen.

Produkty bez stanu nie schodzą na dół. Włącz przełącznik „Produkty bez stanu na dole”; reguła obowiązuje tylko przy sortowaniu domyślnym, nie przy sortowaniach po cenie, popularności czy ocenie.