WooCommerce OLX – integracja sklepu z OLX – instrukcja i historia zmian

Aktualna wersja: 0.2.1 · Ostatnia aktualizacja: 2026-11-03 · Wymaga: WordPress 6.4+, WooCommerce 8.5+, PHP 7.4+ · Nazwa w panelu: wpAsist OLX for WooCommerce · Strona wtyczki ›

Do czego służy wtyczka

Integracja WooCommerce z OLX. Produkty ze sklepu stają się ogłoszeniami na OLX, a cena i dostępność same zgadzają się w obu miejscach: zmiana w sklepie aktualizuje ogłoszenie, brak towaru wyłącza ogłoszenie, dostawa włącza je z powrotem. Obsługuje OLX w Polsce, Rumunii, Bułgarii, Portugalii, Ukrainie i Kazachstanie.

Co potrafi

Konta OLX

• Kilka kont w jednym sklepie; każde konto to jeden serwis OLX (olx.pl, olx.ro, olx.bg, olx.pt, olx.ua, olx.kz) z własną walutą.
• Logowanie przyciskiem „Połącz z OLX”, test połączenia (konto i waluta), tokeny odświeżane codziennie w tle – sklep nie rozłącza się po miesiącu.

Ogłoszenia z produktów

• Wystawianie z listy produktów (działania masowe i link „Wystaw na OLX”) albo z zakładki OLX w produkcie.
• Produkty z wariantami: każdy wariant to osobne ogłoszenie z własną ceną, zdjęciem i parametrami.
• Tytuł i opis ze wzorów ze znacznikami; opis zamieniany na zwykły tekst; e-maile i numery telefonów usuwane, bo OLX ich nie przyjmuje.
• Zdjęcia produktu (wariant, zdjęcie główne, galeria) do limitu kategorii OLX.
• Miasto i dzielnica, nazwa i telefon kontaktowy, typ ogłoszeniodawcy, „cena do negocjacji”, automatyczne przedłużanie przez OLX.

Efekt: ogłoszenie powstaje z danych, które już masz w sklepie.

Kategorie i parametry

• Lista kategorii OLX pobierana dla każdego serwisu; przy kategoriach sklepu wpisujesz początek nazwy i wybierasz z podpowiedzi.
• Domyślna kategoria dla produktów z niezmapowanych kategorii; własna kategoria w produkcie wygrywa.
• Parametry OLX: automatycznie z atrybutu o tej samej nazwie, ze wskazanego atrybutu, SKU, EAN albo stała wartość; wartości dopasowane do listy OLX.

Sprawdzenie przed wysłaniem

• Kategoria, tytuł (16–150 znaków), opis (od 80 znaków), wielkie litery, miasto, cena, kurs waluty i wymagane parametry – braki opisane po polsku przy produkcie.
• Przycisk „Sprawdź (bez wysyłania)” w produkcie.

Synchronizacja

• Zmiana ceny lub stanu w sklepie aktualizuje ogłoszenie w tle.
• Brak na stanie: ogłoszenie się wyłącza; po dostawie włącza się to samo ogłoszenie.
• OLX Polska z Przesyłką OLX (Pay & Ship): prawdziwa liczba sztuk na sprzedaż (do 1000).
• Status, link i data ważności odświeżane regularnie.

Lista ogłoszeń

• Ekran „Ogłoszenia OLX”: status, data ważności, link, wysłana cena i ilość, błędy; widoki (aktywne, w toku, wyłączone, do poprawy) i wyszukiwarka.
• Działania: aktualizuj, aktywuj, wyłącz, przedłuż, odśwież, usuń z OLX.

Dobrze wiedzieć

• Ceny: jak w sklepie albo z narzutem, kwotą stałą, zaokrągleniem i regułami dla kategorii; dla serwisów w innej walucie ustawiasz kurs.
• Sklepy wielojęzyczne: treść ogłoszeń z wybranej wersji językowej (WPML, Polylang).
• Dane bezpieczeństwa produktu (GPSR) dla OLX w Polsce i Rumunii.
• Działa razem z wtyczką WooCommerce Allegro: przy obu masz jeden panel, jeden pulpit i jeden dziennik, każda z własną licencją.
• Oficjalne API OLX, klucze zapisane w formie zaszyfrowanej. Zgodna z HPOS.

