Active Findalo sur ta boutique en 10 minutes.

Installation par plateforme

• Disponible

  PrestaShop 1.7 / 8.x / 9.x

  Module natif. Compatible avec le thème Classic, Hummingbird et custom.

• Bêta — libre-service

  Shopify

  Custom App + snippet dans theme.liquid. App officielle sur Partners en chemin.

• Disponible

  WooCommerce

  Plugin WordPress officiel. Compatible avec WPML/Polylang et les caches WP.

• Disponible

  Magento 2 / Adobe Commerce

  Module natif. Téléchargeable depuis ton panneau. PHP 8.2/8.3/8.4. Compatible avec Hyvä et PWA Studio.

• Disponible

  Shopware 6

  Plugin natif. Téléchargeable depuis ton panneau. Compatible avec Shopware 6.6+ et Storefront / Headless.

Prérequis techniques minimaux

Ce dont ta boutique a besoin pour installer le module Findalo. Si ton stack est en dessous, dis-le-nous à hola@findalo.io et on voit ce qu'on peut faire.

Le widget dans le navigateur fonctionne sur Chrome, Firefox, Safari et Edge actuels et sur les deux versions précédentes. Aucune dépendance jQuery ni à ton thème.

PrestaShop — étapes essentielles

1. 1 · Téléchargement

   Accède à ton espace client et ouvre Intégrations → Module PrestaShop. Clique sur Télécharger le ZIP — on te donne toujours la dernière version publiée. Pas encore de compte ? Inscris-toi gratuitement.

2. 2 · Téléverse et installe

   Dans le BO PrestaShop : Modules → Gestionnaire de modules → Mettre en ligne un module. Fais glisser le ZIP et clique sur Installer.

