Ce guide explique la configuration des étiquettes lorsque vous utilisez une imprimante ZPL.
Le code de votre étiquette se renseigne dans la section 'Paramètres/Impression/Étiquettes'.

---

1/ Contenu dynamique

Le contenu (texte ou code-barres) est un bloc que vous positionnez sur l’étiquette.
Vous devez donc définir pour chaque élément ses coordonnées (x et y) où x est le positionnement du contenu (en points) par rapport au bord gauche de votre étiquette et y son positionnement par rapport au bord haut de votre étiquette.
Le format de votre étiquette est défini en points. En fonction de la résolution de votre imprimante et de la taille de vos étiquettes, vous aurez plus ou moins de points en largeur et en hauteur. Vous devrez donc jouer sur les valeurs de x et y pour bien positionner votre contenu.
ex: pour une imprimante en 8 pts/mm, une étiquette de 51×25 mm aura 408 pts en abscisse (x) et 200 pts en ordonnée (y).

Les contenus que vous pouvez imprimer sur l’étiquette sont :
– l’identifiant du produit : <hibou_print_products_id>,
– le nom du produit : <hibou_print_products_name>,
– la déclinaison du produit : <hibou_print_products_size>,
– la catégorie du produit : <hibou_print_products_category>,
– le prix du produit : <hibou_print_products_price>,
– le prix du produit sans décimales : <hibou_print_products_price_round_0>,
– le prix du produit avec 2 décimales : <hibou_print_products_price_round_2>,
– le prix du produit pondéré par le multiple : <hibou_print_products_price_weighted>,
– le prix soldé du produit : <hibou_print_products_discount_price>,
– le code-barre du produit: <hibou_print_bar_code_value>,
– la devise du compte: <hibou_print_currency>,
– la référence fournisseur du produit : <hibou_print_products_ref_manufacturer>,
– la référence externe du produit : <hibou_print_products_ref_ext>,
– la marque du produit : <hibou_print_products_brand>,
– l’emplacement stock: <hibou_print_products_storage_location>,
– le nom court du produit: <hibou_print_products_short_name>,
– le nom du point de vente: <hibou_print_store_name>,
– le paramètre misc_date: <hibou_print_products_misc_date>,
– le paramètre misc_decimal: <hibou_print_products_misc_decimal>,
– le paramètre misc_text: <hibou_print_products_misc_text>,
– le paramètre misc_integer: <hibou_print_products_misc_int>,
– le paramètre misc_varchar: <hibou_print_products_misc_varchar>,
– le paramètre misc_varchar2: <hibou_print_products_misc_varchar2>,
– ou tout texte libre.

---

2/ Configuration des blocs textes

Pour le texte (<hibou_print_zpl_add_text>), vous devez définir les variables suivantes dans l’ordre :
– le positionnement (x et y en points),
– la police d’écriture (A à Z ou 0 à 9),
– l’orientation du texte (N pour horizontale, R pour verticale, I pour horizontale inversée, B pour verticale inversée),
– la hauteur de la police d’écriture (en points),
– la largeur de la police d’écriture (par défaut vous pouvez mettre la même valeur que la hauteur de la police).
Les variables sont séparées par des pipes (|).

Exemple :

<hibou_print_zpl_add_text>20|10|D|N|30|30|<hibou_print_products_price> <hibou_print_currency>

<hibou_print_zpl_add_text> indique que nous souhaitons imprimer un texte,
20|10 sont les coordonnées x et y,
D est la police D de l’imprimante,
N permet d’imprimer le texte horizontalement,
30|30 est la hauteur et la largeur de la police,
et <hibou_print_products_price> <hibou_print_currency> indique qu’il faut imprimer le prix du produit suivi de la devise.

Si votre bloc texte est trop long vous pouvez le tronquer avec les balises suivantes : <hibou_print_zpl_cut_start> et <hibou_print_zpl_cut_end>
Exemple :

