Module Marketplace

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Informations

Module name Marketplace
Editor / Editeur dolibarr-foundation
Download or buy page / Page achat ou téléchargement
Status / Statut / Estado Development / Développement
Prerequisites / Prérequis

Dolibarr min version: 20    Dolibarr max version: {{{maxversion}}}

Last update date / Date mise à jour fiche / Fecha última actualización 2025-03-16
Note / Nota


Features

The Marketplace module provides a fully operational online marketplace, where customers can explore and purchase products from various vendors and vendors can submit or manage their product to sell. It offers robust support for vendor management, payment processing, and order management within Dolibarr, making it an ideal solution for businesses looking to efficiently manage a marketplace ecosystem.

Prerequisites

This module requires Dolibarr version 20 or higher.

Additionally, the following modules are required: Website, Products/Services, Tags/Categories, Third Parties, Vendors, Sales Orders, Invoices, Bank, Mailing.

Installation

From the application

  • Download the archive file of module (.zip file)
  • Go on menu Home -> Setup -> Modules -> Deploy external module and submit the file.
  • Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Manually

  • Download the archive file of module (.zip file)
  • Put the file into the root directory of Dolibarr.
  • Uncompress the archive file, for example with command
unzip modulefile.zip
  • Module is then visible into list of available modules (Home -> Setup -> Modules) and can be activated.

Setup

To use this module, you must first enable it using an administrator account, via the menu option "Home - Setup - Modules".

Choose the tab where the module is listed. Then click on "Activate".

The module is now activated.

If a cog icon appears Cog circle.svg on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

Once the Marketplace module is activated, the following elements will be created:

  • Website: A new website named Marketplace.
  • Product Categories:
    • A root category for products listed on the marketplace.
    • A category for the Version widget displayed on the marketplace homepage.
    • A category for the Promotions widget displayed on the marketplace homepage.
    • A category for products excluded from discounts.
  • Customer & Vendor Categories:
    • A category for all prospects or customers created from the marketplace.
    • A category for all vendors selling products on the marketplace.
    • A category for prospects or customers labeled as Preferred or qualified for discounts.
  • Email Templates:
    • Welcome email template for new account registrations.
    • Password recovery email template.
    • Order confirmation email template for buyers.
    • Order notification email template for sellers.

This setup ensures a structured and automated marketplace environment within Dolibarr.

Configuration

General Setup

The Marketplace module comes preconfigured with default settings. However, you can fully customize various elements, including product categories, email templates, website information, default email settings, and the marketplace logo. All these options can be managed through the Settings tab.

Payments Setup

In the Payments Setup tab, you can define how payments are processed within the marketplace:

  • Embedded Payment Mode: The payment pages provided by Dolibarr can be displayed within an iframe inside the marketplace shop. This option is intended for advanced users and may require additional configuration.
  • Redirected Payment Mode: If the payment process is handled on a separate page, no specific setup is required. The marketplace shop will automatically redirect users to the Dolibarr back-office public payment pages.

Google Captcha Setup

The Google reCAPTCHA Setup tab allows you to configure and enable Google reCAPTCHA for pages containing forms. This enhances security by preventing spam and automated submissions.

Prestashop migration

The Marketplace module includes example scripts to assist with migrating data from PrestaShop 1.6 to Dolibarr. Additionally, you will find a guide on how to adapt these scripts, as well as rewrite rules to be included in your Apache virtual host configuration file.

These resources are available in the Migration Tips tab.

Development and contributions

The development of this Open Source application is available on GitHub:

We encourage community contributions. Whether it's bug fixes, feature enhancements, or optimizations, your pull requests are highly valued and contribute to the continuous improvement of the Marketplace module.

Troubleshooting