Module Animalerie PrestaShop : documentation du module

Ce module ajoute à PrestaShop 8 et 9 des profils d’animaux dans le compte client, un calcul de ration et une recommandation de format sur les fiches croquettes, et des plans de réassort qui envoient un rappel avant la fin du sac, calculé sur la consommation réelle du client. Nom technique : dfpetcare.

Installation

1. Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et déposez le fichier ZIP.
2. Le module crée ses tables et trois espèces avec leurs races : chien (32 races), chat (12 races) et lapin (2 races).
3. Un menu Vendre > Animalerie apparaît avec quatre pages : Rations des aliments, Réassort, Profils animaux et Espèces et races. Un lien Mes animaux est ajouté à la page Mon compte du client.
4. Programmez l’URL cron affichée sur la page de configuration du module (voir plus bas).

Régler les aliments

Seuls les produits déclarés dans Animalerie > Rations des aliments affichent le bloc de ration. Cliquez sur Ajouter, recherchez le produit par nom, référence ou ID, puis renseignez :

• Pour : les espèces concernées. Seuls les animaux de ces espèces sont proposés sur la fiche produit. Laissez vide pour toutes les espèces.
• Stade de vie de l’aliment (tous âges, croissance, adulte, senior) : un avertissement s’affiche si l’animal du client n’est pas dans ce stade.
• Calcul : par l’énergie ou par la table de rationnement (voir ci-dessous).
• Conservation après ouverture en jours : les sacs qui resteraient ouverts plus longtemps ne sont pas recommandés. 0 = pas de limite.
• Poids net : pour un produit avec déclinaisons, le poids de chaque déclinaison en grammes. Le bouton Remplir depuis les noms des déclinaisons reprend les poids lus dans les noms (12 kg, 400 g, 12 x 85 g). Laissez vide une déclinaison qui n’est pas de l’aliment. Pour un produit simple, saisissez le poids net total.

Calcul par l’énergie

Saisissez l’énergie métabolisable de l’aliment en kcal/kg (croquettes : en général 3400 à 4200, pâtée : 700 à 1200). Pour un chien ou un chat, le module calcule le besoin énergétique au repos (70 × poids^0,75) et le multiplie par un coefficient selon le stade de vie, la stérilisation et l’activité, puis convertit en grammes. Cette méthode ne s’applique pas aux espèces réglées en « Autre ».

Calcul par la table de rationnement

Recopiez la table imprimée sur le sac : une ligne par poids d’animal avec les grammes par jour, et le stade de vie de la ligne. Entre deux lignes, la ration est interpolée. Hors de la table, elle suit le poids métabolique. L’option Ajuster à l’animal corrige la ration selon la stérilisation et l’activité pour les adultes et les seniors. C’est la seule méthode possible pour les lapins, rongeurs et oiseaux.

Espèces et races

Dans Animalerie > Espèces et races, chaque espèce a un nom par langue et un modèle nutritionnel : chien, chat ou autre (table de rationnement uniquement). Les races ont un nom par langue et une taille de très petite à géante : pour un chiot, la taille fixe l’âge adulte (12 mois pour les petites races, 18 mois pour les grandes, 24 mois pour les géantes). Sans race, la taille est déduite du poids. Une espèce utilisée par des animaux ne peut pas être supprimée : désactivez-la. Supprimer une race laisse les animaux concernés sans race.

Ce que voit le client

Mes animaux

Depuis Mon compte, le client crée jusqu’à 20 profils : nom, espèce, race, sexe, date de naissance, poids actuel, poids cible, stérilisation et niveau d’activité. Chaque carte affiche l’âge et le stade de vie (chiot, chaton, adulte, senior).

Fiche produit

Sous le prix, le bloc Ration quotidienne et format propose les animaux du client compatibles avec l’aliment. Pour les animaux cochés, il affiche la ration en grammes par jour, le nombre de repas conseillé, le total quand il y en a plusieurs, puis un tableau des formats avec leur durée et leur prix au kilo. Le format recommandé porte un badge et un bouton Choisir le sac. Un guide de transition sur 7 jours indique les grammes du nouvel aliment jour après jour, avec le nom de l’aliment actuel de l’animal quand il est connu.

Le format recommandé est le moins cher au kilo parmi les formats disponibles qui durent au moins la durée minimale réglée, sans dépasser la conservation après ouverture.

La case Me prévenir avant la fin du sac active les rappels pour cet aliment. Le choix des animaux et de la case est retenu pour la prochaine commande.

Visiteurs

Avec le calculateur de ration pour les visiteurs, un visiteur ou un client sans animal saisit l’espèce, le poids, l’âge, l’activité et la stérilisation et obtient la même recommandation. Un client connecté peut enregistrer ce profil en lui donnant un nom.

Page de confirmation de commande

Après une commande de croquettes, un bloc propose d’activer les rappels et, si le client a plusieurs animaux, de choisir ceux qui mangent cet aliment. Ce bloc ne coupe jamais des rappels déjà actifs : il peut seulement les activer et renseigner les animaux.

Plans de réassort

Chaque client a un plan par aliment. Une commande est enregistrée à sa validation et ajoutée au plan quand son statut est considéré comme payé. Le stock démarre à la date de commande plus le délai de livraison moyen, puis diminue chaque jour selon la consommation :

