Intégrer Dolibarr avec WordPress : Méthode au Maroc

Published: 3 novembre 2025 – 8 minutes de lecture

1. Pourquoi associer Dolibarr et WordPress ?

Dolibarr WordPress
ERP/CRM open‑source complet (gestion des devis, factures, stocks, contacts, etc.) CMS le plus répandu pour la création de sites vitrines, boutiques en ligne, blogs, etc.
Installation légère, PHP/MySQL, aucune licence coûteuse Écosystème de plugins et de thèmes très riche
Idéal pour les PME, associations, artisans et petites structures locales Interface d’édition très intuitive, communauté francophone solide

En combinant les deux, vous pouvez conserver la puissance de Dolibarr pour la gestion métier tout en profitant de la flexibilité et du design de WordPress pour présenter vos services, publier des actualités, optimiser le référencement, etc.

2. Cadre légal et technique au Maroc

Point Information clé
Hébergement La plupart des hébergeurs marocains (e.g. Ikoula, OVHcloud Maroc, Scaleway, Online.net) proposent des plans compatibles PHP 7.4+ et MySQL 8.0 – requis par Dolibarr ≥ 9.0.
RGPD / CNIL La législation marocaine (Loi 09‑08 sur la protection des données à caractère personnel) impose la conformité aux données clients. Utilisez des modules de consentement et de chiffrement (HTTPS).
Paiement en ligne Intégrer des passerelles de paiement locales (ex. PayFacile Maroc, Oney, Wafeq) ou internationales (Stripe, PayPal).
Langue Traduction française / arabe /  amazighe : assurez‑vous que le thème WordPress et les plugins sont multilingues (polylang ou WPML).
Sauvegarde Privilégiez des sauvegardes automatisées (ex. UpdraftPlus, Akeeba Backup) et un plan de reprise (RAID, serveur dédié).

3. Architecture générale de l’intégration

+-----------------------+          +-----------------------+

|  Site WordPress       |  <--->  |  Dolibarr (API/REST)  |

|  (Thème + Plugins)    |  API    |  (Gestion métier)    |

+-----------------------+          +-----------------------+

          |                               |

          |   • Thème/Afficheur de produit  |

          |   • Formulaire de contact       |

          |   • Gestion des paiements       |

          +---------------------------------+

3.1. Deux voies principales

Méthode Description Avantages Inconvénients
API native de Dolibarr (v9+) Exposer les actions (devise, commande, client) via REST/JSON. Très flexible, pas de redondance de données. Nécessite des compétences en développement.
Modules/WP‑Dolibarr Existence de plugins communautaires (ex. WP‑Doli, WP‑ERP) qui synchronisent des tables MySQL. Installation simple, peu de code. Moins maintenu, dépend de la version de Dolibarr.

Nous détaillerons les deux approches.

4. Méthode 1 : Utiliser l’API REST de Dolibarr

Cette méthode est recommandée pour les projets qui prévoient d’évoluer rapidement ou d’ajouter des modules spécifiques (ex. gestion de devis en ligne).

4.1. Activation de l’API sur Dolibarr

  1. Connexion à l’admin Dolibarr → Configuration → “API”.

  2. Activer l’API : cocher “Enable REST API”. 3. Générer une clef d’API :

    • Menu Configuration → API → Generate key.

    • Copiez Client ID et Client Secret.

  3. Définir les droits : sélectionner les objets à exposer (ex. Customer, Invoice, Order).

Tip : créez un utilisateur dédié (ex. api_user) avec les seules permissions nécessaires ; évitez les droits d’administration.

4.2. Authentification (OAuth 2.0 simplifié)

curl -X POST "https://votredomaine.com/dolibarr/api.php" \

     -H "Content-Type: application/x-www-form-urlencoded" \

     -d "f=login&username=api_user&password=******&grant_type=client_credentials"

Vous obtiendrez un access_token valable 1 heure (ou la durée définie).

4.3. Exemple d’appel depuis WordPress

a) Créer un custom post type « Produit »

