Cette contribution est largement inspirée de celle-ci : Génération améliorée de fichiers PDF
et de celle-ci :Génération de PDF pour SPIP - Drop Zone City
Je vous invite donc à lire ces contributions avant la mienne.
Installation
Vous trouverez en pièce-jointe (prenez l’archive intitulée PDF Nouvelle Version), les fichiers nécessaires à la génération des articles au format PDF.
N’oubliez pas de créer un dossier nommé : _article_PDF dans le répertoire IMG et de lui attribuer les permissions à 777 (comme vous l’aviez fait lors de l’installation de SPIP pour le répertoire IMG par exemple).
Ensuite, vous installez les fichiers joints à la racine de votre site SPIP.
Attention : Si vous utilisez déjà un fichier mes _fonctions.php3, recopiez le code contenu dans notre fichier mes_fonctions.php3 entre les balises
<?php et ?>
dans votre fichier mes_fonctions.php3.
Puis, faîtes un lien dans votre squelette article.html vers article_pdf.php3 comme ceci :
<a href="article_pdf.php3?id_article=#ID_ARTICLE" target="_blank">Voir au format PDF</a>
Démo articles SPIP au format PDF
Voici un récapitulatif des fonctionnalités ajoutées aux PDF :
- Les PDF se régénèrent automatiquement quand vous modifiez un article, alors qu’avec les contrib. proposées vous devez effacer à la main les pdf dans votre dossier IMG/_article_PDF à chaque fois que vous modifiez un article.
- Le problème de titre trop long qui était coupé et donc qui ne revenait pas à la ligne a été corrigé.
- Amélioration de la génération de certains caractères spéciaux.
- Les logos d’articles apparaissent correctement, par contre il faut que je règle le problème de liens sur les logos, pour l’instant, j’ai tout simplement retiré les liens qui finalement ne servent à rien.
- Les images insérées dans les articles apparaissent correctement.
- Cette contribution est compatible avec la contribution : Découper un article en plusieurs pages et lui ajouter un sommaire, ainsi les <hr>
générés n’apparaissent pas dans le pdf.
- Les fichiers au format GIF sont gérés de 2 façons. Soit en pur PHP et le résultat n’est pas terrible bien qu’il reste utilisable. Soit, avec utilisation de la librairie GD dans une version capable de manipuler les GIF, et la, vous aurez un resultat parfait.
- Les fichiers PNG avec couche Alpha sont gérés mais le fichier PNG généré dans le PDF aura forcément un fond blanc ### On peut peut être ressortir la couleur dans une variable en tête de fichier si qq1 veut pouvoir la changer facilement ###
- Nous utilisons la dernière version de FPDF qui est à l’heure où parait cet article la 1.53. Pour plus d’infos sur l’historique des versions, il faut se rendre ici.
Un PDF simplifié sans page de garde
Vous trouverez aussi en pièce-jointe le fichier permettant de générer un article au format PDF, de présentation plus simple, sans page de garde.
Installation :
Pour cela, vous installez comme décrit précédemment le « package PDF Nouvelle Version », puis il suffit de remplacer le fichier lib_pdf_spip.php qui se situe
dans le répertoire : lib/class_pdf
par celui fourni en pièce jointe (dont le titre du zip est PDF simple sans page de garde).
Vous obtiendrez alors un fichier simple sans page de garde, avec un footer (pied de page) où l’on retrouve l’auteur, le nombre de pages, la date de publication et le nom du site.
Vous pourrez facilement modifier la taille et le type de police et les espaces entre chaque balise surtitre, titre sous-titre et texte.
Exemple :
//Titre
$this->SetFont(’helvetica’,’B’,12) ;
$this->WriteHTML($titre) ;
$this->Ln(12) ;
- SetFont permet de définir la police B=Gras 12=Taille (comme d’habitude)
- WriteHTML sert à transformer les balises html en codes interprétables par le PDF
- Ln(12) = Effectue un saut de ligne, et 12 = amplitude du saut de ligne.
Pour plus d’infos, aller sur http://www.fpdf.org
Pour aller plus loin : ajouter des champs extra dans la génération des PDF
Pour ce qui est des champs extras, il faut les déclarer dans le fichier : lib_pdf_spip.php comme ceci :
ligne 137 remplacer : global $texte, $chapo, $ps, $notes ; par : global $texte, $chapo, $extra, $ps, $notes ;
ligne 146 environ, ajoutez en dessous de ce code :
//Texte - justifie $this->SetFont('helvetica','',10) ; $this->WriteHTML($texte) ; $this->Ln(12) ;
le code suivant :
if ($extra) // extra $this->SetFont('helvetica','',10) ; $this->WriteHTML($extra) ; $this->Ln(12) ;
Dans cet exemple, les champs extra apparaitront dans vos pdf sous le texte de l’article et avant le Post-scriptum de l’article.
Vous pouvez donc positionner le code ci-dessous ailleurs, avant le texte de l’article, avant le chapo, après le PS...
et dans article_pdf.html : ligne 11 : insérez en dessous de :
$conf_nom_site = "[(#NOM_SITE_SPIP|pdf_first_clean)]" ;
Les champs extras que vous voulez faire apparaitre, ici un exemple avec 2 champs extra (Mission, Competences) :
$extra = "Missions : "."[(#EXTRA|Mission|pdf_first_clean)]"."
"."Compétences : "."[(#EXTRA|Competences|pdf_first_clean)] ;
Vous ajoutez ainsi autant de champs extra que vous le souhaitez.
Pour plus d’infos sur les champs extra, allez dans la partie privé de spip-contrib.net et faites une recherche sur extra, vous trouverez toute la doc sur les champs extra et leur utilisation.
Voilà, je crois que je n’ai rien oublié, à part vous dire que cette contribution n’est qu’une collecte d’infos glanées sur spip-contrib et ses forums.
Donc je ne suis qu’un assembleur de ce que j’ai trouvé et non le créateur (juste des petits bouts ici et là). Merci à Chag qui a complété cette contrib. en améliorant la gestion des images, des tableaux et en intégrant la dernière version de FPDF.
Intégration des images dans les PDF grâce à la librairie GD
Commençons par rendre à César ce qui appartient à César. Ces modifications sont inspirées de ce commentaire.Cette librairie de manipulation d’images permet d’améliorer la qualité de certaines images intégrées dans les PDF. Les formats de fichiers concernés sont :
- GIF (Graphics Interchange Format). Ce format d’image était soumis à licence. Afin de ne pas risquer de poursuites et pour ne pas payer, la librairie GD ne manipulait plus les fichiers GIF entre sa version 1.6.0 (correspondant à la date à laquelle UNISYS a commencé à vouloir faire payer les utilisateurs) et la version 2.0.28 (date à laquelle son algorithme principal est passé dans le domaine public). L’avantage de la librairie GD est qu’elle manipule très bien les images au format GIF. Pour savoir si vous pouvez l’utiliser, utilisez la commande <?PHP phpinfo(); ?>
dans une page. Vous devriez obtenir plusieurs rubriques dont une qui concerne GD et qui pourrait ressembler à ca :
GD Support | enabled |
GD Version | bundled (2.0.28 compatible) |
FreeType Support | enabled |
FreeType Linkage | with freetype |
GIF Read Support | enabled |
GIF Create Support | enabled |
JPG Support | enabled |
PNG Support | enabled |
WBMP Support | enabled |
XBM Support | enabled |
Il faut au moins que le support des GIF en lecture soit possible pour pouvoir utiliser la librairie GD.
Que ce soit le cas ou pas, notre modification pourra inclure dans le fichier PDF une image au format GIF. Mais elle sera plus belle avec l’utilisation de GD :)
- PNG (Portable Network Graphics) : Quand UNISYS a commencé à vouloir faire payer des licences pour le format GIF, le format PNG a émmergé. La librairie FPDF utilisée pour créer les PDF de cette contribution sait déjà gérer les fichier PNG. Mais pas les PNG avec couche alpha. Pour résumer, la couche Alpha, c’est une méthode de transparence sur les images qui permet d’avoir des parties plus ou moins transparentes. Notre modification dans la librairie permet de gérer les fichiers PNG avec couche Alpha. le fichier sera obligatoirement replacé sur un fond blanc.
Même si vous n’avez pas l’impression/l’intention d’utiliser d’images PNG avec canal alpha, sachez par exemple que, si vous ajoutez un document PDF à un article, son icône est un PNG avec canal Alpha.
Sur l’image suivante, vous pouvez comparer 2 captures d’écran de PDF générés à partir de SPIP. Le premier ne gère pas correctement le canal alpha. Le second, si.
Discussions par date d’activité
32 discussions
Bonjour,
Je réalise des articles avec plusieur onglet (Car c’est pour la réalisation d’un catalogue)
Par contre quand je souhaite générer le PDF tout est dispatcher ; y a t il un moyen pour faire apparaitre chaque onglet sur une nouvelle page ?
Merci d’avance
Répondre à ce message
par exemple "« " est remplacé par "& #171 ;"
Répondre à ce message
Bonjour,
Est-ce que ce plugin est compatible avec FCKEDITOR...?
Merci d’avance
Répondre à ce message
J’ai mon site en utf-8 et les caractères accentués apparaissent ds mon PDF le langage martien (« é » => « é » par exemple). Est-ce qu’il y a moyen de corriger ce petit bug ?
Sinon, ce script est vraiment pratique, merci à l’auteur.
P.S : En utilisant
« $texte = ereg_replace( »Ã©« , »é« , $texte) ; »
dans mes_fonctions.php3 pour chaque caractère mal affiché ca corrige le tir, bien sûr... Et c’est ce que j’ai fais, mais n’y aurait-il pas un moyen plus propre ?
Bon, je m’excuse d’avoir poser une question à laquelle je répond en une 1/2 heure, j’ai posé ma question trop vite, la réponse était simple en fait... Si mon fichier PDF affiche ces caractères martiens, c’est parce que c’est sous cette forme que Spip enregistre mes caractères spéciaux dans ma bdd (rien d’anormal à ça je pense). Donc, pour corriger ce problème, il suffit de mettre la ligne :
« $texte = utf8_decode($texte) ; »
dans les fichier « mes_fonctions.php3 » juste avant « return $texte ; ». De cette façon, ça marche très bien et utf-8 est au rendez-vous... Du moins, autant que le permettent les polices utilisées, mais cela est une autre histoire.
C’est ce que j’ai fait mais ça ne marche qu’à moitié. Mes caractères ’ sont remplacés par des ?
J’ai ajouté une ligne
<HTML>
$trans["’"] = "\’" ;
</HTML>
(j’ai mis & # 146 mais là ça me le convertit, grrrrr !!!)
à mes_fonctions.php3 mais ça ne produit aucun effet.
Au secours !!!
pour ton probleme d’apostrophe, je te conseille d’utiliser la pokice cp1252 à la place de UTF8 en changeant dans mes_fonctions.php :
en plus, il contient le caractère « € »
Répondre à ce message
Suite au passage de notre intranet sous PHP 5, la génération des PDF ne marchait plus s’il y avait des images.
Un petit débuggage m’a permis de corriger le code du fichier gif.php (dans le répertoire /lib/classe_pdf de SPIP) :
- tous les appels de fonction avec initialisation lors de l’appel d’une variable passée en référence ne retourne pas la valeur modifiée (l’appel doit créer une variable anonyme en lui affectant la valeur initialisée, perdant ainsi le lien avec la variables que l’on souhaite référencer).
ex :
if(!$this->m_gih->load($data, $len = 0))
return false ;
ne retourne plus la valeur attendue dans $len (reste à 0), il faut maintenant :
$len = 0 ;
if(!$this->m_gih->load($data, $len))
return false ;
Il y en a plusieurs dans le fichier gif.php .
Répondre à ce message
Bonsoir
J’utilisais la version de génération du PDF sans image avant. J’ai changé la fonction pdf_first_clean du fichier mes_fonctions, supprimé les pdf dans IMG/_article_PDF et remplacé la lib par celle fournie dans le fichier ZIP mais rien n’y fait :
L’image de Form, de type 3 ou De motif est trop grande. Je clique OK, j’ai un rectangle gris en lieu et place de l’image.
Mes images en jpg font environ 440 pixels de large alors, si vous avez des idées je suis preneur.
Salut,
il faut que tu supprimes complètement tes anciens fichiers qui permettaient la génération des pdf et que tu installes ceux fourni dans le zip, plutôt que de faire un mix des 2. Tes images, même si elles sont grandes devraient apparaître.
@+
Bonjour,
Ben non, toujours pas. Le logo s’affiche mais pas les photos dans le texte. Il y a plusieurs illustrations par article. Y a t-il une limite ?
deca
Bonjour,
Ben non, toujours pas. Le logo s’affiche mais pas les photos dans le texte. Il y a plusieurs illustrations par article. Y a t-il une limite ?
Je vois que tes articles sont énormes (40 pages pour certains), essaye avec un article simple avec une image intégrée dans le texte et dis-moi si celle-ci apparait ?
Bonjour,
Sur un petit article (une page, deux photos, une vingtaine de lignes de texte), il n’y a pas d’erreur affichée par Acrobat Reader mais les images n’apparaissent pas et le texte en partie masqué.
Je sèche, à la prochaine marée, je me barre, le thon de ces échanges, aussi clair que du morse, me donne envie de changer d’eau.
Ok alors écoutes, déjà je perds mon temps à essayer de t’aider, tu es le seul qui a un problème pour afficher les images dans le pdf et pourtant, ils sont nombreux à avoir installer cette contrib. sans rencontrer aucun problème.
Pour exemple, voici le dernier extrait de mail reçu suite à une install. de la contrib. :
« Je cherchais à installer le générateur pdf pour spip. Alors je tape sous google : spip contrib pdf, et je tombe sur une page de Paul Sanches qui explique tout. J’essaye et en moins de 5 min c’était installé sur 2 sites.
Alors merci infiniment
Lilian Bacquet »
Si tu veux une solution rapide et fiable, je peux te facturer une journée de consulting à 300 euros (pas cher) et là je m’engage à résoudre ton problème.
Je veux bien t’aider mais je refuse ce type de phrase agressive : « Je sèche, à la prochaine marée, je me barre, le thon de ces échanges, aussi clair que du morse, me donne envie de changer d’eau. »
Donc, si t’es pas content, t’as qu’a effectivement « changer d’eau » et revenir à l’ancienne version.
Bon ce coup de gueule passé, j’ai pris des images de ton site, qui au passage ne sont pas du tout optimisées, et j’ai donc testé avec 5 images d’un poids total de 100 KO environ, aucun problème le pdf est généré proprement.
Donc le problème ne vient ni de la taille ni du poids des images.
Maintenant je te fais une dernière suggestion concernant ton problème, il y a peut-être, je dis bien peut-être un problème de chemin vers tes images, si tu regardes cet article, la puce s’affiche, elle est à la racine du site :
http://www.archeographe.net/charte_redactionnelle_article13.html
Questions :
Est-ce que ton fichier article_pdf.html est bien à la racine de ton site ?
Est-ce que le repertoire _article_pdf a bien les droits à 777 ?
@+
Paul Sanches
Bonjour,
C’était de l’humour en rapport avec l’aspect marin de spip-contrib. Donc je m’excuse pour le thon agressif de cette phrase. Merci aussi pour le travail réalisé même si en définitve, je n’arrive pas à implémenter cette fonction.
J’ai étudié ta propsition : sur un article il indique une erreur : FPDF error : GIF parser : unable to open file http://www.archeographe.net/IMG/art18-2.gif , hors cette image est bien à cet emplacement.
Les droits sont bien en 777 et article_pdf.html est bien à la racine du site. Peut être, le script n’est pas compatible avec la réicriture d’url.
A bientôt.
PS j’aimerais beaucoup te verser 300 euros pour la résolution du problème mais mon site est perso, bénévole et manque donc cruellement de moyens financiers.
Par rapport a l’ erreur FPDF error : GIF parser : unable to open file j’ai eu le meme probleme.
Ca venait du passage a php5. En effet, dans la librairie gif.php il y a un certain nombre d’ appels de fonction avec une initialisation de variable dans l’ appel :
ex :$this->m_img->load($this->m_lpData, $imgLen = 0)
Or, ces fonctions doivent retourner une valeur de ce parametre en sortie (passage par reference).
En php4, il semble que l’ affectation de la variable se fasse AVANT l’ appel de la fonction alors qu’ en php5 elle se fait APRES... conclusion, $imgLen est remise a zero.
Qui plus est, ces affectations dans l’ appel sont inutiles car les fonctions appellees font deja l’ initialisation.
Il suffit donc de supprimer l’ affectation dans l’ appel.
Ca revient a modifier comme suit le fichier gif.php :
Répondre à ce message
les apostrophes ne passent pas :
dans les titres elles sont remplacées par ’
dans les textes elles sont remplacées par un espace
j’ai essayé
<code>$trans[’’’] = "’" ;</code>
et
<code>$trans[’’’] = " ;’" ; ;< ;</code>
ça marche pas
un petit coup de main svp ?
les apostrophes sont remplacées par & # 8217 ;
chez moi les apostrophes sont remplacées par rien du tout, les mots sont collés
Répondre à ce message
Ci dessous une modif du filtre pour le PDF qui convertie l’UTF-8 en ISO-8859-1 pour supporter les accents sous SPIP 1.9 (si UTF-8 est activé, comme dans le cas d’une nouvelle installation), + conversion des retour chariots (\n) en BR pour les « cadre » :
A remplacer/compléter dans mes_fonctions.php.
Salut, cette modife dans mon fichier mes_fontions.php me fait le même effet qu’une autre contrib pour avoir les PDF en UTF-8 c’est à dire que les pages de mon site deviennent toute blanches.
A+
Répondre à ce message
Bonjour,
J’ai un message d’erreur suite à l’installation de cette contrib qui me parait fort efficace. Le fichier pdf est correctement créé au bon endroit, mais le soucis c’est que j’ai un warning sur la page qui s’ouvre et je ne peux voir le fichier pdf. Que faire ?
Message :
Warning : Cannot modify header information - headers already sent by (output started at /var/www/html/etablissements/0601882v/mes_fonctions.php3:15) in /var/www/html/etablissements/0601882v/inc-public.php3(60) : eval()’d code on line 107
Site en question
Merci d’avance
++
Ben
Répondre à ce message
la conversion des .gif par gif.php ne fonctionnant pas bien pour moi (il s’obstine a me dire qu’il ne trouve pas le fichier .gif alors qu’il est bien la...), j’ai parcouru le fichier fpdf.php.
a la ligne 933 :
meme si GD est bien installe,
if ($readgif[3])
n’est jamais verifie, unecho gd_info();
donne dans mon cas :je ne sais pas bien ce que devrait verifier $readgif[3], toujours est-il qu’en supprimant ce test, ca fonctionne...
seb
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |