Installer la barre de recherche IA
Une barre de recherche qui comprend les phrases. Le visiteur tape ce qu'il veut avec ses mots (« un canapé vert pour 3 à moins de 1 000 € ») : la barre en tire des filtres qu'il peut modifier et affiche les produits qui correspondent pendant la frappe. Il ajoute au panier depuis les résultats, sélectionne des produits à comparer ou continue avec l'assistant quand le widget de chat est sur la page.
Placez-la dans l'en-tête de votre site, à la place de votre champ de recherche actuel ou à côté.
Whitelister votre domaine d'abord
La barre de recherche ne se charge que sur les domaines whitelistés dans la page URL whitelist de votre dashboard. Ajoutez chaque environnement où vous l'intégrez (prod, staging, preview, etc.).
Aperçu
Cet aperçu tourne sur une boutique de démo de jardinage : cliquez dans la barre, puis tapez jardin ou gants. Pour essayer la barre sur votre propre catalogue, ouvrez la page Barre de recherche IA de votre dashboard.
Ce que voit le visiteur
- Au repos : un champ de recherche avec des exemples de demandes qui défilent. Un clic dessus, une frappe dessus, ou ⌘K / Ctrl+K n'importe où sur la page ouvre la recherche.
- Avant de taper : ses recherches récentes, des exemples de demandes et des produits recommandés.
- Pendant la frappe : des suggestions pour compléter le texte, les filtres lus dans ce texte (des pastilles qu'il peut modifier ou retirer), les produits qui correspondent, et les collections et pages de votre boutique qui correspondent. Une question qui demande un conseil est proposée à l'assistant.
- Achat : les cartes produit suivent le bouton d'ajout au panier de votre widget de chat et vos règles produit (prix sur demande, abonnement en premier, panier désactivé...). Un produit avec des options ouvre un volet pour les choisir.
- Comparaison : avec le widget de chat sur la page, le visiteur sélectionne jusqu'à 4 produits et demande à l'assistant de les comparer, d'en trouver de similaires ou d'en dire plus. Demander sur une carte ouvre le chat sur ce produit.
Design
Sur la page Barre de recherche IA de votre dashboard, Personnaliser le widget ouvre un panneau latéral avec un aperçu en direct sur votre catalogue, sur téléphone ou sur ordinateur :
- Textes : la première demande de la barre et le texte du bouton, dans chacune des langues de votre boutique.
- Affichage : la barre de recherche (le champ, avec des exemples de demandes qui défilent) ou un bouton (une loupe « Rechercher », la loupe seule sur téléphone).
- Ouverture : dans la barre (par défaut : la barre s'agrandit sur place et les résultats se déplient dessous) ou par-dessus la page (la recherche s'ouvre dans une fenêtre centrée, la page floutée derrière). Sur téléphone, la recherche s'ouvre en plein écran dans les deux cas.
- L'apparence de la barre : couleurs du fond, de la bordure, du texte, des icônes et du
+, arrondi, hauteur, largeur maximale, ombre. - L'apparence du bouton : couleurs du fond, du texte et de la bordure, arrondi, hauteur, loupe seule.
Chaque modification est enregistrée tout de suite et s'applique à la barre déjà installée sur votre site, sans code à changer. Ce que vous laissez sur « Par défaut » suit votre widget de chat (couleurs de marque, police, arrondis). Pour un autre design sur une page précise, utilisez les attributs : ils remplacent le réglage du dashboard pour cette balise.
Installer
Collez le code là où la barre doit apparaître, en général dans l'en-tête de votre site :
<script src="https://widgets.thehumind.com/v1/loader.js" defer></script>
<humind-search company-id="YOUR_COMPANY_ID"></humind-search>La page Barre de recherche IA du dashboard vous donne ce code avec votre identifiant d'entreprise déjà rempli. Chargez le script une seule fois par page, même avec plusieurs widgets Humind.
Shopify
Il n'y a pas encore de bloc d'app de thème pour la barre de recherche. Collez le code dans votre thème, là où la barre doit se placer : en général sections/header.liquid (Boutique en ligne > Thèmes > ... > Modifier le code), ou une section ou un bloc Liquid personnalisé dans l'éditeur de thème. Sur Shopify, vous pouvez utiliser le domaine de la boutique au lieu de l'identifiant d'entreprise :
<script src="https://widgets.thehumind.com/v1/loader.js" defer></script>
<humind-search shop-domain="{{ shop.permanent_domain }}"></humind-search>Ajout au panier
L'ajout au panier utilise la même configuration que le widget de chat (voir Ajout au panier) : rien de plus à brancher pour la barre de recherche. Un produit qui ne peut pas être ajouté renvoie vers sa page.
Taille
La barre fermée fait au plus 560 px de large et prend la largeur de son conteneur en dessous (le bouton garde sa propre taille). Définissez --humind-search-max-width sur l'élément pour changer ce maximum :
humind-search {
--humind-search-max-width: 720px;
}Sur téléphone, la recherche s'ouvre en plein écran.
Attributs
| Attribut | Type | Rôle |
|---|---|---|
company-id | string | Votre identifiant d'entreprise Humind. Celui-ci ou shop-domain. |
shop-domain | string | Alternative à company-id : un domaine enregistré sur votre entreprise (sur Shopify, la variable Liquid shop.permanent_domain). |
market-key | string | Multimarché uniquement : désigne le marché quand plusieurs marchés partagent un domaine. Voir plusieurs marchés sur un même domaine. |
language | string | Code ISO 639-1 pour les textes de la barre. Langues prises en charge : en, fr, de, es, it, nl. Par défaut : le lang de la page, puis l'anglais. |
placeholder | string | Premier texte affiché dans la barre, avant les exemples de demandes qui défilent. Par défaut : celui du dashboard, sinon le texte de la barre. |
primary-color | string | Remplace la couleur de votre marque. |
rounding | number | Arrondi de la barre, de 0 à 48 (px). Par défaut : celui du dashboard, sinon l'arrondi de votre widget de chat. |
display | string | bar : le champ de recherche. button : une loupe « Rechercher », la loupe seule sur téléphone. Par défaut : le choix du dashboard, sinon bar. |
layout | string | inline : la barre s'agrandit sur place et les résultats se déplient dessous. overlay : la recherche s'ouvre dans un panneau centré par-dessus la page. Par défaut : le choix du dashboard, sinon inline. |
bar-background-color, bar-border-color, bar-text-color, bar-icon-color, bar-plus-background-color | string | Les couleurs de la barre (toute couleur CSS). |
bar-height | number | Hauteur de la barre, de 40 à 72 (px). |
bar-max-width | number | Largeur maximale de la barre, de 240 à 1200 (px). |
bar-shadow | string | false retire l'ombre de la barre. |
button-background-color, button-text-color, button-border-color | string | Les couleurs du bouton (toute couleur CSS). |
button-radius | number | Arrondi du bouton, de 0 à 48 (px). |
button-height | number | Hauteur du bouton, de 32 à 64 (px). |
button-icon-only | string | true : la loupe seule, aussi sur ordinateur. |
button-label | string | Le texte du bouton. |
suggestions | string | off masque les suggestions qui complètent le texte. |