📦 Module Dolibarr – PublicQuote

🎯 Objectif

Permettre aux visiteurs d’un site public Dolibarr de :

• parcourir un catalogue produits

• ajouter des produits à un panier (devis)

• remplir un formulaire de demande

• envoyer une demande de devis

• notifier l’entreprise par email

• fonctionner en environnement multi-entity

🛒 1. Catalogue Produits Public

• Page publique :
  /custom/publicquote/public/catalog.php

Fonctionnalités :

• Liste des produits actifs

• Affichage image produit (multi-entity OK)

• Bouton Ajouter au devis

• Gestion AJAX du panier

• Compatible ?entity=X

📄 2. Fiche Produit

• Page produit individuelle

• Ajout au panier via POST sécurisé

• Fonctionne en multi-entity

• Image produit dynamique (via image.php)

🧺 3. Panier (Devis temporaire)

• Stockage en session PHP

• Compatible multi-entity

• Compteur dynamique

• Suppression d’articles

• Vidage panier

AJAX géré via :

/public/ajax/cart.php

📝 4. Formulaire de demande de devis

Page :

/public/checkout.php

Champs :

• Email (obligatoire)

• Nom (obligatoire)

• Téléphone

• Société

• Ville

• Adresse

• Code postal

• Message / besoin

• RGPD obligatoire

✔ Bloc RGPD dédié sécurisé
✔ Alignement propre
✔ Validation required

📧 5. Envoi Email

Deux modes possibles :

Mode A – Email natif Dolibarr (CMailFile)

Utilise la configuration email globale Dolibarr.

Mode B – SMTP personnalisé du module

• Paramètres SMTP configurables

• Authentification

• Support TLS/SSL

• Correction bug destinataires (RCPT)

🏢 6. Multi-Entity

• Gestion correcte de ?entity=X

• Contexte forcé côté AJAX

• Images entity-correctes

• Produits entity-corrects

• Panier isolé par entity

🔐 7. Sécurité

• GETPOST filtré

• Session isolée

• Validation RGPD obligatoire

• Pas d’injection JS

• Pas d’erreur AJAX bloquante

🎨 8. Interface

• Thème sombre custom

• Navigation en étapes :

  • Produits

  • Mon devis

  • Coordonnées

  • Confirmation

• Responsive

📂 Architecture simplifiée

custom/publicquote/
│
├── public/
│ ├── catalog.php
│ ├── checkout.php
│ ├── ajax/cart.php
│ ├── inc/rgpd.php
│ └── assets/style.css
│
├── lib/
│ └── publicquote.lib.php
│
└── image.php

🔄 Flux complet utilisateur

1. Le visiteur consulte les produits

2. Il ajoute au devis

3. Il remplit ses coordonnées

4. Il valide RGPD

5. Le module :

   • compile les produits

   • génère le mail

   • envoie notification

   • affiche confirmation