Export PDF des contenus

Il est possible d'exporter les contenus vers le format PDF, soit directement à partir de la vue du contenu (menu contextuel + » Télécharger PDF), soit dans l'archive qui peut être générée à partir de la vue de sa collection (menu contextuel + » Télécharger archive : requiert les droits de téléchargement).

L'export vers le format PDF s'appuie en principe sur le binaire externe wkhtmltopdf ainsi que sur la bibliothèque externe phpwkhtmltopdf.

Le chemin vers wkhtmltopdf sur le serveur hôte de chora doit être configuré dans le fichier /application/configuration/<ENVIRONNEMENT>/site.php :

/* Wkhtmltopdf (a LGPL v3 HTML to PDF Converter)
 *  If this is defined as the path to the wkhtmltopdf binary on chora host,
 *  Wkhtmltopdf will be used instead of Dompdf to generate the PDF Version of contents
 *  It usually consumes more RAM, but is quicker and better handles complex HTML
 */
// WARNING: Loading images might be broken on some systems:
// if your images do not load, try placing them in a table and remove positionning/size attributes
define('WKHTMLTOPDF','/usr/local/bin/wkhtmltopdf');

Pour installer la bibliothèque externe phpwkhtmltopdf, vous pouvez utiliser Composer à partir de la racine de votre installation de chora :

composer require mikehaertl/phpwkhtmltopdf

Celle-ci est distribuée sous licence MIT.

Alternativement, si la constante WKHTMLTOPDF n'est pas définie, les PDFs seront générés en mode dégradé grâce à la bibliothèque Dompdf, mais certaines fonctions ne sont pas supportées par cette dernière (comme par exemple l'affichage des vignettes de vidéos incluses dans le document, ou l'affichage d'images externes). En outre, la mise en page de documents complexes est limitée. Pour cette raison, lorsque cela est possible, nous vous recommandons d'installer et d'activer wkhtmltopdf sur le serveur hôte de chora.

Format d'export PDF

Le format final d'export PDF peut être modifié dans les fichiers suivants :

/assets/css/pdf-container.css
/application/views/Pdfhead.php
/application/views/data/viewaspdf.php ou /application/views/data/viewaspdf.php (lorsque wkhtmltopdf est utilisé)
/application/views/Pdffooter.php