3. 3 · Configure

   Clique sur Configurer sur le module Findalo. Remplis :

   • URL du moteur de recherche : le slug que tu as dans ton panneau findalo.io (visible dès l'inscription).
   • Feed token : laisse-le vide pour en générer un fort automatiquement. Copie-le ensuite dans ton panneau findalo.io.
   • Trigger selector : laisse la valeur par défaut (couvre le thème Classic et la majorité). Ne le change que si ton thème utilise des sélecteurs custom.
4. 4 · Active

   Coche « Charger le bundle du moteur de recherche sur toutes les pages » et sauvegarde. Recharge ton storefront, clique sur la loupe du thème — le widget ouvre un modal plein écran et les produits apparaissent instantanément.

5. 5 · Vérifie la synchronisation

   Sur findalo.io → ton moteur de recherche → État du catalogue : tu devrais voir tes produits indexés en moins de 5 minutes. Sinon, vérifie que ton PrestaShop est accessible depuis internet (la synchronisation interroge l'endpoint /module/findalo/feed toutes les 5 min).

WooCommerce — étapes essentielles

Plugin WordPress standard. ~10 minutes. Compatible avec WPML, Polylang, WP Rocket, LiteSpeed Cache et les thèmes Storefront / Hello Elementor / Astra / Blocksy. Démo live : woocommerce.findalo.io/shop.

1. 1 · Télécharge le plugin

   Accède à ton panneau → Intégration → onglet WooCommerce → Télécharger le ZIP. On te donne toujours la dernière version publiée. Si tu n'as pas encore de compte, inscris-toi gratuitement.

2. 2 · Téléverse et installe dans WordPress

   Dans ton admin WordPress : Extensions → Ajouter → Mettre en ligne une extension. Fais glisser le ZIP et clique sur Installer, puis Activer.

3. 3 · Configure le plugin

   Dans le menu WooCommerce → Findalo. Remplis :

   • Your search URL : le slug que tu vois dans ton panneau findalo.io (tu le choisis à l'inscription).
   • Feed token (Bearer) : celui qui apparaît dans le panneau findalo — copie-le et colle-le ici. S'il est vide, le plugin en génère un que tu copies ensuite dans le panneau.
   • Trigger selector : laisse la valeur par défaut — couvre le bloc de recherche Gutenberg, le search-field classique et le formulaire de recherche de produits.

   Sauvegarde. Le plugin injecte le widget dans wp_head automatiquement.

4. 4 · Force la première synchronisation

   Sur la même page de réglages du plugin, clique sur « Mark as pending (force next rebuild) ». Attends 5 à 10 secondes. Le plugin construit le JSON du catalogue et l'envoie à findalo.io (push asynchrone — la page revient sans attendre le téléchargement).

5. 5 · Vérifie

   Sur findalo.io → ton moteur de recherche → Synchronisation : tu devrais voir les produits synchronisés avec sync_source: push. Ouvre ton storefront, clique sur la loupe — le modal findalo s'ouvre avec tes produits. Désormais tout changement de produit, stock ou prix se reflétera en ≤10 min (throttle anti-spam sur le stock).

6. 6 · Support multilingue (optionnel)

   Si tu utilises WPML ou Polylang, le plugin les détecte automatiquement et publie chaque produit traduit sous sa locale (ISO 2 lettres). Aucune configuration supplémentaire.

Shopify — étapes essentielles

En attendant que l'app officielle arrive sur le Shopify App Store, le connecteur fonctionne en mode Custom App. ~10 minutes de bout en bout. Utilise la dev store de démo (pass 1234) comme référence du rendu final.

1. 1 · Crée un compte findalo

   Inscris-toi sur findalo.io (le plan Free suffit pour tester). Note ton slug — tu en auras besoin à la dernière étape.

2. 2 · Crée une Custom App dans Shopify

   Dans ton Shopify Admin : Settings → Apps and sales channels → Develop apps → Create an app. Donne-lui le nom que tu veux (ex. « findalo-search »).

3. 3 · Active les scopes

   Dans l'app : Configuration → Admin API integration → Configure. Coche :

   • read_products
   • read_product_listings
   • read_collections
   • read_inventory

   Save en bas à droite.

4. 4 · Installe l'app et copie le token

   Clique sur Install app en haut à droite. Tu arrives sur API credentials : copie l'Admin API access token (commence par shpat_ et fait 38 caractères).

   ⚠ Shopify affiche le token une seule fois. Si tu fais une erreur ou fermes l'onglet, tu devras faire une rotation des identifiants et en générer un nouveau.

5. 5 · Connecte findalo dans le panneau

   Dans ton panneau findalo : Intégration → onglet Shopify. Colle :

   • Domaine : ta-boutique.myshopify.com
   • Admin API access token : le shpat_… de l'étape 4

   Clique sur Connecter et synchroniser. On valide les identifiants auprès de Shopify et on récupère ton catalogue en quelques secondes. Tu verras « Connecté à ta-boutique.myshopify.com ».

6. 6 · Colle le snippet dans le thème

   Dans Shopify Admin : Online Store → Themes → ⋯ → Edit code → layout/theme.liquid. Juste avant </body> :

   <script src="https://widget.findalo.io/widget.js" data-tenant="TON_SLUG" defer></script>

   Remplace TON_SLUG par le slug de l'étape 1. Sauvegarde. Recharge ton storefront et clique sur la loupe — le widget findalo ouvre le modal avec tes produits.

7. 7 · Synchronisation continue automatique

   À partir de là : le cron findalo fait un pull toutes les 5 min. Tu modifies prix, stock ou produits dans Shopify → findalo réindexe automatiquement en moins de 5 minutes. Zéro infrastructure de ton côté. Pour forcer une synchronisation manuelle : panneau → Synchronisation → Synchroniser maintenant.

Magento — étapes essentielles

Module natif pour Magento 2 et Adobe Commerce. ~10 minutes. Requiert PHP 8.2, 8.3 ou 8.4. Compatible avec Hyvä Themes et les storefronts PWA Studio / headless.

1. 1 · Télécharge le module

   Accède à ton panneau → Intégration → onglet Magento → Télécharger le ZIP. On te donne toujours la dernière version publiée. Si tu n'as pas encore de compte, inscris-toi gratuitement.

2. 2 · Téléverse le module sur ton Magento

   Décompresse le ZIP et copie le dossier dans app/code/Findalo/Search de ton Magento. Via SSH :

   mkdir -p app/code/Findalo/Search
   unzip findalo-magento-*.zip -d app/code/Findalo/Search

3. 3 · Active le module

   Depuis la racine de ton Magento :

   bin/magento module:enable Findalo_Search
   bin/magento setup:upgrade
   bin/magento cache:flush

   En production, ajoute bin/magento setup:di:compile et bin/magento setup:static-content:deploy si ton pipeline le nécessite.

4. 4 · Configure

   Dans Magento Admin : Stores → Configuration → Findalo → General. Remplis :

   • Search URL : le slug que tu vois dans ton panneau findalo.io.
   • Feed token : copie-le depuis le panneau findalo et colle-le ici, ou laisse-le vide pour le générer automatiquement.
   • Trigger selector : laisse la valeur par défaut — couvre les thèmes Luma, Blank et Hyvä.

   Sauvegarde et vide les caches : bin/magento cache:flush.

5. 5 · Vérifie la synchronisation

   Sur findalo.io → ton moteur de recherche → État du catalogue : tu devrais voir tes produits indexés en moins de 5 minutes. Si tu utilises multi-store ou multi-website, chaque vue est indexée séparément et identifiée par son store_code. Recharge ton storefront, clique sur la loupe — le widget ouvre le modal avec tes produits.

Shopware — étapes essentielles

Plugin natif pour Shopware 6.6 et versions supérieures. ~10 minutes. Compatible avec le Storefront classique et les storefronts headless.

1. 1 · Télécharge le plugin

   Accède à ton panneau → Intégration → onglet Shopware → Télécharger le ZIP. On te donne toujours la dernière version publiée. Si tu n'as pas encore de compte, inscris-toi gratuitement.

2. 2 · Téléverse le plugin sur Shopware

   Dans ton Shopware Admin : Extensions → Mes extensions → Mettre en ligne une extension. Fais glisser le ZIP. Via CLI :

   bin/console plugin:refresh
   bin/console plugin:install --activate FindaloSearch
   bin/console cache:clear

3. 3 · Configure

   Dans Shopware Admin : Extensions → Findalo Search → Configurer. Remplis :

   • Search URL : le slug que tu vois dans ton panneau findalo.io.
   • Feed token : copie-le depuis le panneau findalo et colle-le ici, ou laisse-le vide pour le générer automatiquement.
   • Trigger selector : laisse la valeur par défaut — couvre les thèmes Storefront par défaut.

   Sauvegarde. Le plugin injecte le widget dans le Storefront automatiquement.

4. 4 · Vérifie la synchronisation

   Sur findalo.io → ton moteur de recherche → État du catalogue : tu devrais voir tes produits indexés en moins de 5 minutes. Si tu utilises multi-sales-channel, chacun est indexé séparément. Recharge ton Storefront, clique sur la loupe — le widget ouvre le modal avec tes produits.

Ressources rapides

API et endpoints

Recommandations (plan Pro+)

// Sur la fiche produit :
findalo.reco({
  context: 'similar',
  productId: '123',
  target: '#findalo-similar-slot',
  title: 'Vous aimerez peut-être aussi',
});

// Au chargement de la fiche :
findalo.trackView('123');

// À l'ajout au panier :
findalo.trackAddToCart('123');

// Recently viewed (côté client, sans trafic vers le backend) :
findalo.recentlyViewed();  // → ['123', '456', ...]