Module UltimateMarketPlace EN - Revision history

Grandoc at 08:48, 12 October 2026

2026-10-12T08:48:19Z

@@ Line 20: / Line 20: @@
 |Author||Philippe Grand — Atoo-Net
 |-
-|Version||24.0.0
+|Version||24.0.1
 |-
 |License||GNU GPL v3+
@@ Line 77: / Line 77: @@
 The module declares no permission of its own: the administration pages are reserved for Dolibarr administrators, and the shop pages use their own customer session.
 ==Configuration==
@@ Line 308: / Line 343: @@
 <code>robots.txt</code>, <code>sitemap.xml</code> and <code>llms.txt</code> are regenerated automatically when the module is enabled, when the Settings tab is opened and after a template reset. Once simplified URLs are enabled, the old URLs remain valid during the transition.
 ==What's new in version 24.0.0==
@@ Line 330: / Line 369: @@
 ==FAQ==

Grandoc at 20:35, 6 October 2026

2026-10-06T20:35:04Z

Show changes

Grandoc at 14:52, 29 July 2026

2026-07-29T14:52:41Z

← Older revision		Revision as of 14:52, 29 July 2026
Line 284:		Line 284:

	* [[Module_UltimateMarketPlace_FR\|Documentation française du module UltimateMarketPlace]]		* [[Module_UltimateMarketPlace_FR\|Documentation française du module UltimateMarketPlace]]
			* [[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]]

			[[fr:Module_UltimateMarketPlace_FR]]
			[[de:Module_UltimateMarketPlace_DE]]
			[[es:Module_UltimateMarketPlace_ES]]
			[[it:Module_UltimateMarketPlace_IT]]

Grandoc: Created page with "Category:Modules Category:AtooNet =Module UltimateMarketPlace= ==Overview== The '''UltimateMarketPlace''' module is an extension for Dolibarr ERP/CRM published by [..."

2026-07-08T12:20:50Z

Created page with "Category:Modules Category:AtooNet =Module UltimateMarketPlace= ==Overview== The '''UltimateMarketPlace''' module is an extension for Dolibarr ERP/CRM published by [..."

New page

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

=Module UltimateMarketPlace=

==Overview==

