CC Documentation sur l'intégration WordPress OLX
Documentation complète pour un plug-in qui permet l'intégration de WooCommerce avec la plateforme OLX (cc_wordpress_olx_integration).Table des matières
- Introduction
- Installation
- Activation de la licence
- Bureau principal
- Intégration des produits
- Gestion de la liste de publicité
- Paramètres de l'API
- Gestion des emplacements
- Résolution de problèmes
- FAQ
1. Introduction
CC WordPress OLX Integration est un plugin professionnel pour WordPress qui permet l'intégration complète de votre boutique WooCommerce avec la plateforme OLX. Il vous permet de publier, mettre à jour et gérer vos annonces directement depuis le panneau d'administration de WordPress, sans avoir à vous connecter au panneau OLX.Le plug-in permet un contrôle total sur :
- Création et publication d'annonces OLX basées sur des produits WooCommerce
- Mise à jour des annonces suite à des changements de produits
- Gestion du statut des annonces (activation, désactivation)
- Suivi des statistiques publicitaires
- Synchronisation automatique des lieux (villes, quartiers)
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
- Télécharger le fichier ZIP du plug-in depuis la boutique officielle cocos.codes
- Se connecter au panneau d'administration de WordPress
- Allez à : Plugins > Ajouter un nouveau plugin > Soumettre un plugin
- Sélectionnez le fichier ZIP téléchargé et cliquez sur "Installer maintenant"
- Une fois l'installation terminée, cliquez sur "Activer le plug-in"
Info
Le plugin nécessite un WooCommerce actif. Si WooCommerce n'est pas installé ou activé, le plugin affichera un message correspondant.
3. Activation de la licence
Il est nécessaire d'activer la licence avant d'utiliser le plug-in :- Après l'installation, un nouvel élément de menu "Intégration OLX" apparaît.
- Allez dans l'onglet Intégration OLX > Licence
- Saisir la clé de licence reçue après l'achat
- Cliquez sur "Activer la licence"
- Une fois l'activation réussie, un message de confirmation s'affiche et toutes les fonctions du plug-in sont déverrouillées.
Avertissement
Sans licence active, le plug-in fonctionnera en mode limité, sans possibilité de publier et de gérer des annonces sur OLX.
4 Bureau principal
Le tableau de bord principal du plug-in contient des informations et des statistiques clés : Panel de statistiques- Nombre total d'annonces
- Nombre d'annonces actives
- Nombre d'annonces en attente
- Nombre d'annonces inactives
- Nouvelles annonces
- Avis non payés
- Annonces non confirmées
- Voir toutes les annonces - rediriger vers la liste des annonces
- Ajouter une nouvelle annonce - redirection pour ajouter des produits WooCommerce
Conseil
Le panneau des statistiques donne un aperçu rapide de l'état des annonces. Le graphique montre le pourcentage d'annonces avec différents statuts.
5. l'intégration des produits
L'intégration avec les produits WooCommerce se fait via un panneau supplémentaire dans l'édition du produit : Permettre l'intégration des produits- Allez éditer votre produit WooCommerce (Produits > Editer)
- Localisez la section "Intégration avec OLX" sous la description du produit.
- Cochez l'option "Activer l'intégration OLX pour ce produit".
- Remplir le formulaire de données publicitaires
- Enregistrez les données du produit en cliquant sur le bouton "Mise à jour".
- Titre de la demande - le même que le nom du produit par défaut (nécessite 16-70 caractères)
- Description de l'annonce - description du produit par défaut (80-9000 caractères)
- Catégorie OLX - Sélection de la catégorie OLX pour l'annonce
- Attributs de catégorie - des champs supplémentaires spécifiques à la catégorie sélectionnée
- Type de compte - privé ou entreprise
- Coordonnées de la personne à contacter - nom de l'entreprise et numéro de téléphone
- Localisation - ville et éventuellement district
- Prix - valeur, devise et option "négociable
- Bouton "Publier sur OLX" - pour les nouvelles annonces
- Bouton "Mettre à jour l'annonce" - pour les annonces existantes
- Bouton "Désactiver l'annonce" pour les annonces actives
- Bouton "Activer l'annonce" - pour les annonces inactives
- Bouton "Supprimer l'annonce" - suppression complète d'une annonce d'OLX
Note
Les photos du produit sont automatiquement utilisées dans l'annonce OLX. Les 8 premières photos de la galerie de produits seront envoyées à OLX.
6. la gestion de la liste des avis
L'onglet "Liste des annonces" vous permet de visualiser et de gérer toutes vos annonces : Filtrage des annonces
- Par catégorie de produits
- Selon le statut de l'annonce
- Par date (du au)
- Recherche de texte
- Nom du produit
- ID de l'annonce (avec lien vers l'annonce sur OLX)
- Statut de l'annonce
- Catégorie OLX
- Date de création
- Date d'expiration
- Prix
- Actions disponibles
- Désactivation de l'annonce
- Activation de la publicité
- Suppression de l'avis
- Actualisation du statut
Conseil
Les annonces qui expirent dans les trois prochains jours sont signalées par un message d'avertissement spécial.
7 Paramètres de l'API
Dans l'onglet "Paramètres", vous pouvez configurer la connexion à l'API OLX et les valeurs par défaut pour les annonces : Paramètres de l'API OLX- Identifiant du client - ID client reçu de OLX
- Secret du client - clé client secrète reçue d'OLX
- URI de redirection - adresse d'autorisation (réglage par défaut)
- URL de l'API de base - Adresse API OLX (par défaut : https://www.olx.pl)
- Ville par défaut - lieu utilisé pour les nouvelles annonces
- Quartier par défaut - quartier utilisé pour les nouvelles annonces
- Numéro de téléphone par défaut - numéro de contact pour les annonces
- Nom par défaut / nom de l'entreprise - nom de la personne à contacter pour les annonces
- Type de compte par défaut - privé ou entreprise
- Devise par défaut - la devise utilisée dans les publicités (PLN, EUR, USD)
- Titre de l'annonce - texte ajouté au début de la description
- Pied de page - texte ajouté à la fin de la description
- Activer l'en-tête/pied de page automatique - l'inclusion ou non de ces éléments dans les descriptions
Succès
Une fois que vous avez réussi à vous connecter à l'API OLX, vous verrez le message "Connected to OLX API. Le jeton d'accès est valide."
8. gestion du site
L'onglet "Emplacements" permet de synchroniser les données d'emplacement avec OLX : Données de localisation- Régions/provinces
- Villes
- Districts
- Synchronisation des régions
- Synchronisation des villes (processus progressif)
- Synchronisation des districts (pour chaque ville)
Info
La synchronisation des emplacements permet de stocker les données relatives aux villes et aux quartiers dans une base de données locale, ce qui rend le plug-in beaucoup plus rapide.
Par défaut, le plug-in dispose d'une base de données préinstallée, de sorte qu'aucune synchronisation des villes n'est nécessaire.
Par défaut, le plug-in dispose d'une base de données préinstallée, de sorte qu'aucune synchronisation des villes n'est nécessaire.
9 Dépannage
L'annonce n'est pas publiée sur OLX- Vérifier que la licence est active
- S'assurer que les données de l'API (identifiant et secret du client) sont correctes.
- Vérifier que tous les champs obligatoires du formulaire d'annonce sont remplis.
- Vérifiez que le titre et la description respectent les exigences de longueur (titre : 16-70 caractères, description : 80-9000 caractères).
- Assurez-vous que la catégorie OLX sélectionnée est la catégorie finale (pas de sous-catégories).
- Vérifiez que tous les attributs requis pour la catégorie sélectionnée ont été remplis.
- Assurez-vous que le prix est un nombre supérieur à zéro.
- Vérifier l'exactitude du numéro de téléphone
- Vérifier la connexion à l'API OLX
- S'assurer que le jeton d'accès est valide
- Vérifier les droits d'écriture de la base de données
Erreur
S'il y a des erreurs de communication avec l'API OLX, assurez-vous que vos paramètres API sont corrects et que vous avez un compte actif sur la plateforme OLX avec des permissions API.
10. LA FAQ
Le plug-in fonctionne-t-il sans WooCommerce ?Non, le plugin nécessite un WooCommerce actif car il s'appuie sur les produits WooCommerce comme source de données pour les annonces.
Combien d'annonces puis-je publier sur OLX ?
Le nombre d'annonces dépend de votre plan sur la plateforme OLX, pas du plug-in.
Puis-je utiliser le plug-in pour plusieurs boutiques ?
Oui, chaque licence vous permet d'utiliser le plugin sur une installation WordPress. Vous avez besoin de licences séparées pour plusieurs boutiques.
Le plug-in met-il automatiquement à jour les annonces lorsque le produit change ?
Non, vous devez cliquer manuellement sur "Mettre à jour l'annonce" après avoir apporté des modifications au produit.
Qu'advient-il de l'annonce lorsque le produit est épuisé ?
Le plugin ne désactive pas automatiquement les publicités. Vous pouvez configurer une fonction qui vérifiera le stock et désactivera les publicités pour les produits épuisés.
Puis-je avoir des paramètres différents pour des publicités différentes ?
Oui, chaque produit peut avoir des paramètres publicitaires individuels, indépendamment des paramètres par défaut.
Le plug-in prend-il en charge les variantes de produits ?
Oui, pour les produits à variantes, vous pouvez créer des annonces contenant toutes les variantes disponibles.
Ai-je besoin d'un compte spécial sur OLX pour utiliser le plug-in ?
Oui, vous avez besoin d'un compte avec accès à l'API OLX. Contactez le support OLX pour obtenir les données d'accès à l'API à travers la plateforme. https://developer.olx.pl/
Conseil
Si vous rencontrez des problèmes avec le plug-in ou si vous avez des questions sur son fonctionnement, consultez la page d'assistance à l'adresse suivante cocos.codes/support.
