NsFreeLine – Lignes libres dans les objets de Dolibarr
Documentation du module · version 23.0.0 · éditeur NS INFO
Sommaire
1. Présentation
NsFreeLine ajoute des lignes libres (lignes de texte) dans les documents de Dolibarr : précision technique sous un article, condition particulière avant le total, consigne de livraison en tête d'un bon de livraison, mention commerciale entre deux groupes de produits…
- Le texte est saisi en texte enrichi (gras, italique, couleurs, listes).
- La ligne est placée où vous le voulez : au début, après n'importe quelle ligne, ou à la fin.
- Elle est imprimée à sa place dans le PDF, sans quantité, sans prix, sans TVA : les totaux du document ne changent pas.
- Des textes prédéfinis (modèles) personnels ou partagés accélèrent la saisie.
- Le module ne modifie pas le Core de Dolibarr.
Documents pris en charge
| Clients | Fournisseurs |
|---|---|
| Propositions commerciales | Demandes de prix (devis fournisseurs) |
| Commandes clients | Commandes fournisseurs |
| Expéditions / bons de livraison | Factures fournisseurs |
| Factures clients | Modèles de factures fournisseurs |
| Modèles de factures clients |
2. Prérequis et installation
2.1 Prérequis
| Élément | Version |
|---|---|
| Dolibarr | 19.0.0 ou supérieur (testé sur 22.0) |
| PHP | 7.1 ou supérieur (testé en 7.4) |
| Framework NSINFO (module « NS INFO ») | 23.3.1 ou supérieur, installé et activé |
| Module FCKeditor (CKEditor) | Recommandé pour la saisie en texte enrichi (sinon zone de texte simple) |
Le framework NSINFO est obligatoire. Si le module « NS INFO » n'est pas installé et activé,
l'activation de NsFreeLine est refusée avec le message :
« Le framework NSINFO est obligatoire : le module « NS INFO » (nsinfo) doit être installé et activé avant d'activer le module « Lignes libres dans les objets de Dolibarr ». »
« Le framework NSINFO est obligatoire : le module « NS INFO » (nsinfo) doit être installé et activé avant d'activer le module « Lignes libres dans les objets de Dolibarr ». »
2.2 Installation
- Installer et activer le module NS INFO (version 23.3.1 ou supérieure).
- Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe,
envoyer l'archive
module_nsfreeline-X.Y.Z.zip. - Dans la liste des modules, famille NS INFO, activer « Lignes libres dans les objets de Dolibarr ».
- Attribuer les permissions aux utilisateurs ou groupes concernés.
- Vérifier la configuration (roue crantée du module).
À la première activation, le module crée :
- les tables du module (textes prédéfinis, lignes libres ajoutées sur les expéditions) ;
- les réglages par défaut, avec le bouton activé pour tous les types de document ;
- les deux permissions du module et l'entrée de menu Outils > Modèles de lignes libres.
2.3 Mise à jour / réactivation
Après une mise à jour du module, désactiver puis réactiver le module : c'est cette opération qui enregistre les nouveaux contextes de hooks, permissions, menus et évolutions de tables. Les réglages sont conservés, y compris les boutons que vous avez désactivés (voir 3.2).
3. Configuration
Page de réglages : Configuration > Modules, roue crantée du module (onglets Réglages, ChangeLog et À propos fournis par le framework NSINFO). Réservée aux administrateurs.
3.1 Libellé et couleur du bouton
| Option | Description | Défaut |
|---|---|---|
| Libellé du bouton | Texte du bouton, ou clé de traduction d'un fichier de langue (le bouton est alors traduit dans la langue de chaque utilisateur). Si le champ est vide, la clé par défaut est utilisée. | « Ajouter une ligne » |
| Couleur du bouton | Couleur de fond du bouton. La couleur du texte (noir ou blanc) s'adapte automatiquement pour rester lisible. | Rouge |
Aperçu du bouton par défaut : Ajouter une ligne
3.2 Bouton par type de document
Le bloc « Bouton « Ajouter une ligne » par type de document » contient un interrupteur par type de document, regroupés en Clients et Fournisseurs, ainsi qu'un interrupteur « Tout activer / tout désactiver ».
- Tout activer / tout désactiver : sur « oui » quand tous les types de document sont activés.
- Clients : propositions commerciales, commandes, expéditions (bons de livraison), factures, modèles de factures.
- Fournisseurs : demandes de prix, commandes, factures, modèles de factures.
- Un bouton désactivé masque le bouton et interdit l'ajout de nouvelles lignes libres sur ce type de document. Les lignes libres existantes restent affichées, modifiables et supprimables.
- Toutes les options sont activées à la première activation du module seulement : une réactivation ne réactive pas les boutons que vous avez désactivés.
4. Droits d'accès
Ajouter, modifier ou supprimer une ligne libre dans un document nécessite le droit Dolibarr de créer/modifier ce document (ex. « Créer/modifier les propositions commerciales »), et le document doit être au statut brouillon.
Les modèles de lignes libres sont gérés par deux permissions propres au module :
| Permission | Effet |
|---|---|
| Gérer ses modèles de lignes libres personnels (modèles partagés en lecture seule) | Accès à la page des modèles ; crée et modifie ses modèles personnels ; voit les modèles partagés sans pouvoir les modifier ; peut « Enregistrer comme modèle » (personnel). |
| Gérer les modèles de lignes libres partagés (pour tout le monde) | Gère les modèles partagés ; voit et gère les modèles personnels de tous les utilisateurs (avec le nom de leur propriétaire) ; peut enregistrer un modèle partagé. |
| Profil | Page Outils > Modèles | Fenêtre d'ajout de ligne |
|---|---|---|
| Administrateur ou permission « Gérer les modèles partagés » | Tous les modèles, tous modifiables | Modèles partagés + les siens ; enregistrement personnel ou partagé |
| Permission « Gérer ses modèles personnels » | Modèles partagés (lecture seule) + les siens (modifiables) | Modèles partagés + les siens ; enregistrement personnel |
| Aucune permission du module | Pas d'accès (menu masqué) | Modèles partagés utilisables ; pas d'enregistrement de modèle |
5. Utilisation
5.1 Ajouter une ligne libre
- Ouvrir un document au statut brouillon.
- Cliquer sur le bouton Ajouter une ligne (avec les autres boutons d'action de la fiche).
- Dans la fenêtre :
- Texte prédéfini : choisir un modèle (« Modèles partagés » / « Mes modèles ») ; son texte est copié dans la zone de saisie, où il reste modifiable. Le lien Gérer les modèles ouvre la page des modèles dans un nouvel onglet.
- Description (obligatoire) : texte enrichi.
- Position : En fin de document, En début de document, ou Après la ligne N : référence – libellé.
- Enregistrer comme modèle (selon vos droits) : cocher, donner un libellé (sinon le début du texte est utilisé), choisir Tous les documents ou Ce type de document uniquement, et cocher Partagé pour un modèle visible par tous (permission « Gérer les modèles partagés »).
- Cliquer sur Ajouter. Le message « Ligne libre ajoutée » s'affiche et la ligne apparaît dans le tableau des lignes, à la position choisie.
5.2 Modifier, supprimer, déplacer
Dans le tableau des lignes, une ligne libre s'affiche sur toute la largeur, avec les icônes habituelles :
| Action | Fonctionnement |
|---|---|
| Modifier (crayon) | Ouvre la fenêtre du module, pré-remplie (texte et position actuelle). Bouton Enregistrer. |
| Supprimer (corbeille) | Confirmation standard de Dolibarr, puis suppression de la ligne. |
| Déplacer (flèches / glisser-déposer) | Comme pour les autres lignes du document. |
5.3 Particularités par document
| Document | Particularité |
|---|---|
| Propositions, commandes, factures, demandes de prix, commandes et factures fournisseurs, modèles de factures clients | Fonctionnement standard décrit ci-dessus. |
| Modèles de factures fournisseurs | La fiche n'offrant pas de point d'extension pour les boutons, le bouton est affiché par le module puis placé automatiquement avec les autres boutons de la fiche ; il n'apparaît que lorsque le formulaire d'ajout de ligne est affiché (modèle non suspendu, droit de créer des factures fournisseurs). |
| Expéditions | Voir la section Bons de livraison. |
Les textes prédéfinis proposés sur un modèle de facture sont ceux des factures (client ou fournisseur).
6. Bons de livraison (expéditions)
Dans Dolibarr, chaque ligne d'une expédition doit être rattachée à une ligne de la commande d'origine. Les lignes libres des expéditions ont donc deux origines :
| Origine | Fonctionnement | Modification |
|---|---|---|
| Reprises de la commande | À la création de l'expédition, les lignes libres de la commande sont automatiquement ajoutées (quantité 0), à la même position par rapport aux articles. Dans le formulaire de création de l'expédition, elles sont signalées « Ligne libre de la commande, reprise dans l'expédition ». | Dans la commande (les expéditions déjà créées ne sont pas mises à jour). |
| Ajoutées sur l'expédition | Bouton « Ajouter une ligne » sur l'expédition en brouillon, même fenêtre que les autres documents. Position : début, après n'importe quelle ligne de l'expédition (y compris une ligne libre reprise), ou fin. | Crayon (fenêtre pré-remplie) et corbeille (avec confirmation) sur la fiche de l'expédition en brouillon. |
- Si la ligne après laquelle une ligne libre est placée est supprimée, la ligne libre passe en fin de document.
- Plusieurs lignes libres placées après la même ligne s'affichent dans leur ordre de création.
- Les lignes libres ajoutées sur une expédition sont supprimées avec l'expédition.
- Sur le PDF du bon de livraison, les lignes libres n'affichent ni quantité commandée, ni quantité à expédier, ni poids, ni volume ; les totaux de quantités ne changent pas.
7. Modèles de lignes libres
Menu Outils > Modèles de lignes libres (selon les permissions).
Liste
| Colonne | Contenu |
|---|---|
| Libellé | Nom du modèle, affiché dans la liste « Texte prédéfini » de la fenêtre d'ajout. |
| Description | Début du texte du modèle. |
| Type de document | « Tous les documents » ou un type précis. |
| Portée | « Partagé », ou nom de l'utilisateur propriétaire d'un modèle personnel. |
| État | Interrupteur actif / inactif (un modèle inactif n'est plus proposé). |
| Actions | Modifier, supprimer (avec confirmation), selon vos droits. |
Fiche d'un modèle
| Champ | Description |
|---|---|
| Libellé | Obligatoire. |
| Description | Texte enrichi du modèle. |
| Partagé | Visible par tout le monde (permission « Gérer les modèles partagés » requise). Non coché : modèle personnel. |
| Type de document | Tous les documents, ou : Proposition commerciale, Commande client, Bon de livraison (expédition), Facture client, Demande de prix, Commande fournisseur, Facture fournisseur. |
| Actif | Proposé ou non dans la fenêtre d'ajout. |
La fenêtre d'ajout d'un document ne propose que les modèles actifs, partagés ou personnels de l'utilisateur, et destinés à tous les documents ou à ce type de document.
Un modèle personnel modifié par un gestionnaire (permission « Gérer les modèles partagés ») garde son propriétaire.
8. Impression PDF
- Le texte enrichi de la ligne libre est imprimé dans la colonne Désignation, à sa position.
- Les colonnes référence, référence fournisseur, quantité, unité, prix unitaire, remise, TVA, avancement et totaux restent vides.
- Les lignes libres ont une quantité et des montants nuls : les totaux et la TVA du document sont inchangés, aucune ligne de TVA supplémentaire n'apparaît.
- Testé avec les modèles standards et DPersoPlus : propositions (Propositiondpp), commandes (commandedpp), factures (Facturedpp), commandes fournisseurs (commandefrn), factures fournisseurs (canelle), demandes de prix (aurore), bons de livraison (blclassic).
9. Conversions et factures récurrentes
Les lignes libres étant de vraies lignes des documents, elles suivent le cycle de vie de Dolibarr :
- Proposition → commande → facture : les lignes libres sont recopiées dans le document créé.
- Commande → expédition : reprise automatique (voir section 6).
- Modèle de facture → facture (client ou fournisseur) : les lignes libres du modèle sont reprises dans chaque facture générée, à leur position.
- Suppression d'un document : ses lignes libres sont supprimées avec lui.
10. Limites connues et FAQ
Le bouton « Ajouter une ligne » n'apparaît pas.
- Le document doit être en brouillon et l'utilisateur doit avoir le droit de le modifier.
- Le bouton doit être activé pour ce type de document (3.2).
- Après une mise à jour du module, il faut le désactiver puis le réactiver.
Une ligne libre de la commande n'est pas dans l'expédition.
La reprise se fait à la création de l'expédition : les expéditions créées avant l'ajout de la ligne libre dans la commande ne sont pas mises à jour. Vous pouvez ajouter la ligne directement sur l'expédition en brouillon.
Le texte n'est pas en texte enrichi.
La saisie en texte enrichi utilise CKEditor : le module Dolibarr FCKeditor doit être activé.
Le PDF n'affiche pas les lignes libres d'une expédition.
Les lignes libres ajoutées sur une expédition sont insérées au moment de la génération depuis la fiche de l'expédition. Certains modèles PDF qui comptent leurs lignes très tôt peuvent ne pas les afficher lorsqu'un PDF est généré en masse depuis une liste.
Autres limites
- L'onglet « Expéditions » de la commande affiche les lignes libres comme des lignes ordinaires de quantité 0.
- Si l'option Dolibarr « photos des produits dans les bons de livraison » est activée, les images peuvent être décalées par les lignes libres ajoutées sur l'expédition.
- Si le module « NS INFO » est désactivé après coup, la page de réglages de NsFreeLine n'est plus utilisable.
11. Historique des versions
23.0.0 – 01/10/2026 version initiale
- Module de la famille NS INFO, réglages via le framework NSINFO.
- Lignes libres (sans quantité ni montant) sur les propositions, commandes, factures, modèles de factures, demandes de prix, commandes et factures fournisseurs.
- Bouton « Ajouter une ligne », fenêtre en texte enrichi, texte prédéfini, position, enregistrement comme modèle.
- Affichage dans le tableau des lignes ; modification, suppression et déplacement.
- Expéditions : reprise des lignes libres de la commande et ajout direct sur l'expédition.
- PDF : texte enrichi dans la désignation, colonnes vides, totaux inchangés.
- Modèles de lignes libres personnels / partagés, par type de document ; page Outils > Modèles de lignes libres ; deux permissions.
- Réglages : libellé et couleur du bouton, activation par type de document, « Tout activer / tout désactiver ».
- Framework NSINFO 23.3.1 obligatoire (activation refusée sinon).