function register_produit_cpt() {

    $args = [

        'public' => true,

        'label'  => 'Produits',

        'supports' => ['title','editor'],

        'has_archive' => true,

    ];

    register_post_type('produit', $args);

}

add_action('init', 'register_produit_cpt');

b) Ajouter un script d’importation des produits depuis Dolibarr

function import_dolibarr_products() {

    $token = get_transient('dolibarr_token');

    if (!$token) {

        // récupérer le token via le script ci‑dessus (voir plus haut)

        $token = dolibarr_get_access_token();

        set_transient('dolibarr_token', $token, HOUR_IN_SECONDS);

    }
$response = wp_remote_get(

        'https://votredomaine.com/dolibarr/api.php?f=resources/PublicClient&range=0-99',

        [

            'headers' => [

                'Authorization' => 'Bearer '.$token,

                'Accept' => 'application/json',

            ],

        ]

    );
if (is_wp_error($response)) return;
$data = json_decode(wp_remote_retrieve_body($response), true);

    foreach ($data as $product) {

        $post = [

            'post_title'   => $product['name'],

            'post_content' => $product['description'],

            'post_status'  => 'publish',

            'post_type'    => 'produit',

        ];

        wp_insert_post($post);

    }

}

add_action('wp', 'import_dolibarr_products');

Remarque : Vous pouvez stocker les produits dans un custom table si vous avez besoin d’un mapping plus fin (ex. SKU, prix TTC).

4.4. Affichage côté thème WordPress

Utilisez la boucle standard :

$args = [

    'post_type' => 'produit',

    'posts_per_page' => -1,

];

$loop = new WP_Query($args);

while ( $loop->have_posts() ) : $loop->the_post(); ?>
<h2><?php the_title(); ?></h2>

    <?php the_content(); ?>
<?php endwhile; wp_reset_postdata(); ?>

4.5. Synchronisation bidirectionnelle

  • Devise : lorsqu’un devis est créé dans Dolibarr, un webhook (POST /wp-json/dolibarr/v1/create_invoice) peut appeler wp_insert_post() pour créer un article de type « Devis » dans WordPress.

  • Webhook : configupez dans Dolibarr Configuration → API → Webhooks des URL comme https://votresite.com/wp-json/dolibarr/v1/receive.

  • Gestion des erreurs : implémentez un système de journalisation (error_log()) afin de pouvoir retenter les appels défaillants.

5. Méthode 2 : Utiliser un plugin d’intégration (solution « clé‑en‑main »)

5.1. Plugins populaires

Plugin Fonction principale Dernière mise à jour
WP‑Doli Synchronisation des contacts, devis, factures via tables WP. 2024‑11
Dolibarr‑ERP‑Sync (open‑source) Export CSV/JSON, import automatique des commandes. 2023‑09
WP‑ERP (CRM/Facturation) Intègre la fonctionnalité de Dolibarr dans WP (module compta). 2025‑03

⚠️ Vérifiez la compatibilité avec votre version de Dolibarr (>= 9.0) et le PHP de votre hébergeur.

5.2. Installation pas à pas avec un exemple (WP‑Doli)

  1. Installer le plugin : Plugins → Ajouter → rechercher “WP-Doli” → installer.

  2. Configurer la connexion : – Paramètres → WP‑Doli → Connection → entrer les informations de la base MySQL de Dolibarr (hôte, user, mdp) et choisir le prefix de table doli_. 3. Mapper les champs : – Produit → Article → associer doli_product.price à un champ custom du post (_price_ttc).

  3. Synchronisation :

    • Choisissez « Synchroniser les contacts » → crée automatiquement des entrées dans WordPress (wp_users, wp_usermeta) avec les mêmes champs que Dolibarr.

  4. Créer une page d’affichage :

    • Utilisez le shortcode [dolibarr_products] pour afficher les produits directement dans une page.

