Impression PDF

Temps de lecture: 14 minutes


Introduction

Si vous pouvez imprimer d’un simple clic un bon de livraison et une facture, vous économisez beaucoup de temps et d’argent. Ce module d’impression de bons de livraison et de factures PDF génère des documents PDF élégants pour chaque commande reçue. Vous pouvez également importer votre propre modèle PDF, qui est ensuite utilisé comme modèle de lettre. Ce module est disponible en option pour le PepperShop et doit être acheté séparément.

Configuration du module

Vous accédez d’abord à l’administration du module PDF : menu principal Administration de la boutique > Modules > PDF.

Dans le masque d’administration de ce module PepperShop, vous pouvez maintenant télécharger vos propres modèles PDF, activer le module et configurer précisément l’emplacement des différents éléments (adresse, titre, position des articles, etc.).

Illustration 1: Extrait de la boîte de dialogue de configuration du module PDF

Dans l’administration du module PDF, il existe les paramètres de configuration suivantes :

Illustration 2: Suite de la Figure 3

  • Réinitialiser les valeurs standards: Restaurer les valeurs standards : le module sera réinitialisé à ses valeurs standards, toutes les configurations seront perdues et les valeurs par défaut seront définies.

Configuration pour l’affichage des articles

  • Activation : le module doit-il être actif ?
  • Modèle PDF pour la première page : un modèle PDF pour la première page est téléchargé ici. Le téléchargement se fait sans le bouton Enregistrer.
  • Modèle PDF pour la page suivante : un modèle PDF pour la page suivante est téléchargé ici. Le téléchargement se fait sans le bouton Enregistrer.
  • Affichage test : un PDF de test est généré.

Paramètres de configuration Bloc adresse (adresse)

  • Longueur maximale de ligne (les lignes plus longues seront réalignées) : le nombre de caractères maximum qui peut se trouver sur une ligne.
  • Distance entre le bloc adresse et la marge gauche du document (en mm) : quelle doit être la distance totale entre la marge gauche du document et le bloc d’adresse ? L’indication doit être donnée en millimètres.
  • Distance entre le bloc adresse et la marge supérieure du document (en mm) : Quelle doit être la distance totale entre la marge supérieure du document et le bloc adresse ? L’indication doit être donnée en millimètres.
  • Largeur du bloc adresses (en mm) : largeur du bloc d’adresses complet. L’indication doit être donnée en millimètres.
  • Style de police du bloc adresse : vide, B, I, U : spécifiez si le texte doit être Gras (gras), Italique (italique), Souligné, ou simplement non formaté (vide).
  • Taille de la police du bloc adresse en points : quelle doit être la taille de la police normale dans le bloc d’adresse ?

Paramètres de configuration Titre du document (par ex. facture, bon de livraison)

  • Distance entre le bloc titre et la marge gauche du document (en mm) : quelle doit être la distance totale entre la marge gauche du document et le bloc titre ? L’indication doit être donnée en millimètres.
  • Distance entre le bloc titre et la marge supérieur du document (en mm) : quelle doit être la distance totale entre la marge supérieure du document et le bloc titre ? L’indication doit être donnée en millimètres.
  • Largeur de la colonne de gauche (désignations) : quelle devrait être la taille de la colonne de gauche ? La valeur doit être exprimée en millimètres.
  • Alignement du texte colonne de gauche : la largeur de tout le bloc d’adresse. L’indication doit être donnée en millimètres.
  • Style de police du bloc titre : vide, B, I, U : Spécifiez si le texte doit être en gras, en italique, souligné ou simplement non formaté.
  • Taille de la police du bloc titre en points : quelle taille doit avoir la police normale dans le bloc titre ?

