Module UltimateMarketPlace FR - Revision history

Grandoc at 08:46, 12 October 2026

2026-10-12T08:46:42Z

@@ Line 20: / Line 20: @@
 |Auteur||Philippe Grand — Atoo-Net
 |-
-|Version||24.0.0
+|Version||24.0.1
 |-
 |Licence||GNU GPL v3+
@@ Line 77: / Line 77: @@
 Le module ne déclare aucun droit propre : les pages d'administration sont réservées aux administrateurs Dolibarr, et les pages de la boutique utilisent leur propre session client.
 ==Configuration==
@@ Line 308: / Line 343: @@
 <code>robots.txt</code>, <code>sitemap.xml</code> et <code>llms.txt</code> sont régénérés automatiquement à l'activation, à l'ouverture de l'onglet Paramètres et après une réinitialisation du modèle. Une fois les URLs simplifiées activées, les anciennes URLs restent valides pendant la transition.
 ==Nouveautés de la version 24.0.0==
@@ Line 330: / Line 369: @@
 ==FAQ==

Grandoc at 20:19, 6 October 2026

2026-10-06T20:19:23Z

Show changes

Grandoc: /* Autres langues */

2026-07-10T10:12:28Z

Autres langues

← Older revision		Revision as of 10:12, 10 July 2026
Line 284:		Line 284:

	* [[Module_UltimateMarketPlace_EN\|English documentation for the UltimateMarketPlace module]]		* [[Module_UltimateMarketPlace_EN\|English documentation for the UltimateMarketPlace module]]
			* [[Module_UltimateMarketPlace_DE\|Deutsche Dokumentation für das Modul UltimateMarketPlace]]
			* [[Module_UltimateMarketPlace_ES\|Documentación en español del módulo UltimateMarketPlace]]
			* [[Module_UltimateMarketPlace_IT\|Documentazione in italiano del modulo UltimateMarketPlace]]

	[[en:Module_UltimateMarketPlace_EN]]		[[en:Module_UltimateMarketPlace_EN]]
			[[de:Module_UltimateMarketPlace_DE]]
			[[es:Module_UltimateMarketPlace_ES]]
			[[it:Module_UltimateMarketPlace_IT]]

Grandoc at 12:25, 8 July 2026

2026-07-08T12:25:04Z

