Paramètres et suivi PrestaShop
Section intitulée « Paramètres et suivi PrestaShop »La référence pour tout ce qui va au-delà de la configuration de base : prérequis, champs de marque, fonctionnement du suivi des commandes et solutions si quelque chose ne fonctionne pas.
Prérequis
Section intitulée « Prérequis »- PrestaShop 8.1+ avec PHP 8.1+.
- Le module contient tout le nécessaire dans le fichier zip. Il n’y a rien à installer en ligne de commande.
Champs de marque
Section intitulée « Champs de marque »Le panneau Informations sur le site web définit ce que vos clients voient dans la fenêtre Frak :
- Nom de la boutique : utilise par défaut le nom de votre boutique PrestaShop. Utilisé comme titre.
- Logo : collez l’URL du logo public, ou utilisez l’option Ou charger un fichier (JPG, PNG, GIF ou SVG jusqu’à 2 Mo). L’aperçu sur la droite se met à jour en temps réel.
Le reste des textes et des traductions se gère depuis le tableau de bord professionnel. Cliquez sur Enregistrer les paramètres une fois terminé.
Comment le suivi des commandes reste fiable
Section intitulée « Comment le suivi des commandes reste fiable »Lorsqu’un statut de commande change, le module en informe Frak pour que les récompenses soient attribuées sur de vraies ventes. Si un message ne passe pas, il est enregistré et renvoyé automatiquement (jusqu’à 5 tentatives, avec un intervalle de plus en plus long). Pour vous assurer que ces tentatives s’exécutent, configurez l’une des deux options ci-dessous.
Installez le module officiel ps_cronjobs depuis le gestionnaire de modules. Frak s’enregistre automatiquement et la ligne Cron de relance dans les paramètres devient verte. Rien d’autre à faire.
La ligne Cron de relance affiche une URL prête à l’emploi. Ajoutez-la à une tâche cron qui s’exécute toutes les 5 minutes, par exemple avec crontab -e :
*/5 * * * * curl -fs 'https://your-shop.example/index.php?fc=module&module=frakintegration&controller=cron&token=<paste-from-settings>'L’URL contient un jeton privé issu de vos paramètres, gardez-le donc confidentiel.
Vous pouvez aussi lancer une tentative manuellement : ouvrez Maintenance → File d’attente des webhooks et cliquez sur Vider la file d’attente maintenant.
Suivre la file d’attente
Section intitulée « Suivre la file d’attente »Le panneau Maintenance → File d’attente des webhooks affiche l’état de santé du suivi des commandes en un coup d’œil :
- En attente : en attente de la prochaine tentative.
- Livré : envoyé avec succès.
- Mis de côté (échec) : abandonné après épuisement des tentatives. Un badge rouge apparaît si ce nombre n’est pas à zéro.
- Dernière erreur : le problème le plus récent, avec son horodatage.
Statuts de commande pris en compte
Section intitulée « Statuts de commande pris en compte »Les commandes qui passent aux statuts En attente de validation du paiement, Paiement accepté, Livré ou En attente de paiement (rupture de stock) sont suivies comme des ventes confirmées. Les statuts Annulé et Erreur de paiement marquent la vente comme annulée. Tout remboursement (y compris les remboursements partiels et les retours) la marque comme remboursée. Les statuts Préparation en cours et Expédié sont ignorés volontairement pour ne pas encombrer vos résultats.
Dépannage
Section intitulée « Dépannage »- Le marchand indique « Non résolu pour ce domaine ». Vérifiez que le domaine de votre boutique est bien enregistré sur le tableau de bord, puis allez dans Maintenance et cliquez sur Actualiser le marchand. (Votre domaine principal fonctionne automatiquement, seuls les sous-domaines doivent être ajoutés.)
- Les envois échouent juste après l’installation. Copiez à nouveau la clé depuis Suivi des achats → PrestaShop dans le tableau de bord, collez-la dans Secret du webhook, puis cliquez sur Enregistrer les paramètres.
- Le nombre d’échecs mis de côté augmente. Ouvrez Paramètres avancés → Logs et filtrez sur
FrakIntegration. La ligne Dernière erreur sur le panneau de la file d’attente indique généralement la cause directe. - Les boutons ne s’affichent pas sur la boutique. Vérifiez que l’emplacement est activé dans Emplacements des composants et videz votre cache (Paramètres avancés → Performances → Vider le cache).
Pour les développeurs
Section intitulée « Pour les développeurs »Le module Frak PrestaShop est open source, disponible dans le monorepo du wallet Frak sous plugins/prestashop. N’hésitez pas à ouvrir une issue ou une pull request.