Dolibarr ERP CRM Wiki

Module OnePageBasket

Revision as of 11:47, 23 October 2026 by Eric.seigne (talk | contribs) (OnePageBasket 1.5.1)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Return to developer
documentation index

File Doc dev.png

Return to user
documentation index
File Doc user.png

Information


Module name OnePageBasket
Editor / Editeur CAP-REL - www.cap-rel.fr
Download or buy page / Page achat ou téléchargement External module - www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis Agenda, Invoices, Services, Banks, Categories and Contracts modules (enabled with OnePageBasket)

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2026-10-23
Note / Nota Online shop and customer portal plugged into the Dolibarr catalogue: an order placed online arrives in Dolibarr as a real order, then as a paid invoice.

Features

OnePageBasket turns Dolibarr into an online shop and a customer portal, with no double entry. Your products, services, prices and pictures become a storefront your customers browse on a computer or a phone. An order placed online arrives in Dolibarr as a real order, then as a paid invoice: no synchronisation to watch over, no second tool to keep up to date next to your ERP.

At a glance

  • Who it is for: shops and service providers who already run their business in Dolibarr and want to sell online without setting up a separate platform.
  • What it does: it publishes your Dolibarr catalogue as a shop, takes the order and the payment, creates the third party, the order and the invoice in Dolibarr, and gives your customers a portal with their documents.
  • What it does not do: it does not try to replace Prestashop or WooCommerce; it offers a simple shop, built into Dolibarr.

Feature list

  • Storefront - catalogue by categories, search, product pages with pictures and variants, product badges, customer reviews, carousel, trust badges, multilingual web pages, FAQ, newsletter, customer picture gallery, Open Graph tags, canonical URLs and sitemap.
  • From basket to payment - a single order form, third party created when it does not exist yet (looked up by email or VAT number), order or quote created in Dolibarr with every basket line, online payment through the Dolibarr payment modules, paid invoice sent to the customer, discount codes and rules, saved basket and reminders for abandoned baskets.
  • Physical products and services - shipping costs from the basket weight and the delivery zone, in-store pickup, stock shown and checked, subscriptions from recurring invoices and contract templates, prepaid time, leasing and appointment booking in the Dolibarr agenda.
  • Legal and tax rules - European right of withdrawal (directive 2011/83/EU), intra-EU reverse charge, sales outside the European Union, VAT of the destination country for distance sales to EU consumers (OSS).
  • Private catalogue and B2B sales - products visible only to some customer categories, the Dolibarr price level of the logged-in customer, one account for several companies.
  • Customer portal - quotes, orders, invoices, contracts, interventions, projects and leases as PDF, login by one-time code or password, account details, favourites lists, product returns (RMA), support tickets.
  • Administration - settings in themed tabs, a dedicated dashboard, a permission for a non-administrator shop manager, webhooks on purchase, data cache, multicompany.
  • Themes and languages - several themes, mobile-friendly, with dark mode; shop and portal in English, French, German, Spanish, Italian, Dutch, Polish and Brazilian Portuguese.

Screenshots

  • Shop home page

  • Product page

  • Basket

  • Customer portal

  • Orders of the customer in the portal

  • Favourites lists

  • The shop on a phone

  • Setup tabs in Dolibarr

Links

Requirements

Item Version or condition
Dolibarr 18.0 or higher
PHP 7.4 or higher
Rights an administrator account to install, enable and set up the module
Online payment a Dolibarr payment module (card and SEPA direct debit through Stripe or Stancer)

Enabling OnePageBasket also enables the Agenda, Invoices, Services, Banks, Categories and Contracts modules. Depending on the features used, enable Commercial proposals, Sales orders, Stock, Shipments and Tickets too.

Installation

  • Download archive file of module (.zip file) from web site www.dolistore.com or from any other source.
  • Install module into the /custom folder of Dolibarr:
    • Go to Home - Setup - Modules - Deploy/install external app/module
    • Upload the file. Note: If it fails because upload from this page has been locked by your web hosting provider, you can manually unzip the file into the /custom directory from command line: Go into the /custom directory and uncompress file with command unzip modulefile.zip then check that the directory with the nameof the module is inside the /custom directory. If into a subdirectory, just move it into /custom.
  • Module should be ready to be activated and used.

Upgrade

  1. Install the new version through Home > Setup > Modules/Applications > Deploy/install external app/module.
  2. Disable then enable the module again: enabling applies the database upgrades and registers the new permissions.

Your settings, pages and customer accounts are kept.

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   on module thumb or at end of the line of the module, click on it to access the setup page specific to the module.

The setup is in Home > Setup > Modules > OnePageBasket. First set:

  1. Default user (mandatory): the Dolibarr user that creates the orders and invoices of the shop.
  2. Default country: used for VAT when the customer does not give a country.
  3. Public address: the address of your shop. A dedicated virtual host pointing to the public/ folder of the module is recommended.
  4. Root category: only the products of this category and of its subcategories are shown.

The other settings are grouped in tabs: Settings, Appearance, Catalogue, Sales, Shipping, Customer portal, Returns, Content, Web pages, Gallery, Services, Tickets (when the Tickets module is enabled), Advanced and About.

Permissions

The module declares permissions for its customer portal login, its setup pages (a non-administrator can manage the shop), product returns, leasings and appointment availabilities. An administrator grants them from Home > Users & Groups, Permissions tab. After an upgrade, disable then enable the module so that new permissions are registered.

Usage

Prepare the catalogue in Dolibarr (products in the root category, prices, pictures, public notes), then share the address of the shop. Orders and quotes arrive in Dolibarr, linked to the third party of the customer; once paid online, the order becomes a paid invoice sent to the customer. The day-to-day use is described in the user guide.

FAQ

The shop shows no product.
Check the root category of the setup: only the products of this category and of its subcategories are shown, and only when they are on sale.

The setup warns that the configuration is incomplete.
Choose the default user in the Settings tab: the shop needs it to create orders and invoices.

Addresses of the shop contain index.php.
Enable the Apache mod_rewrite module, then the option that hides index.php in the web addresses.

Development

Developments and improvements can be suggested to the project maintainer by email (see the headers of the source files) or through the support form.

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_OnePageBasket&oldid=68546"