Wstępna konfiguracja modułu

Instalacja

arena_install

  1. Pobierz moduł integracyjny ze strony dystrybutora.
  2. Zainstaluj moduł w swoim sklepie PrestaShop poprzez panel administracyjny (Moduły > Dodaj nowy).
  3. Po instalacji kliknij Konfiguruj, aby przejść do ustawień modułu.

Konfiguracja API

arena_panel_api

  1. Otwórz w nowej karcie Panel Sprzedawcy Arena.pl.
  2. Przejdź do zakładki Ustawienia sklepu > API.
  3. Skopiuj:
    • Login sklepu (2)
    • Klucz API (3)

arena_konfiguracja1

  1. Wróć do konfiguracji modułu w sklepie PrestaShop.
  2. Wprowadź skopiowane dane odpowiednio:
    • Login sklepu (1)
    • Klucz API (2)
  3. Zapisz ustawienia.

Konfiguracja zadań CRON

Czym są „Produkty oczekujące“?

Produkty oczekujące to produkty, które zostały zmodyfikowane w sklepie od ostatniej synchronizacji z Arena.pl. Moduł automatycznie dodaje je do kolejki do aktualizacji.

Ważne: Mechanizm ten pozwala ograniczyć ilość przesyłanych danych tylko do produktów, które rzeczywiście uległy zmianie.

arena_cron

Typy zadań CRON obsługiwane przez moduł

  1. Synchronizacja zamówień
    • Pobiera nowe zamówienia z Arena.pl do sklepu.
  2. Synchronizacja produktów oczekujących
    • Synchronizuje tylko produkty oznaczone jako oczekujące.
    • Zalecana częstotliwość: co 1 minutę.
  3. Oznaczenie wszystkich produktów jako oczekujące
    • Oznacza wszystkie produkty w sklepie jako oczekujące do aktualizacji.
    • Przydatne przy dużych aktualizacjach lub przebudowie oferty.
  4. Aktualizacja wszystkich produktów oczekujących w jednym wywołaniu
    • Wykonuje pełną synchronizację oczekujących produktów w jednym cyklu.
    • Wymaga dużych zasobów serwera.

Zalecane konfiguracje zadań CRON

Konfiguracja 1 – Podstawowa (dla serwerów współdzielonych lub z ograniczeniami)

Zadanie Częstotliwość Uwagi
(1) Synchronizacja zamówień Co 5 minut Rekomendowane minimum
(2) Synchronizacja produktów oczekujących Co 1 minutę Synchronizacja porcjowana
(3) Oznaczenie wszystkich jako oczekujące Ignorujemy Niepotrzebne w tej konfiguracji
(4) Aktualizacja wszystkich w jednym wywołaniu Ignorujemy Niepotrzebne w tej konfiguracji

Konfiguracja 2 – Zaawansowana (dla serwerów dedykowanych)

Zadanie Częstotliwość Uwagi
(1) Synchronizacja zamówień Co 5 minut Stała synchronizacja zamówień
(2) Synchronizacja produktów oczekujących Ignorujemy Zastąpione zadaniem (4)
(3) Oznaczenie wszystkich jako oczekujące Ignorujemy Zbędne
(4) Aktualizacja wszystkich w jednym wywołaniu Co 30 minut (lub rzadziej) Pełna synchronizacja oczekujących

Konfiguracje specjalne (dla świadomych użytkowników)

  • (3) Oznaczenie wszystkich jako oczekujące
    • Opcjonalne.
    • Używaj wyłącznie, gdy chcesz ręcznie wymusić odświeżenie całej oferty.
    • Przykład zastosowania: raz na tydzień lub miesiąc.

Wskazówki praktyczne

💡 Wskazówka:
W przypadku częstej aktualizacji cen lub stanów magazynowych, rekomendowane jest korzystanie z zadania (2), co pozwoli na sprawną synchronizację zmodyfikowanych produktów w trybie ciągłym bez dużego obciążania serwera.

⚠️ Uwaga:
Zadanie (4) wymaga dużych zasobów serwera. Nie uruchamiaj go na serwerze współdzielonym lub VPS z niskimi limitami pamięci i czasu wykonania skryptu.

💡 Wskazówka:
Aby zapewnić poprawne działanie aktualizacji stanów magazynowych, upewnij się, że inne moduły nie blokują systemowego hooka ProductUpdateQuantity.