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 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.
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.
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.
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 ; l’exclusion du bloc des totaux du document n’est pas encore appliquée.
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.
