WordPress OLX-Integration

Dokumentacja CC WordPress OLX Integration

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

Inhaltsübersicht

1. Einführung
2. Einrichtung
3. Aktivierung der Lizenz
4. Pulpit główny
5. Integracja z produktami
6. Zarządzanie listą ogłoszeń
7. Ustawienia API
8. Zarządzanie lokalizacjami
9. Lösung von Problemen
10. FAQ

1. Einleitung

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. Einbau

Systemanforderungen

• WordPress 5.0 oder höher
• WooCommerce 3.0 oder höher
• PHP 7.0 oder höher

Einbauverfahren

1. Pobierz plik ZIP wtyczki z oficjalnego sklepu cocos.codes
2. Loggen Sie sich in das WordPress-Administrationspanel ein
3. Gehen Sie zu: Plugins > Neu hinzufügen > Plugin einreichen
4. Wybierz pobrany plik ZIP i kliknij „Zainstaluj teraz”
5. Po zakończeniu instalacji kliknij „Włącz wtyczkę”

3. die Aktivierung der Lizenz

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. Geben Sie den nach dem Kauf erhaltenen Lizenzschlüssel ein
4. Klicken Sie auf "Lizenz aktivieren".
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. Aktivieren Sie die Option "OLX-Integration für dieses Produkt aktivieren".
4. Wypełnij formularz danych ogłoszenia
5. Zapisz dane produktu klikając przycisk „Aktualizuj”

Konfiguracja ogłoszenia

• Titel der Forderung – domyślnie taki sam jak nazwa produktu (wymaga 16-70 znaków)
• Beschreibung der Anzeige – domyślnie opis produktu (wymaga 80-9000 znaków)
• OLX-Kategorie – 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ń

• Name des Produkts
• ID ogłoszenia (z linkiem do ogłoszenia na OLX)
• Status ogłoszenia
• OLX-Kategorie
• Data utworzenia
• Data wygaśnięcia
• Cena
• Verfügbare Aktionen

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

• Kunden-ID – identyfikator klienta otrzymany od OLX
• Geheimnis des Kunden – tajny klucz klienta otrzymany od OLX
• Umleitung URI – adres do autoryzacji (domyślnie ustawiony)
• Basis-API-URL – adres API OLX (domyślnie: https://www.olx.pl)

Domyślne wartości ogłoszeń

• Standard-Stadt – lokalizacja używana dla nowych ogłoszeń
• Domyślna dzielnica – dzielnica używana dla nowych ogłoszeń
• Standard-Telefonnummer – numer kontaktowy do ogłoszeń
• Standardname / Firmenname – nazwa kontaktu do ogłoszeń
• Standard-Kontotyp – prywatne lub firmowe
• Standardwährung – waluta używana w ogłoszeniach (PLN, EUR, USD)
• Überschrift der Ankündigung – tekst dodawany na początku opisu
• Fußzeile – 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: Standortdaten

• 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. Überprüfen Sie, ob der Titel und die Beschreibung den Längenanforderungen entsprechen (Titel: 16-70 Zeichen, Beschreibung: 80-9000 Zeichen)
5. Stellen Sie sicher, dass die ausgewählte OLX-Kategorie die letzte Kategorie ist (keine Unterkategorien)

Błędy walidacji danych

1. Überprüfen Sie, ob alle erforderlichen Attribute für die ausgewählte Kategorie ausgefüllt wurden.
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/