Pair Pro

• Strona wtyczki: https://plogins.com/pl/plogins-pair-pro/
• Dokumentacja: https://plogins.com/pl/plogins-pair-pro/docs/
• Autor: WPPoland.com

Pair Pro to edycja premium dla Pair. To rozszerzenie wymagające zainstalowanej i aktywnej darmowej wtyczki Pair w wersji 0.1.0 lub nowszej; dystrybuowane przez Freemius (licencjonowanie, aktywacja i automatyczne aktualizacje), nie przez katalog WordPress.org.

Pair Pro rozszerza darmowe rekomendacje produktowe. Nie działa samodzielnie. Gdy darmowa wtyczka jest nieobecna, wyłączona lub starsza niż wymagana wersja, Pair Pro pozostaje uśpione i pokazuje powiadomienie w panelu zamiast się uruchamiać.

Wdrożone funkcje PRO

• Często kupowane razem: blok na karcie produktu z produktami najczęściej kupowanymi w tym samym zamówieniu co oglądany produkt. Analizuje zrealizowane i przetwarzane zamówienia (ograniczony, cache’owany skan najnowszych opłaconych zamówień) zamiast zgadywać po kategoriach, więc sugestie odzwierciedlają rzeczywiste zakupy. Renderuje się tuż nad darmowym blokiem “You may also like” i korzysta z kart produktu aktywnego motywu.
• Przycisk “Add all to cart”: opcjonalny przycisk dodający cały zestaw kupowanych razem produktów do koszyka jednym kliknięciem. Zwykły formularz POST z tokenem nonce, bez JavaScriptu.
• Strona ustawień: WooCommerce > Pair Pro obejmuje włączenie bloku, nagłówek wraz z przełącznikiem Show this heading, liczbę produktów (1-6), kolumny, filtr dostępności, przycisk zbiorczego dodania i liczbę analizowanych zamówień.
• Rabat na zestaw (bundle_discount): opcjonalne “kup cały zestaw, oszczędź X%”. Po zbiorczym dodaniu identyfikatory produktów zestawu trafiają do sesji WooCommerce, a rabat wchodzi jako ujemna opłata koszyka i obowiązuje tak długo, jak wszystkie produkty zestawu zostają w koszyku.
• Ręczny wybór rekomendacji (manual_enabled, manual_mode): wskazujesz rekomendacje dla konkretnego produktu sam. Wybór jest zapisywany w meta _pair_manual_recommendations i wchodzi przez filtr pair/recommendations darmowej wtyczki, prowadząc automatyczne propozycje albo je zastępując.
• Reguły kategorii (rules_enabled, category_rules): “gdy produkt jest w kategorii A, polecaj produkty z kategorii B”, ustawiane globalnie i stosowane na karcie produktu.
• Dodatkowe miejsca (place_thankyou, place_checkout): ten sam blok rekomendacji na stronie podziękowania za zamówienie i przy kasie, w markupie darmowej wtyczki, więc style i analityka działają tak samo.
• Blok do edytora: dynamiczny blok “Pair Recommendations” do edytora bloków i szablonów FSE, renderowany po stronie serwera przez rekomender darmowej wtyczki.
• Testy A/B (ab_enabled, ab_strategy_b): każdy klient dostaje stały wariant zapisany w ciasteczku. A zostaje przy domyślnych rekomendacjach na karcie produktu, B podmienia strategię na inną, a ekran analityki pokazuje oba warianty obok siebie.
• Analityka rekomendacji (analytics_enabled): wyświetlenia i kliknięcia bloków na froncie oraz dodanie do koszyka przypisane do klikniętego produktu. Atrybucja opiera się na kliknięciu i jest przybliżona, to sygnał kierunkowy, nie dokładne księgowanie przychodu.

Skąd pochodzą dane

Pair Pro skanuje najnowsze opłacone zamówienia (statusy completed i processing), znajduje te zawierające oglądany produkt i zlicza produkty kupione razem z nim. Warianty tego samego produktu zliczane są jako produkt nadrzędny, więc nie rozbijają wyniku. Ranking jest zapisywany w transiencie na 12 godzin per produkt, więc skan zamówień uruchamia się najwyżej raz na okno cache.

Instalacja i uruchomienie