Paramètres de configuration Bloc info (numéro de facture, date de commande,…)

  • Distance entre le bloc info et la marge gauche du document (en mm) : quelle doit être la distance totale entre la marge gauche du document et le bloc info ? L’indication doit être donnée en millimètres.
  • Distance entre le bloc info et la marge supérieure du document (en mm) : quelle doit être la distance totale entre la marge supérieure du document et le bloc info ? L’indication doit être donnée en millimètres.
  • Largeur de la colonne de gauche (désignations) : quelle devrait être la taille de la colonne de gauche ? La valeur doit être exprimée en millimètres.
  • Largeur de la colonne de droite (contenu) : quelle devrait être la taille de la colonne de droite ? La valeur doit être exprimée en millimètres.
  • Largeur de la deuxième colonne gauche (activée avec deux colonnes) : quelle doit être la largeur de la deuxième colonne gauche ? La valeur doit être exprimée en millimètres.
  • Largeur de la deuxième colonne de droite (allumée avec deux colonnes) : quelle doit être la largeur de la deuxième colonne de droite ? La valeur doit être exprimée en millimètres.
  • Alignement du texte dans la colonne de gauche : l’alignement du texte dans la colonne de gauche. Entrez G pour gauche ou D pour droite.
  • Alignement du texte dans la colonne de droite : l’alignement du texte dans la colonne de droite. Entrez G pour gauche ou D pour droite.

Paramètres de configuration Tableau des articles

  • Facture, longueur maximale des lignes du nom de l’article (les lignes plus longues seront réalignées) : Après combien de lettres le contenu doit-il être réaligné ?
  • Livraison, longueur maximale de la ligne du nom de l’article (les lignes plus longues seront réalignées) : Après combien de lettres le contenu doit-il être réaligné ?
  • Distance entre le tableau des articles et la marge gauche du document (en mm) : quelle doit être la distance totale entre la marge gauche du document et le tableau des articles ? L’indication doit être donnée en millimètres.
  • Distance entre le tableau des articles et la marge supérieure du document (en mm) : quelle doit être la distance totale entre la marge supérieure du document et le tableau des articles ? L’indication doit être donnée en millimètres.
  • Largeur de la colonne Position : quelle devrait être la largeur de la colonne qui affiche les positions individuelles ? L’indication doit être donnée en millimètres.
  • Largeur de la colonne Désignation : quelle devrait être la largeur de la colonne contenant les désignations ? La valeur doit être exprimée en millimètres.
  • Largeur de la colonne Nombre : quelle devrait être la largeur de la colonne contenant le nombre d’articles ? La valeur doit être exprimée en millimètres.
  • Largeur de la colonne Unité : quelle doit être la largeur de la colonne contenant l’unité (pièce, kg, etc.) ? La valeur doit être exprimée en millimètres.
  • Large de la colonne Prix : quelle devrait être la largeur de la colonne contenant les prix ? La valeur doit être exprimée en millimètres.
  • Large de la colonne TVA : quelle doit être la largeur de la colonne contenant la TVA ? La valeur doit être exprimée en millimètres.
  • Largeur de la colonne Total : quelle devrait être la largeur de la colonne contenant les totaux ? La valeur doit être exprimée en millimètres.
  • Alignement du texte dans la colonne Position : l’alignement du texte à l’intérieur des colonnes de position. Entrez G pour gauche ou D pour droite.
  • Alignement du texte dans la colonne Désignation : l’alignement du texte à l’intérieur de la colonne de désignation. Entrez G pour gauche ou D pour droite.
  • Alignement du texte dans la colonne Nombre : l’alignement du texte à l’intérieur de la colonne du nombre. Entrez G pour gauche ou D pour droite.
  • Alignement du texte dans la colonne Unité : l’alignement du texte dans la colonne Unité. Entrez G pour gauche ou D pour droite.
  • Alignement du texte dans la colonne Prix : l’alignement du texte dans la colonne de prix. Entrez G pour gauche ou D pour droite.
  • Alignement du texte dans la colonne TVA : l’alignement du texte dans la colonne TVA. Entrez G pour gauche ou D pour droite.
  • Alignement du texte dans la colonne Total : l’alignement du texte dans la colonne des totaux. Entrez G pour gauche ou D pour droite.

