Integracja WordPress OLX

Dokumentacja CC WordPress OLX Integration

Kompleksowa dokumentacja dla wtyczki umożliwiającej integrację WooCommerce z platformą OLX (cc_wordpress_olx_integration).

Spis treści

1. Wprowadzenie
2. Instalacja
3. Aktywacja licencji
4. Pulpit główny
5. Integracja z produktami
6. Zarządzanie listą ogłoszeń
7. Ustawienia API
8. Zarządzanie lokalizacjami
9. Rozwiązywanie problemów
10. FAQ

1. Wprowadzenie

CC WordPress OLX Integration to profesjonalna wtyczka dla WordPress umożliwiająca pełną integrację sklepu WooCommerce z platformą OLX. Pozwala na publikowanie, aktualizowanie i zarządzanie ogłoszeniami bezpośrednio z panelu administratora WordPress, bez konieczności logowania się do panelu OLX.

Wtyczka pozwala na pełną kontrolę nad:

• Tworzeniem i publikowaniem ogłoszeń OLX na podstawie produktów WooCommerce
• Aktualizacją ogłoszeń po zmianach w produktach
• Zarządzaniem statusem ogłoszeń (aktywacja, dezaktywacja)
• Monitorowaniem statystyk ogłoszeń
• Automatycznym synchronizowaniem lokalizacji (miasta, dzielnice)

2. Instalacja

Wymagania systemowe

• WordPress 5.0 lub nowszy
• WooCommerce 3.0 lub nowszy
• PHP 7.0 lub nowszy

Proces instalacji

1. Pobierz plik ZIP wtyczki z oficjalnego sklepu cocos.codes
2. Zaloguj się do panelu administracyjnego WordPress
3. Przejdź do: Wtyczki > Dodaj nową > Wyślij wtyczkę
4. Wybierz pobrany plik ZIP i kliknij „Zainstaluj teraz”
5. Po zakończeniu instalacji kliknij „Włącz wtyczkę”

3. Aktywacja licencji

Przed rozpoczęciem korzystania z wtyczki konieczna jest aktywacja licencji:

1. Po instalacji w menu pojawi się nowa pozycja „Integracja OLX”
2. Przejdź do zakładki Integracja OLX > Licencja
3. Wprowadź klucz licencyjny otrzymany po zakupie
4. Kliknij „Aktywuj licencję”
5. Po pomyślnej aktywacji zobaczysz komunikat potwierdzający i odblokowane zostaną wszystkie funkcje wtyczki

4. Pulpit główny

Pulpit główny wtyczki zawiera najważniejsze informacje i statystyki: Panel statystyk

• Liczba ogłoszeń ogółem
• Liczba aktywnych ogłoszeń
• Liczba oczekujących ogłoszeń
• Liczba nieaktywnych ogłoszeń

Szczegóły ogłoszeń

• Nowe ogłoszenia
• Nieopłacone ogłoszenia
• Niepotwierdzone ogłoszenia

Szybkie akcje

• Zobacz wszystkie ogłoszenia – przekierowanie do listy ogłoszeń
• Dodaj nowe ogłoszenie – przekierowanie do dodawania produktów WooCommerce

5. Integracja z produktami

Integracja z produktami WooCommerce odbywa się za pomocą dodatkowego panelu w edycji produktu: Włączanie integracji dla produktu

1. Przejdź do edycji produktu WooCommerce (Produkty > Edytuj)
2. Zlokalizuj sekcję „Integracja z OLX” poniżej opisu produktu
3. Zaznacz opcję „Włącz integrację z OLX dla tego produktu”
4. Wypełnij formularz danych ogłoszenia
5. Zapisz dane produktu klikając przycisk „Aktualizuj”

Konfiguracja ogłoszenia

• Tytuł ogłoszenia – domyślnie taki sam jak nazwa produktu (wymaga 16-70 znaków)
• Opis ogłoszenia – domyślnie opis produktu (wymaga 80-9000 znaków)
• Kategoria OLX – wybór kategorii OLX dla ogłoszenia
• Atrybuty kategorii – dodatkowe pola specyficzne dla wybranej kategorii
• Typ konta – prywatne lub firmowe
• Dane kontaktowe – imię/nazwa firmy i numer telefonu
• Lokalizacja – miasto i opcjonalnie dzielnica
• Cena – wartość, waluta i opcja „do negocjacji”

Panel publikacji w bocznym menu

• Przycisk „Opublikuj na OLX” – dla nowych ogłoszeń
• Przycisk „Aktualizuj ogłoszenie” – dla istniejących ogłoszeń
• Przycisk „Dezaktywuj ogłoszenie” – dla aktywnych ogłoszeń
• Przycisk „Aktywuj ogłoszenie” – dla nieaktywnych ogłoszeń
• Przycisk „Usuń ogłoszenie” – całkowite usunięcie ogłoszenia z OLX

6. Zarządzanie listą ogłoszeń

Zakładka „Lista ogłoszeń” umożliwia przeglądanie i zarządzanie wszystkimi ogłoszeniami:

