Module UltimateMarketPlace FR
Module UltimateMarketPlace
Présentation
Le module UltimateMarketPlace est une extension pour Dolibarr ERP/CRM éditée par Atoo-Net.
Il fournit toutes les fonctionnalités nécessaires pour publier une place de marché en ligne mono-vendeur : un modèle de site Web prêt à l'emploi (catalogue produits, panier, tunnel de commande, comptes clients), utilisable avec le module Site Web de Dolibarr, pour vendre vos propres produits et services directement en ligne.
Il s'agit d'un fork simplifié du module Dolibarr « Marketplace » (utilisé pour dolistore.com), duquel tout ce qui est spécifique à l'association Dolibarr ainsi que le circuit multi-vendeurs / soumission et revue de modules par des développeurs tiers a été retiré.
| Propriété | Valeur |
|---|---|
| Auteur | Philippe Grand — Atoo-Net |
| Version | 1.0 |
| Licence | GNU GPL v3+ |
| Dolibarr minimum | v24.0 |
| PHP minimum | v8.0 |
Pourquoi utiliser UltimateMarketPlace ?
UltimateMarketPlace transforme votre installation Dolibarr en boutique en ligne autonome, sans dépendre d'un CMS ou d'une plateforme e-commerce tierce (type PrestaShop, WooCommerce…). Le catalogue, les commandes, les factures et les clients restent nativement dans Dolibarr.
Cas d'utilisation
Vente de produits physiques ou dématérialisés
Publiez votre catalogue de produits ou de services directement depuis les fiches produits Dolibarr. Le module gère aussi bien les biens physiques (avec frais de port) que les articles dématérialisés (téléchargements, licences, prestations).
Fidélisation de la clientèle professionnelle
Grâce aux remises automatiques pour les « clients privilégiés » (catégorie tiers dédiée), offrez un tarif préférentiel négocié à vos meilleurs clients, avec possibilité d'exclure certains produits de la remise.
Opérations commerciales et codes promo
Créez des codes de réduction (pourcentage ou montant fixe), limités dans le temps ou en nombre d'utilisations, éventuellement réservés à un produit précis, pour animer vos ventes en ligne.
Vente additionnelle (upsell) au panier
Proposez automatiquement un produit complémentaire dans le panier (ex. assurance, garantie, éco-participation), calculé en pourcentage du total et limité aux pays de votre choix.
Paiement en ligne
Connectez le tunnel d'achat aux modes de paiement déjà configurés dans Dolibarr (Stripe, PayPal, virement…), soit en redirection classique vers votre back-office, soit intégré en frame dans la boutique.
Suivi d'audience
Intégrez Matomo Analytics pour suivre la fréquentation et le comportement d'achat sur votre boutique, sans dépendre de Google Analytics.
Installation
Prérequis : le module nécessite que les modules Dolibarr suivants soient activés (ils sont activés automatiquement si besoin) : Tiers, Produits, Services, Catégories, Commandes, Factures, Banque, Mailing et Site Web.
- Télécharger le module depuis DoliStore ou cloner le dépôt Git dans
htdocs/custom/ultimatemarketplace - Aller dans Accueil → Configuration → Modules/Applications
- Localiser UltimateMarketPlace dans la section AtooNet
- Activer le module en cliquant sur le bouton de la colonne Activé
À l'activation, le module effectue automatiquement plusieurs actions :
- Création d'un site Web dédié (référence
ultimatemarketplace) avec le modèle de site "website_template-ultimatemarketplace" importé - Création d'une catégorie produit racine pour les articles visibles sur la marketplace
- Création d'une catégorie tiers pour les clients/prospects créés depuis le site marchand
- Ajout de 3 extrafields produit : séparateur "Marketplace", commentaire après prix (
PriceComment) et message d'avertissement public (DisclaimerMessage)
Configuration
La configuration du module se fait dans Accueil → Configuration → Modules/Applications → UltimateMarketPlace, répartie en plusieurs onglets.
Général : produits et tiers
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_NAME |
Nom de la marketplace |
ULTIMATEMARKETPLACE_EMAIL |
Email de contact de la marketplace |
ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID |
Catégorie racine des produits vendus sur la marketplace |
ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS |
Catégorie mise en avant dans le bloc central de la page d'accueil |
ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID |
Catégorie utilisée par le widget "Version" de la page d'accueil |
ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID |
Catégorie utilisée par le widget "Promotions" de la page d'accueil |
ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE |
Prix minimum d'un produit (si celui-ci n'est pas gratuit) |
ULTIMATEMARKETPLACE_DELAY_FOR_NEW |
Ancienneté maximale (en jours) pour qu'un produit apparaisse dans la section "Nouveautés" |
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID |
Catégorie assignée à tous les prospects/clients créés depuis le site marchand |
Remises pour les clients privilégiés
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID |
Catégorie des tiers labellisés "Privilégié", éligibles à la remise |
ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT |
Pourcentage de remise appliqué à ces tiers |
ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID |
Catégorie des produits exclus de cette remise |
Site Web
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_URL_FOR_LOGO |
URL du logo de la marketplace |
ULTIMATEMARKETPLACE_THEME_COLOR |
Couleur principale du thème (boutons, bannières, éléments mis en avant) |
ULTIMATEMARKETPLACE_WEBSITE_ID |
Site Web Dolibarr utilisé par la marketplace |
ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE |
Utilisateur technique autorisé à exécuter les actions du site (ajout de produits, gestion des tiers, création de commandes) |
Important : si vous changez le site Web associé (ULTIMATEMARKETPLACE_WEBSITE_ID), les utilisateurs, tiers et commandes déjà créés restent liés à l'ancien site et ne sont pas migrés automatiquement.
Modèles d'emails
Trois modèles d'emails Dolibarr peuvent être personnalisés :
- Email de bienvenue envoyé à la création du compte client
- Email "Mot de passe oublié"
- Email de confirmation de commande envoyé à l'acheteur
Produit additionnel dans le panier
Permet d'ajouter automatiquement un produit complémentaire (assurance, garantie, éco-participation…) au panier :
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID |
Produit additionnel à ajouter |
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT |
Prix du produit additionnel, exprimé en % du total du panier |
ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES |
Codes pays où ce produit additionnel s'applique |
Frais de port
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT / ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID |
Produit Dolibarr utilisé pour facturer les frais de port |
Inscription : Google reCAPTCHA
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM |
Active le Captcha Google sur le formulaire d'inscription |
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY |
Clé publique reCAPTCHA fournie par Google |
ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY |
Clé privée reCAPTCHA (à garder confidentielle) |
Paiement
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_BLOCK_SALES |
Bloque temporairement les ventes sur la marketplace |
ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT |
Clôture automatiquement la commande après paiement réussi |
ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD |
Mode de paiement à utiliser |
Deux modes d'intégration du paiement sont possibles :
- Page séparée (par défaut) : aucune configuration particulière, le client est redirigé vers les pages de paiement publiques de votre back-office Dolibarr. Inconvénient : le domaine du back-office est visible du client.
- Frame (utilisateurs avancés) : la page de paiement du back-office est appelée via une URL de la boutique marketplace elle-même. Nécessite une configuration de proxy sur le serveur Web de la marketplace pour rediriger les requêtes vers le back-office Dolibarr. Avantage : le domaine du back-office reste masqué.
API
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_PUBLIC_API_KEY |
Clé publique utilisée pour accéder à l'API produits/catégories |
L'API expose un flux XML des produits et des catégories, avec les paramètres categorieid, limit, page, search et lang. Un routage proxy peut être mis en place pour masquer l'URL réelle de l'API derrière le domaine de la boutique.
Matomo
| Constante | Description |
|---|---|
ULTIMATEMARKETPLACE_ENABLE_MATOMO |
Active Matomo Analytics sur le site marketplace |
ULTIMATEMARKETPLACE_MATOMO_SITE_KEY |
Identifiant de site (Site ID) Matomo |
ULTIMATEMARKETPLACE_MATOMO_SERVER_URL |
URL complète du serveur Matomo |
Codes promo (coupons)
Un onglet Codes promo dédié permet de créer des codes de réduction :
- Type de remise : pourcentage ou montant fixe hors taxes
- Nombre d'utilisations maximum (laisser vide pour un usage illimité)
- Réservation possible à un produit précis
- Suivi du nombre d'utilisations déjà effectuées
Le code est vérifié lors de son application au panier : un code inexistant, expiré ou déjà entièrement utilisé est refusé (message "Ce code promo est invalide, expiré ou déjà utilisé").
Utilisation
Boutique en ligne (front office)
Le site généré par le module reprend la charte graphique définie dans la configuration (logo, couleur principale) et propose :
- Un catalogue de produits organisé par catégories, avec mise en avant des nouveautés et des promotions
- Une fiche produit avec prix, commentaire libre après le prix et message d'avertissement public si configurés
- Un panier avec application de code promo, calcul automatique des remises "client privilégié" et ajout du produit additionnel éventuel
- Un tunnel de commande relié aux modes de paiement configurés dans Dolibarr
- Un espace client (inscription, connexion, historique de commandes) protégé par Google reCAPTCHA si activé
Gestion des tags produits
Le menu UltimateMarketPlace → Produits sans tags liste les produits/services de la marketplace qui n'ont pas encore été rattachés à une catégorie/tag, afin de leur appliquer en masse un ou plusieurs tags (catégories).
Statistiques
Le module ajoute des pages statistiques dédiées à la marketplace :
- Statistiques des factures et des ventes (regroupement par pays/taux de TVA ou par zone/taux de TVA)
- Statistiques clients (derniers tiers créés, derniers tiers "privilégiés")
- Statistiques produits/services (classement par popularité)
Suivi des commandes et factures
Deux entrées de menu permettent de retrouver rapidement les commandes et factures issues de la marketplace (filtrées sur module_source = ultimatemarketplace).
FAQ
Le site marketplace n'a pas été créé automatiquement
Vérifiez que le module Site Web de Dolibarr est bien activé. Si le site n'existe toujours pas après activation du module, désactivez puis réactivez UltimateMarketPlace.
Comment changer le site Web utilisé sans perdre les commandes existantes ?
Ce n'est pas recommandé : changer ULTIMATEMARKETPLACE_WEBSITE_ID ne migre pas les utilisateurs, tiers et commandes déjà créés vers le nouveau site. Ils restent associés à l'ancien site.
Puis-je limiter la remise "client privilégié" à certains produits uniquement ?
Oui, en configurant ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID avec une catégorie regroupant les produits à exclure de la remise.
Le paiement en frame est-il obligatoire ?
Non, c'est une option pour utilisateurs avancés. Par défaut, le paiement redirige simplement vers les pages publiques de paiement de votre back-office Dolibarr, sans configuration serveur particulière.
Quels moyens de paiement sont supportés ?
Tous les modes de paiement déjà pris en charge nativement par Dolibarr (Stripe, PayPal, virement, etc.), sélectionnés via ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD.