Installer et configurer le module PrestaShop

Étape 1 sur 11

Avant de commencer

Avant d'installer, vérifiez ces quatre points : abonnement Rivalyse, accès au back-office, accès chez votre hébergeur, version de PrestaShop.

• Un abonnement Rivalyse Pro, Business+ ou Entreprise actif. Pendant l'essai gratuit, Rivalyse refuse les clés API.
• Un accès employé autorisé à configurer les modules (Paramètres avancés › Équipe › Permissions).
• Un accès à l'espace de votre hébergeur pour programmer une tâche planifiée (étape 7), ou un prestataire qui l'a.
• Une version de PrestaShop et de PHP prise en charge : consultez le tableau des versions testées. Votre version de PHP s'affiche dans Paramètres avancés › Informations.

Ce guide est filmé en PrestaShop 8.2. Quand un écran diffère dans une autre version, un encadré le signale à l'étape concernée.

Étape 2 sur 11

Créer la clé API

Le module se connecte à Rivalyse avec une clé d'usage « Module PrestaShop ». Rivalyse ne l'affiche qu'une fois : copiez-la avant de fermer la fenêtre.

1. Dans Rivalyse, ouvrez Intégrations.
2. Ouvrez l'onglet Clés API.
3. Cliquez sur « Nouvelle clé ».
4. Nommez la clé, par exemple du nom de votre boutique, et choisissez l'usage « Module PrestaShop ».
5. Cliquez sur « Créer ».
6. Copiez la clé. Elle commence par rvk_.

Une clé « Module PrestaShop » envoie le catalogue et lit les prix recommandés. Elle n'ouvre ni vos prix concurrents, ni vos alertes, ni vos exports. Clé perdue avant de l'avoir collée : créez-en une autre et révoquez la première.

Étape 3 sur 11

Télécharger le module

Le module se télécharge depuis votre compte Rivalyse, dans la fenêtre de la carte PrestaShop. Vous obtenez une archive rivalysesync.zip.

1. Dans Rivalyse, ouvrez Intégrations, onglet Connecteurs.
2. Dans la rubrique E-commerce, cliquez sur la carte PrestaShop.
3. Dans la fenêtre, cliquez sur « rivalysesync.zip (module PrestaShop) ».

Gardez le fichier tel quel : PrestaShop installe l'archive zip, pas le dossier décompressé. La même fenêtre propose « Créer une clé API », raccourci vers l'étape 2.

Étape 4 sur 11

Installer le module

PrestaShop installe le module depuis l'archive, dans le Gestionnaire de modules.

1. Dans le back-office, ouvrez le menu Modules.
2. Choisissez « Gestionnaire de modules ».
3. Cliquez sur « Installer un module ».
4. Déposez le fichier rivalysesync.zip. PrestaShop installe le module et affiche « Module installé ! ».
5. Cliquez sur « Configurer » pour ouvrir le module Rivalyse Sync.

Étape 5 sur 11

Connecter la boutique

Le module s'ouvre sur l'onglet Connexion. Collez la clé de l'étape 2 et testez-la : le module ne l'enregistre que si Rivalyse l'accepte.

1. Collez la clé dans le champ « Clé API ».
2. Cliquez sur « Tester la connexion ».
3. La carte verte « Connecté : compte … » confirme votre adresse de compte, votre plan et le nombre de produits déjà au catalogue Rivalyse.

Carte rouge « Clé invalide ou révoquée » : Rivalyse a refusé la clé, la page Dépannage donne les causes. Pour changer de clé plus tard, collez la nouvelle, testez-la, puis révoquez l'ancienne dans Rivalyse : aucune réinstallation n'est nécessaire.

Étape 6 sur 11

Synchroniser le catalogue

Choisissez les produits à envoyer et les options, puis lancez la première synchronisation. Vos réglages ne sont enregistrés qu'au clic sur « Synchroniser maintenant ».

