WooCommerce Allegro PRO — integracja sklepu z Allegro
Komercyjna wtyczka WordPress integrująca WooCommerce z Allegro: wystawianie ofert, dwukierunkowa synchronizacja stanów, cen i statusów oraz import zamówień i opinii.
Produkt jest rozwijany długoterminowo i obsługuje wiele kont sprzedawcy równolegle.
Technologie:
PHP 7.4–8.x · WordPress Plugin API · WooCommerce API · Allegro REST API · OAuth 2.0 · MySQL/MariaDB · JavaScript · AJAX · WP-Cron
Wersja:
2.7.40 · WordPress 4.0+ / WooCommerce 5.0+ · GPL-3.0
Punkt wyjścia
Sklep WooCommerce i Allegro muszą działać jak jeden kanał sprzedaży.
Projekt odpowiada na potrzebę sprawnego zarządzania ofertą, stanami magazynowymi, cenami i zamówieniami w sklepie oraz na marketplace.
WooCommerce Allegro PRO łączy oba systemy przez Allegro REST API, obsługuje OAuth 2.0 i bezpiecznie prowadzi synchronizację dla wielu kont sprzedawcy.
Największym wyzwaniem było zbudowanie odpornego procesu, który uwzględnia asynchroniczne komunikaty Allegro, limity API, kolejki CRON oraz różnice wersji PHP, WordPressa i WooCommerce.
Rozwiązanie
Od produktu w WooCommerce do kompletnej oferty na Allegro.
Wtyczka prowadzi użytkownika przez konfigurację oferty, walidację danych i kolejkę eksportu produktów do Allegro.
Produkty zmienne są wystawiane jako osobne oferty wariantów, a wartości można ustawiać pojedynczo lub zbiorczo dla całej listy.
Szablony ofert z autorskimi blokami Gutenberga pozwalają wizualnie budować opis z tytułu, treści, zdjęcia, galerii i układu kolumnowego.
Cenniki dostaw, tabele rozmiarów, usługi dodatkowe, warunki posprzedażowe oraz dane GPSR są przypisywane do produktów zgodnie z konfiguracją sklepu.
Jak działa integracja WooCommerce z Allegro?
Konfiguracja produktu
Produkt WooCommerce otrzymuje konfigurację oferty Allegro, obejmującą kategorię, parametry, cenę, dostawę, opis i konto sprzedawcy.
Mapowanie kategorii i atrybutów łączy parametry Allegro z taksonomiami oraz atrybutami WooCommerce, a API podpowiada dostępne wartości.
Marże i przeliczniki cen można definiować osobno dla kategorii Allegro, podobnie jak szablony opisów.
Walidacja przed wysyłką wykrywa braki zanim oferta trafi do kolejki eksportu.
Oferta i synchronizacja
Po przygotowaniu danych oferta trafia do kolejki eksportu i jest wysyłana do Allegro w kontrolowanych paczkach.
Dwukierunkowa synchronizacja przekazuje zmiany stanów i cen ze sklepu do Allegro, a aktualizacje z Allegro wracają do WooCommerce.
Każda zmiana jest zlecana jako komenda, a osobne zadanie weryfikuje jej rzeczywisty wynik po stronie Allegro.
Cykliczne odświeżanie aktywnych ofert wiąże je z produktami sklepu i ogranicza ryzyko rozbieżności.
Zamówienia i opinie
Zamówienia z Allegro są importowane co 5 minut przez strumień zdarzeń oraz dobową synchronizację kontrolną.
Do WooCommerce trafiają dane kupującego, adres, dane do faktury, rabaty i forma płatności.
Własna metoda płatności oraz mapowanie statusów działają w obie strony, z uwzględnieniem etapów realizacji Allegro, takich jak READY_FOR_PROCESSING, SENT i PICKED_UP.
Numery przesyłek i przewoźników można przekazywać bezpośrednio z ekranu zamówienia, a opinie sprzedawcy i produktów publikować jako recenzje WooCommerce.
Automatyzacja i kolejki
Operacje Allegro i WooCommerce są wykonywane przez zadania CRON, każde z limitem paczki, zapamiętanym postępem i odpornością na przerwanie.
Asynchroniczny command pattern rozdziela zlecenie zmiany ceny, stanu lub statusu od późniejszej weryfikacji rezultatu.
Dzięki temu katalog liczący dziesiątki tysięcy produktów może synchronizować się bez przekraczania limitów API i czasu wykonania PHP.
Panel, diagnostyka i utrzymanie
Panel administracyjny ma układ inspirowany CommerceKit: stałą belkę, ciemne menu boczne, kolumnę opisu sekcji oraz spójne formularze.
Ekran diagnostyczny raportuje stan wtyczki bazowej, zamówień, opinii, produktów i środowiska bez zgadywania — brak danych jest ostrzeżeniem, nie błędem.
Całość wspierają komunikaty czytelne dla użytkownika, kontrola wymagań środowiska, tłumaczenia gettext oraz regularne wydania i wsparcie techniczne.
WooCommerce Allegro PRO — architektura gotowa na skalę
Asynchroniczne komendy Allegro
Allegro przyjmuje zmianę ceny, stanu lub statusu jako komendę i zwraca jej identyfikator.
Osobne zadania kolejki weryfikują wynik, dzięki czemu sklep wie, czy operacja faktycznie została wykonana.
Skala i limity API
Zadania CRON przetwarzają katalog paczkami i zapamiętują postęp.
Dziesiątki tysięcy produktów mogą synchronizować się bez przekraczania limitów API i czasu wykonania PHP.
Zmieniające się API bez przerw w pracy
Wycofywane endpointy i nowe pola odpowiedzi są obsługiwane defensywnie.
Brakujący klucz nie przerywa importu, a użytkownik otrzymuje czytelny komunikat zamiast błędu PHP.
Własna architektura MVC
Mikroframework zbudowany nad WordPressem rozdziela kontrolery, serwisy, modele, formularze, tabele i zadania Cron.
Wtyczka działa bez zewnętrznych zależności kompozytowych i upraszcza dystrybucję na hostingu współdzielonym.
Własne dane i migracje
Własny ORM mapuje modele na tabele MySQL/MariaDB, a wersjonowane migracje bezpiecznie rozwijają schemat.
Przejście na utf8mb4 pozwala zapisywać pełne opisy, także z emoji.
Wiele kont sprzedawcy
OAuth 2.0 obsługuje authorization code, automatyczne odświeżanie tokenów i równoległą pracę z wieloma kontami Allegro.
Odporność zadań w tle
Każde zadanie ma limit paczki, zapamiętany postęp i możliwość wznowienia po przerwaniu.
Błąd pojedynczej operacji nie blokuje całej synchronizacji katalogu.
Spójność stanów, cen i statusów
Zmiana w WooCommerce zleca aktualizację w Allegro, a zmiana na Allegro wraca do sklepu.
Mechanizm weryfikacji i cykliczne odświeżanie aktywnych ofert ograniczają ryzyko rozbieżności.
Kontrola jakości i uprawnień
Walidacja działa po stronie klienta i serwera, a każde wywołanie AJAX wymaga nonce oraz uprawnienia manage_woocommerce.
Diagnostyka pokazuje realny stan wtyczki bazowej, produktów, zamówień, opinii i środowiska.
Zamówienia i opinie z Allegro
Import co 5 minut przenosi zamówienia, dane kupującego, adres, fakturę, rabaty i płatność do WooCommerce.
Opinie o sprzedawcy i produktach mogą być publikowane jako recenzje WooCommerce.
Długoterminowe utrzymanie
Produkt komercyjny pozostaje w ciągłym rozwoju: regularne wydania, raporty zmian, instrukcja użytkownika i wsparcie techniczne.
Aktualna wersja 2.7.40 wspiera PHP 7.4–8.x, WordPress 4.0+ i WooCommerce 5.0+.
Technologia
Stos dopasowany do integracji marketplace
Backend działa w PHP 7.4–8.x w oparciu o OOP, strict_types w nowszych serwisach i WordPress Plugin API.
Integracja wykorzystuje WooCommerce API, Allegro REST API i OAuth 2.0 z automatycznym odświeżaniem tokenów oraz obsługą wielu kont sprzedawcy.
Dane są przechowywane w MySQL/MariaDB przez $wpdb, z własnym lekkim ORM, wersjonowanymi migracjami i utf8mb4 z porównaniem binarnym.
Panel korzysta z PHTML, jQuery, Select2, jQuery UI, AJAX z nonce, CSS Grid, custom properties i Bootstrapa.
Bezpieczeństwo, jakość i kontrola danych
Formularze są walidowane po stronie klienta i serwera, a każdy endpoint AJAX wymaga nonce i uprawnienia manage_woocommerce.
Pełne tłumaczenie PL wykorzystuje gettext (.po/.mo), a ekran diagnostyczny pomaga szybko sprawdzić stan podsystemów.
Defensywna obsługa zmieniającego się API nie przerywa importu przy brakujących polach, tylko przekazuje użytkownikowi zrozumiały komunikat.
Wtyczka bazowa jest wykrywana bezpiecznie, a wersja PRO kontroluje zgodność jej wersji przed uruchomieniem zależności.
Proces dopasowany do ograniczeń środowiska
Wtyczka działa bez zewnętrznych zależności kompozytowych, co upraszcza dystrybucję i wsparcie na hostingach współdzielonych.
Własny mikroframework MVC nad WordPressem ładuje serwisy, modele i kontrolery leniwie po nazwie.
Wersjonowane migracje bezpiecznie rozwijają schemat danych, a zadania kolejkowe dzielą pracę na paczki z możliwością wznowienia.
Od produktu do zamówienia w jednym ekosystemie
WooCommerce Allegro PRO łączy wystawianie ofert, synchronizację cen i stanów, import zamówień, przekazywanie przesyłek oraz obsługę opinii.
Architektura obejmuje kontrolery ekranów, serwisy komunikacji z Allegro i WooCommerce, modele własnych tabel, deklaratywne formularze, listy WP_List_Table oraz zadania Cron.
Własne tabele SQL, migracje, kontrola uprawnień i komunikaty diagnostyczne zapewniają przewidywalne działanie w codziennej pracy sklepu.
Efektem jest rozwijana długoterminowo wtyczka, która automatyzuje sprzedaż wielokanałową bez utraty kontroli nad danymi.