Module OnePageBasket: Difference between revisions

Jump to navigation Jump to search

Module OnePageBasket (view source)

Revision as of 11:47, 23 October 2026

5,048 bytes added ,  16 days ago
OnePageBasket 1.5.1
VisualWikitext
(link to doc)
(OnePageBasket 1.5.1)
 
Line 1: Line 1:
[[Category:Modules complémentaires]]
[[fr:Module_OnePageBasket_FR]]
[[Category:E-commerce]]
[[Category:Complementary modules]]
[[Category:CAP-REL]]
[[Category:CAP-REL]]
{{TemplateDocDevFr}}
{{TemplateDocDevEn}}
{{TemplateDocUtil}}
{{TemplateDocUser}}
=Informations=
=Information=
{{TemplateModuleInfo
{{TemplateModuleInfo
|modulename=OnePageBasket
|modulename=OnePageBasket
Line 11: Line 11:
|webbuy={{LinkToPluginDownloadDoliStore|keyword=onepagebasket}}
|webbuy={{LinkToPluginDownloadDoliStore|keyword=onepagebasket}}
|status=stable
|status=stable
|prerequisites=
|prerequisites=Agenda, Invoices, Services, Banks, Categories and Contracts modules (enabled with OnePageBasket)
|minversion=14.0.0
|minversion=18.0.0
|note=Une page de vente en ligne pour articles dématérialisés
|note=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.
}}
}}


=Fonctionnalités=
=Features=


Après l'activation de ce module vous pourrez mettre en vente n'importe quel article de votre dolibarr sous la forme d'une simple page de commande directe sans intermédiaires comme par exemple ceci: https://shop.cap-rel.fr/?ref=MOD-Dolibarr-OnePageBasket
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==
<gallery widths="300px" heights="200px">
File:OnePageBasket vitrine-accueil.png|Shop home page
File:OnePageBasket vitrine-fiche-produit.png|Product page
File:OnePageBasket panier-achat.png|Basket
File:OnePageBasket portail-client-accueil.png|Customer portal
File:OnePageBasket portail-commandes.png|Orders of the customer in the portal
File:OnePageBasket portail-favoris.png|Favourites lists
File:OnePageBasket vitrine-mobile.png|The shop on a phone
File:OnePageBasket configuration-onglets.png|Setup tabs in Dolibarr
</gallery>
=Links=
* [https://doc.cap-rel.fr/onepagebasket/?lang=en Module documentation]
* [https://doc.cap-rel.fr/onepagebasket/nouveautes-1-5-1 What's new in version 1.5.1] (in French)
* [https://dolinews.com/en/projets/onepagebasket Get update notifications]
* [https://cap-rel.fr/sav-module-dolibarr/ Support form]
* [https://dolitest.fr/onepagebasket/ Online demo]: a Dolibarr with OnePageBasket, created for you in less than 20 seconds and removed after the session
* [https://shop.cap-rel.fr/ A shop running OnePageBasket]
=Requirements=
{| class="wikitable"
! 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=
=Installation=


{{InstallModuleDoliStoreFr|keyword=onepagebasket}}
{{InstallModuleDoliStoreEn|keyword=onepagebasket}}
 
==Upgrade==
 
# Install the new version through '''Home > Setup > Modules/Applications > Deploy/install external app/module'''.
# 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=
 
{{ActivationModuleEn}}
 
The setup is in '''Home > Setup > Modules > OnePageBasket'''. First set:
 
# '''Default user''' (mandatory): the Dolibarr user that creates the orders and invoices of the shop.
# '''Default country''': used for VAT when the customer does not give a country.
# '''Public address''': the address of your shop. A dedicated virtual host pointing to the <code>public/</code> folder of the module is recommended.
# '''Root category''': only the products of this category and of its subcategories are shown.


Pour cloisonner votre dolibarr la création d'un hôte virtuel est fortement conseillé, par exemple avec Apache:
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.


Si votre dolibarr est stocké dans <code>/srv/webs/dolibarr/htdocs</code> le module onepagebasket après installation sera alors ici <code>/srv/webs/dolibarr/htdocs/custom/onepagebasket</code> et toutes les pages dédiées à la partie publique sont dans le sous dossier <code>public</code> vous pouvez donc très facilement faire un hote virtuel dont la racine serait <code>/srv/webs/dolibarr/htdocs/custom/onepagebasket/public</code>
=Permissions=


Exemple pour apache2:
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.
<VirtualHost *:443>
      ServerName shop.cap-rel.fr
      ServerAdmin contact@cap-rel.fr
      Header always add Strict-Transport-Security "max-age=15768000; includeSubDomains; preload"
      DocumentRoot /srv/webs/dolibarr/htdocs/custom/onepagebasket/public
      LogLevel warn
      ErrorLog /srv/webs/dolibarr/logs/error.log
      CustomLog /srv/webs/dolibarr/logs/access.log "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"
      <Directory /srv/webs/dolibarr/htdocs/custom/onepagebasket/public>
        AllowOverride All
        Options Indexes FollowSymLinks MultiViews
        Require all granted
      </Directory>
     
      (bloc de configuration du certificat ssl)
</VirtualHost>


=Configuration=
=Usage=


{{ActivationModuleFr}}
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 [https://doc.cap-rel.fr/onepagebasket/utilisation?lang=en user guide].


=FAQ=


=Utilisation=
'''The shop shows no product.'''<br>
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.


Allez sur la fiche d'un article, ajoutez une image dans les fichiers liés puis complétez les champs (et choisissez quelle image vous voulez mettre en avant sur la partie vente en ligne) et c'est tout.
'''The setup warns that the configuration is incomplete.'''<br>
Choose the default user in the '''Settings''' tab: the shop needs it to create orders and invoices.


Documentation complète : [https://doc.cap-rel.fr/projet_onepagebasket/accueil https://doc.cap-rel.fr/projet_onepagebasket]
'''Addresses of the shop contain index.php.'''<br>
Enable the Apache <code>mod_rewrite</code> module, then the option that hides index.php in the web addresses.


=Développement=
=Development=


Les développements et améliorations peuvent être proposés au responsable du projet par email (voir dans les entêtes des fichiers sources).
Developments and improvements can be suggested to the project maintainer by email (see the headers of the source files) or through the [https://cap-rel.fr/sav-module-dolibarr/ support form].
Eric.seigne
417

edits

Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/68546"

Navigation menu