Comment utiliser Hallwil Filters

Hallwil Filters ajoute des filtres de collection rapides, une recherche et une découverte de produits à votre storefront Shopify. Ce guide vous accompagne de l'installation à l'intégration en direct dans le thème.

1. Installer et ouvrir l'application

Installez Hallwil Filters depuis la Shopify App Store et approuvez les autorisations demandées. Ouvrez l'application depuis Shopify Admin → Apps.

L'écran d'accueil affiche l'état d'indexation du catalogue, votre plan actuel et une liste de vérification de configuration. Complétez-la pour préparer votre storefront.

  • Installez l'application sur votre boutique de développement ou de production.
  • Ouvrez Hallwil Filters depuis la barre latérale Shopify admin.
  • Vérifiez que l'indexation du catalogue démarre automatiquement après l'installation.

2. Indexation du catalogue

L'application indexe vos produits dans un moteur de recherche (Typesense) afin que les filtres et la recherche répondent en millisecondes. L'indexation s'exécute en arrière-plan après l'installation ou lorsque vous déclenchez une réindexation.

Pendant l'indexation, les comptages de filtres peuvent être incomplets. Attendez que le statut affiche Ready sur la page d'accueil ou dans Paramètres.

  • Pending / Indexing — la synchronisation du catalogue est en cours.
  • Ready — l'API storefront peut renvoyer des données complètes de filtres et de produits.
  • Error — vérifiez la connectivité Redis et utilisez Reindex catalog dans Paramètres.

3. Créer des jeux de filtres

Accédez à Filters dans la navigation de l'application. Un jeu de filtres définit quels filtres apparaissent sur des pages de collection ou de recherche spécifiques.

Ajoutez des filtres basés sur les options produit, vendor, type, tags, prix, disponibilité ou metafields. Configurez les types d'affichage (checkbox, swatch, range) et l'ordre de tri.

  • Créez un jeu de filtres et assignez des handles de collection ou utilisez-le par défaut pour la recherche.
  • Ajoutez des filtres et associez chacun à un attribut produit.
  • Prévisualisez les comptages de facettes depuis l'éditeur de jeu de filtres lorsque l'index est prêt.

4. Intégration storefront

Votre thème appelle la Discovery API via Shopify App Proxy à https://{your-store}.myshopify.com/apps/discovery/v1/*. Shopify signe automatiquement chaque requête storefront — n'ajoutez pas de signature ni d'horodatage dans le code du thème.

Utilisez l'URL App Proxy affichée dans Paramètres ou la page Documentation de l'application. Endpoints typiques : /v1/filters, /v1/products, /v1/search/suggest.

Pour des exemples Liquid et JavaScript, ouvrez Documentation dans l'application embarquée (URL proxy spécifique à la boutique et exemples de code).

5. Facturation et plans

Les plans d'abonnement sont gérés via Shopify Billing. Ouvrez Billing dans l'application pour consulter votre plan, mettre à niveau ou annuler.

Les limites du plan (jeux de filtres, marchés, volume d'indexation) s'appliquent selon le niveau affiché sur la page Billing.

6. Migration et outils catalogue

Utilisez Migration pour exporter ou importer des attributs produit alignés avec vos filtres (vendor, tags, options, metafields) via Excel.

Utilisez Catalog overview sur la page d'accueil pour inspecter les produits indexés et la couverture des facettes.

7. Support et ressources

La Documentation embarquée (Shopify admin → Hallwil Filters → Documentation) inclut des exemples API et du code d'intégration thème pour votre boutique.

La documentation OpenAPI interactive est disponible sur le service Discovery API lorsqu'il est déployé.

  • Documentation in-app — exemples API et extraits de thème.
  • Référence API (Swagger) — schémas complets de requête/réponse.
  • Paramètres — langue, réindexation, URL App Proxy, liens légaux.