<hibou_print_products_name>|<hibou_print_zpl_cut_start>0</hibou_print_zpl_cut_start>||<hibou_print_zpl_cut_end>20</hibou_print_zpl_cut_end>|  

affichera uniquement les 20 premiers caractères du nom du produit.

---

3/ Configuration des codes-barres

Pour le code-barres (<hibou_print_zpl_bar_code>), vous devez définir les variables suivantes dans l’ordre :
– le positionnement (x et y en points),
– l’orientation (N pour horizontale, R pour verticale, I pour horizontale inversée, B pour verticale inversée),
– la hauteur (en points entre 1 et 32000),
– l’affichage de la séquence chiffrée du code-barres (Y pour oui ou N pour non),
– le positionnement de la séquence chiffrée du code-barres (N si en bas du code-barres, Y si en haut du code-barres).

Exemple :

<hibou_print_zpl_bar_code>20|300|N|10|Y|N

<hibou_print_zpl_bar_code> indique que nous souhaitons imprimer le code-barres du produit,
20|300 sont les coordonnées x et y du code-barres,
N permet d’imprimer le code-barres horizontalement,
10|Y|N indique que la hauteur du code-barres est de 10 points, et que les chiffres du code-barres s’impriment en bas.

---

3/ Configuration des QR-codes

Pour le QR-code (<hibou_print_zpl_products_qr_code>), vous devez définir les variables suivantes dans l’ordre :
– le positionnement (x et y en points),
– Le modèle (1 pour standard, 2 pour optimisé - recommandé),
– la taille (de 1 à 10),
– La précision (H pour très haute, Q pour haute, M pour normal, L pour dégradé),
– le masque d'encodage (de 0 à 7).

Exemple :

<hibou_print_zpl_products_qr_code>20|50|2|5|M|7|https://www.google.com

<hibou_print_zpl_products_qr_code> indique que nous souhaitons imprimer un QR-code,
20|50 sont les coordonnées x et y du QR-code,
0|2|5|M|7 sont les paramètres spécifiques du QR-code,
Suivi du contenu à encoder (l'URL de Google pour l'exemple).

---

5/ Un exemple pratique

Voici le code à saisir pour l’étiquette suivante:

<hibou_print_zpl_start_format>
//balise de début du code pour configurer l’étiquette

<hibou_print_zpl_add_text>20|25|D|N|10|10|<hibou_print_products_name>
//Impression du nom du produit en haut de l’étiquette

<hibou_print_zpl_bar_code>20|70|N|80|Y|N
// Impression du code-barres du produit

<hibou_print_zpl_add_text>330|80|D|B|16|10|<hibou_print_products_price>
//Impression du prix du produit verticalement après le code-barres

<hibou_print_zpl_add_text>360|80|D|B|16|10|EUR
//Impression de la devise du produit verticalement en dessous du prix

<hibou_print_zpl_end_format>
//balise de fin du code pour configurer l’étiquette

---

6/ Pour aller plus loin : cadres et prix barré

Les variables d’un cadre (<hibou_print_zpl_add_box>) sont :
– le positionnement (x et y en points),
– la largeur (en points entre 1 et 32000),
– la hauteur (en points entre 1 et 32000),
– l’épaisseur des bords (en points entre 1 et 32000),
– la couleur du cadre (B pour noir et W pour blanc)
– et l’arrondi des coins (entre 0 et 8, où 0 signifie que les coins sont carrés)

Exemple :

<hibou_print_zpl_add_box>50|100|200|40|4|B|0

pour créer un cadre noir aux coins carrés de 200 points de largeur et 40 points de hauteur

Pour les prix barrés, il suffit de créer un cadre noir dont la hauteur est égale à l’épaisseur des bords, que nous positionnerons à une coordonnée x un peu avant le prix à barrer, et à une coordonnée y au centre du prix.

Exemple :

<hibou_print_zpl_add_text>250|70|D|N|16|10|<hibou_print_products_price> EUR  
<hibou_print_zpl_add_box>240|83|150|2|2|B|0