1. Ouvrez l'onglet Synchronisation.
2. Choisissez le périmètre : « Tout le catalogue », ou « Catégories sélectionnées ». Une catégorie cochée inclut ses sous-catégories.
3. Activez « Synchronisation automatique quotidienne » : la tâche planifiée renverra le catalogue chaque jour, et les produits du périmètre que vous créez ou modifiez partiront dès leur enregistrement (en file d'attente si Rivalyse ne répond pas).
4. Activez, si vous le souhaitez, « Envoyer aussi mes prix d'achat » : Rivalyse calcule alors votre marge.
5. Cliquez sur « Synchroniser maintenant ».
6. Le module affiche le résultat : produits envoyés, créés, mis à jour, inchangés et erreurs. Le bloc « Dernière synchronisation » reprend la date et l'état.

Les produits arrivent dans Rivalyse, rubrique « Mon catalogue ». Le détail de ce que le module envoie et n'envoie pas est sur la page du module, ainsi que le sort des prix d'achat si vous désactivez l'option.

Lancée avec le bouton, une synchronisation dispose de 60 secondes. Si elle n'a pas atteint sa clôture à l'échéance, elle s'arrête sans rien retirer et le journal indique « Incomplète » : relancez-la, elle reprend sans doublon. Pour plusieurs milliers de produits, la tâche planifiée en ligne de commande de l'étape 7 n'a pas cette limite.

Étape 7 sur 11

Programmer la tâche planifiée

La tâche planifiée fait tourner le module sans vous : synchronisation quotidienne, envois restés en attente et repricing. Elle se programme une fois par jour chez votre hébergeur.

1. Dans l'onglet Synchronisation, descendez à la section « Tâche planifiée (cron) ».
2. Copiez la ligne de commande affichée et programmez-la une fois par jour dans l'espace de votre hébergeur.
3. Synchronisation automatique activée, le module affiche « Dernier passage abouti le … » après le premier passage réussi de la tâche.
4. Si l'adresse de la tâche a pu être vue par un tiers, cliquez sur « Régénérer le jeton », puis mettez à jour l'adresse chez votre hébergeur.

Synchronisation automatique activée et aucun passage abouti depuis plus de 48 h : le module affiche une alerte. La page Dépannage explique quoi vérifier.

Étape 8 sur 11

Lire le journal

L'onglet Journal liste les 10 dernières synchronisations du catalogue, avec leurs compteurs et leur état. C'est là que vous vérifiez que vos synchronisations aboutissent.

1. Ouvrez l'onglet Journal.
2. Chaque ligne donne la date, le déclencheur, les produits créés, mis à jour, inchangés, et les erreurs.
3. Pour une synchronisation complète, le déclencheur vaut « Planifiée » (tâche planifiée) ou « Manuelle » (bouton « Synchroniser maintenant »).

La colonne État vaut « Réussie », « Terminée avec erreurs », « Incomplète » ou « Échec », avec le motif sous l'état. Que faire dans chaque cas : page Dépannage.

Une modification de produit réussie n'écrit aucune ligne. Le déclencheur « Modification produit » n'apparaît que lorsqu'un envoi immédiat a échoué.

Étape 9 sur 11

Régler le repricing

L'onglet Repricing choisit quels prix le module peut écrire dans la boutique. Les règles de prix, elles, se créent dans Rivalyse : sans règle active, le module ne change aucun prix.

1. Ouvrez l'onglet Repricing.
2. Lisez l'encart du plan : « Inclus dans votre plan » à partir de Business+.
3. Choisissez les prix que le module peut ajuster : « Mettre à jour le prix standard », « Mettre à jour le prix promo », ou les deux.
4. Cliquez sur « Enregistrer les réglages ».

À l'installation, seul le prix standard est activé. Le prix promo passe par un prix spécifique créé par le module : vos propres promotions ne sont jamais réécrites. Les deux options activées, c'est le prix standard qui change.

Le module applique les prix recommandés au passage suivant de la tâche planifiée. Stratégies, marge minimale, prix plancher et plafond : voir le repricing sur la page du module.

Étape 10 sur 11

Mettre à jour le module

Quand une nouvelle version sort, le module l'annonce par un bandeau « Version … disponible » en haut de sa page. La mise à jour reprend l'installation ; l'ouverture du module la vérifie ensuite.

1. Téléchargez la nouvelle archive depuis la carte PrestaShop de Rivalyse (étape 3).
2. Installez-la comme à l'étape 4, par « Installer un module ».
3. Ouvrez la configuration de Rivalyse Sync. Si la mise à niveau est restée en attente, le module la termine et l'annonce en haut de page.

Tant que la mise à niveau reste en attente, les envois du module sont suspendus. En PrestaShop 8.2, « Module installé ! » peut s'afficher avant qu'elle soit faite : l'étape 3 reste nécessaire. Le lien « Voir la nouveauté » du bandeau ouvre le journal des versions de Rivalyse, et la croix masque le bandeau pour cette version.

Étape 11 sur 11

Désinstaller le module

La désinstallation se fait dans le Gestionnaire de modules. Deux gestes la complètent hors de PrestaShop : retirer la tâche planifiée, et révoquer la clé dans Rivalyse.

1. Ouvrez Modules › Gestionnaire de modules et trouvez Rivalyse Sync.
2. Ouvrez le menu du module et choisissez « Désinstaller », puis confirmez.
3. Retirez la tâche planifiée chez votre hébergeur : sans le module, elle échoue à chaque passage.
4. Dans Rivalyse, Intégrations › Clés API, révoquez la clé du module : la désinstallation l'efface de PrestaShop, pas de Rivalyse.

Ce qui disparaît et ce qui reste, côté boutique et côté Rivalyse : voir la désinstallation sur la page du module.