Recsubst

Module Dolibarr (Evarisk) qui applique les balises de substitution sur les factures récurrentes générées, sans modifier le cœur de Dolibarr.

Fonctionnement

Au moment de la génération d'une facture depuis un modèle récurrent (trigger BILL_CREATE), le module :

• reconstruit le tableau de substitution (__INVOICE_MONTH_TEXT__, __INVOICE_MONTH__, __INVOICE_YEAR__, période __INVOICE_DATE_PREV_INVOICE__START__ / __INVOICE_DATE_PREV_INVOICE__END__, dates de génération __INVOICE_DATE_NEXT_INVOICE_BEFORE_GEN__ / __INVOICE_DATE_NEXT_INVOICE_AFTER_GEN__, ...) ;
• applique les substitutions sur les lignes (description + label), ce qui couvre aussi les sous-totaux (module subtotal) ;
• applique les substitutions sur la référence client (depuis le champ ref_client du modèle, s'il existe).

Dolibarr ne substitue nativement que les notes (publique / privée), jamais les lignes ni la référence client : ce module comble ce manque proprement.

Installation

1. Copier le dossier recsubst/ dans htdocs/custom/.
2. Activer le module dans Accueil > Configuration > Modules > Recsubst.

Dépendances

• Facture (module Factures de Dolibarr) — seule dépendance.

Le module est autonome : il ne dépend ni de Saturne ni d'aucun framework Evarisk (chargement des langues via $langs->load('recsubst@recsubst')).

Changelog

1.0.6

• Suppression de la dépendance Saturne : le module est de nouveau autonome (chargement des langues via $langs->load('recsubst@recsubst')).

1.0.1

• Ajout de la gestion des balises __INVOICE_DATE_NEXT_INVOICE_BEFORE_GEN__ (date de la facture générée) et __INVOICE_DATE_NEXT_INVOICE_AFTER_GEN__ (date de la prochaine génération = date facture + 1 fréquence).
• Ajout d'un alias de compatibilité __INVOICE_PREVIOUS_DATE_NEXT_INVOICE_AFTER_GEN__ (orthographe non standard rencontrée dans certains modèles).

1.0.0

• Version initiale : substitution des balises sur les lignes (description + label) et la référence client des factures récurrentes générées.

Auteur

Evarisk — technique@evarisk.com