5.3. Points de vigilance – Les versions de Dolibarr et du plugin doivent rester alignées ; sinon, les champs peuvent changer.

  • Le déploiement sur un serveur partagé peut nécessiter l’activation du module mod_rewrite pour les URLs “pretty”.

  • Sécurité : limitez l’accès au dossier dolibarr/ via .htaccess (ex. Deny from all).

6. Exemple concret : Boutique d’artisanat marocain

Imaginons un site « Atelier Casa » qui vend des poteries artisanales :

Fonctionnalité Implémentation dans WordPress + Dolibarr
Produit Article créé dans Dolibarr (SKU = POT-001). Synchronisé via API → crée un post type pot dans WP.
Prix TTC Champ price de Dolibarr → meta _price_ttc du post WP.
Panier Utilisation du plugin WooCommerce. Dans le produit WP, ajouter le champ data-wc-price qui sera lu par WooCommerce pour afficher le prix.
Paiement Intégration de PayFacile via le gateway officiel WooCommerce. La facture générée dans Dolibarr se déclenche automatiquement (webhook) → statut payé dans WP.
Gestion des stocks La fonction stock de Dolibarr (doli_stock) est lue chaque jour et met à jour le champ _stock du produit WP (affiché en texte « En stock limité »).
Conversion locale Ajout d’un sélecteur de devise (MAD, EUR) qui modifie automatiquement le prix affiché grâce à un petit script JavaScript qui interroge l’API Dolibarr pour le taux de change.

7. Checklist avant le déploiement | ✅ | Action |

|—-|——–|
| 1 | Héberger Dolibarr et WordPress sur le même serveur ou sur deux serveurs avec un VPN/SSH sécurisé. |
| 2 | Créer un utilisateur API dédié avec droits limités. |
| 3 | Tester l’API (GET/POST) via Postman ou curl. |
| 4 | Installer le ou les plugins nécessaires et configurer le mapping des champs. |
| 5 | Mettre en place le schéma de synchronisation (Cron, Webhooks). |
| 6 | Configurer les passerelles de paiement locales (PayFacile, Oney) et créer les pages de confirmation. |
| 7 | Mettre en place des sauvegardes quotidiennes (DB + fichiers). |
| 8 | Vérifier la conformité RGPD (checkbox de consentement, stockage minimal). |
| 9 | Effectuer des tests utilisateurs (création devis, paiement, affichage produit). |
|10 | Documenter le processus pour les équipes internes. |

8. Ressources utiles (français & marocaines)

Ressource URL
Documentation officielle Dolibarr – API https://wiki.dolibarr.org/index.php/REST_API
Guide d’intégration WP‑Doli https://github.com/AGILIX/dolibarr-wp-doli
Plugin WooCommerce – PayFacile Maroc https://wordpress.org/plugins/woocommerce-payfacile/
PayFacile Maroc – API https://payfacile.com/docs/api
RGPD Maroc – CNIL https://www.cnil.fr/fr/commission-nationale-informatique-cnil
Communauté WordPress francophone https://fr.wordpress.org/support/
Meetup Marrakech – WordPress & Open‑Source https://www.meetup.com/fr-FR/marrakech-wordpress/

9. Conclusion L’intégration de Dolibarr avec WordPress est une solution puissante pour les acteurs marocains (artisans, PME, associations) qui souhaitent séparer la gestion métier (ERP/CRM) de la présentation web (CMS).

  • Méthode API : la plus robuste, idéale pour des besoins évolutifs et une synchronisation bidirectionnelle fluide.

  • Méthode plugin : rapide à mettre en œuvre, adaptée aux petites structures avec des compétences techniques limitées.

En suivant la checklist et en tenant compte des spécificités locales (hébergement, législation, paiement), vous pouvez créer un système fiable, sécurisé et conforme qui profite du meilleur des deux mondes : la flexibilité de WordPress et la richesse fonctionnelle de Dolibarr.

Bon développement ! 🚀

— Auteur : [Votre Nom], consultant en solutions open‑source, spécialiste Dolibarr & WordPress pour le marché marocain.
Date de publication : 3 novembre 2025.

Publications similaires