Aller au contenu principal

Introduction

Bienvenue dans la documentation de PDF Generator

PDF Generator est votre solution complète pour créer des PDF dynamiques dans Joomla!. Cette extension simplifie le processus de transformation de votre contenu en fichiers PDF de qualité professionnelle, que vous soyez propriétaire de site web ou administrateur.

Principales fonctionnalités​

  • Intégration transparente : PDF Generator s'intègre harmonieusement à votre site web Joomla, simplifiant la génération de PDF.

  • Compatibilité du contenu : Profitez d'une prise en charge native de com_content de Joomla et de FLEXIcontent grâce à des plugins dédiés. Cela garantit une création de PDF simple à partir d'articles et de types de contenu personnalisés.

  • À l'épreuve du futur : Notre engagement à améliorer votre expérience signifie que nous développons constamment de nouveaux plugins, étendant la prise en charge aux extensions Joomla populaires telles que HikaShop et autres ( n'hésitez pas à nous faire part de vos besoins).

  • Création de modèles facile : Au cœur de PDF Generator se trouve le concept de génération de PDF basée sur des modèles. Personnalisez les modèles pour des types de contenu spécifiques, tels que les catégories Joomla ou les types de contenu FLEXIcontent. Ces modèles sont conçus pour être flexibles et adaptables.

  • Édition visuelle simplifiée : Utilisez l'éditeur visuel intuitif GrapesJS pour concevoir des modèles sans effort. Aucune expertise technique n'est requise. Créez des modèles visuellement attrayants qui s'intègrent parfaitement à la charte graphique de votre site web.

  • Générez des PDF à votre manière : PDF Generator vous donne le contrôle de la génération de fichiers PDF. Que ce soit des fichiers/documents individuels ou des catalogues/livres entiers, vous décidez quand les créer. Cette flexibilité vous permet d'expérimenter avec les modèles et d'apporter des modifications tout en ayant toujours des PDF prêts à être téléchargés.

  • Création de documents : Une fois votre modèle prêt, la génération de documents PDF est simple. Un document ou un document PDF associe votre modèle à des articles/éléments compatibles. La bibliothèque robuste Dompdf garantit des PDF de haute qualité, préservant l'intégrité visuelle et la qualité.

  • Création de catalogues/livres : Poussez la génération de PDF à un niveau supérieur en assemblant vos fichiers créés en catalogues/livres. Ces compilations sont créés à l'aide de la bibliothèque Setasign FPDI, vous permettant de créer des documents complets regroupant plusieurs éléments de contenu en un tout cohérent.

Principe de fonctionnement​

Deux types de PDF peuvent être créés avec PDF Generator :

  1. PDF libres : par exemple, une page de garde. Ces PDF sont créés à partir d'un modèle qui intègre directement le contenu.
  2. PDF générés à partir des données d'un contenu : par exemple, un article com_content ou un item FLEXIcontent. Dans ce cas, le contenu est appelé dynamiquement via des shortcodes (remplacés lors de la génération du document) et doit être obligatoirement associé à un type de données et de contenu spécifiques.

Dans les deux cas, la création implique l'utilisation d'un modèle qui définit la mise en page du PDF. Dans le premier cas, le modèle intègre directement le contenu, tandis que dans le second cas, le contenu est appelé dynamiquement à l'aide de shortcodes (remplacés lors de la génération du document) et doit être spécifiquement associé à un type de données et de contenu.

Les modèles peuvent être de trois types :

  • Contenu : pour tout type de PDF.
  • En-tête : qui peut être utilisé en complément de plusieurs autres modèles ("contenu" et "pied de page").
  • Pied de page : qui peut être utilisé en complément de plusieurs autres modèles ("contenu" et "en-tête").

Créez autant de modèles que nécessaire pour un même élément/article : plusieurs PDF peuvent être générés à partir de différents modèles pour des mises en page spécifiques à partir du même contenu.

La mise à disposition des PDF pour téléchargement sur votre site se fait via un module. Un bouton de téléchargement ne s'affichera que si un PDF correspondant existe et a été généré au préalable.

Dans cette documentation, nous vous guiderons à travers chaque aspect de PDF Generator, de l'installation et la configuration jusqu'aux conseils et astuces avancés. Notre objectif est de rendre votre expérience de génération de PDF dans Joomla fluide, productive et capable de produire des documents de qualité professionnelle.