# Chapitrre 8 : « Fichiers spéciaux (masques PDF et traitements) »

[![y3.png](https://wiki.infras.fr/uploads/images/gallery/2026-10/scaled-1680-/Le0ltMhfdX6igqNf-y3.png)](https://wiki.infras.fr/uploads/images/gallery/2026-10/scaled-1680-/Le0ltMhfdX6igqNf-y3.png)

#### **Principe**

Un **« fichier spécial »** est un masque PDF (formulaire, attestation, page degarde…) rempli automatiquement avec les données du document puis fusionné au PDF généré. Il est composé de deux éléments de même nom :

- Le masque PDF, importé dans *documents/infraspackplus/specialfiles/*
- Un fichier PHP de traitement, importé dans c*ustom/infraspackplus/core/modules/specialfiles/*, qui décrit comment remplir le masque.

Le bloc **« Gestion des fichiers spéciaux »** de l'onglet Paramètres InfraS permet d'importer l'un et l'autre et affiche la liste des masques. Un masque n'est « utilisable » que si son fichier PHP homonyme existe.

#### **Activation par type de document** 

Pour chaque masque utilisable, des cases indiquent sur quels documents il sera proposé comme fichier à fusionner : Devis, Commandes, Interventions, Factures, Projets, Projets Auto., Contrats, Contrats Auto., Utilisateurs (constantes **INFRASPLUS\_PDF\_SPECIAL\_FILE\_<TYPE>\_<NOM>**, suffixe **\_AUTO** pour les variantes automatiques).

- **Mode manuel :** le masque apparaît dans la liste « fichiers à fusionner » des options avant génération, l'utilisateur le coche s'il le souhaite.
- **Mode « Auto. » :** le masque est toujours fusionné, sans choix.

Les deux modes s'excluent pour un même masque et un même type de document. Les modèles InfraSPlus\_CTS (dossier de contrat), PJ\_Dossier et PJ\_Docs (dossiers de projet) et User\_Contrat (contrat employé) reposent sur ce mécanisme.