Intégration : Doc technique

Introduction

Cette documentation est destinée aux développeurs et webmasters souhaitant intégrer le module de réservation Yoplanning.pro sur leur site web. L'objectif est d'améliorer l'expérience utilisateur en offrant une interface de réservation accessible et réactive, tout en permettant une personnalisation du module.

Principe de Fonctionnement

Le module de réservation Yoplanning.pro est conçu pour s'intégrer harmonieusement à votre site web, offrant une expérience utilisateur fluide sans nécessiter de redirections. Le module se présente sous forme d'une fenêtre contextuelle (pop-up) qui s'active à partir d'un bouton ou d'un lien, permettant aux utilisateurs de réaliser leurs réservations directement sur votre site.

Avantages

• Affichage optimal : Adaptation à tous les types d'écrans, y compris mobiles.

• Intégration facile : Peut être ajouté à votre site avec un simple morceau de code JavaScript.

• Personnalisation : Génération de liens spécifiques pour différentes actions ou catégories.

Intégration via Iframe

Bien que possible, l'intégration via iframe n'est pas recommandée en raison de contraintes de compatibilité avec les appareils mobiles. En cas de nécessité, le module peut s'ouvrir dans un nouvel onglet pour une expérience plein écran.

Code d'Intégration

Pour intégrer le module, insérez le code JavaScript suivant dans le <header> de votre site. Ceci permettra au module d'être accessible sur l'ensemble des pages sans nécessiter de multiples insertions.

<script type="text/javascript" src="https://booking.yoplanning.pro/integration/script.js" async></script>

Génération des Liens du Module de Réservation

Les liens spécifiques au module de réservation peuvent être générés via le backoffice de Yoplanning :

1. Accédez à Paramétrage > Module de réservation > Menu d'intégration.

2. Utilisez le mode URL pour créer une URL adaptée à vos besoins.

Exemples de Liens Générés

• Lien général : https://booking.yoplanning.pro/<ID_UNIQUE>/

• Catégorie spécifique : https://booking.yoplanning.pro/<ID_UNIQUE>/?tag=<ID_CATEGORIE>

• Fiche produit : https://booking.yoplanning.pro/<ID_UNIQUE>/product/<ID_PRODUIT>

• Accès direct au panier : https://booking.yoplanning.pro/<ID_UNIQUE>/cart/

• Boutique directe : https://booking.yoplanning.pro/<ID_UNIQUE>/shop/

Options d'Intégration

Yoplanning propose divers modes d'intégration :

• Bouton : Pour un accès direct via un bouton cliquable.

• Icône flottante : Une icône accessible à tout moment sur la page.

• Lien hypertexte : Pour intégrer dans du texte ou des images.

• Iframe : Utilisé en dernier recours, si le JavaScript est restreint.

• URL simple : Pour une intégration directe comme lien.

Gestion Multilingue

Le module détecte automatiquement la langue du navigateur de l'utilisateur grâce au service externe https://gtranslate.io/detect-browser-language, offrant une expérience localisée et intuitive. (Méthode recommandée dans la plupart des cas.)

Langue forcée par défaut.

Si vous avez un site internet multilingue ou que vous avez des problèmes de détection de langue ou que vous voulez forcer le module à s'afficher dans une langue définie, vous pouvez créer un module de réservation spécifique en forçant la langue dans sa configuration.

Conclusion

L'intégration du module de réservation Yoplanning.pro améliore significativement l'expérience de réservation sur votre site web, grâce à son interface utilisateur optimisée, ses options de personnalisation avancées, et sa gestion du multilinguisme. Suivez les instructions fournies pour une intégration réussie et pour offrir à vos utilisateurs une expérience de réservation sans faille.