Ultimatepropale v24

📌 Version du module : 24.0.0 📅 Dernière mise à jour : 07/10/2026 👤 Éditeur/Licence : Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Langues de l'interface : 📧 Support : par e-mail à l'adresse contact@atoo-net.com ✅ Compatibilité Dolibarr : Dolibarr 24 ✅ Module requis : Propositions commerciales ✅ Version PHP requise : PHP 8.2 ou supérieur 💡 Mises à jour gratuites pendant 1 an pour une même version, puis 50 % de remise sur la version suivante.

Donnez à vos devis Dolibarr l'apparence de votre entreprise avec UltimatePropale

Le module UltimatePropale remplace le modèle PDF natif de Dolibarr pour les propositions commerciales (devis) par un modèle entièrement personnalisable : ultimatepropale_propal.

Il permet de définir votre charte graphique (logo, couleurs, marges, fond de page, largeur des colonnes), de choisir précisément ce qui s'affiche sur le devis, d'y joindre vos CGV ou des PDF annexes, d'y ajouter des codes-barres et QR-codes, et de le faire signer en ligne par votre client.

Aucune ligne de code n'est nécessaire : tout se configure depuis les écrans d'administration du module, avec des aperçus graphiques et des poignées de redimensionnement à la souris.

UltimatePropale est l'édition du module UltimatePDF dédiée aux devis. Pour les commandes et les factures, voyez UltimatepdfLight ou UltimateInvoice. Pour les contrats, expéditions, bons de livraison, notes de frais, interventions, projets, produits/nomenclatures ou documents fournisseurs, la version complète UltimatePDF est nécessaire.

🎨 Ce que vous pouvez personnaliser

🧩 Deux niveaux de configuration à ne pas confondre

Le module s'articule autour de deux notions distinctes :

1. Le Design (onglet Modèles) définit à quoi ressemble le devis : couleurs, marges, logo, alias société, fond de page, largeur des colonnes.

2. Les pages Options et Devis décident ce qui s'affiche sur le devis : colonnes visibles, blocs d'adresses, mentions légales, bon pour accord, signatures imprimées.

Plusieurs Designs peuvent coexister. Un seul est actif par défaut, et un sélecteur placé en haut à droite de l'application permet d'en changer instantanément, sans repasser par la configuration.

Chaque bloc du formulaire de Design possède son propre bouton Enregistrer : vous validez bloc par bloc sans perdre votre saisie sur les autres.

🖌️ Personnalisation graphique (Designs)

• Fond de page : image de fond ou PDF de fond, pour utiliser un papier à en-tête déjà maquetté, avec réglage de la transparence et du positionnement X/Y.

• En-tête : hauteur et largeur du logo, second logo pour un partenaire ou une certification, largeur du bloc expéditeur avec aperçu glisser-déposer et préréglage enveloppe à fenêtre norme postale française.

• Alias société : affichez une raison sociale, une adresse, un capital ou un numéro de TVA différents de l'entité juridique réelle, pour une marque commerciale ou une filiale.

• Icônes vectorielles : les icônes téléphone, mobile, fax, e-mail et site web des blocs d'adresse sont des icônes Font Awesome, nettes à tous les niveaux de zoom, avec une couleur réglable par Design.

• Marges et colonnes : marges du PDF et largeur de chaque colonne du tableau de lignes (référence, image, TVA, prix unitaire, quantité, unité, remise), redimensionnables à la souris sur un aperçu graphique.

• Pied de page : taille de police, hauteur réservée au texte libre, couleurs du texte et du fond.

• Police : choix de la police du document, avec DejaVuSans pour les jeux de caractères étendus ou cyrilliques.

• Export / import : chaque Design s'exporte dans un fichier JSON et se réimporte sur le même Dolibarr ou sur un autre, y compris un Design exporté depuis UltimatePDF, UltimatepdfLight ou UltimateInvoice. Le Design importé est créé désactivé, et renommé si son libellé existe déjà : rien n'est écrasé.

• Aperçu PDF réel : un bouton du formulaire génère le PDF du devis le plus récent avec les réglages en cours de saisie, sans les enregistrer. Les blocs du formulaire se replient en accordéon.

📄 Contenu du devis

Les options s'activent indépendamment les unes des autres, par simple case à cocher :

📎 Fusion de PDF et conditions générales de vente

📑 Pages de présentation et signature en ligne

