Przejdź do treści
Dokumentacja

Troubleshooting

Ostatnia aktualizacja: 14 godzin temu

Diagnostyka najczęstszych problemów. Jeśli nie znajdziesz tu odpowiedzi, skontaktuj się z nami przez sekcję Kontakt.

  1. Sprawdź czy tryger Add to Cart jest włączony w zakładce Triggers.
  2. Sprawdź czy AJAX add-to-cart jest aktywny w WooCommerce → Settings → Products (opcja Enable AJAX add to cart buttons on archives). Bez AJAX modal nie ma eventu do nasłuchu.
  3. Otwórz produkt w trybie incognito (wyklucza cookies i cache).
  4. Wyczyść cache: przeglądarki, pluginu cache (W3 Total Cache / WP Super Cache / LiteSpeed), CDN.
  5. Sprawdź konsolę developera (F12) — czy JS pluginu się załadował? Czy są błędy?
  • Algorytm FBT wymaga historycznych par produktów. Wymuś rebuild: wp wpnest-rpm pairs:rebuild.
  • Dla nowych sklepów dodaj algorytmy fallback: Same Category, Best Sellers, New Arrivals — działają bez wymaganej historii.
  • Sprawdź czy produkt bazowy ma kategorię i czy w kategorii są inne produkty w sprzedaży.
  • Sprawdź transient cache: wp transient delete wpnest_rpm_recs_<product_id>.

Exit-intent się nie odpala

  • Exit-intent na desktop używa mouseout + threshold do top wiewportu. Na mobile — visibility API (tab w tle). Sprawdź czy testujesz na właściwym urządzeniu.
  • Ustaw cooldown w zakładce Triggers (domyślnie 1× per session). Jeśli już raz wyzwolony, ponownie odpali się dopiero w nowej sesji.
  • Wyczyść cookies sesji: w DevTools usuń cookie wpnest_rpm_session i odśwież.

A/B test nie pokazuje obu wariantów

Każdy użytkownik widzi tylko jeden wariant — sticky session 30 dni. Aby zobaczyć drugi, otwórz inkognito lub usuń cookie wpnest_rpm_session. Po stronie analityki widzisz oba.

Cron nie działa

Wtyczka korzysta z 3 cron-ów: wpnest_rpm_pro_pairs_cron (rebuild FBT pairs daily), wpnest_rpm_pro_email_followup_cron (email follow-up hourly), wpnest_rpm_pro_events_cleanup_cron (cleanup eventów daily). Sprawdzenie:

wp cron event list | grep wpnest_rpm

Jeśli zadań brakuje — dezaktywuj i zaktywuj Pro ponownie. Zalecamy też systemowego crona zamiast WP-Cron:

*/15 * * * * /usr/bin/wget -q -O- https://twojadomena.pl/wp-cron.php

Webhook Slack/Discord nie dochodzi

  • Testuj URL przed produkcją: wp wpnest-rpm webhook:test --url=<url>
  • Slack URL musi pasować do regex hooks.slack.com. Discord: discord.com/api|discordapp.com/api. Wszystko inne — generic JSON.
  • Sprawdź firewall serwera — czy wp_remote_post ma wyjście na zewnątrz.
  • Webhooki są non-blocking (blocking=false), więc błędy nie pojawią się w UI. Sprawdź wp-content/debug.log jeśli masz WP_DEBUG_LOG.

Konflikt z innym pluginem

Najszybsza diagnostyka: dezaktywuj wszystkie inne wtyczki (poza WooCommerce + RPM Free + RPM Pro), sprawdź czy problem znika, a następnie aktywuj je pojedynczo. To wskaże winowajcę w mniej niż 5 minut.

Jak zgłosić błąd

Jeśli żaden z powyższych kroków nie pomógł, skontaktuj się z nami przez Kontakt. Załącz:

  • Wersję WordPress, WooCommerce i PHP (z WooCommerce → Status → System)
  • Wersję motywu
  • Listę aktywnych wtyczek
  • Dokładny opis kroków, które prowadzą do problemu
  • Screenshoty z error logu (wp-content/debug.log jeśli włączone)
  • Output: wp wpnest-rpm doctor (skanuje konfigurację i wykrywa typowe problemy)