Order Reminder Module for Thelia

Description

Ce module permet d'envoyer automatiquement des emails de rappel aux clients ayant passé une commande il y a X mois. Il permet de proposer aux clients de renouveler leur achat.

Fonctionnalités

• ✅ Configuration du nombre de mois avant l'envoi du rappel
• ✅ Envoi d'emails de test pour vérifier le fonctionnement
• ✅ Liste des emails envoyés dans le back-office
• ✅ Commande CLI pour automatiser l'envoi via cron
• ✅ Flag sur les commandes pour éviter les doublons
• ✅ Templates d'email personnalisables (HTML et texte)
• ✅ Support multilingue (FR/EN)

Installation

1. Copier le module dans le dossier local/modules/OrderReminder
2. Activer le module depuis le back-office Thelia
3. Le module créera automatiquement la table de base de données nécessaire

Configuration

Back-office

1. Aller dans Modules > Order Reminder
2. Configurer le nombre de mois avant l'envoi du rappel (défaut : 6 mois)
3. Configurer le nombre maximum d'emails par exécution (défaut : 100)
4. Tester l'envoi avec un email de test

Limite d'envoi

Le paramètre "Nombre maximum d'emails par exécution" permet de :

• Limiter la charge serveur : Évite d'envoyer trop d'emails d'un coup
• Respecter les quotas : Évite les blocages liés aux limites d'envoi SMTP
• Répartir les envois : Permet d'exécuter le cron plusieurs fois par jour

Exemple : Avec une limite de 50 emails et un cron toutes les 2 heures, vous pouvez envoyer jusqu'à 600 emails par jour (12 exécutions × 50 emails).

Ligne de commande

Pour envoyer les emails de rappel :

php Thelia OrderReminder:send

Options disponibles

• --months=X : Remplacer le nombre de mois configuré
• --dry-run : Mode test (affiche les commandes éligibles sans envoyer d'emails)

Exemples

# Utiliser la configuration par défaut
php Thelia OrderReminder:send

# Envoyer pour les commandes de 3 mois
php Thelia OrderReminder:send --months=3

# Mode test
php Thelia OrderReminder:send --dry-run

Automatisation avec Cron

Pour automatiser l'envoi quotidien à 9h du matin :

0 9 * * * cd /path/to/thelia && php Thelia OrderReminder:send

Personnalisation des templates

Les templates d'email se trouvent dans :

• templates/email/default/order-reminder.html (version HTML)
• templates/email/default/order-reminder.txt (version texte)

Vous pouvez les personnaliser selon vos besoins.

Base de données

Le module crée une table order_reminder_log qui enregistre :

• L'ID de la commande
• L'ID du client
• L'email du destinataire
• La date d'envoi
• Si c'est un email de test ou non

Cette table permet d'éviter d'envoyer plusieurs fois le même email pour une commande.

Critères d'éligibilité

Une commande est éligible pour un rappel si :

1. Elle a été passée il y a X mois ou plus (configuré dans le back-office)
2. Son statut est "payé", "expédié" ou "livré" (statuts 2, 3 ou 4)
3. Aucun email de rappel n'a déjà été envoyé pour cette commande

Note importante : Le système envoie des rappels pour toutes les commandes de X mois ou plus qui n'ont pas encore reçu de rappel. Cela permet de rattraper les commandes manquées si le module n'est pas exécuté quotidiennement.

Support

Pour toute question ou problème, consultez la documentation Thelia ou contactez le support.

Licence

Ce module est fourni tel quel, sans garantie. Vous êtes libre de l'utiliser et de le modifier selon vos besoins.