The '''UltimateMarketPlace''' module is an extension for Dolibarr ERP/CRM published by [https://www.atoo-net.com Atoo-Net].

It provides all the features needed to publish a '''single-vendor online marketplace''': a ready-to-use website template (product catalog, shopping cart, checkout tunnel, customer accounts) built on top of Dolibarr's Website module, to sell your own products and services directly online.

It is a simplified fork of the Dolibarr "Marketplace" module (used for dolistore.com), from which everything specific to the Dolibarr association, as well as the multi-vendor / third-party developer module submission and review workflow, has been removed.

{| class="wikitable"
|-
!Property!!Value
|-
|Author||Philippe Grand — Atoo-Net
|-
|Version||1.0
|-
|License||GNU GPL v3+
|-
|Dolibarr minimum||v24.0
|-
|PHP minimum||v8.0
|}

==Why use UltimateMarketPlace?==

UltimateMarketPlace turns your Dolibarr installation into a standalone online shop, without depending on a CMS or a third-party ecommerce platform (such as PrestaShop or WooCommerce). Your catalog, orders, invoices and customers all stay natively inside Dolibarr.

===Use cases===

====Selling physical or dematerialized products====
Publish your catalog of products or services directly from Dolibarr product sheets. The module handles both physical goods (with shipping fees) and dematerialized items (downloads, licenses, services).

====Loyalty for professional customers====
Using automatic discounts for "preferred customers" (a dedicated third-party category), offer a negotiated preferential rate to your best customers, with the option to exclude specific products from the discount.

====Promotions and coupon codes====
Create discount codes (percentage or fixed amount), limited in time or in number of uses, optionally restricted to a specific product, to drive your online sales campaigns.

====Cart upselling====
Automatically add a complementary product to the cart (e.g. insurance, warranty, eco-contribution), calculated as a percentage of the total and restricted to the countries of your choice.

====Online payment====
Connect the checkout tunnel to the payment methods already configured in Dolibarr (Stripe, PayPal, bank transfer…), either through a classic redirect to your back office, or embedded in a frame inside the shop.

====Audience tracking====
Integrate Matomo Analytics to track traffic and purchase behavior on your shop, without relying on Google Analytics.

==Installation==

'''Requirements''': the module requires the following Dolibarr modules to be enabled (they are enabled automatically if needed): Third Parties, Products, Services, Categories, Orders, Invoices, Bank, Mailing and Website.

#Download the module from [https://www.dolistore.com DoliStore] or clone the Git repository into <code>htdocs/custom/ultimatemarketplace</code>
#Go to '''Home → Setup → Modules/Applications'''
#Locate '''UltimateMarketPlace''' in the '''AtooNet''' section
#Enable the module by clicking the button in the ''Enabled'' column

[[File:ultimatemarketplace_activation.png|center|thumb|800px|Activating the UltimateMarketPlace module in the AtooNet section]]

On activation, the module automatically performs several actions:

*Creates a '''dedicated website''' (reference <code>ultimatemarketplace</code>) with the "website_template-ultimatemarketplace" template imported
*Creates a '''root product category''' for items visible on the marketplace
*Creates a '''third-party category''' for customers/prospects created from the storefront
*Adds 3 product '''extrafields''': "Marketplace" separator, comment after price (<code>PriceComment</code>) and public disclaimer message (<code>DisclaimerMessage</code>)

==Setup==

The module is configured under '''Home → Setup → Modules/Applications → UltimateMarketPlace''', split into several tabs.

===General: products and third parties===

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_NAME</code>||Marketplace name
|-
|<code>ULTIMATEMARKETPLACE_EMAIL</code>||Marketplace contact email
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID</code>||Root category for products sold on the marketplace
|-
|<code>ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS</code>||Category featured in the central block of the home page
|-
|<code>ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID</code>||Category used by the "Version" widget on the home page
|-
|<code>ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID</code>||Category used by the "Promotions" widget on the home page
|-
|<code>ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE</code>||Minimum product price (if the product is not free)
|-
|<code>ULTIMATEMARKETPLACE_DELAY_FOR_NEW</code>||Maximum age (in days) for a product to appear in the "New products" section
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID</code>||Category assigned to all prospects/customers created from the storefront
|}

===Discounts for preferred customers===

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID</code>||Category for third parties labeled "Preferred", eligible for the discount
|-
|<code>ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT</code>||Discount percentage applied to these third parties
|-
|<code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code>||Category of products excluded from this discount
|}

===Website===

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_URL_FOR_LOGO</code>||URL of the marketplace logo
|-
|<code>ULTIMATEMARKETPLACE_THEME_COLOR</code>||Main theme color (buttons, banners, highlighted elements)
|-
|<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>||Dolibarr website used by the marketplace
|-
|<code>ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE</code>||Technical user allowed to perform website actions (adding products, managing third parties, placing orders)
|}

'''Important''': if you change the associated website (<code>ULTIMATEMARKETPLACE_WEBSITE_ID</code>), existing users, third parties and orders remain linked to the old website and are not migrated automatically.

===Email templates===

Three Dolibarr email templates can be customized:

*'''Welcome email''' sent when the customer account is created
*'''"Forgot password" email'''
*'''Order confirmation email''' sent to the buyer

===Additional product in cart===

Automatically adds a complementary product (insurance, warranty, eco-contribution…) to the cart:

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID</code>||Additional product to add
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT</code>||Price of the additional product, expressed as a % of the cart total
|-
|<code>ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES</code>||Country codes where this additional product applies
|}

===Shipping fees===

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT</code> / <code>ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID</code>||Dolibarr product used to bill shipping fees
|}

===Registration: Google reCAPTCHA===

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM</code>||Enables Google Captcha on the registration form
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY</code>||Public reCAPTCHA key provided by Google
|-
|<code>ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY</code>||Private reCAPTCHA key (keep confidential)
|}

===Payment===

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_BLOCK_SALES</code>||Temporarily blocks sales on the marketplace
|-
|<code>ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT</code>||Automatically closes the order after a successful payment
|-
|<code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>||Payment method to use
|}

Two payment integration modes are available:

*'''Separate page''' (default): no particular setup required, the customer is redirected to the public payment pages of your Dolibarr back office. Drawback: the back office's domain is visible to the customer.
*'''Frame''' (advanced users): the back office's payment page is called through a URL of the marketplace shop itself. Requires a proxy setup on the marketplace's web server to redirect the requests to the Dolibarr back office. Advantage: the back office's domain stays hidden.

===API===

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_PUBLIC_API_KEY</code>||Public key used to access the products/categories API
|}

The API exposes an XML feed of products and categories, with the parameters <code>categorieid</code>, <code>limit</code>, <code>page</code>, <code>search</code> and <code>lang</code>. A proxy routing setup can be put in place to hide the real API URL behind the shop's own domain.

===Matomo===

{| class="wikitable"
|-
!Constant!!Description
|-
|<code>ULTIMATEMARKETPLACE_ENABLE_MATOMO</code>||Enables Matomo Analytics on the marketplace website
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SITE_KEY</code>||Matomo Site ID
|-
|<code>ULTIMATEMARKETPLACE_MATOMO_SERVER_URL</code>||Full URL of your Matomo server
|}

===Coupon codes===

A dedicated '''Coupon codes''' tab lets you create discount codes:

*'''Discount type''': percentage or fixed amount excluding tax
*'''Maximum number of uses''' (leave empty for unlimited use)
*Can be restricted to a '''specific product'''
*Tracks the number of uses already made

[[File:ultimatemarketplace_coupons.png|center|thumb|800px|Coupon codes administration tab]]

The code is verified when applied to the cart: a code that does not exist, has expired, or has already been fully used is rejected ("This coupon code is invalid, expired or already used up").

==Usage==

===Online shop (storefront)===

The site generated by the module follows the branding defined in the setup (logo, main color) and provides:

#A product catalog organized by category, highlighting '''new products''' and '''promotions'''
#A product sheet showing price, a free-text comment after the price, and a public disclaimer message when configured
#A cart with coupon code redemption, automatic "preferred customer" discount calculation, and the optional additional product
#A checkout tunnel connected to the payment methods configured in Dolibarr
#A customer area (registration, login, order history) protected by Google reCAPTCHA when enabled

[[File:ultimatemarketplace_home.png|center|thumb|800px|Home page of the shop generated by UltimateMarketPlace]]

===Product tag management===

The '''UltimateMarketPlace → Products without tags''' menu lists marketplace products/services that have not yet been assigned to a category/tag, so you can bulk-apply one or more tags to them.

===Statistics===

The module adds statistics pages dedicated to the marketplace:

*'''Invoice''' and '''sales''' statistics (grouped by country/VAT rate or by zone/VAT rate)
*'''Customer''' statistics (latest third parties created, latest "preferred" third parties)
*'''Product/service''' statistics (ranked by popularity)

===Order and invoice tracking===

Two menu entries let you quickly find the orders and invoices coming from the marketplace (filtered on <code>module_source = ultimatemarketplace</code>).

==FAQ==

===The marketplace website was not created automatically===
Check that Dolibarr's '''Website''' module is enabled. If the website still doesn't exist after enabling the module, disable and re-enable UltimateMarketPlace.

===How do I change the website used without losing existing orders?===
This is not recommended: changing <code>ULTIMATEMARKETPLACE_WEBSITE_ID</code> does not migrate existing users, third parties and orders to the new website. They stay associated with the old one.

===Can I limit the "preferred customer" discount to specific products only?===
Yes, by setting <code>ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID</code> to a category grouping the products to exclude from the discount.

===Is payment in a frame mandatory?===
No, it is an option for advanced users. By default, payment simply redirects to the public payment pages of your Dolibarr back office, with no particular server setup.

===Which payment methods are supported?===
Any payment method already natively supported by Dolibarr (Stripe, PayPal, bank transfer, etc.), selected via <code>ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD</code>.

==See also==

*[https://www.atoo-net.com Atoo-Net — Module publisher]
*[https://framagit.org/grandoc/ultimatemarketplace Module repository]
*[https://wiki.dolibarr.org/index.php/Module_Website Dolibarr Website module documentation]

==Other languages==

* [[Module_UltimateMarketPlace_FR|Documentation française du module UltimateMarketPlace]]