Intégration WordPress OLX

Dokumentacja CC WordPress OLX Integration

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

Table des matières

1. Introduction
2. Installation
3. Activation de la licence
4. Pulpit główny
5. Integracja z produktami
6. Zarządzanie listą ogłoszeń
7. Ustawienia API
8. Zarządzanie lokalizacjami
9. Résolution de problèmes
10. FAQ

1. Introduction

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

Exigences du système

• WordPress 5.0 ou supérieur
• WooCommerce 3.0 ou plus récent
• PHP 7.0 ou plus récent

Processus d'installation

1. Pobierz plik ZIP wtyczki z oficjalnego sklepu cocos.codes
2. Se connecter au panneau d'administration de WordPress
3. Allez à : Plugins > Ajouter un nouveau plugin > Soumettre un plugin
4. Wybierz pobrany plik ZIP i kliknij „Zainstaluj teraz”
5. Po zakończeniu instalacji kliknij „Włącz wtyczkę”

3. Activation de la licence

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. Saisir la clé de licence reçue après l'achat
4. Cliquez sur "Activer la licence"
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. Cochez l'option "Activer l'intégration OLX pour ce produit".
4. Wypełnij formularz danych ogłoszenia
5. Zapisz dane produktu klikając przycisk „Aktualizuj”

Konfiguracja ogłoszenia

• Titre de la demande – domyślnie taki sam jak nazwa produktu (wymaga 16-70 znaków)
• Description de l'annonce – domyślnie opis produktu (wymaga 80-9000 znaków)
• Catégorie 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ń

• Nom du produit
• ID ogłoszenia (z linkiem do ogłoszenia na OLX)
• Status ogłoszenia
• Catégorie OLX
• Data utworzenia
• Data wygaśnięcia
• Cena
• Actions disponibles

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

• Identifiant du client – identyfikator klienta otrzymany od OLX
• Secret du client – tajny klucz klienta otrzymany od OLX
• URI de redirection – adres do autoryzacji (domyślnie ustawiony)
• URL de l'API de base – adres API OLX (domyślnie: https://www.olx.pl)

Domyślne wartości ogłoszeń

• Ville par défaut – lokalizacja używana dla nowych ogłoszeń
• Domyślna dzielnica – dzielnica używana dla nowych ogłoszeń
• Numéro de téléphone par défaut – numer kontaktowy do ogłoszeń
• Nom par défaut / nom de l'entreprise – nazwa kontaktu do ogłoszeń
• Type de compte par défaut – prywatne lub firmowe
• Devise par défaut – waluta używana w ogłoszeniach (PLN, EUR, USD)
• Titre de l'annonce – tekst dodawany na początku opisu
• Pied de page – 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: Données de localisation

• 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. Vérifiez que le titre et la description respectent les exigences de longueur (titre : 16-70 caractères, description : 80-9000 caractères).
5. Assurez-vous que la catégorie OLX sélectionnée est la catégorie finale (pas de sous-catégories).

Błędy walidacji danych

1. Vérifiez que tous les attributs requis pour la catégorie sélectionnée ont été remplis.
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/