← Older revision		Revision as of 12:25, 8 July 2026
Line 280:		Line 280:
	*[https://framagit.org/grandoc/ultimatemarketplace Dépôt du module]		*[https://framagit.org/grandoc/ultimatemarketplace Dépôt du module]
	*[https://wiki.dolibarr.org/index.php/Module_Website Documentation du module Site Web Dolibarr]		*[https://wiki.dolibarr.org/index.php/Module_Website Documentation du module Site Web Dolibarr]

			==Autres langues==

			* [[Module_UltimateMarketPlace_EN\|English documentation for the UltimateMarketPlace module]]

			[[en:Module_UltimateMarketPlace_EN]]

Grandoc: Created page with "Category:Modules Category:AtooNet =Module UltimateMarketPlace= ==Présentation== Le module '''UltimateMarketPlace''' est une extension pour Dolibarr ERP/CRM édité..."

2026-07-08T11:32:18Z

Created page with "Category:Modules Category:AtooNet =Module UltimateMarketPlace= ==Présentation== Le module '''UltimateMarketPlace''' est une extension pour Dolibarr ERP/CRM édité..."

New page

[[Category:Modules]]
[[Category:AtooNet]]

=Module UltimateMarketPlace=

==Présentation==

Le module '''UltimateMarketPlace''' est une extension pour Dolibarr ERP/CRM éditée par [https://www.atoo-net.com 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é.

{| class="wikitable"
|-
!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 [https://www.dolistore.com DoliStore] ou cloner le dépôt Git dans <code>htdocs/custom/ultimatemarketplace</code>
#Aller dans '''Accueil → Configuration → Modules/Applications'''
#Localiser '''UltimateMarketPlace''' dans la section '''AtooNet'''
#Activer le module en cliquant sur le bouton de la colonne ''Activé''

[[File:ultimatemarketplace_activation.png|center|thumb|800px|Activation du module UltimateMarketPlace dans la section AtooNet]]

À l'activation, le module effectue automatiquement plusieurs actions :

*Création d'un '''site Web dédié''' (référence <code>ultimatemarketplace</code>) 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 (<code>PriceComment</code>) et message d'avertissement public (<code>DisclaimerMessage</code>)

==Configuration==

La configuration du module se fait dans '''Accueil → Configuration → Modules/Applications → UltimateMarketPlace''', répartie en plusieurs onglets.

===Général : produits et tiers===

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_NAME</code>||Nom de la marketplace
|-
|<code>ULTIMATEMARKETPLACE_EMAIL</code>||Email de contact de la marketplace
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID</code>||Catégorie racine des produits vendus sur la marketplace
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS</code>||Catégorie mise en avant dans le bloc central de la page d'accueil
|-
|<code>ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID</code>||Catégorie utilisée par le widget "Version" de la page d'accueil
|-
|<code>ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID</code>||Catégorie utilisée par le widget "Promotions" de la page d'accueil
|-
|<code>ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE</code>||Prix minimum d'un produit (si celui-ci n'est pas gratuit)
|-
|<code>ULTIMATEMARKETPLACE_DELAY_FOR_NEW</code>||Ancienneté maximale (en jours) pour qu'un produit apparaisse dans la section "Nouveautés"
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID</code>||Catégorie assignée à tous les prospects/clients créés depuis le site marchand
|}

===Remises pour les clients privilégiés===

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID</code>||Catégorie des tiers labellisés "Privilégié", éligibles à la remise
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT</code>||Pourcentage de remise appliqué à ces tiers
|-
|<code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code>||Catégorie des produits exclus de cette remise
|}

===Site Web===

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_URL_FOR_LOGO</code>||URL du logo de la marketplace
|-
|<code>ULTIMATEMARKETPLACE_THEME_COLOR</code>||Couleur principale du thème (boutons, bannières, éléments mis en avant)
|-
|<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>||Site Web Dolibarr utilisé par la marketplace
|-
|<code>ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE</code>||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é (<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>), 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 :

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID</code>||Produit additionnel à ajouter
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT</code>||Prix du produit additionnel, exprimé en % du total du panier
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES</code>||Codes pays où ce produit additionnel s'applique
|}

===Frais de port===

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT</code> / <code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID</code>||Produit Dolibarr utilisé pour facturer les frais de port
|}

===Inscription : Google reCAPTCHA===

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM</code>||Active le Captcha Google sur le formulaire d'inscription
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY</code>||Clé publique reCAPTCHA fournie par Google
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY</code>||Clé privée reCAPTCHA (à garder confidentielle)
|}

===Paiement===

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_BLOCK_SALES</code>||Bloque temporairement les ventes sur la marketplace
|-
|<code>ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT</code>||Clôture automatiquement la commande après paiement réussi
|-
|<code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>||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===

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_PUBLIC_API_KEY</code>||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 <code>categorieid</code>, <code>limit</code>, <code>page</code>, <code>search</code> et <code>lang</code>. 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===

{| class="wikitable"
|-
!Constante!!Description
|-
|<code>ULTIMATEMARKETPLACE_ENABLE_MATOMO</code>||Active Matomo Analytics sur le site marketplace
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SITE_KEY</code>||Identifiant de site (Site ID) Matomo
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SERVER_URL</code>||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

[[File:ultimatemarketplace_coupons.png|center|thumb|800px|Onglet d'administration des codes promo]]

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é

[[File:ultimatemarketplace_home.png|center|thumb|800px|Page d'accueil de la boutique générée par UltimateMarketPlace]]

===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 <code>module_source = ultimatemarketplace</code>).

==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 <code>ULTIMATEMARKETPLACE_WEBSITE_ID</code> 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 <code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code> 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 <code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>.

==Voir aussi==

*[https://www.atoo-net.com Atoo-Net — Éditeur du module]
*[https://framagit.org/grandoc/ultimatemarketplace Dépôt du module]
*[https://wiki.dolibarr.org/index.php/Module_Website Documentation du module Site Web Dolibarr]