Paramètres de configuration Informations supplémentaires sur l’article (variantes, options, champs de texte)

  • Taille de police des informations supplémentaires sur l’article en points : quelle taille doit avoir la police normale dans le bloc adresse ?
  • Style de police des informations supplémentaires sur l’article : vide, B, I, U : spécifiez si le texte doit être en gras, en italique, souligné ou simplement non formaté.

Paramètres de configuration (article) Photos

  • Afficher les photos de l’article dans la facture
  • Afficher les photos de l’article sur le bon de livraison
  • Photos de l’article : hauteur maximale
  • Photos de l’article : largeur maximale
  • Photos générales : résolution en dpi (dpi = points par pouce)

Les photos des articles sont toujours reprises depuis la gamme actuelle des articles (identifiée par l’ID interne de l’article). Si un article est retiré de la gamme ou si son image a changé entre-temps, cela affecte également l’impression de la facture/du bon de livraison. De plus, il faut considérer que seules les photos aux formats JPG et PNG (8 bits uniquement) peuvent être affichées.

Paramètres de configuration Positions Total

  • Largeur de la colonne Monnaie : quelle devrait être la largeur de la colonne Monnaie ? La valeur doit être exprimée en millimètres.
  • Largeur de la colonne Total : quelle devrait être la largeur de la colonne de total ? La valeur doit être exprimée en millimètres.
  • Alignement du texte de la colonne Désignation : l’alignement du texte dans la colonne de désignation. Entrez G pour gauche ou D pour droite.
  • Alignement du texte de la colonne Monnaie : l’alignement du texte dans la colonne de la monnaie. Entrez G pour gauche ou D pour droite.
  • Alignement du texte de la colonne Total : l’alignement du texte dans la colonne de total. Entrez G pour gauche ou D pour droite.

Paramètres de configuration Numéro de pages / nombre total de pages

  • Distance entre le n° de page et la marge gauche du document (en mm) : quelle doit être la distance totale entre la marge gauche du document et le n° de page ? L’indication doit être donnée en millimètres.
  • Distance entre le n° de page et la marge supérieure du document (en mm) : quelle doit être la distance totale entre la marge supérieure du document et le n° de page ? L’indication doit être donnée en millimètres.
  • Style de police : vide, B, I, U : spécifiez si le texte doit être en gras, en italique, souligné ou simplement non formaté (vide).
  • Taille de la police en points : quelle taille doit avoir la police normale du n° de page ?
  • Alignement : l’alignement du texte du numéro de page / nombre total de page. Entrez G pour gauche ou D pour droite.

Paramètres des configurations Délai de paiement des factures

  • Affichage du délai de paiement (uniquement pour le document PDF de facture) : affichage dans la facture
  • Délai de paiement : Nombre de jours : Indication en jours

Configuration générale

  • Couleur du texte Composante rouge de RVB : la partie rouge de la couleur du texte pour le PDF.
  • Couleur du texte Composante verte du RVB : la partie verte de la couleur du texte pour le PDF.
  • Couleur du texte Composante bleue du RVB : la partie bleue de la couleur du texte pour le PDF.
  • Nom de police : sélectionnez ici la police pour le PDF.
  • Style de police : vide, B, I, U : spécifiez si le texte doit être en gras, en italique, souligné ou simplement non formaté.
  • Taille de la police en points : quelle doit être la taille de la police normale ?
  • Marge supérieure : spécifiez la marge supérieure en millimètres à partir de la marge supérieure.
  • Marge de droite : spécifiez la marge en millimètres à partir de la marge de droite.
  • Marge inférieure : spécifiez la marge de la page en millimètres à partir de la marge inférieure.
  • Marge de gauche : spécifiez la marge en millimètres à partir de la marge de gauche.
  • Éditez la grille d’orientation pour l’ensemble du document : place une grille auxiliaire sur l’ensemble du PDF afin de pouvoir vérifier l’alignement.
  • Affichage des prix TVA incluse.