• la consommation théorique est la somme des rations des animaux liés au plan ;
• à chaque réponse du client sur ce qu’il lui reste (au moins 5 jours après le dernier relevé), le module calcule la consommation observée, la borne entre 0,4 et 2,5 fois la théorique pour écarter les erreurs de saisie, et la combine avec l’estimation précédente ;
• si le client modifie le profil d’un animal, la consommation suit la même proportion.

La date de fin du sac en découle, et le rappel est prévu délai du rappel jours avant. Un plan dont le sac est vide depuis 90 jours sans nouvelle commande est clôturé.

Espace client

Dans Mes animaux, chaque aliment suivi affiche une jauge de stock, les jours restants, la date de fin estimée, la date du prochain rappel et la consommation retenue. Le client peut indiquer ce qu’il reste (vide, un quart, la moitié, trois quarts, un sac, un sac et demi, deux sacs), choisir les animaux qui mangent l’aliment, activer ou couper les rappels, recommander ou arrêter le suivi.

Rappels et recommande

Seuls les plans dont le client a activé les rappels reçoivent des e-mails :

• le premier rappel part le jour prévu ;
• la relance part le nombre de jours réglé plus tard si le client n’a ni recommandé ni répondu (0 la désactive).

L’e-mail contient un bouton Recommander, trois liens de réponse (il reste environ 2 semaines, environ 1 semaine, le sac est vide) et un lien pour suspendre les rappels. Les liens de réponse ouvrent une page de confirmation : rien n’est enregistré tant que le client n’a pas cliqué, ce qui protège contre les antivirus de messagerie qui ouvrent les liens.

Le bouton Recommander demande la connexion au compte, remplit le panier avec le même format et la même quantité et redirige vers la commande. Si ce format est en rupture, le module propose le format disponible le plus proche en quantité. Si la remise de réassort est supérieure à 0 et que le client garde ses rappels actifs, un bon à usage unique est appliqué, limité à cet aliment, valable le nombre de jours réglé (code PET suivi de 8 caractères).

Configuration du module

• Délai du rappel (7 jours) : combien de jours avant la fin estimée le rappel part. Incluez votre délai de livraison.
• Relance (5 jours, 0 = désactivée).
• Délai de livraison moyen (3 jours) : départ de la consommation d’un nouveau sac.
• Remise de réassort (5 %, 0 = pas de bon) et validité du bon (14 jours).
• Durée minimale du sac recommandé (14 jours) et conservation après ouverture par défaut (42 jours), préremplie sur les nouveaux aliments.
• Calculateur de ration pour les visiteurs, exécution des tâches via le trafic du back-office et rappels par exécution (50).

Les valeurs hors limites sont ramenées automatiquement dans les bornes autorisées.

Tâche cron

La page de configuration affiche une URL protégée par jeton. Appelez-la toutes les heures, par exemple :

0 * * * * curl -s "https://votre-boutique.fr/module/dfpetcare/cron?token=..." > /dev/null

Chaque exécution intègre les commandes payées, envoie les rappels dus et clôture les plans inactifs. Sans cron, laissez activée l’exécution via le trafic du back-office : les tâches tournent au plus toutes les 3 heures quand un employé navigue dans le back-office. Le bouton Lancer les tâches maintenant les exécute à la demande.

Back-office

• Réassort : liste des plans filtrable par client, e-mail, aliment, statut, rappels et date de fin, exportable en CSV, avec les indicateurs du mois (rappels envoyés, recommandes après un rappel, relevés de stock). La fiche d’un plan montre les animaux et leur ration, la consommation théorique et retenue, le stock estimé, l’historique complet, et permet de saisir le stock déclaré par le client ou de renvoyer le rappel.
• Profils animaux : liste filtrable et exportable pour vos segments marketing (espèce, race, âge, poids, stérilisation, client).
• Fiche client : un bloc affiche ses animaux et ses plans avec un lien vers chaque plan.

E-mails et traductions

Le modèle dfpetcare_reorder est fourni en 8 langues (français, anglais, espagnol, allemand, italien, néerlandais, polonais, portugais), en HTML et en texte, avec un objet et une introduction distincts pour la relance. Pour une autre langue installée, le modèle anglais est copié. L’interface du module est traduite dans les mêmes langues.

RGPD

Le module répond aux demandes d’export et de suppression des données personnelles : profils d’animaux, plans, commandes suivies et choix enregistrés. La suppression d’un client efface aussi ses données dans le module.

Mise à jour depuis la 1.0.0

Installez le ZIP 1.1.0 par-dessus la version existante. Le script de mise à jour ajoute la date du dernier rappel, active la relance à 5 jours, greffe les hooks de la page de confirmation de commande et de la fiche client, et conserve vos animaux, aliments et plans.

Questions fréquentes

Le bloc de ration n’apparaît pas sur la fiche produit

Vérifiez que le produit est déclaré et activé dans Rations des aliments, qu’une énergie ou une table est saisie, et que le client a un animal d’une espèce compatible. Sans animal, le calculateur ne s’affiche que s’il est activé.

La durée des sacs n’est pas affichée

Le poids net de la déclinaison est manquant. Renseignez-le dans Rations des aliments.

Aucun rappel n’est envoyé

Vérifiez que le client a activé les rappels pour cet aliment, que la tâche cron tourne (date de dernière exécution sur la page de configuration) et que les e-mails de la boutique fonctionnent. Le bouton Envoyer le rappel maintenant de la fiche d’un plan affiche une erreur si l’envoi échoue.

Que se passe-t-il à la désinstallation ?

Les tables du module sont supprimées : animaux, aliments, plans et historiques. Les bons de réduction déjà créés restent dans les règles panier.