Le devis peut s'ouvrir sur une véritable offre commerciale, puis être signé par le client depuis une page web, sans impression ni scan.

🔎 Codes-barres et QR-codes

• Codes-barres produits (EAN13 avec clé de contrôle, CODE128, CODE39) et codes-barres tiers, en haut ou en bas de page.

• QR-codes société (MyCompany) ou tiers. Un seul QR-code est autorisé à la fois en haut du devis, pour éviter toute superposition.

🧱 Compatibilité avec le module Milestone

UltimatePropale reconnaît les lignes jalons du module Milestone : elles ne sont pas traitées comme des lignes produit classiques dans le calcul du poids de ligne et du prix unitaire après remise, et conservent leur mise en forme propre dans le PDF.

📖 Guide d'utilisation intégré

Un guide complet en français, anglais, allemand, espagnol et italien est consultable directement depuis la configuration du module, onglet Guide utilisateur, dans la langue de l'interface.

Il détaille chaque option écran par écran, avec un fil conducteur unique de bout en bout : création d'un Design, réglage des options, génération et signature d'un devis. Il est mis à jour à chaque version.

⚙️ Prérequis

⚙️ Installation

Le zip du module pèse environ 1,5 Mo : il passe sous la limite d'envoi de 2 Mo appliquée par défaut par Dolibarr et par PHP, mais une installation plus restrictive peut le refuser. Trois méthodes sont possibles, de la plus simple à la plus technique.

Méthode 1 : installation via l'interface Dolibarr

1. Accueil → Configuration → Modules/Applications, onglet Déployer/Installer un module externe.

2. Choisir le fichier .zip du module, puis cliquer sur Envoyer fichier.

Si Dolibarr répond « La taille du fichier est trop grande ou le fichier n'est pas fourni », l'une des trois limites suivantes est trop basse (c'est la plus petite qui l'emporte) :

Les valeurs en vigueur s'affichent en survolant l'icône d'information à droite du bouton Envoyer fichier, et dans Accueil → Outils d'administration → Infos PHP. Après modification du php.ini, redémarrer le serveur web ou PHP-FPM si l'hébergeur ne le fait pas. En hébergement mutualisé, ces limites ne sont pas toujours modifiables : utiliser alors la méthode 2 ou 3.

Méthode 2 : installation manuelle sur le serveur (SSH)

1. Copier le zip sur le serveur puis le décompresser : unzip module_ultimatepropale-X.Y.Z.zip -d /tmp/ultimatepropale_zip

2. Copier le dossier du module : cp -r /tmp/ultimatepropale_zip/htdocs/ultimatepropale /chemin/vers/dolibarr/htdocs/custom/

3. Donner les droits au serveur web si nécessaire : chown -R www-data:www-data /chemin/vers/dolibarr/htdocs/custom/ultimatepropale

4. Vérifier que le module se trouve bien dans htdocs/custom/ultimatepropale (et non htdocs/custom/htdocs/ultimatepropale).

Méthode 3 : envoi par FTP / SFTP (en dernier recours)

1. Décompresser le zip sur votre ordinateur : il contient un dossier htdocs, qui contient lui-même le dossier ultimatepropale.

2. Avec un client FTP/SFTP (FileZilla par exemple), envoyer le dossier ultimatepropale (ni le zip, ni le dossier htdocs qui l'entoure) dans le répertoire custom de Dolibarr (celui qui voisine avec admin, core, conf… ; selon l'hébergeur, dans htdocs, httpdocs, www ou public_html).

3. Vérifier dans le journal du client qu'aucun fichier n'est en échec, puis que le chemin …/custom/ultimatepropale/core/modules/modUltimatePropale.class.php existe.

Ensuite

1. Activer le module depuis Accueil → Configuration → Modules, onglet Atoo-Net.

2. Sélectionner le modèle ultimatepropale_propal dans la liste déroulante Modèles de la fiche du devis.

3. Choisir ultimatepropale_propal comme modèle par défaut dans Accueil → Configuration → Modules → Propositions commerciales (colonne Défaut) : c'est lui qu'utilisent la validation et les actions de masse. L'ancien modèle ultimate_propal disparaît avec UltimatePDF.

🧭 Cas d'utilisation typiques

• Aligner vos devis sur votre charte graphique : sans faire développer de modèle PDF sur mesure.

• Vendre sous une marque commerciale : utiliser l'alias société pour afficher une raison sociale ou une adresse différentes de l'entité juridique.

