Ultimatepropale

📌 Module version: 24.0.0 📅 Last update: October 7, 2026 👤 Publisher/License: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Interface languages: 📧 Support: by e-mail at contact@atoo-net.com ✅ Dolibarr compatibility: Dolibarr 24 ✅ Required module: Commercial proposals ✅ Required PHP version: PHP 8.2 or higher 💡 Free updates for 1 year within the same version, then 50% off the next version.

Give your Dolibarr proposals your company's look with UltimatePropale

The UltimatePropale module replaces Dolibarr's native PDF template for commercial proposals (quotes) with a fully customisable template: ultimatepropale_propal.

It lets you define your brand identity (logo, colours, margins, page background, column widths), choose precisely what is printed on the proposal, append your general sales conditions or extra PDF files, add barcodes and QR codes, and have the proposal signed online by your customer.

No line of code is needed: everything is configured from the module's administration screens, with graphic previews and mouse resizing handles.

UltimatePropale is the edition of the UltimatePDF module dedicated to proposals. For orders and invoices, see UltimatepdfLight or UltimateInvoice. For contracts, shipments, delivery notes, expense reports, interventions, projects, products/BOMs or supplier documents, the full UltimatePDF version is required.

🎨 What you can customise

🧩 Two levels of configuration not to be confused

The module is built around two distinct notions:

1. The Design (Models tab) defines what the proposal looks like: colours, margins, logo, company alias, page background, column widths.

2. The Options and Proposals pages decide what is printed on the proposal: visible columns, address blocks, legal mentions, approval block, printed signatures.

Several Designs can coexist. Only one is active by default, and a selector at the top right of the application switches between them instantly, without going back to the setup.

Each block of the Design form has its own Save button: you validate block by block without losing what you entered in the others.

🖌️ Graphic customisation (Designs)

• Page background: background image or background PDF, to use a pre-designed letterhead, with transparency and X/Y positioning settings.

• Header: logo height and width, second logo for a partner or a certification, sender block width with drag-and-drop preview and a French postal standard window envelope preset.

• Company alias: print a company name, address, capital or VAT number different from the real legal entity, for a trade name or a subsidiary.

• Vector icons: the phone, mobile, fax, email and website icons of the address blocks are Font Awesome icons, sharp at any zoom level, with a colour that can be set per Design.

• Margins and columns: PDF margins and width of each column of the line table (reference, picture, VAT, unit price, quantity, unit, discount), resizable with the mouse on a graphic preview.

• Footer: font size, height reserved for the free text, text and background colours.

• Font: choice of the document font, with DejaVuSans for extended or Cyrillic character sets.

• Export / import: each Design is exported to a JSON file and imported on the same Dolibarr or another one, including a Design exported from UltimatePDF, UltimatepdfLight or UltimateInvoice. The imported Design is created disabled, and renamed if its label already exists: nothing is overwritten.

• Real PDF preview: a button of the form generates the PDF of the most recent proposal with the settings being entered, without saving them. The blocks of the form fold like an accordion.

📄 Proposal content

Options are enabled independently of one another, with a simple checkbox:

📎 PDF merging and general sales conditions

📑 Presentation pages and online signature

The proposal can open with a genuine sales pitch, then be signed by the customer from a web page, with no printing or scanning.

🔎 Barcodes and QR codes

• Product barcodes (EAN13 with check digit, CODE128, CODE39) and third-party barcodes, at the top or bottom of the page.

• Company (MyCompany) or third-party QR codes. Only one QR code at a time is allowed at the top of the proposal, to avoid any overlap.

🧱 Compatibility with the Milestone module

UltimatePropale recognises the milestone lines of the Milestone module: they are not treated as standard product lines in the line weight and unit price after discount calculations, and keep their own formatting in the PDF.

📖 Built-in user guide

A complete guide in English, French, German, Spanish and Italian can be read directly from the module setup, User guide tab, in the interface language.

It details every option screen by screen, with a single end-to-end thread: creating a Design, setting the options, generating and signing a proposal. It is updated with each version.

⚙️ Requirements

⚙️ Installation

The module zip weighs about 1.5 MB: it fits under the 2 MB upload limit applied by default by Dolibarr and by PHP, but a more restrictive installation may reject it. Three methods are available, from the simplest to the most technical.

Method 1: installation from the Dolibarr interface

1. Home → Setup → Modules/Applications, Deploy/install external app/module tab.

2. Choose the module .zip file, then click on Upload.

If Dolibarr answers "File size is too large or file not provided", one of the following three limits is too low (the smallest one wins):

The current values are shown by hovering the information icon to the right of the Upload button, and in Home → Admin Tools → About PHP. After changing php.ini, restart the web server or PHP-FPM if your hosting provider does not do it. On shared hosting, these limits cannot always be changed: use method 2 or 3 instead.

Method 2: manual installation on the server (SSH)

