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

---

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 (200 DPI), 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 balises d'ouverture et fermeture

Chaque code d'étiquette doit commencer par la balise d'ouverture <hibou_print_tspl_start_format> et terminer par la balise de fermeture <hibou_print_tspl_end_format>.
La balise d'ouverture encode le format de l'étiquette en millimètres:

Exemple:

<hibou_print_tspl_start_format>50|25

pour imprimer sur des étiquettes de 50 x 25 mm

---

3/ Configuration des blocs textes

Pour le texte (<hibou_print_tspl_add_text>), vous devez définir les variables suivantes dans l’ordre :
– le positionnement (x et y en points),
– la police d’écriture (A ou 0 à 5 | 3 par défaut),
– l’orientation du texte (0 pour horizontale, 90 pour verticale, 180 pour horizontale inversée, 270 pour verticale inversée),
– la hauteur de la police d’écriture (coefficent multiplicateur de 1 à 10),
– la largeur de la police d’écriture (coefficent multiplicateur de 1 à 10).
Les variables sont séparées par des pipes (|).

Exemple :

<hibou_print_tspl_add_text>20|10|2|0|1|1|<hibou_print_products_price> <hibou_print_currency>

<hibou_print_tspl_add_text> indique que nous souhaitons imprimer un texte,
20|10 sont les coordonnées x et y,
2 est la police n°2 de l’imprimante,
0 permet d’imprimer le texte horizontalement,
1|1 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 devise.

---

4/ Configuration des codes-barres

Pour le code-barres (<hibou_print_tspl_bar_code>) seuls les codes EAN13 sont acceptés.
Vous devez définir les variables suivantes dans l’ordre :
– le positionnement (x et y en points),
– la hauteur (en points, par défaut 100),
– l’orientation (0 pour horizontale, 90 pour verticale, 180 pour horizontale inversée, 260 pour verticale inversée),

Exemple :

<hibou_print_tspl_bar_code>20|300|100|0|<hibou_print_bar_code_value>

<hibou_print_bar_code> indique que nous souhaitons imprimer le code-barres du produit,
20|300 sont les coordonnées x et y du code-barres,
100 indique que la hauteur du code-barres est de 100 points,
0 permet d’imprimer le code-barres horizontalement,
et <hibou_print_bar_code_value> indique qu’il faut imprimer le code-barres du produit.

---

5/ Configuration des QR-codes

Pour le QR-code (<hibou_print_tspl_dmatrix>), vous devez définir les variables suivantes dans l’ordre :
– le positionnement (x et y en points),
– La hauteur (en points),
– la largeur (en points).

Exemple :

<hibou_print_tspl_dmatrix>20|50|80|80|https://www.google.com

<hibou_print_tspl_dmatrix> indique que nous souhaitons imprimer un QR-code,
20|50 sont les coordonnées x et y du QR-code,
80|80 sont la hauteur et largeur du QR-code,
Suivi du contenu à encoder (l'URL de Google pour l'exemple).

---

6/ Un exemple pratique

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

<hibou_print_tspl_start_format>50|25
//balise de début du code pour configurer l’étiquette de 50x25 mm

<hibou_print_tspl_add_text>20|25|2|0|1|1|<hibou_print_products_name>
//Impression du nom du produit en haut de l’étiquette

<hibou_print_tspl_bar_code>20|70|90|0|<hibou_print_bar_code_value>
// Impression du code-barres du produit

<hibou_print_tspl_add_text>330|80|2|90|1|1|<hibou_print_products_price>
//Impression du prix du produit verticalement après le code-barres

<hibou_print_tspl_add_text>360|80|2|90|1|1|EUR
//Impression de la devise du produit verticalement en dessous du prix

<hibou_print_tspl_end_format>
//balise de fin du code

---

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

Les variables d’un cadre (<hibou_print_tspl_add_box>) sont :
– le positionnement du bord haut gauche (x et y en points),
– le positionnement du bord bas droit (x et y en points),
– l’épaisseur des bords (en points entre 1 et 10),
– et l’arrondi des coins (entre 0 et 8, où 0 signifie que les coins sont carrés)

Exemple :

<hibou_print_tspl_add_box>50|50|250|90|1|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_tspl_add_text>250|70|3|0|1|1|<hibou_print_products_price> EUR  
<hibou_print_tspl_add_box>240|83|290|83|1|0