# Paramètres et suivi PrestaShop # Paramètres et suivi PrestaShop La référence pour tout ce qui va au-delà de la [configuration de base](/guides/platforms/prestashop/) : prérequis, champs de marque, fonctionnement du suivi des commandes et solutions si quelque chose ne fonctionne pas. ## 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. **Vous utilisez un sous-domaine ?:** Si votre boutique utilise un sous-domaine (comme `shop.your-store.com`) différent du domaine enregistré, ouvrez l'onglet **Domaines Autorisés** dans le tableau de bord et ajoutez-le avant l'installation. Sinon, la connexion du suivi échouera. ## 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](https://business.frak.id/). Cliquez sur **Enregistrer les paramètres** une fois terminé. **Tip:** Si votre logo ne s'affiche pas dans la fenêtre Frak, importez directement le fichier au lieu de mettre un lien. Les logos importés évitent les problèmes de cache tiers et de CORS. ## 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` : ```cron */5 * * * * curl -fs 'https://your-shop.example/index.php?fc=module&module=frakintegration&controller=cron&token=' ``` 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 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 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 - **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](https://business.frak.id/), 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](/guides/platforms/prestashop/components/) et videz votre cache (**Paramètres avancés → Performances → Vider le cache**). ## Pour les développeurs Le module Frak PrestaShop est open source, disponible dans le [monorepo du wallet Frak](https://github.com/frak-id/wallet) sous `plugins/prestashop`. N'hésitez pas à ouvrir une issue ou une pull request. [Référence du webhook d](/developers/api/webhook/)