1. Copy the zip to the server and unzip it: unzip module_ultimatepropale-X.Y.Z.zip -d /tmp/ultimatepropale_zip

2. Copy the module folder: cp -r /tmp/ultimatepropale_zip/htdocs/ultimatepropale /path/to/dolibarr/htdocs/custom/

3. Give ownership to the web server if needed: chown -R www-data:www-data /path/to/dolibarr/htdocs/custom/ultimatepropale

4. Check that the module is located in htdocs/custom/ultimatepropale (and not htdocs/custom/htdocs/ultimatepropale).

Method 3: FTP / SFTP upload (last resort)

1. Unzip the archive on your computer: it contains an htdocs folder, which itself contains the ultimatepropale folder.

2. With an FTP/SFTP client (FileZilla for example), upload the ultimatepropale folder (neither the zip nor the surrounding htdocs folder) into the Dolibarr custom directory (the one next to admin, core, conf…; depending on the provider, inside htdocs, httpdocs, www or public_html).

3. Check in the client log that no file failed, then that the path …/custom/ultimatepropale/core/modules/modUltimatePropale.class.php exists.

Then

1. Enable the module from Home → Setup → Modules, Atoo-Net tab.

2. Select the ultimatepropale_propal template in the Models dropdown list of the proposal card.

3. Choose ultimatepropale_propal as the default template under Home → Setup → Modules → Commercial proposals (Default column): it is the one used by validation and mass actions. The former ultimate_propal template disappears with UltimatePDF.

🧭 Typical use cases

• Align your proposals with your brand identity: without having a custom PDF template developed.

• Sell under a trade name: use the company alias to print a company name or address different from the legal entity.

• Have your proposals signed: printed approval block, or online customer signature area.

• Present your offer: add presentation pages before the proposal and track its successive versions.

• Send your proposals by mail: use the window envelope preset and the fold mark.

• Always append your GSC: automatically add the right contractual document and the products' technical sheets after each proposal.

❓ FAQ

• What is the difference with UltimatePDF, UltimatepdfLight and UltimateInvoice?
  UltimatePropale is the edition of UltimatePDF limited to proposals. UltimatepdfLight covers proposals, orders and invoices, UltimateInvoice invoices only. UltimatePDF also covers contracts, shipments, expense reports, interventions, projects, products and supplier documents.

• Does the module modify the Dolibarr core?
  No. UltimatePropale adds an extra document template and relies on standard hooks. The native PDF templates remain available: you can go back at any time by selecting them again on the card.

• Can I have several different layouts?
  Yes. Create as many Designs as needed. Only one is active by default, and a selector at the top right of the application switches from one to another.

• Can I reuse a Design from UltimatePDF?
  Yes. Export it to JSON from UltimatePDF, UltimatepdfLight or UltimateInvoice, then import it into UltimatePropale.

• Are technical skills required?
  No. The whole configuration is done from the administration screens, with graphic previews. No file needs to be modified.

• Is the module compatible with the milestones of the Milestone module?
  Yes. Milestone lines are recognised and keep their own formatting in the PDF.

• Are my existing proposals modified?
  No. Only the proposals regenerated after the template is enabled use the new layout. PDF files already produced remain untouched.

• If I add a cover, presentation pages and terms and conditions, does the online signature land in the right place?
  Yes. On each generation, the template writes into the PDF the number of the page carrying the "Agreed and signed" frame; Dolibarr places the signature there, whatever the number of presentation pages and the length of the appendices. Just remember to regenerate the PDF after any change to the proposal, before sending the link.

Why use UltimatePropale?

• Get proposals in your company's image without having a custom PDF template developed

• Set the layout from administration screens, with previews and mouse resizing

• Create several Designs and switch between them in one click

• Use an existing letterhead as page background, image or PDF

• Sell under a trade name thanks to the company alias

• Choose precisely the columns and blocks printed on the proposal

• Have your proposals signed online

• Automatically append your GSC and extra PDF files

• Add barcodes and QR codes

• Keep Dolibarr's native template available at any time

⚠️ Important recommendation

As with any module that changes the look of commercial documents, test UltimatePropale on a test instance before using it in production.

Before starting, make a full backup of:

• The Dolibarr database

• The Dolibarr documents directory

After configuration, generate a short proposal and a long one spanning several pages, then check the address blocks, totals, footer and the absence of blank pages before rolling out the template.

📖 Documentation

The complete documentation of the module is available on the official Dolibarr wiki:

👉 Dolibarr wiki – UltimatePropale module (EN)

Documentation in other languages:

👉 Dolibarr wiki – UltimatePropale module (FR)

👉 Dolibarr wiki – UltimatePropale module (DE)

👉 Dolibarr wiki – UltimatePropale module (ES)

👉 Dolibarr wiki – UltimatePropale module (IT)

A complete user guide is also built into the module, in the User guide tab of its setup page.

More modules