Konfiguracja

Pair Pro przechowuje ustawienia w opcji pair_pro_settings. Strona ustawień znajduje się pod WooCommerce → Pair Pro i wymaga uprawnienia manage_woocommerce.

Ustawienia

• Enable (enabled), główny przełącznik. Gdy wyłączony, blok nie jest renderowany.
• Heading (heading), nagłówek nad blokiem, domyślnie “Frequently bought together”. Puste pole ukrywa nagłówek.
• Products (count), liczba pokazywanych produktów, ograniczona do zakresu 1-6, domyślnie 3.
• Columns (columns), liczba kolumn siatki, ograniczona do zakresu 1-6, domyślnie 3.
• Add all to cart (add_all), pokazuje przycisk dodający cały zestaw do koszyka jednym kliknięciem.
• In stock only (in_stock_only), pokazuje wyłącznie produkty dostępne w magazynie.
• Orders to analyse (scan_orders), liczba najnowszych opłaconych zamówień skanowanych pod kątem współzakupów, ograniczona do zakresu 20-1000, domyślnie 150.

Jak działa analiza zamówień

Na potrzeby bloku Pair Pro pobiera najnowsze zamówienia o statusach zrealizowane i przetwarzane (do limitu scan_orders), wybiera te zawierające oglądany produkt i zlicza, jak często inne produkty występują w tych samych zamówieniach. Pozycje wariantów są przypisywane do produktu nadrzędnego, więc warianty tego samego produktu składają się na jedną rekomendację.

Ranking (do 12 pozycji) jest zapisywany w transiencie pair_pro_fbt_<id> na 12 godzin per produkt. Skan zamówień uruchamia się tylko przy braku cache, więc nowe zamówienia pojawiają się w wynikach po wygaśnięciu transientu. Zamówienia są odczytywane przez API zamówień WooCommerce, zgodne z HPOS.

Renderowanie bloku

Blok renderuje się na haku woocommerce_after_single_product_summary z priorytetem 14, czyli tuż nad darmowym blokiem “You may also like” (priorytet 15). Siatka używa pętli produktów WooCommerce i dziedziczy karty produktu aktywnego motywu oraz klasy .pair-recommendations z darmowej wtyczki, z modyfikatorem pair-recommendations--bought-together.

Pokazywane są tylko produkty opublikowane i widoczne w katalogu. Przy włączonym In stock only wyniki są dodatkowo filtrowane do produktów dostępnych. Gdy po filtrach lista jest pusta, blok w ogóle się nie renderuje. Wtyczka dodaje na karcie produktu tylko mały arkusz stylów, bez JavaScriptu.

Przycisk “Add all to cart”

Przy włączonym add_all pod siatką pojawia się formularz POST z ukrytą listą ID produktów i tokenem nonce. Po kliknięciu Pair Pro dodaje do koszyka każdy produkt z zestawu, który jest możliwy do kupienia i dostępny, pokazuje standardowy komunikat WooCommerce o dodaniu do koszyka i wraca na poprzednią stronę. Przycisk działa bez JavaScriptu.

Przechowywanie i odinstalowanie

Pair Pro zapisuje tylko:

• pair_pro_settings
• pair_pro_version
• pair_pro_activated_at
• pair_pro_db_version
• transienty cache pair_pro_fbt_<id>

Procedura odinstalowania usuwa wszystkie te opcje i transienty. Wtyczka nie tworzy własnych tabel w bazie danych.