Module PrestaShop open source : afficher la référence produit dans les alertes de stock

Sur une boutique PrestaShop, les alertes de stock sont précieuses pour réagir vite lorsqu’un produit devient faible ou arrive en rupture. Mais dans certains cas, l’email reçu ne permet pas d’identifier immédiatement la bonne référence, surtout lorsque le catalogue contient de nombreux produits ou déclinaisons.

C’est exactement le besoin qui a donné naissance à tsmailvars, un module PrestaShop open source développé par Studio 109. Son rôle est simple : ajouter automatiquement la référence produit, ou la référence de déclinaison, dans les emails d’alerte de stock envoyés par le module natif ps_emailalerts.

Le problème : une alerte stock sans référence produit

Le module natif ps_emailalerts permet d’envoyer des emails lorsqu’un produit devient faible ou atteint un seuil de rupture. C’est utile, mais il manque parfois une information essentielle : la référence produit.

Sur une petite boutique, ce n’est pas toujours bloquant. Mais sur une boutique avec beaucoup de produits, de tailles, de couleurs ou de déclinaisons, cela peut ralentir le traitement.

Pourquoi cette petite amélioration change beaucoup de choses

Ajouter une référence produit dans un email peut sembler anecdotique. Pourtant, dans un contexte e-commerce, c’est souvent ce type de détail qui fait gagner du temps au quotidien.

Une référence claire permet :

• d’identifier plus rapidement le produit concerné ;
• de limiter les erreurs lorsqu’il existe plusieurs déclinaisons proches ;
• de réagir plus vite côté stock, réassort ou fournisseur ;
• d’améliorer le suivi interne sans modifier le fonctionnement natif de PrestaShop.

C’est le genre d’amélioration discrète mais utile que l’on rencontre souvent lors d’un travail de maintenance PrestaShop ou d’optimisation d’une boutique existante.

tsmailvars : un module PrestaShop simple, ciblé et open source

Le module tsmailvars a été conçu pour rester volontairement léger. Il ne remplace pas ps_emailalerts, ne modifie pas le core PrestaShop et ne nécessite pas d’override.

Il ajoute une nouvelle variable email :

Cette variable peut ensuite être utilisée dans le template email d’alerte stock pour afficher la référence du produit ou de la déclinaison concernée.

Compatibilité PrestaShop

Le module est prévu pour les boutiques PrestaShop 1.7 et PrestaShop 8. Il a été pensé pour fonctionner avec le module natif ps_emailalerts, sans modification directe de ce dernier.

• compatible PrestaShop 1.7.x ;
• compatible PrestaShop 8.x ;
• prise en charge des déclinaisons produit ;
• aucune modification du core ;
• aucun override ;
• installation et désinstallation sécurisées.

Pour une boutique PrestaShop, ce type de module peut être utile lorsqu’il faut améliorer le quotidien de gestion sans partir sur un développement lourd.

Comment fonctionne le module ?

Le fonctionnement repose sur deux hooks PrestaShop.

1. Le hook actionUpdateQuantity

Ce hook est déclenché lorsqu’une quantité produit est mise à jour. Le module mémorise temporairement l’identifiant du produit et l’identifiant de la déclinaison lorsque celle-ci existe.

2. Le hook sendMailAlterTemplateVars

Ce hook intervient juste avant l’envoi d’un email. Le module vérifie que le template concerné est bien productoutofstock, récupère la référence produit ou déclinaison, puis injecte la variable {product_reference} dans les variables du template email.

Installation du module

Le module peut être installé depuis le back-office PrestaShop en envoyant le ZIP via :

• Modules ;
• Gestionnaire de modules ;
• Installer un module.

Il peut aussi être installé manuellement en envoyant le dossier dans :

Point important : l’ordre du hook

Pour que la variable soit disponible au bon moment, il faut vérifier l’ordre du hook actionUpdateQuantity dans le back-office PrestaShop.

Le module tsmailvars doit être positionné avant ps_emailalerts.

• aller dans Apparence → Positions ;
• chercher le hook actionUpdateQuantity ;
• placer tsmailvars avant ps_emailalerts.

Modification du template email

Une fois le module installé, il faut ajouter la variable dans le template email d’alerte stock.

Les fichiers concernés peuvent se trouver dans les templates mails du thème, par exemple :

• productoutofstock.html ;
• productoutofstock.txt.

Pourquoi publier ce module en open source ?

Le module répond à un besoin simple, mais réel. Le publier en open source permet à d’autres e-commerçants, développeurs ou intégrateurs PrestaShop de l’utiliser, de le vérifier, de l’adapter ou de proposer des améliorations.

C’est aussi une façon de montrer concrètement l’approche de Studio 109 : chercher des solutions utiles, propres et maintenables, sans complexifier inutilement une boutique.

Le module est disponible sur GitHub : prestashop-tsmailvars .

Un exemple de développement utile pour PrestaShop

Toutes les améliorations e-commerce n’ont pas besoin d’être lourdes. Parfois, un petit module bien ciblé peut apporter un vrai confort de gestion.

Studio 109 accompagne les entreprises sur la création de boutiques PrestaShop, la correction de problèmes existants, la maintenance, l’optimisation des emails, du tunnel de commande et des outils internes. Ce type de module s’inscrit parfaitement dans cette logique.

FAQ — Module PrestaShop tsmailvars

À quoi sert le module tsmailvars ?

Il permet d’ajouter la référence produit ou déclinaison dans les emails d’alerte stock envoyés par le module natif ps_emailalerts.

Le module modifie-t-il le core PrestaShop ?

Non. Le module ne modifie pas le core PrestaShop et ne nécessite pas d’override.

Est-il compatible avec les déclinaisons ?

Oui. Le module peut récupérer la référence de la déclinaison lorsque le produit concerné en possède une.

Est-il compatible avec PrestaShop 8 ?

Oui. Le module est prévu pour PrestaShop 1.7.x et PrestaShop 8.x.

Faut-il modifier le template email ?

Oui. Le module ajoute la variable {product_reference}, mais il faut l’insérer dans le template email pour l’afficher dans le message.