Fonctionnement

Pour créer un bon de livraison ou une facture, cliquez simplement sur le nouveau bouton PDF sous Clients/Commandes > Gestion des clients et sélectionnez le lien correspondant.

Illustration 3: aperçu Gestion des clients et des commandes

Les fichiers PDF générés sont stockés dans le répertoire suivant :

{shopdir}/shop/Admin/pdf/generated/

Importez vos propres polices (pour les utilisateurs avancés)

Dans PepperShop, les PDF sont créés à l’aide de la bibliothèque FPDF. Ceci ne peut utiliser que des polices spécifiquement formatées. Une police TrueType doit d’abord être convertie. Il existe un générateur en ligne facile à utiliser : http://fpdf.fruit-lab.de/

Ici, vous spécifiez une police TrueType (fichier.TTF) et enregistrez les deux fichiers .php et.z après la conversion. Ces deux fichiers doivent être copiés pour chaque police de caractères (normal, gras, italique et gras+italique) dans le répertoire suivant :

{shop_directory}shop/Admin/pdf/fpdf

Afin d’utiliser la police FPDF, elle doit correspondre à un schéma de nom spécial : seulement des lettres minuscules et pas de caractères spéciaux (ex : police : Lars Sans) :

  • Normal:{Nom de police}.ttf Exemple : larssans.ttf
  • Gras:{Nom de police}b.ttf Exemple : larssansb.ttf
  • Italique:{Nom de police}i.ttf Exemple : larssansi.ttf
  • Gras+italique:{Nom de police}bi.ttf Exemple : larssansbi.ttf

Convertir sa propre police via PepperShop Batchimport

Avec cet outil, disponible depuis PepperShop v.3.2, vous pouvez rapidement convertir de nombreuses polices en FPDF.

Connectez-vous au serveur Web via FTP ou console. Créez les deux répertoires suivants dans la boutique, s’ils n’existent pas déjà :

shop_directory}/shop/Admin/pdf/fpdf/fpdf/src (si nécessaire, ajustez les droits du répertoire à 777)

shop_directory}/shop/Admin/pdf/fpdf/fpdf/dest (si nécessaire, ajustez les droits du répertoire à 777)

Stockez les fichiers TTF à convertir dans le répertoire src.

Les fichiers TTF doivent respecter la convention d’appellation mentionnée dans le chapitre précédent et les quatre styles de polices doivent toujours être présents !

a) Effectuer l’appel suivant dans le navigateur ou via la ligne de commande (le mode Safe doit être désactivé !):

http://www.example.com/mein/pfad_to_the_webshop/shop/Admin/pdf/makefont_batch.php

b) …ou via Commande-Line :

cd {shopdirectory}/shop/Admin && php pdf/makefont_batch.php commandline

Les polices maintenant créées (fichiers.php +.z) du dossier

.../shop/admin/pdf/fpdf/fpdf/makefont/_dest_

dans le dossier

shop/Admin/pdf/fpdf/fpdf/font move. Les polices peuvent maintenant être utilisées.

Support UTF-8

Le système FPDF sous-jacent ne supporte que le jeu de caractères Latin1. Si vous souhaitez utiliser le jeu de caractères UTF-8 étendu, qui peut également être utilisé pour afficher de nombreux caractères d’autres langues, procédez comme suit :

Conditions préalables :

  • La configuration système requise est une version 5.0.0.24 ou supérieure de PepperShop.
  • L’accès direct aux fichiers doit être disponible (FTP ou SCP).
  • Connaissance de PHP et d’un éditeur capable de travailler avec des sauts de ligne UNIX

