Module Concat PDF FR

Retour index
Documentation développeur

Retour index
Documentation Utilisateur

Informations

Module name	concatpdf
Editor / Editeur	DoliCloud - www.dolicloud.com
Download or buy page / Page achat ou téléchargement	www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version 8.0.0
Last update date / Date mise à jour fiche / Fecha última actualización	2020-11-17
Note / Nota

Fonctionnalités

Permet de fusionner des documents PDF aux fichiers PDF générés. Par exemple, le module permet l'ajout de

• CGV (Conditions Générales de Ventes) dans un PDF de devis ou de commande client,
• CGA (Conditions Générales d'Achat) dans un PDF de commande fournisseur,
• L'ajout d'un PDF catalogue de produit au sein du PDF de la proposition commerciale / devis.
• Conditions d'utilisation dans un PDF de contrat

...

Les documents gérés sont:

• Devis client
• Commandes client
• Factures client
• Devis fournisseur
• Commandes fournisseur
• Factures fournisseur
• Contrats

Voir aussi le Module Auto Attachement Pièces Jointes qui offre une fonction similaire en rapport avec les documents PDF envoyés par emails.

Prérequis

Les fichiers PDF que vous voulez concaténer peuvent être des PDF de toute version jusqu'à 1.7.

Installation

• Télécharger le fichier archive du module (.zip) depuis le site web www.dolistore.com ou le récupérer par tout autre manière.

• Placer le répertoire du module dans le répertoire custom de Dolibarr:
  • Pour cela, aller dans Accueil - Configuration - Modules - Déployer/installer une app/module externe
  • Téléverser le fichier. Note: Si cela échoue, vous pouvez manuellement dézipper le fichier dans le répertoire custom via la ligne de commande: aller dans le répertoire *custom* et décompressez le zip avec la commande: unzip fichiermodule.zip

• Le module est opérationnel et peut être activé.

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, aller sur la page "Accueil - Configuration - Modules".

Choisissez l'onglet dans lequel apparaît le module puis cliquez sur "Activer".

Le module est alors activé.

Si un pictogramme apparaît sur la vignette ou à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Page de configuration propre au module:

Dans la page de configuration dédiée au module, vous pouvez voir les chemins vers lesquels se trouvent vos PDF à fusionner dans les PDF générés. Vous pouvez aussi uploader par cet écran ces fichiers candidat à concaténation.

Vérifiez de plus que l'option "Protection des pdf générés (Activation NON recommandée, rend inopérante la génération de PDF de masse)" est désactivé dans Configuration - PDF.

Autres options

• Vous pouvez activer l'option pour permettre la concaténation de plusieurs fichiers.

• Vous pouvez aussi ajouter la constante CONCATPDF_PRESELECTED_MODELS dans Accueil - Configuration - Autre si vous voulez que l'un des documents PDF à concaténer soit automatiquement présélectionné dans la liste déroulante (et automatiquement ajouté à partir de la version 3.7.1 du module). La syntaxe à utiliser est la suivante:
  • Dans le champ nom, mettre CONCATPDF_PRESELECTED_MODELS
  • Dans le champ valeur, mettre proposal:filename1,filename2;...;order:filename4... où filenamex est le nom (nom court sans le chemin, par exemple My_PDF_To_Add) du ou des fichiers PDF sans l'extension .pdf (si cela ne marche pas pour les factures ou commande, essayer avec le mot clé 'facture' au lieu de 'invoice' ou 'commande' au lieu de 'order').

Les mots clés possibles sont:

proposal
order
invoice
supplier_proposal
supplier_order
supplier_invoice

Utilisation

Une liste déroulante avec la liste des PDF candidats à l'ajout doit être apparue sur la fiche facture, proposition, commande ou autre au niveau de la zone de génération de PDF (si vous avez bien ajouter les PDF candidats dans la configuration à l'étape précédente).

Choisissez le PDF complémentaire à ajouter et cliquer sur "Générer". Le PDF de la facture est désormais enrichi du PDF complémentaire.

Développement

Le développement de ce module n'est pas inclus dans le repository GIT standard de Dolibarr mais dans un repository dédié de modules gérés par DoliCloud sur la plateforme Git de GitHub:

• GIT Repository: git clone https://github.com/DoliCloud/DoliMods.git

Note: Ce repository contient de nombreux autres modules Open Source pour Dolibarr ERP CRM (1 sous-répertoire de htdocs = 1 module).