Konfiguracja

Pair przechowuje ustawienia w opcji pair_settings. Ekran ustawień znajduje się w WooCommerce → Pair recommendations i wymaga uprawnienia manage_woocommerce.

Umiejscowienie

• Enable recommendations (enabled), główny włącznik. Gdy wyłączony, Pair nie renderuje niczego.
• On the single product page (show_on_single), renderuje rekomendacje po podsumowaniu produktu.
• Under the cart (show_on_cart), renderuje rekomendacje pod koszykiem.
• Show recently viewed products (show_recently_viewed), włącza osobny blok ostatnio oglądanych.
• Recently viewed on product pages (recently_on_single), renderuje ostatnio oglądane produkty na kartach produktów.
• Recently viewed on the cart (recently_on_cart), renderuje ostatnio oglądane produkty w koszyku.
• Only recommend products that are in stock (in_stock_only), wyklucza z wyników produkty niedostępne w magazynie.

Strategie

• Strategia na karcie produktu (single_strategy), domyślnie related.
• Strategia w koszyku (cart_strategy), domyślnie related.

Dozwolone wartości:

Wartość	Znaczenie
related	Produkty z tych samych kategorii, uporządkowane według popularności.
tags	Produkty ze wspólnymi tagami.
bestsellers	Najlepiej sprzedające się produkty.
newest	Najnowsze opublikowane produkty.
recently	Produkty ostatnio oglądane przez kupującego.

Każda strategia uzupełnia wyniki najnowszymi produktami, gdy dopasowań jest za mało.

Ustawienia siatki

• Number of products (count), przycinane do zakresu od 1 do 12.
• Columns (columns), przycinane do zakresu od 1 do 6.

Siatka renderuje się przez szablon pętli produktów WooCommerce, więc dziedziczy wygląd kart produktów z aktywnego motywu.

Nagłówki

• Nagłówek na karcie produktu (single_heading), wyświetlany nad rekomendacjami na karcie produktu.
• Nagłówek w koszyku (cart_heading), wyświetlany nad rekomendacjami w koszyku.
• Nagłówek ostatnio oglądanych (recently_heading), wyświetlany nad ostatnio oglądanymi produktami.

Zapisanie pustego nagłówka nie przywraca domyślnego. Blok renderuje się wtedy bez widocznego nagłówka <h2>, a jedynie atrybut aria-label sekcji otrzymuje wartość zastępczą „Recommended products”. Aby wrócić do domyślnego tekstu, wpisz go ponownie w pole.

Shortcode

[pair_recommendations]
[pair_recommendations strategy="bestsellers" count="4" columns="4"]
[pair_recently_viewed count="4" columns="4"]

Atrybuty:

Atrybut	Zakres	Opis
strategy	related, tags, bestsellers, newest, recently	Tylko [pair_recommendations]. Nadpisuje skonfigurowaną strategię rekomendacji.
count	1-12	Nadpisuje skonfigurowaną liczbę produktów dla tego bloku.
columns	1-6	Nadpisuje skonfigurowaną liczbę kolumn dla tego bloku.
heading	tekst	Nadpisuje nagłówek bloku.

[pair_recently_viewed] przyjmuje tylko count, columns i heading. Zawsze używa strategii recently, więc atrybut strategy jest w nim ignorowany.

Na karcie produktu [pair_recommendations] używa bieżącego produktu. Poza kartą produktu używa zawartości koszyka. [pair_recently_viewed] zawsze używa identyfikatorów produktów ostatnio oglądanych przez kupującego.

Przechowywanie danych i deinstalacja

Pair przechowuje tylko:

• pair_settings
• pair_db_version

Procedura deinstalacji usuwa obie opcje. Wtyczka nie tworzy własnych tabel w bazie danych.