Instalacja i pierwsze ustawienia

Zanim zaczniesz

Potrzebujesz WordPressa 6.4+, WooCommerce 8.5+, PHP 7.4+ i konta administratora. Na OLX: konto (najlepiej firmowe) w kraju, w którym chcesz sprzedawać. W sklepie: produkty z ceną, stanem, zdjęciem i opisem (co najmniej 80 znaków). Przed instalacją nowej wtyczki zrób kopię zapasową sklepu.

Krok 1: pobierz wtyczkę i klucz licencji

Po zamówieniu (Pro albo darmowej wersji Free na 10 dni) dostajesz e-mail z kluczem licencji i przyciskiem Pobierz. Klucz i plik są zawsze w Moje konto → Licencje na wpasist.eu.

1. Kliknij Pobierz i zapisz wpasist-olx-for-woocommerce.zip na komputerze.
2. Nie rozpakowuj pliku – WordPress instaluje wtyczkę prosto z ZIP-a.

Safari na Macu potrafi samo rozpakować pobrany plik. Jeśli zamiast ZIP-a widzisz folder, spakuj go ponownie (prawy przycisk → Kompresuj).

Krok 2: zainstaluj i włącz wtyczkę

1. Zaloguj się do panelu WordPressa.
2. Wejdź w Wtyczki → Dodaj wtyczkę i kliknij Wyślij wtyczkę na serwer.
3. Wybierz wpasist-olx-for-woocommerce.zip i kliknij Zainstaluj, potem Włącz wtyczkę.

Efekt: w lewym menu jest wpAsist → OLX. Jeśli masz też wtyczkę WooCommerce Allegro, OLX jest zakładką w wpAsist → Marketplace Hub.

Krok 3: aktywuj licencję

1. Wejdź w wpAsist → Licencje.
2. Przy wtyczce wklej klucz z e-maila i kliknij Aktywuj licencję.
3. Status zmieni się na Aktywna do ….

Bez aktywnej licencji możesz wszystko ustawić, ale nic nie jest wysyłane na OLX. Klucz działa na jednej domenie; zmienisz ją sam w Moje konto → Licencje → Zmień domenę. Nowe wersje przychodzą w Kokpit → Aktualizacje, dopóki licencja jest aktywna.

Krok 4: załóż aplikację na portalu deweloperskim OLX

1. W wtyczce wejdź w OLX → Konta OLX i skopiuj adres z punktu „URI wywołania zwrotnego” (kończy się na admin-post.php?action=wpasist_olx_oauth).
2. Zaloguj się kontem OLX na portalu swojego kraju: developer.olx.pl, developer.olx.ro, developer.olx.bg, developer.olx.pt …
3. Dodaj aplikację: nazwa (np. „Sklep – OLX”), adres strony sklepu, w URI wywołania zwrotnego wklej skopiowany adres, w opisie napisz, że to integracja sklepu WooCommerce z Twoim kontem OLX.
4. OLX sprawdza aplikację (zwykle kilka dni roboczych) i wysyła Client ID oraz Client Secret e-mailem.

Krok 5: połącz konto OLX

1. W OLX → Konta OLX kliknij + Dodaj konto OLX, wybierz serwis (np. olx.pl – Polska), wpisz nazwę dla siebie, Client ID i Client Secret i kliknij Dodaj konto.
2. Kliknij Połącz z OLX, zaloguj się na OLX i zezwól na dostęp.
3. Kliknij Testuj połączenie – zobaczysz konto i walutę serwisu.

Krok 6: kategorie i parametry

1. Wejdź w OLX → Kategorie i parametry i kliknij Pobierz kategorie OLX.
2. Przy kategoriach sklepu zacznij wpisywać nazwę kategorii OLX i wybierz pełną ścieżkę z podpowiedzi. Podkategorie sklepu bez własnego wpisu biorą kategorię nadrzędnej.
3. Opcjonalnie ustaw Domyślną kategorię OLX dla pozostałych produktów i zapisz.
4. Niżej pojawią się parametry zmapowanych kategorii. Dla każdego wybierz źródło; pola z * są wymagane. Przykład: „Stan” → Stała wartość → „Nowe”.

OLX przyjmuje ogłoszenia tylko w ostatnim poziomie drzewa kategorii – podpowiedzi pokazują wyłącznie takie kategorie.