Filtrowanie ogłoszeń

• Według kategorii produktów
• Według statusu ogłoszenia
• Według daty (od-do)
• Wyszukiwanie tekstowe

Tabela ogłoszeń

• Nazwa produktu
• ID ogłoszenia (z linkiem do ogłoszenia na OLX)
• Status ogłoszenia
• Kategoria OLX
• Data utworzenia
• Data wygaśnięcia
• Cena
• Dostępne akcje

Akcje dla ogłoszeń

• Dezaktywacja ogłoszenia
• Aktywacja ogłoszenia
• Usunięcie ogłoszenia
• Odświeżenie statusu

7. Ustawienia API

W zakładce „Ustawienia” można skonfigurować połączenie z API OLX oraz domyślne wartości dla ogłoszeń: Ustawienia API OLX

• Client ID – identyfikator klienta otrzymany od OLX
• Client Secret – tajny klucz klienta otrzymany od OLX
• URI przekierowania – adres do autoryzacji (domyślnie ustawiony)
• Bazowy URL API – adres API OLX (domyślnie: https://www.olx.pl)

Domyślne wartości ogłoszeń

• Domyślne miasto – lokalizacja używana dla nowych ogłoszeń
• Domyślna dzielnica – dzielnica używana dla nowych ogłoszeń
• Domyślny numer telefonu – numer kontaktowy do ogłoszeń
• Domyślne imię / nazwa firmy – nazwa kontaktu do ogłoszeń
• Domyślny typ konta – prywatne lub firmowe
• Domyślna waluta – waluta używana w ogłoszeniach (PLN, EUR, USD)
• Nagłówek ogłoszenia – tekst dodawany na początku opisu
• Stopka ogłoszenia – tekst dodawany na końcu opisu
• Włącz automatyczny nagłówek/stopkę – czy dołączać te elementy do opisów

8. Zarządzanie lokalizacjami

Zakładka „Lokalizacje” umożliwia synchronizację danych lokalizacyjnych z OLX: Dane lokalizacyjne

• Regiony/Województwa
• Miasta
• Dzielnice

Proces synchronizacji

1. Synchronizacja regionów
2. Synchronizacja miast (proces przyrostowy)
3. Synchronizacja dzielnic (dla każdego miasta)

9. Rozwiązywanie problemów

Ogłoszenie nie publikuje się na OLX

1. Sprawdź, czy licencja jest aktywna
2. Upewnij się, że dane API (Client ID i Client Secret) są poprawne
3. Sprawdź, czy wszystkie wymagane pola w formularzu ogłoszenia są wypełnione
4. Sprawdź, czy tytuł i opis spełniają wymagania długości (tytuł: 16-70 znaków, opis: 80-9000 znaków)
5. Upewnij się, że wybrana kategoria OLX jest kategorią końcową (bez podkategorii)

Błędy walidacji danych

1. Sprawdź, czy wszystkie wymagane atrybuty dla wybranej kategorii zostały wypełnione
2. Upewnij się, że cena jest liczbą większą od zera
3. Sprawdź poprawność numeru telefonu

Problemy z synchronizacją lokalizacji

1. Sprawdź połączenie z API OLX
2. Upewnij się, że token dostępu jest ważny
3. Sprawdź uprawnienia do zapisu w bazie danych

10. FAQ

Czy wtyczka działa bez WooCommerce?
Nie, wtyczka wymaga aktywnego WooCommerce, ponieważ opiera się na produktach WooCommerce jako źródle danych dla ogłoszeń.

Ile ogłoszeń mogę opublikować na OLX?
Liczba ogłoszeń zależy od twojego planu na platformie OLX, a nie od wtyczki.

Czy mogę używać wtyczki dla wielu sklepów?
Tak, każda licencja pozwala na użycie wtyczki na jednej instalacji WordPress. Dla wielu sklepów potrzebujesz osobnych licencji.

Czy wtyczka automatycznie aktualizuje ogłoszenia po zmianie produktu?
Nie, musisz ręcznie kliknąć „Aktualizuj ogłoszenie” po wprowadzeniu zmian w produkcie.

Co się stanie z ogłoszeniem, gdy produkt zostanie wyprzedany?
Wtyczka nie dezaktywuje automatycznie ogłoszeń. Możesz skonfigurować funkcję, która będzie sprawdzać stan magazynowy i dezaktywować ogłoszenia dla wyprzedanych produktów.

Czy mogę mieć różne ustawienia dla różnych ogłoszeń?
Tak, każdy produkt może mieć indywidualne ustawienia ogłoszenia, niezależne od ustawień domyślnych.

Czy wtyczka obsługuje warianty produktów?
Tak, dla produktów wariacyjnych możesz tworzyć ogłoszenia zawierające wszystkie dostępne warianty.

Czy potrzebuję specjalnego konta na OLX do korzystania z wtyczki?
Tak, potrzebujesz konta z dostępem do API OLX. Skontaktuj się z obsługą OLX, aby uzyskać dane dostępowe do API poprzez platformę https://developer.olx.pl/