Grandoc at 17:04, 19 April 2026

2026-04-19T17:04:53Z

← Older revision		Revision as of 17:04, 19 April 2026
Line 6:		Line 6:
	=Information=		=Information=
	{{TemplateModuleInfo		{{TemplateModuleInfo
	\|modulename=Milestone		\|modulename=Milestone/Jalon
	\|editor=[[File:Logo atoonet.jpg\|link=https://www.atoo-net.com]]		\|editor=[[File:Logo atoonet.jpg\|link=https://www.atoo-net.com]]
	\|web=http://www.atoo-net.com		\|web=http://www.atoo-net.com

Grandoc: Created page with "= Table of Contents = Category:Add-on Modules Category:Milestone {{TemplateDocDev}} {{TemplateDocUtil}} =Information= {{TemplateModuleInfo |modulename=Milestone |edito..."

2026-04-19T16:48:17Z

Created page with "= Table of Contents = Category:Add-on Modules Category:Milestone {{TemplateDocDev}} {{TemplateDocUtil}} =Information= {{TemplateModuleInfo |modulename=Milestone |edito..."

New page

= Table of Contents =
[[Category:Add-on Modules]]
[[Category:Milestone]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Information=
{{TemplateModuleInfo
|modulename=Milestone
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|web=http://www.atoo-net.com
|webbuy={{LinkToPluginDownloadDoliStore|keyword=Milestone}}
|status=stable
|prerequisites=
|minversion=20.0.0 - 23.0.0
|note=
''[[#Table of Contents|⬆ Back to top]]''
}}

=Features=
This module allows you to associate/group products/services under a milestone and display the subtotal.
It is possible to add comment lines without details (tax, price, etc.), as well as force page breaks in commercial documents.

The module is compatible with the following document types:
- Commercial proposals
- Customer orders
- Customer invoices
- Supplier orders
- Supplier invoices

Compatible with the Multi-Company module.

Main features:
- '''Line grouping''': associate products/services with a milestone to group them visually and manage them as a block.
- '''Automatic subtotal''': display the total amount per milestone on the document and in the PDF.
- '''Comment lines''': add text lines without amount or VAT.
- '''Forced page break''': insert a page break at any desired position in the PDF.
- '''Move a line into a milestone''': attach an existing line to a milestone after the fact, using a dropdown menu.
- '''Block cloning''': duplicate a milestone and all its child lines in a single click.
- '''Block deletion with options''':
** Option 1 — Delete the milestone and all its lines.
** Option 2 — Delete the milestone only and detach its lines (they remain on the document).
** Option 3 — Delete the milestone and migrate its lines to another existing milestone.
- '''Milestone dictionary''': save reusable milestones from the configuration page.

=Prerequisites=
Dolibarr 20.0.0 - 23.0.0

=⚙️ Installation=

===⚙️ Manual installation===

# '''Download''' the module archive file (.zip).
# '''Place''' the file in the Dolibarr root directory.
# '''Extract''' the zip file with the following command:

<code>unzip module_milestone-X.0.0.zip</code>

# '''Verify''' that the correct module location is:

<code>htdocs/custom/milestone</code>

# '''The module is now available''' and can be enabled from Dolibarr.

---

===⚙️ Installation via the Dolibarr interface===
You can also '''deploy and install''' the module directly from the Dolibarr interface:

# Go to the '''Setup''' > '''Modules/Applications''' menu.
# Open the '''Deploy/Install an external module''' tab.
# Click '''Choose a file''' and select the module .zip file.
# Click '''Send File''' to start the installation.
# Enable the module once the installation is complete.

'''✅ The module is now operational and ready to use!'''
''[[#Table of Contents|⬆ Back to top]]''

=Configuration=
To use this module, you must first enable it. To do so, log in with an administrator account
and go to "'''Home - Setup - Modules'''".
The module appears under "Add-on modules/Cross-module tools". Click "Enable".
A settings icon appears at the end of the module row — click it to access the module-specific configuration page.

The module is then ready to use.

==Module configuration==

'''Module-specific configuration page:'''

The configuration page contains one tab:

*Options tab

[[File:Milestone_demo_01-23.0.jpg|800px]]

The following options are available:
- Hide by default the detail of products/services associated with milestones.
- Hide by default the description of products/services associated with milestones.
- Hide by default the amount of milestones.
- Set the background color of milestones.

[[File:Milestone_demo_02-23.0.png|800px]]

You can save milestones you wish to reuse in a dictionary.

=Usage=
Easy to get started — just a few clicks.

[[File:milestone_dolistore_01.png|800px]]

[[File:milestone_dolistore_02.png|800px]]

[[File:milestone_dolistore_03.png|800px]]

[[File:milestone_dolistore_04.png|800px]]

=Compatibility and Synergies=

Milestone is compatible with:
- The MultiCompany module
- The UltimatePdf module
- Commercial proposals (propal)
- Customer orders (order)
- Customer invoices (invoice)
- Supplier orders (order_supplier) — support added in v23
- Supplier invoices (invoice_supplier) — support added in v23

=Technical Notes=

==Supplier document specifics==

The Dolibarr ORM classes for supplier documents ('''CommandeFournisseur''', '''FactureFournisseur''') have limitations compared to their customer counterparts:

- The <code>fetch_lines()</code> method of <code>CommandeFournisseur</code> does not map the <code>label</code> field onto line objects. The module works around this behaviour with direct SQL queries whenever the label is empty.
- The <code>updateline()</code> and <code>addline()</code> methods of these classes do not handle the <code>fk_parent_line</code> parameter. Any write to this field (attaching to a milestone, cloning, deletion) is performed via a direct <code>SQL UPDATE</code> on the corresponding line table.

These workarounds are encapsulated within the module and are fully transparent to the end user.

=Development=
Milestone is tracked on the Framasoft Git repository:
https://git.framasoft.org/inodbox/milestone

Module Jalon EN - Revision history

Grandoc at 17:04, 19 April 2026

Grandoc: Created page with "= Table of Contents = Category:Add-on Modules Category:Milestone {{TemplateDocDev}} {{TemplateDocUtil}} =Information= {{TemplateModuleInfo |modulename=Milestone |edito..."