Krok 7: treść ogłoszenia, miasto i ceny

1. OLX → Treść ogłoszenia: wzór tytułu (np. {name}), wzór opisu (np. {description} i {attributes}), maksymalna liczba zdjęć.
2. Nazwa i telefon kontaktowy, typ ogłoszeniodawcy, „Cena do negocjacji”, „Przedłużaj ogłoszenia automatycznie”.
3. Lokalizacja i serwis: wpisz miasto tak jak na OLX (np. „Rzeszów”) i zapisz – pod polem pojawi się „Znaleziono na OLX”. W dużych miastach wybierz dzielnicę.
4. Sklep w innej walucie niż serwis (np. sklep w PLN, olx.ro w RON)? Ustaw kurs. Na olx.pl możesz zaznaczyć paczki Przesyłki OLX.
5. OLX → Ceny, VAT i reguły: narzut, kwota stała, zaokrąglenie i reguły dla kategorii.

Krok 8: włącz sprzedaż i wystaw pierwszy produkt

1. OLX → Sprzedaż i synchronizacja: włącz sprzedaż, zostaw synchronizację stanów i cen, zapisz.
2. Otwórz jeden produkt, zakładka OLX, kliknij Sprawdź (bez wysyłania). Popraw to, co wtyczka wskaże.
3. Kliknij Wystaw na OLX teraz. Ogłoszenie przechodzi moderację OLX (zwykle kilka sekund) i pojawia się w OLX → Ogłoszenia OLX.
4. Pozostałe produkty: Produkty → zaznacz → Wystaw / zaktualizuj na OLX. Ogłoszenia wysyłają się w tle.

Rozwiązywanie problemów

• „Limit wykorzystany – potrzebny pakiet” – w tej kategorii skończyły się darmowe ogłoszenia OLX. Kup pakiet na OLX i kliknij Aktywuj przy ogłoszeniu.
• „Brak parametru OLX …” – ustaw źródło parametru w Kategoriach i parametrach albo uzupełnij atrybut produktu; wartość musi pasować do listy OLX.
• „Tytuł / opis jest za krótki” – dodaj szczegóły do wzoru (np. {name} {brand}) albo do opisu produktu.
• „OLX nie zna miasta” – wpisz nazwę jak na OLX; przy powtarzających się nazwach dopisz powiat po przecinku.
• Konto się rozłączyło – sprawdź, czy w Automatyzacji i logach działa praca w tle, i połącz konto jeszcze raz.
• Odrzucone przez moderację – OLX nie przyjął treści; popraw tytuł, opis lub zdjęcia zgodnie z zasadami OLX i kliknij Aktualizuj.

Pomoc: help@wpasist.eu oraz komentarze pod tą instrukcją (dla zalogowanych klientów).

Historia zmian

0.2.1 – 2026-11-03

• Link do strony wtyczki i zakupu licencji prowadzi do strony WooCommerce OLX na wpasist.eu.

0.2.0

• Ogłoszenia z produktów (warianty osobno), zdjęcia, wzory tytułu i opisu, lokalizacja, kontakt, przedłużanie.
• Kategorie i parametry z podpowiedziami, sprawdzenie przed wysłaniem.
• Ekran „Ogłoszenia OLX”, zakładka OLX w produkcie, kolumna i działania masowe.
• Synchronizacja ceny i stanu, wyłączanie i włączanie przy braku towaru, Przesyłka OLX z liczbą sztuk, GPSR.

0.1.1

• Ustawienia stanów i przyciski „Więcej” podają OLX zamiast Allegro.

0.1.0

• Pierwsza wersja: konta OLX dla 6 krajów, logowanie przez OLX, odświeżanie tokenów, test połączenia, wspólne ustawienia sprzedaży i cen.

Forum dla klientów

Pytaj, zanim się zirytujesz 🙂

Problem po instalacji? Coś niejasne w instrukcji? Tu nie ma głupich pytań, są tylko sklepy, które jeszcze nie działają tak, jak powinny. Odpisujemy osobiście, zwykle tego samego dnia.

Forum dostępne tylko dla klientów. Zaloguj się albo kup wtyczkę, żeby rozwinąć swój sklep razem z nami i móc zadawać pytania i otrzymać wsparcie.

Zaloguj się