Entre WordPress et Odoo, il manquait un pont. Je l’ai construit.

WordPress fait tourner votre vitrine. Odoo fait tourner votre back-office. Entre les deux, une terre de personne où vos données se perdent, se dupliquent ou ne se parlent plus. WP4Odoo est un pont modulaire entre ces deux mondes : open source, bidirectionnel, et conçu pour ne pas vous réveiller la nuit.

Le problème que tout le monde contourne

Si vous utilisez WordPress (ou WooCommerce) en façade et Odoo comme ERP, vous connaissez la chanson. Un client passe commande sur votre boutique. La commande arrive dans WooCommerce. Puis quelqu’un (souvent vous, souvent à la main) la ressaisit dans Odoo pour la facturation, la gestion de stock, le suivi commercial. Les abonnements, les contacts CRM, les inscriptions à vos formations en ligne : même histoire.

Chaque saisie manuelle est une opportunité d’erreur. Chaque heure passée à copier-coller entre deux onglets est une heure en moins pour développer votre activité. Et au bout de quelques mois, vos deux systèmes divergent silencieusement : le stock WordPress dit une chose, Odoo en dit une autre, et vous découvrez le décalage quand un client appelle pour demander où est sa commande.

Il existe des connecteurs commerciaux, souvent verrouillés sur une poignée de cas d’usage, parfois dépendants de plateformes intermédiaires comme Zapier ou Make qui ajoutent un point de défaillance et une facture de plus. J’ai voulu construire autre chose.

Ce qu’est WP4Odoo

WP4Odoo est un plugin WordPress modulaire qui crée un pont bidirectionnel entre WordPress/WooCommerce et Odoo. Vous activez uniquement les modules dont vous avez besoin, et le plugin synchronise les données dans les deux sens, de manière asynchrone : aucun appel API vers Odoo ne se fait pendant qu’un visiteur navigue sur votre site.

Tout passe par une file d’attente persistante, traitée en arrière-plan par lots configurables. Retry automatique, déduplication des jobs, logs détaillés. Si Odoo est temporairement injoignable, les jobs attendent et seront retentés automatiquement. Votre site ne ralentit jamais, vos visiteurs ne voient rien.

Un plugin, des dizaines de modules

Plutôt qu’un gros monolithe, WP4Odoo est découpé en modules indépendants. Chaque module correspond à un domaine fonctionnel (e-commerce, CRM, LMS, helpdesk, événements, marketplace, comptabilité…) et à un ou plusieurs plugins WordPress tiers. Vous n’utilisez pas WooCommerce Subscriptions ? Le module n’est pas chargé. Pas besoin du CRM ? Il reste désactivé.

La couverture fonctionnelle est large et continue de s’étendre. Chaque module sait quelles applications Odoo il requiert et le vérifie à l’activation. Certains dépendent d’applications réservées à Odoo Enterprise, et d’autres ne peuvent pas fonctionner avec les versions les plus récentes d’Odoo lorsque l’application correspondante a disparu (c’est le cas des adhésions, par exemple). Le README sur GitHub détaille la compatibilité, les directions de synchronisation et les prérequis module par module.

Ce qui circule : et dans quel sens

La direction de synchronisation varie selon le module. WooCommerce est bidirectionnel : produits, commandes, stocks et catégories circulent dans les deux sens. Les formulaires de contact ne poussent que vers Odoo. Le module Sales ne tire que depuis Odoo vers WordPress. Ce n’est pas un caprice d’architecte : forcer la bidirectionnalité partout, c’est s’exposer à des conflits de données impossibles à résoudre proprement. Mieux vaut définir clairement qui est le maître de chaque type de donnée.

Sous le capot

Le cœur du plugin est sa file d’attente asynchrone. Plutôt que d’appeler Odoo en temps réel au moment du checkout (fragile et lent) chaque événement génère un job traité en arrière-plan. Le plugin parle à Odoo par ses trois interfaces : JSON-RPC, XML-RPC et JSON-2, la nouvelle API qu’Odoo propose à partir de la version 19 pour remplacer les deux autres, désormais dépréciées. Les credentials sont chiffrés au repos, et des webhooks entrants permettent à Odoo de notifier WordPress en temps réel avec authentification et rate limiting.

