NsSubtotal structure les lignes de vos documents en blocs : un titre ouvre un
bloc, un sous-total le ferme et affiche le total des lignes qu’il contient.
Jusqu’à 9 niveaux de titres imbriqués, avec une numérotation automatique (1, 1.1, 1.2…).
Le texte des titres et des sous-totaux est un texte enrichi (gras, couleurs…).
Ajout depuis un bouton à menu déroulant dans la barre d’action, dans une fenêtre où l’on choisit la
position, le niveau et un modèle.
Les titres et sous-totaux se déplacent à la souris comme les autres lignes et les totaux se recalculent.
Un rendu PDF soigné : titres en gras indentés, sous-totaux avec leur total.
Le framework NSINFO (module gratuit « NSINFO »), installé et activé. Sans lui, l’activation du module est refusée.
L’éditeur de texte enrichi de Dolibarr (module « FCKeditor ») pour saisir le texte mis en forme ; sans lui, le texte est saisi en texte simple.
2.2 Installation
Dans Dolibarr : Accueil > Configuration > Modules > Déployer/Installer un module externe, envoyer l’archive du module.
Activer le module « Sous-totaux » dans la liste des modules (famille NSINFO).
Ouvrir ses réglages (roue crantée) pour adapter le bouton et l’éditeur.
2.3 Mise à jour / réactivation
Après une mise à jour, désactivez puis réactivez le module : les menus, les droits et les options activées par défaut ne sont enregistrés qu’à l’activation.
3. Configuration
Les réglages sont rangés en sous-onglets verticaux. Un picto ↺ signale un réglage qui n’est pas à sa valeur par défaut ; chaque réglage s’enregistre dès qu’il change.
3.1 Le bouton
Réglage
Effet
Texte du bouton
Texte libre ou clé de traduction du bouton « Titres et sous-totaux ».
Couleur du bouton
Couleur de fond du bouton (le texte passe en noir ou en blanc selon la couleur).
Picto dans le bouton
Affiche un picto à gauche du texte (activé par défaut).
Un seul bouton
Si le module Lignes libres est actif, son bouton « Ajouter une ligne » devient une entrée du menu du bouton (activé par défaut).
Clic sur le texte pour modifier
Un clic sur le texte d’un titre ou d’un sous-total ouvre la fenêtre de modification ; le crayon reste présent (activé par défaut).
3.2 L’éditeur de texte
Choix de la barre d’outils de l’éditeur de la fenêtre d’ajout et des modèles : simple (par défaut), intermédiaire ou complète (polices, styles, couleurs).
Si le module Lignes libres est actif, un encadré indique la barre d’outils qu’il a choisie de son côté : chaque module a son propre réglage.
3.3 Les sous-totaux
Réglage
Effet
Écrire le mot « Sous-total » devant le texte
Pour un sous-total qui a un texte à lui mais qui ne contient pas le mot, l’écrit devant, dans la couleur du texte (fiche et PDF). Désactivé par défaut.
Montant du sous-total dans la couleur de son texte
Le total prend la couleur du texte saisi (activé par défaut).
Montant du sous-total en gras / en italique
Style du montant, sur la fiche et dans le PDF (gras activé par défaut).
Offert : laisser le montant du bloc sur le PDF
Pour un bloc marqué « Offert » : garde le montant à côté de la mention, ou imprime seulement la mention (activé par défaut).
3.4 Le PDF
Option « ajouter aussi le numéro devant le texte des titres » : par défaut, le numéro (1, 1.1…) est écrit dans la colonne des numéros de ligne du modèle PDF ; avec l’option, il est aussi écrit devant le texte.
Option « écrire le total du sous-total dans les colonnes du modèle » : pour les modèles PDF qui n’impriment pas les colonnes des lignes titre et sous-total, le module écrit lui-même le total du sous-total dans les colonnes du modèle. Elle est automatique avec les modèles DPersoPlus.
4. Droits d’accès
Les titres et sous-totaux se modifient sur un document au statut brouillon, avec le droit de créer / modifier ce document et les droits du module :
Droit
Effet
Lire les blocs titres et sous-totaux
Voir les blocs ; accordé par défaut.
Créer / modifier les blocs titres et sous-totaux
Ajouter et modifier titres et sous-totaux, utiliser les modèles.
Supprimer les blocs titres et sous-totaux
Supprimer un bloc ou une ligne de bloc.
Gérer ses modèles personnels de titres et de sous-totaux
Accès à la page des modèles ; crée et modifie ses modèles personnels ; voit les modèles partagés sans les modifier.
Gérer les modèles partagés de titres et de sous-totaux
Gère les modèles partagés et voit les modèles personnels de tous les utilisateurs.
5. Utilisation
5.1 Ajouter un titre ou un sous-total
Ouvrez un document en brouillon et cliquez sur le bouton « Titres et sous-totaux » de la barre d’action.
Choisissez Ajouter un titre ou Ajouter un sous-total (et, si le module Lignes libres est actif, Ajouter une ligne).
Dans la fenêtre : choisissez éventuellement un modèle, saisissez le texte, choisissez le niveau (boutons de 1 à 9), les options (saut de page avant un titre) et la position : au début, à la fin ou après une ligne.
Pour garder ce texte, activez « Enregistrer comme modèle » (nom, type de document, partagé).
Un sous-total ferme par défaut le dernier titre resté ouvert : son niveau est repris. Sans texte, il reprend celui de son titre ; avec un texte à lui, seul ce texte est écrit.
5.2 Modifier, supprimer, déplacer
Modifier : crayon, ou clic sur le texte. La fenêtre permet de changer le texte, le niveau, le saut de page, « non compris », « cacher les lignes de ce titre » (titre) et l’affichage de la quantité et du total (sous-total).
Supprimer : la corbeille rouge supprime tout le bloc (titre, lignes et sous-total) ; la corbeille grise supprime seulement la ligne, les lignes du bloc restent.
Déplacer : glisser-déposer avec la poignée de droite, comme une ligne normale. La numérotation et les totaux sont recalculés sans recharger la page.
Avec le module NsDTools actif, la case de sélection et la suppression groupée s’affichent comme sur une ligne normale.
5.3 Couleurs
Le total d’un sous-total prend la couleur du texte saisi. Un picto palette placé sur un titre et sur son sous-total propose d’aligner la couleur de l’un sur celle de l’autre.
5.4 Cacher le détail, offrir un bloc
Deux pictos avec bulle d’info, placés à droite de la ligne d’un titre (sur les colonnes de la TVA et des prix), se basculent d’un clic, sans recharger la page :
Cacher le détail du bloc (œil barré) : le PDF n’imprime que le titre avec le montant du bloc, sans les lignes ni le sous-total. Le total du document ne change pas, la TVA du bloc reste comptée dans les totaux par taux.
Offert (cadeau) : le montant du bloc n’est pas compté dans le total du PDF ; la mention « Offert », dans la langue du PDF, est écrite sur le titre et le sous-total, avec ou sans le montant selon le réglage.
Les deux options peuvent se combiner. Les lignes et les totaux du document dans Dolibarr ne sont jamais modifiés : seul le PDF change.
6. Modèles de titres et de sous-totaux
Un modèle enregistre un texte enrichi, un niveau, un saut de page et le type de document concerné. Il est personnel ou partagé avec tous les utilisateurs.
La page Outils > Modèles de titres et de sous-totaux liste, crée, modifie, active ou supprime les modèles.
Dans la fenêtre d’ajout, la liste « Modèle » remplit le texte, le niveau et le saut de page.
Un modèle peut être réservé à un type de document (proposition, commande, facture, côté client ou fournisseur) ou proposé partout.
7. Impression PDF
Les titres sont imprimés en gras, indentés de 4 mm par niveau, avec leur numéro dans la colonne des numéros de ligne.
Les sous-totaux sont imprimés avec leur libellé et le total HT du bloc (dans la couleur du texte) ; la quantité du bloc s’affiche si l’option est cochée.
Ces lignes n’ont ni TVA, ni prix unitaire, ni remise.
Le total des documents n’est pas modifié par les titres ni par les sous-totaux.
Un bloc dont le détail est caché est remplacé par son titre et le montant du bloc ; un bloc offert est retiré du total du PDF et porte la mention « Offert » (voir 5.4).
Compatible avec les modèles DPersoPlus : le total des sous-totaux est écrit dans leurs colonnes.
8. Avec le module Lignes libres
Quand le module Lignes libres est actif et que l’option « Un seul bouton » est cochée, les deux modules partagent un seul bouton dans la barre d’action : « Ajouter une ligne » devient la première entrée du menu « Titres et sous-totaux ».
Le bouton n’est fusionné que si l’utilisateur a les droits des deux côtés ; sinon, chaque module garde son bouton.
9. Reprendre les blocs du module Subtotal
Si vos documents contiennent déjà des titres et des sous-totaux créés par le module Subtotal (ATM Consulting), un administrateur peut les reprendre dans NsSubtotal, à la demande, depuis l’onglet « Migration depuis Subtotal » des réglages.
Faites une sauvegarde de la base : la migration n’est pas annulable.
L’onglet affiche, pour chaque type de document, le nombre de titres et de sous-totaux à reprendre.
Lancez la migration et confirmez : elle s’exécute en une seule fois, tout ou rien.
Désactivez ensuite le module Subtotal.
Les lignes de texte libre de l’ancien module ne sont pas reprises ici : elles le sont par le module Lignes libres.
Les lignes des factures qui ne sont plus au statut brouillon ne sont jamais modifiées ; elles sont comptées à part dans la colonne « Non migrées (facture validée) ».
Les lignes des modèles de factures récurrentes (clients et fournisseurs) sont reprises, pour que les factures générées portent les blocs de ce module.
Après la confirmation (choisir « Oui » puis valider), la migration s’exécute en une seule fois, tout ou rien.
Clonage et création de documents
Quand un document est cloné ou créé à partir d’un autre (proposition → commande → facture, factures fournisseurs comprises), les titres et sous-totaux
qui y sont encore liés au module Subtotal deviennent automatiquement des blocs de NsSubtotal dans le nouveau document (brouillon).
10. Limites connues et FAQ
Saut de page avant un titre : l’option est enregistrée mais n’est pas encore appliquée au PDF.
Bloc « non compris » : l’option est enregistrée ; son exclusion des totaux n’est pas encore appliquée (utilisez « Offert » pour retirer un bloc du total du PDF).
Détail caché ou bloc offert : seul le PDF change ; un bloc dont les lignes ont plusieurs taux de TVA peut laisser un petit écart vertical dans le PDF.
Les expéditions, les conversions entre documents et les factures récurrentes ne sont pas encore pris en charge.
Dolibarr 23 propose un module natif « Sous-totaux » : n’activez pas les deux modules sur les mêmes documents.
Une ligne titre ou sous-total ne se modifie que sur un document en brouillon.
