Murelh Ntyandi

Developpeur Web

Hiboutik Sync

Publié le

Dernière version 1 : v 1.0

 

Documentaiton et téléchargement sur mon compte Github:

 

Pour toute question veuillez utiliser l'espace des commentaires en bas de page !

 

Tuto/Démo

Voici un tutoriel qui montre comment fonctionne le plugin.

Pour ce tuto, j'ai créé un site Wordpress et installé WooCommerce. Son adresse, qui n'existe certainement plus au moment où vous lisez ceci est : http://hiboutiksync.murelh.info

Mon url de callback sera donc : http://hiboutiksync.murelh.info/hiboutik-woocommerce-sync

1. Installer le plugin

Rendez-vous sur la page githut (https://github.com/murelh/hiboutik-sync) et téléchargez le plugin

Ce plugin, vous l'installez, vous l'activez et vous passez aux réglages.

 

2. Récupération des clés API WooCommerce

Vous devez recupérer les clés d'acces à vos API WooCommerce et Hiboutik.

Pour Woocommerce, allez les réglages WooCommerce

choisissez l'onglet "API" et cliquez sur le bouton "ajoutez une clé"

Donnez le nom que vous voulez à votre clé et n'oubliez surtout pas de lui donner les permisisons de lecture ET d'écriture.

Sauvegardez précieusement les identifiants API qui vous seront alors communiqués par WooCommerce

 

3. Récupération des clés API Hiboutik

Pour réaliser ce tuto, j'ai créé un compte sur Hiboutik.
Son adresse https://murelh.hiboutik.com, me permet de déduire le nom du compte API qui est murelh.

Il me ne me reste plus qu'à :

  • Retrouver l'email de mon compte utilisateur
  • Trouver la clé API de mon compte utilisateur

Allez dans Paramètres, Utilisateurs. Déployez l'onglet "Utilisateur", notez l'adresse. Ca sera l'adresse email Hiboutik du plugin.

En cliquant sur l'icone en forme de clé à molette, vous obtiendrez la clé API. Il est possible qu'il faille d'abord activer l'acces à l'API.
Pour ce faire, allez dans "Parametres", "Utilisateurs", "Gestion des acces".

Choisissez l'utilisateur et donnez lui les droits d'acces à l'API

Maintenant vous êtes sûr que cet utilisateur dispose d'une clé API. Retournez sur sa fiche utilisateur et cliquez sur la clé à molette...

Tout en bas de la page, se trouve la clé API de cet utilisateur. Copiez la quelque part.
Si vous cliquez sur "Nouvelle clé API", la clé sera renouvellée. Son ancienne valeur ne sera plus valable et le plugin ne pourra plus se connecter à Hiboutik.

Maintenant vous avez toutes les clés en main.
Vous pouvez passer aux réglages de du plugin.

 

4. Ajout des clés API dans le plugin

Les réglages se font dans le fichier "Settings". Pour le trouver, allez dans votre liste de plugins activés, trouvez "Hiboutik Sync", cliquez sur "Modifier", puis selectionnez le fichier "settings"

Il suffit d'insérer toutes les valeurs que vous avez collecté dans les étapes précédentes de ce tuto, là où elles sont demandées.
N'oubliez pas de sauvegarder les modifications

Pour ce tuto, le résultat est donc :

5. S'assurer que le plugin communique avec avec Hiboutik

Sur Hiboutik, allez dans "Paramètres généraux" et insérez l'url votre url de callback dans la case "Ventes". Maintenant, Hiboutik fera appel au plugin installé sur votre site à chaque vente.

Pour s'assurer que le connexion s'effectue correctement, ouvrez l'url de callback vente directement dans votre navigateur.

Si le mesage ci-dessous s'affiche, c'est que le plugin a été apte à communiquer avec Hiboutik.

No sale with this id

 

Le cas échéant, c'est qu'il y  eu un problème. Assurez-vous d'avoir bien suivi le tuto.
Si vous ne parvenez toujours pas à obtenir le bon message, vous avez deux possibilité

  • Demander de l'aide dans les commentaires facebook.
    J'y répondrai en fonction du temps libre dont je dispose et si ce n'est pas trop compliqué.
  • Ecrivez-moi en privé. Mes conseils ou interventions sur votre site seront chiffrés mais vous serez certains d'un travail réalisé spécialement pour votre site.
    La solution sera ensuite publiée en open-source.

 

FAQ

Comment les produits sont t-ils mis en correspondance entre Hiboutik et WooCommerce ?

Le plugin reconnait les produits des deux boutiques en faisant correspondre le code UGS de WooCommerce avec le code bare Hiboutk

 

La synchronisation se fait-elle dans les deux sens ?
Non, seul le stock WooCommerce est affecté par les ventes Hiboutik.
De plus, le plus le plugin réduit le stock de chaque produit d'une valeur précise (celle de la vente). Il n'initialise pas le stock à une valeur donnée.

Cela signifie que les valeurs de stock d'un produit peut être different entre Hiboutik et WooCommerce.

 

Idées d'améiorations

Tout le monde est libre de participer à l'amélioration de ce plugin.

  • La saisie des parametres du plugin pourrait être plus intuitive
  • Le plugin pourrait ajuster le stock WooCommerce en fonction du stock Hiboutik afin que les deux valeurs soient toujours les mêmes.

Comments