Les versions d’Odoo ne se ressemblent pas : d’une version à l’autre, des champs disparaissent ou changent de nom, et Odoo rejette alors tout l’enregistrement. Le plugin compare ce qu’il envoie au schéma réel de votre Odoo, renomme ce qui doit l’être et laisse de côté ce qui n’existe plus, au lieu d’échouer. L’onglet Santé vous montre ce qui a été laissé de côté, la version d’Odoo détectée et l’état de la base de données, que le plugin sait aussi réparer seul si des tables manquent.

Le tout est administrable via une interface d’administration à onglets ou intégralement en ligne de commande via WP-CLI : configuration de la connexion, bilan de santé (avec un code de sortie exploitable par votre supervision), journaux, réparation de la base, gestion des modules, synchronisation en masse des produits. Pratique pour les déploiements automatisés ou le diagnostic rapide. Les détails techniques sont dans le fichier ARCHITECTURE.md.

Compatibilité Odoo

Le plugin fonctionne avec les versions récentes d’Odoo (17 et plus) en JSON-RPC, avec une clé API ou un mot de passe, et peut utiliser JSON-2 à partir d’Odoo 19. Les versions antérieures (14–16) passent par XML-RPC. Le plugin est vérifié en conditions réelles sur Odoo 19 et Odoo 20, y compris Odoo Online. Compatible On-Premise, Odoo.sh et Odoo Online, éditions Community et Enterprise. Le plan « One App Free » fonctionne partiellement : le README détaille ce qui marche selon l’application choisie.

Extensibilité et multilingue

WP4Odoo est pensé pour être étendu : hooks pour enregistrer vos propres modules, filtres pour transformer les données en transit, mapping de champs personnalisés vers Odoo. Si votre site est multilingue (WPML ou Polylang), le plugin synchronise les traductions de produits, catégories et attributs dans les deux sens. Le plugin est lui-même traduit en plusieurs langues et prêt à en accueillir de nouvelles. Les conventions de contribution sont dans CONTRIBUTING.md.

Qualité et tests

C’est un projet personnel, pas un produit commercial. Mais c’est un projet qui touche à la facturation, au stock et aux données clients de vrais business : le niveau d’exigence doit être à la hauteur. Le plugin est couvert par des milliers de tests automatisés en intégration continue, de l’analyse statique, et des tests d’intégration dans un vrai WordPress.

Des tests unitaires ne suffisent pas pour un connecteur : les logiciels qu’il relie évoluent sans prévenir. Chaque semaine, une vérification automatique démarre de vraies instances d’Odoo (versions 19 et 20) dans Docker, rejoue les opérations courantes (contacts, commandes, factures, stock) sur les trois interfaces d’Odoo, puis installe la dernière version de chaque plugin WordPress gratuit pris en charge pour s’assurer que le module correspondant le reconnaît toujours. C’est ce qui permet de repérer rapidement qu’une mise à jour tierce casse quelque chose.

Disponible en open source

Le code source, la documentation, le changelog et le guide d’architecture sont sur GitHub. Le plugin est distribué sous licence GPL v2+.


Un formulaire de retour sur la compatibilité

Si vous utilisez WP4Odoo et qu’une mise à jour d’un plugin tiers casse quelque chose, ou au contraire si une version non testée fonctionne très bien, vous pouvez me le signaler avec le formulaire ci-dessous. C’est rapide, cela m’aide à prioriser les corrections, et cela fait vivre le projet bien plus efficacement qu’une surveillance en solo.

Le formulaire est aussi accessible directement depuis l’administration WordPress : lorsque le plugin détecte une version d’un plugin tiers supérieure à celle qu’il a validée, il affiche un avertissement avec un lien pré-rempli. Il ne vous reste qu’à indiquer si cela fonctionne ou non.

Does it work or is it broken?

Écrivez quelques éclats d'âme...

Dans l'ombre vacillante d'une chandelle, où les murmures du vent se mêlent aux secrets d'un vieux parchemin, je vous invite à tisser une toile de mots. Écrivez quelques éclats d'âme – rêve, étoile, abîme, étreinte, brume – et laissez-les danser sur la page, comme des lucioles dans une nuit d'encre. Que diriez-vous de les entrelacer dans une phrase, un souffle, une histoire ?

S’abonner
Notification pour
guest
0 Commentaires
Le plus ancien
Le plus récent Le plus populaire

Source : https://paul.argoud.net/wp4odoo-plugin-wordpress-odoo-synchronisation-woocommerce/