Module Concat PDF FR

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Informations

Module name concatpdf
Editor / Editeur NLTechno - www.nltechno.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-01-29
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 à 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.

Screen shot concatpdf 2.png

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...filenamex est le nom 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 apparu 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).

Screen shot concatpdf.png

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 NLTechno sur la plateforme Git de Framasoft:

Notons que c'est un repository privé, aussi il vous faut créer un compte et postuler au projet depuis le site https://git.framasoft.org pour pouvoir cloner les sources par GIT.