# Installer RecoKit sur PrestaShop

Guide du module gratuit RecoKit **1.3.3**, testé pour PrestaShop 8.x.

## Installation

1. Téléchargez [recokit-prestashop-1.3.3.zip](https://recokit.fr/downloads/recokit-prestashop-1.3.3.zip).
2. Dans le back-office, ouvrez **Modules et services → Installer un module**.
3. Sélectionnez le ZIP sans le décompresser, puis cliquez sur **Configurer**.
4. Le compte RecoKit est créé ou associé automatiquement ; aucune action supplémentaire n’est nécessaire sur le site.
5. Après une connexion réussie, la synchronisation initiale démarre automatiquement. Le bouton manuel sert uniquement en cas de déphasage ou d’incident.

Le dossier installé doit être `modules/recokit/`. Le module utilise les hooks officiels PrestaShop et ne modifie pas les fichiers du thème.

## Vérification et dépannage

Le traitement est asynchrone : attendez quelques minutes pour les associations de ventes et davantage pour les recommandations IA selon la taille du catalogue, avant de vérifier une fiche produit et le panier. En cas de problème, contrôlez la clé API, l’accès HTTPS à `https://api.recokit.fr` et les logs PrestaShop. Ne transmettez jamais votre clé API au support. Si l’auto-enregistrement échoue, la configuration permet de saisir les clés manuellement.

La désinstallation conserve les identifiants enregistrés ; utilisez l’action de déconnexion du module pour les supprimer.