Commutation / activation UTF-8:

  • unzip admin/pdf/tfpdf.tar.gz
  • Si vous avez une police TrueType (.ttf) qui supporte UTF-8 ( !), vous pouvez configurer le module pour travailler avec UTF-8.
  • Dans le fichier {shop_directory}/shop/Admin/Admin/pdf/pdf_config.php vous devez changer la constante de contrôle PDF_USE_UTF8 en true.
  • La constante PDF_USE_UTF8_FONT_NAME contient le nom de la police TTF compatible UTF-8.
  • Le nom de fichier de la police est saisi dans la constante PDF_USE_UTF8_FONT.
  • La police doit être dans le répertoire {shop_verzeichnis}/Admin/pdf/tfpdf/font/unifon/
  • La constante PDF_USE_UTF8_FONTB est la même que PDF_USE_UTF8_FONT pour ‘bold’.
  • La constante PDF_USE_UTF8_FONTI est la même que PDF_USE_UTF8_FONT pour ‘italic’.

Installation

Configuration système

Pour pouvoir utiliser le module d’impression PDF, un PepperShop v.3.0 Professional ou Enterprise est nécessaire.

Copier et télécharger des fichiers

Le module se compose de quelques fichiers et sous-répertoires que vous devez copier dans votre PepperShop installé. Tout d’abord, décompressez l’archive ZIP fournie. Il contient les sous-dossiers avec les fichiers :

{shopdir}/shop/Admin/pdf
{shopdir}/shop/Admin/module/pdf
{shopdir}/shop/module/pdf

Les fichiers peuvent être facilement téléchargés via FTP ou SCP sur le serveur Web. L’espace réservé {shopdir} représente le répertoire de la boutique sur le serveur Web, où vous pouvez trouver le fichier index.php et README.txt._

Le module est maintenant reconnu et intégré par la boutique. I est listé dans le menu Paramètres de la boutique > Configuration de la boutique au bas de l’information interne du module.

Installation du module

Après avoir copié les fichiers, vous pouvez aller dans Administration de la boutique > Modules. Sur le côté gauche, dans les modules non installés, vous pouvez voir le module PDF listé.

Sélectionnez maintenant le module PDF et cliquez sur le bouton Installer. Si la routine d’installation se déroule sans problème, elle sera communiquée à la page suivante. Le module est maintenant installé. Nous cliquons maintenant sur le bouton Retour gestion module et là Retour administration module. Nous voyons maintenant un bouton pour le module PDF. Si vous cliquez sur ce bouton, la gestion de ce module apparaîtra.

Illustration 4: Administration modules (les modules affichés peuvent différer)

Autres étapes d’installation

Le module d’impression PDF contient deux paquets qui doivent être déballés pour pouvoir utiliser le module sans problème :

{shopdir}/shop/Admin/pdf/fpdf/fpdf.tar.gz
{shopdir}/shop/Admin/pdf/fpdi.tar.tar.gz

Si PHP s’exécute sur un serveur UNIX en tant que module de serveur Web (et seulement alors):

  • attribuer les droits d’accès 777 au répertoire {shopdir}/shop/Admin/pdf
  • attribuer les droits d’accès 777 au répertoire {shopdir}/shop/Admin/pdf/generated
  • Attribuer les droits d’accès 777 au répertoire {shopdir}/shop/Admin/pdf/template

Les droits d’accès aux fichiers peuvent également être définis automatiquement (par FTP) : Paramètres de la boutique > Configuration de la boutique > Opérations, vous n’avez plus qu’à ajuster les droits aux fichiers.

L’installation du module PDF est maintenant terminée. Pour que le module puisse être utilisé, il doit maintenant être adapté à la configuration spécifique du propriétaire de la boutique, voir le chapitre suivant Configuration du module, ci-dessous.

Pièces jointes

Annexe 1 : Exemple de facture

Annexe 2 : Exemple de bon de livraison

🌶️
🔥
🌶️