Module Jalon FR

Sommaire

Informations

Module name	Milestone/Jalon
Editor / Editeur	- http://www.atoo-net.com
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-04-19
Note / Nota	⬆ Retour au sommaire

Fonctionnalités

Ce module permet d'associer/grouper des produits/services à un jalon et d'afficher le sous-total. Il est possible d'ajouter des lignes de commentaires sans détails (tva, prix, etc.), ainsi que de forcer des sauts de page dans les documents commerciaux.

Le module est compatible avec les types de documents suivants :

- Propositions commerciales
- Commandes clients
- Factures clients
- Commandes fournisseurs
- Factures fournisseurs

Compatible avec le module Multi-Company.

Les fonctionnalités principales sont :

- Regroupement de lignes : associer des produits/services à un jalon pour les regrouper visuellement et les gérer en bloc.
- Sous-total automatique : affichage du montant total par jalon sur le document et le PDF.
- Lignes de commentaire : ajout de lignes texte sans montant ni TVA.
- Saut de page forcé : insertion d'un saut de page à la position souhaitée dans le PDF.
- Déplacer une ligne dans un jalon : rattacher a posteriori une ligne existante à un jalon, via un menu déroulant.
- Clonage de bloc : dupliquer un jalon et toutes ses lignes enfants en un seul clic.
- Suppression de bloc avec options :

- Option 1 — Supprimer le jalon et toutes ses lignes.
- Option 2 — Supprimer le jalon seul et détacher ses lignes (elles restent sur le document).
- Option 3 — Supprimer le jalon et migrer ses lignes vers un autre jalon existant.

- Dictionnaire de jalons : enregistrer des jalons réutilisables depuis la page de configuration.

Prérequis

Dolibarr 20.0.0 - 23.0.0

⚙️ Procédure d'installation

⚙️ Installation manuelle

Télécharger le fichier archive du module (.zip).
Placer le fichier dans le répertoire racine de Dolibarr.
Décompresser le fichier zip avec la commande :

unzip module_milestone-X.0.0.zip

Vérifier que l'emplacement correct du module est :

htdocs/custom/milestone

Le module est maintenant disponible et peut être activé depuis Dolibarr.

---

⚙️ Installation via l'interface Dolibarr

Vous pouvez également déployer et installer le module directement depuis l'interface Dolibarr :

Accédez au menu Configuration > Modules/Applications.
Allez dans l'onglet Déployer/Installer un module externe.
Cliquez sur Choisir un fichier et sélectionnez le fichier .zip du module.
Cliquez sur Envoyer Fichier pour lancer l'installation.
Activez le module une fois l'installation terminée.

✅ Le module est maintenant opérationnel et prêt à l'emploi ! ⬆ Retour au sommaire

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "Accueil - Configuration - Modules". Le module apparaît dans "Modules complémentaires/Outils multi-modules", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Le module est alors opérationnel.

Configuration du module

Page de configuration propre au module:

Dans la page de configuration dédiée au module, un onglet:

Onglet Options

Vous pouvez ici régler les options suivantes :

- Cacher par défaut le détail des produits/services associés aux jalons.
- Cacher par défaut la description des produits/services associés aux jalons.
- Cacher par défaut le montant des jalons.
- Régler la couleur de fond des jalons.

Vous pouvez enregistrer dans un dictionnaire les jalons que vous voulez réutiliser.

Utilisation

Prise en main facile, en quelques clics.

Compatibilité et Synergies

Milestone/Jalon est compatible avec :

- Le module MultiCompany
- Le module UltimatePdf
- Les propositions commerciales (propal)
- Les commandes clients (order)
- Les factures clients (invoice)
- Les commandes fournisseurs (order_supplier) — support ajouté en v23
- Les factures fournisseurs (invoice_supplier) — support ajouté en v23

Notes techniques

Spécificités des éléments fournisseurs

Les classes ORM Dolibarr pour les documents fournisseurs (CommandeFournisseur, FactureFournisseur) présentent des limitations par rapport à leurs équivalents clients :

- La méthode fetch_lines() de CommandeFournisseur ne mappe pas le champ label sur les objets ligne. Le module contourne ce comportement par des requêtes SQL directes lorsque le label est vide.
- Les méthodes updateline() et addline() de ces classes ne gèrent pas le paramètre fk_parent_line. Toute écriture de ce champ (rattachement à un jalon, clonage, suppression) est effectuée par un UPDATE SQL direct sur la table de lignes correspondante.

Ces contournements sont encapsulés dans le module et transparents pour l'utilisateur final.

Développement

Milestone/Jalon est un module suivi sur le Git de Framasoft : https://git.framasoft.org/inodbox/milestone