Module Concat PDF FR: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
Line 47: Line 47:
* Vous pouvez ajouter les constantes '''MAIN_USE_JQUERY_MULTISELECT''' à '''select2''' et '''CONCATPDF_MULTIPLE_CONCATENATION_ENABLED''' à 1 dans '''Accueil - Configuration - Divers''' afin de permettre la sélection et concaténation de plusieurs fichiers.
* Vous pouvez ajouter les constantes '''MAIN_USE_JQUERY_MULTISELECT''' à '''select2''' et '''CONCATPDF_MULTIPLE_CONCATENATION_ENABLED''' à 1 dans '''Accueil - Configuration - Divers''' afin de permettre la sélection et 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.6 du module). La syntaxe à utiliser est la suivante:
* 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 '''nom''', mettre '''CONCATPDF_PRESELECTED_MODELS'''
** Dans le champ '''valeur''', mettre '''propal:filename1,filename2;invoice:filename3;order:filename4...''' où filenamex est le nom du ou des fichiers PDF sans l'extension .pdf
** Dans le champ '''valeur''', mettre '''propal:filename1,filename2;invoice:filename3;order:filename4...''' où filenamex est le nom du ou des fichiers PDF sans l'extension .pdf

Revision as of 09:10, 13 August 2015

Informations


Module name concatpdf
Editor / Editeur NLTechno - www.nltechno.com
Download or buy page / Page achat ou téléchargement External module - www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2015-08-13
Note / Nota

Fonctionnalités

Permet de fusionner des documents PDF aux fichiers PDF générés. Par exemple, permet l'ajout de conditions de ventes dans un PDF de commande, ou encore l'ajout d'un PDF catalogue de produit au sein du PDF de la proposition commerciale.

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

Prérequis

Dolibarr 3.2.0 ou plus.

Les fichiers PDF que vous voulez concaténer doivent être des PDF de toute version jusqu'à 1.4 maximum pour Dolibarr 3.2.0 à 3.7.0.

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

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 Cog circle.svg 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.

Screen shot concatpdf 2.png

Avec Dolibarr 3.4 ou plus, 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 non supportées à partir de Dolibarr 3.7

  • Vous pouvez ajouter les constantes MAIN_USE_JQUERY_MULTISELECT à select2 et CONCATPDF_MULTIPLE_CONCATENATION_ENABLED à 1 dans Accueil - Configuration - Divers afin de permettre la sélection et 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 propal:filename1,filename2;invoice:filename3;order:filename4... où filenamex est le nom du ou des fichiers PDF sans l'extension .pdf

Utilisation

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

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 DoliCloud sur la plateforme Git de GitHub:

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