• Faire signer vos devis : bloc « bon pour accord » imprimé, ou zone de signature client en ligne.

• Présenter votre offre : ajouter des pages de présentation avant le devis et suivre ses versions successives.

• Envoyer vos devis sous pli : utiliser le préréglage d'enveloppe à fenêtre et le repère de pliage.

• Joindre systématiquement vos CGV : ajouter automatiquement le bon document contractuel et les fiches techniques des produits à la suite de chaque devis.

❓ FAQ

• Quelle différence avec UltimatePDF, UltimatepdfLight et UltimateInvoice ?
  UltimatePropale est l'édition d'UltimatePDF limitée aux devis. UltimatepdfLight couvre les devis, commandes et factures, UltimateInvoice les factures seules. UltimatePDF couvre en plus les contrats, expéditions, notes de frais, interventions, projets, produits et documents fournisseurs.

• Le module modifie-t-il le cœur de Dolibarr ?
  Non. UltimatePropale ajoute un modèle de document supplémentaire et s'appuie sur les hooks standards. Les modèles PDF natifs restent disponibles : vous pouvez revenir en arrière à tout moment en les resélectionnant sur la fiche.

• Puis-je avoir plusieurs mises en page différentes ?
  Oui. Créez autant de Designs que nécessaire. Un seul est actif par défaut, et un sélecteur en haut à droite de l'application permet de basculer de l'un à l'autre.

• Puis-je reprendre un Design d'UltimatePDF ?
  Oui. Exportez-le en JSON depuis UltimatePDF, UltimatepdfLight ou UltimateInvoice, puis importez-le dans UltimatePropale.

• Faut-il des compétences techniques ?
  Non. Toute la configuration se fait depuis les écrans d'administration, avec des aperçus graphiques. Aucune modification de fichier n'est nécessaire.

• Le module est-il compatible avec les jalons du module Milestone ?
  Oui. Les lignes jalons sont reconnues et conservent leur mise en forme propre dans le PDF.

• Mes anciens devis sont-ils modifiés ?
  Non. Seuls les devis régénérés après activation du modèle utilisent la nouvelle mise en page. Les PDF déjà produits restent intacts.

• Si j'ajoute une couverture, des pages de présentation et des CGV, la signature en ligne tombe-t-elle au bon endroit ?
  Oui. À chaque génération, le modèle inscrit dans le PDF le numéro de la page qui porte le cadre « Bon pour accord » ; Dolibarr y appose la signature, quels que soient le nombre de pages de présentation et la longueur des annexes. Pensez simplement à régénérer le PDF après toute modification du devis, avant d'envoyer le lien.

Pourquoi utiliser UltimatePropale ?

• Obtenir des devis à votre image sans faire développer de modèle PDF sur mesure

• Régler la mise en page depuis des écrans d'administration, avec aperçus et redimensionnement à la souris

• Créer plusieurs Designs et basculer de l'un à l'autre en un clic

• Utiliser un papier à en-tête existant comme fond de page, image ou PDF

• Vendre sous une marque commerciale grâce à l'alias société

• Choisir précisément les colonnes et les blocs affichés sur le devis

• Faire signer vos devis en ligne

• Joindre automatiquement vos CGV et vos PDF annexes

• Ajouter codes-barres et QR-codes

• Conserver le modèle natif de Dolibarr disponible à tout moment

⚠️ Recommandation importante

Comme pour tout module modifiant l'apparence de documents commerciaux, testez UltimatePropale sur une instance de test avant de l'utiliser en production.

Avant de commencer, effectuez une sauvegarde complète de :

• La base de données Dolibarr

• Le répertoire de documents Dolibarr

Après configuration, générez un devis court et un devis long sur plusieurs pages, puis contrôlez les blocs d'adresses, les totaux, le pied de page et l'absence de page blanche avant de généraliser le modèle.

📖 Documentation

La documentation complète du module est disponible sur le wiki officiel de Dolibarr :

👉 Wiki Dolibarr – Module UltimatePropale (FR)

Documentation dans les autres langues :

👉 Wiki Dolibarr – Module UltimatePropale (EN)

👉 Wiki Dolibarr – Module UltimatePropale (DE)

👉 Wiki Dolibarr – Module UltimatePropale (ES)

👉 Wiki Dolibarr – Module UltimatePropale (IT)

Un guide d'utilisation complet est également intégré au module, onglet Guide utilisateur de sa page de configuration.

Plus de modules