Pair Pro to dodatek: uruchamia się dopiero wtedy, gdy darmowa wtyczka Pair (0.1.0 lub nowsza) jest zainstalowana i aktywna. Domyślne ustawienia są od razu użyteczne: blok włączony, trzy produkty, trzy kolumny, tylko produkty dostępne, przycisk zbiorczego dodania włączony, analiza 150 najnowszych opłaconych zamówień.

Instalacja

1. Zainstaluj i aktywuj WooCommerce (8.0 lub nowsze).
2. Zainstaluj i aktywuj darmową wtyczkę Pair (0.1.0 lub nowszą).
3. Wgraj folder plogins-pair-pro do /wp-content/plugins/ albo zainstaluj paczkę z Freemius przez Wtyczki > Dodaj nową > Wgraj wtyczkę.
4. Aktywuj Pair Pro na ekranie Wtyczki i dokończ aktywację licencji Freemius, gdy pojawi się monit.
5. Otwórz WooCommerce > Pair Pro.

Uruchomienie bloku

Na stronie ustawień:

1. Zostaw zaznaczone Enable (pokazywanie bloku).
2. Ustaw nagłówek. Puste pole oznacza wbudowaną wartość domyślną, przetłumaczoną na język sklepu (po angielsku “Frequently bought together”); wpisz własny, na przykład “Często kupowane razem”. Żeby blok nie miał nagłówka w ogóle, odznacz Show this heading pod polem; samo wyczyszczenie pola już tego nie robi.
3. Wybierz liczbę produktów (1-6) i liczbę kolumn.
4. Zostaw zaznaczone In stock only, jeśli blok ma pokazywać tylko produkty dostępne.
5. Zostaw zaznaczone Add all to cart, jeśli chcesz przycisk dodający cały zestaw jednym kliknięciem.
6. Zapisz zmiany.

Weryfikacja

Blok czerpie z historii zamówień, nie z kategorii. Otwórz kartę produktu, który występuje w zrealizowanych lub przetwarzanych zamówieniach razem z innymi produktami. Blok pojawia się po podsumowaniu produktu, tuż nad darmowym blokiem “You may also like”.

Jeśli żadne z analizowanych zamówień nie zawiera oglądanego produktu razem z innymi, blok w ogóle się nie renderuje. W świeżym sklepie bez zamówień to zachowanie oczekiwane.

Dostrajanie analizy

Ustawienie Orders to analyse (20-1000, domyślnie 150) określa, ile najnowszych opłaconych zamówień jest skanowanych. Wynik jest cache’owany na 12 godzin per produkt, więc zmiana ustawień lub nowe zamówienia mogą być widoczne w bloku dopiero po wygaśnięciu cache.

Konfiguracja

Ekran	Cel
WooCommerce > Pair recommendations	Darmowe bloki rekomendacji: strona produktu, koszyk, ostatnio oglądane.
WooCommerce > Pair Pro	Blok “Często kupowane razem”: włączenie, nagłówek wraz z jego przełącznikiem, liczba produktów, kolumny, filtr dostępności, przycisk zbiorczego dodania, liczba analizowanych zamówień. Tam też nagłówek dodatkowych miejsc i jego własny przełącznik.

Wymagania

• WordPress 6.4 lub nowszy
• PHP 8.1 lub nowszy
• WooCommerce 8.0 lub nowszy
• Darmowa wtyczka Pair w wersji 0.1.0 lub nowszej, zainstalowana i aktywna

Licencja i aktualizacje

Pair Pro jest sprzedawane i dostarczane przez Freemius w trzech planach: 29, 59 i 99 EUR. Freemius obsługuje aktywację licencji i automatyczne aktualizacje przez dołączony SDK. Wtyczka deklaruje zgodność z WooCommerce HPOS (Custom Order Tables) oraz blokami koszyka i kasy.

Relacja z Pair

Darmowa edycja pokrywa automatyczne rekomendacje na stronie produktu i pod koszykiem (kategorie, tagi, bestsellery, najnowsze, ostatnio oglądane) oraz shortcode’y. PRO dodaje rekomendacje oparte o rzeczywiste współzakupy z historii zamówień, z opcjonalnym dodaniem całego zestawu do koszyka jednym kliknięciem.

Następne kroki

• Konfiguracja, każde ustawienie wyjaśnione.
• FAQ, najczęstsze pytania o dane, wydajność i zgodność z WooCommerce.