Installer dans la boutique PrestaShop

Le module, le handshake, la première indexation et l'activation du panneau de recherche, dans le bon ordre.

Le module Buskara pour PrestaShop fait trois choses : il relie la boutique à votre compte, il maintient le catalogue indexé, et il injecte le script du panneau de recherche dans les pages. Installer le module ne change rien dans la boutique : le panneau de recherche n'apparaît aux visiteurs qu'à la fin de ce guide, une fois le catalogue indexé.

1. La clé d'API

Le compte naît sans aucune, et la première arrive toute seule : juste après l'inscription, Buskara vous fait passer par trois étapes (télécharger le module, copier la clé, attendre la boutique), et c'est à la deuxième qu'elle est émise et affichée. Si vous avez fermé cet écran avant de la copier, revenez sur /ativar et demandez-en une nouvelle.

La clé complète (bk_live_…) apparaît une seule fois : copiez-la à ce moment-là. La liste n'affiche ensuite que le préfixe et la date de la dernière utilisation. Pour en émettre d'autres (une par boutique, par exemple), ouvrez le profil du compte dans le panneau, onglet Intégrations.

Chaque clé de la liste a trois destins possibles. Révoquer coupe immédiatement tout ce qui l'utilisait, et cela se défait : une clé révoquée se réactive avec le bouton d'à côté, avec la même valeur qu'avant. Supprimer, en revanche, est sans retour, parce que la valeur n'est stockée nulle part ; si vous supprimez la clé que la boutique utilise, vous en émettez une autre et vous la recollez dans le module.

2. Installer et connecter

1. Installez le module Buskara dans le back-office de PrestaShop et ouvrez la configuration.
2. Tant que la boutique n'est pas connectée, le module affiche un écran d'accueil avec deux champs : collez-y la clé d'API et vérifiez l'adresse de Buskara (https://buskara.com).
3. Cliquez sur Connecter la boutique.

Le module ne crée pas de clés et n'en invente pas : il reçoit celle que votre compte a émise. Qui installe le module avant d'avoir un compte trouve sur ce même écran le bouton pour le créer.

Ce dernier clic est le handshake : la boutique se présente (URL, versions, boutiques, langues et devises) et reçoit en retour son identifiant, la clé publique de recherche et un moteur de recherche par boutique × langue × devise. C'est à ce moment que la boutique apparaît dans le panneau, dans Recherche → Boutiques ; il n'y a rien à créer à la main. C'est aussi à partir de là que la configuration du module affiche tout le reste : état, indexation, apparence et partage de données.

Le nombre de boutiques connectées est une limite du forfait. Si le handshake est refusé pour cette raison, le message indique le forfait et la limite ; reconnecter une boutique qui existe déjà n'est jamais bloqué.

3. La première indexation

Cliquez sur Tout réindexer dans le module. Le catalogue part par lots, et dans le panneau (Recherche → Boutiques) vous voyez la progression : En attente, Indexation… (envoyés / total) et enfin À jour, avec le total de documents.

Sur un grand catalogue, le bouton peut se heurter au temps maximum d'exécution de PHP. Pour ces cas-là, le module fournit une alternative en ligne de commande, qui n'a pas cette limite :

php modules/buskara/cli/reindex.php

Après la première indexation complète, le quotidien se règle tout seul par trois voies :

• Temps réel : enregistrer, supprimer ou changer le stock d'un produit pousse la modification sur-le-champ.
• Synchronisation périodique : la plateforme demande la réindexation à la boutique à intervalles réguliers. Pour cela, l'adresse https://a-tua-loja/module/buskara/sync doit être accessible depuis l'extérieur ; attention aux pare-feu et au basic-auth sur les boutiques de préproduction.
• Manuelle : le bouton ou le CLI, quand vous voulez forcer.

4. Tester sans le montrer à personne

Avant d'activer le panneau de recherche pour tout le monde, utilisez le champ IP de débogage dans le module : avec votre IP à l'intérieur, vous êtes le seul à recevoir le panneau de recherche, et vous pouvez essayer dans la boutique en production à volonté.

Le revers compte : tant qu'il y a des IP dans ce champ, personne d'autre ne reçoit le panneau de recherche. Si un jour « la recherche a disparu de la boutique », c'est le premier endroit où regarder.

5. Activer le panneau de recherche

La première indexation complète qui met des produits dans l'index active le panneau de recherche d'elle-même. À partir de ce moment, chaque page de la boutique charge une seule balise de script, et la recherche devient celle de Buskara : la barre du thème reste en place, mais c'est nous qui répondons.

Jusque-là, l'interrupteur du panneau de recherche est éteint exprès. L'activer alors que l'index est encore vide donnerait à vos clients une recherche qui ne trouve rien, ce qui est pire que pas de recherche du tout. L'interrupteur reste dans la configuration du module, et il est à vous : si vous l'éteignez, il reste éteint, et aucune indexation ultérieure ne le rallume sans vous.

Si le sélecteur par défaut (input[name='s']) n'attrape pas la barre de votre thème, ajustez le sélecteur de la barre de recherche. Sur les thèmes avec une recherche propre au téléphone, il est normal de devoir remplir aussi les sélecteurs de boutons qui ouvrent la recherche et de masquer dans la boutique pendant la recherche ; cela se règle dans la fiche de la boutique dans le panneau, et c'est expliqué dans le guide de l'apparence et intégration dans le thème.

Les autres options du module

• Prix avec TVA et taille d'image : comment les produits arrivent dans l'index.
• Produits en rupture de stock : les indexer quand même, les rétrograder dans les résultats, ou les masquer.
• Données partagées par la boutique : trois signaux facultatifs qui améliorent le produit. Le volume de ventes par produit alimente le tri « meilleures ventes » et la détection des best-sellers invisibles ; le prix de revient donne les marges dans les analytics ; les commandes relient la recherche au chiffre d'affaires (voir le guide analytics). Changer le partage des ventes ou du coût demande une réindexation complète pour que l'index le reflète ; le module vous prévient.
• Articles et contenu : indexer aussi le blog/CMS dans un moteur séparé, qui apparaît dans les résultats sans prendre la place des produits.
• Étoiles : d'où viennent les avis affichés sur les cartes (détection automatique des modules habituels).

Si quelque chose se passe mal

• La boutique n'apparaît pas dans le panneau : le handshake a échoué. Vérifiez l'endpoint, la clé (sans espaces en trop) et revenez à Connecter à Buskara.
• « Indexation » n'arrive jamais au bout : utilisez le CLI ; le bouton se heurte au temps d'exécution de PHP sur les grands catalogues.
• Le panneau de recherche n'apparaît pas : dans cet ordre, l'interrupteur du panneau de recherche est-il activé ? Le champ des IP de débogage est-il vide ? La boutique est-elle Active (et non En pause) dans le panneau Buskara ?
• Le panneau de recherche apparaît mais la barre du thème continue de répondre : le sélecteur de la barre n'attrape pas le bon input ; inspectez le thème et ajustez-le.

Désinstaller le module efface toute la configuration locale. L'index du côté de Buskara reste ; c'est la boutique qui cesse de l'alimenter.