EasyModelePdf

EasyModelePdf — déposez vos modèles PDF, c'est installé

Vous avez développé un modèle PDF personnalisé (pdf_monmodele.modules.php) pour un client. Dolibarr n'offre aucun moyen de l'installer : il faut fabriquer un module porteur à la main pour chaque client, déclarer module_parts['models'], copier le fichier dans le bon répertoire core/modules/<objet>/doc/... et ne pas oublier que le nom de la classe doit être identique au nom du fichier, sinon le modèle n'apparaît jamais, sans aucune erreur.

EasyModelePdf remplace tout ça par un glisser-déposer.

Fonctionnement

• Déposez vos fichiers pdf_*.modules.php sur la page de configuration du module (plusieurs à la fois).
• Détection automatique de l'objet cible via la classe parente ModelePDF* : commandes clients, factures, devis, expéditions, bons de livraison, commandes et factures fournisseurs, contrats, interventions, projets, tâches, stock, ordres de fabrication, BOM, tickets.
• Validation avec messages d'erreur clairs : forme du nom de fichier, classe PHP présente, et la règle Dolibarr « classe = nom de fichier » vérifiée au lieu d'échouer silencieusement.
• Stockage pérenne : le fichier est conservé dans le répertoire documents de Dolibarr (source de vérité) et déployé dans l'arborescence du module. Une mise à jour du module ne perd jamais vos modèles — ils sont redéployés automatiquement à l'activation.
• Gestion depuis la même page : activer/désactiver le modèle, le définir par défaut pour son type d'objet, le retélécharger, le supprimer. Les modèles installés apparaissent aussi dans les listes natives de modèles de documents, comme n'importe quel modèle du core.

Prérequis

• Dolibarr 19.0+, PHP 7.4+
• Le serveur web doit pouvoir écrire dans le répertoire du module pour déployer les modèles (un avertissement clair s'affiche sinon).

Note de sécurité : téléverser un fichier PHP revient à déployer du code. L'envoi est réservé aux administrateurs Dolibarr, protégé CSRF, et le fichier est analysé pour vérifier qu'il déclare bien la classe de modèle attendue. Ne déployez que des modèles de confiance.