Skip to content

Installer le store locator ​

Un annuaire de vos magasins : recherche, carte interactive, horaires d'ouverture en direct, distance du visiteur et, pour les magasins qui prennent des rendez-vous, un bouton « Prendre rendez-vous ». À placer sur une page « Nos magasins », un footer, une landing page ou n'importe quelle page de vos sites.

Le publier d'abord

Le store locator reste vide tant qu'il n'est pas publié : activez Annuaire des magasins dans la page Store locator de votre dashboard, qui en montre aussi un aperçu en direct (aussi dans Réglages > Entreprise > Magasins, où se gèrent vos magasins, leurs horaires et leurs prestations). Il est public dès qu'il est activé.

Whitelister votre domaine

En dehors de la page Shopify, le locator 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.).

Choisir votre mode d'intégration ​

  1. Bloc de thème Shopify : aucun HTML à coller. Voir Bloc de thème Shopify.
  2. Toute autre page ou site : collez le code d'intégration. Voir Copier-coller.
  3. Page Shopify prête à l'emploi : /a/humind/stores, servie par l'app Humind. Voir Page Shopify.

Le widget de chat peut aussi afficher le locator dans un onglet Magasins : activez Afficher dans le widget de chat sous l'interrupteur de l'annuaire (ou store_locator.chat_tab dans l'API des settings). Rien à installer pour celui-là ; son Prendre rendez-vous ouvre la carte de réservation du chat.

Bloc de thème Shopify ​

Dans l'éditeur de thème, ajoutez le bloc d'app Store locator sur n'importe quel template (un template de page pour une page « Nos magasins » est le choix habituel). La page Store locator de votre dashboard a un bouton Installer sur Shopify qui ouvre l'éditeur de thème avec le bloc prêt à placer.

Le bloc retrouve seul votre entreprise à partir de la storefront et de son marché. Ses réglages : une couleur d'accent facultative (vide = la couleur de marque Humind) et les marges.

Copier-coller ​

html
<script src="https://widgets.thehumind.com/v1/loader.js" defer></script>

<humind-store-locator company-id="VOTRE_COMPANY_ID"></humind-store-locator>

La page Store locator du dashboard vous donne ce code avec votre company ID déjà rempli. Vous le trouvez aussi dans la page Developer Credentials.

Le locator prend toute la largeur de son conteneur. Donnez au conteneur la largeur voulue ; la carte et la liste s'empilent sur les écrans étroits.

Page Shopify ​

Tout locator publié a aussi une page complète sur une storefront Shopify, à https://votre-boutique.com/a/humind/stores (le chemin change si vous avez renommé le proxy de l'app dans Shopify). Ajoutez-la à votre menu de navigation comme n'importe quel lien. Son Prendre rendez-vous ouvre la carte de réservation du widget de chat, comme sur le bloc de thème.

Rendez-vous ​

Un magasin affiche Prendre rendez-vous quand il prend des rendez-vous et que la compétence de prise de rendez-vous est activée sur votre assistant (le même interrupteur que l'onglet Rendez-vous du widget de chat). Sur le bloc de thème, le code copié-collé et la page Shopify, le bouton ouvre le widget de chat Humind sur sa carte de réservation pour ce magasin. Si le widget de chat n'est pas sur la page, rien ne s'ouvre : écoutez l'événement ci-dessous pour piloter votre propre parcours de réservation (le bouton suppose toujours la compétence de prise de rendez-vous activée).

Pour retirer la prise de rendez-vous du locator, désactivez Prise de rendez-vous sous l'interrupteur de l'annuaire (ou store_locator.booking dans l'API des settings).

Attributs ​

AttributTypeRôle
company-idstringVotre company ID Humind. Celui-ci ou shop-domain.
shop-domainstringAlternative à company-id : un domaine enregistré sur votre entreprise. Renseigné automatiquement par le bloc de thème Shopify (shop.permanent_domain).
market-keystringConfigurations multimarché uniquement : nomme le marché quand plusieurs marchés partagent un domaine. Renseigné automatiquement sur Shopify. Voir plusieurs marchés sur un domaine.
languagestringCode ISO 639-1. Supportés : en, fr, de, es, ar, it, nl, pt, ru, zh, he.
accent-colorstringRemplace votre couleur de marque (boutons, magasin sélectionné).
accent-text-colorstringRemplace la couleur du texte posé sur la couleur d'accent.

Événements ​

ÉvénementCibleQuand
humind-store-appointmentremonte jusqu'à windowLe visiteur a cliqué sur Prendre rendez-vous pour un magasin.

Détail de humind-store-appointment ​

ts
{
  storeId: string;
  storeName: string;
  address: string;
  bookable: boolean;  // le magasin prend des rendez-vous
  inPlace: boolean;   // le locator réserve lui-même (toujours false : la réservation passe par le chat)
}
js
window.addEventListener('humind-store-appointment', (event) => {
  console.log(event.detail.storeId, event.detail.storeName);
});

Released under the proprietary Humind license.