Aller au contenu principal

Intégration des widgets

Dernière mise à jour:

⚠ Si vous avez un site WIX, consultez notre guide d’intégration WIX.

Nos widgets se composent généralement de 2 éléments. Vous trouvez les deux dans la configuration des widgets.

La première partie est un script et un élément rtr-checkout. Le script établit la connexion avec votre compte Rentware et fournit les fonctionnalités aux éléments HTML. Le checkout se charge d’afficher le panier et les étapes de réservation du paiement. Vous pouvez définir ces étapes de réservation et leur contenu dans les paramètres des étapes.

La première partie ressemble à ceci :

<script
type="module"
src="https://cdn.rtr-io.com/widgets.js"
></script>
<script>
window.RTR_ACCESS_TOKEN = 'YOUR_ACCESS_TOKEN';
</script>
<rtr-checkout></rtr-checkout>

Nous recommandons de la coller simplement dans un en-tête ou un pied de page global (si tout votre site doit offrir les fonctions Rentware) ou à un endroit du corps de certaines sous-pages (si seules certaines sous-pages concernent votre activité de location, alors que d’autres portent par exemple sur des ventes réalisées en dehors de Rentware). Notez aussi qu’un checkout ne doit exister qu’une seule fois par page. Si vous affichez rtr-checkout deux fois par erreur, vous aurez des problèmes avec les prestataires de paiement en ligne.

La deuxième partie est simplement un élément HTML avec votre widget de réservation. Pour un widget de recherche, par exemple, il ressemble à ceci :

<rtr-search></rtr-search>

Il peut contenir d’autres paramètres pour préciser le comportement du widget de recherche. Vous placez simplement cette partie, comme élément HTML, à l’endroit précis où le widget doit apparaître.

Remarque importante : même si c’est techniquement possible, n’intégrez jamais les widgets dans un iFrame. Un iFrame isole les widgets dans un conteneur, déforme la mise en page (surtout sur mobile) et peut empêcher le paiement en ligne de fonctionner.

Plusieurs langues :

Si plusieurs langues sont activées, les widgets essaient de détecter la langue de votre site telle qu’elle est définie dans l’élément <html>. Par exemple, si votre site indique

<html lang="de-DE">

le widget essaie de charger vos traductions allemandes. Si votre compte Rentware n’inclut pas l’allemand, il utilise votre langue par défaut. Si la détection automatique de la langue pose problème, vous pouvez aussi la remplacer en ajoutant le paramètre

window.RTR_LOCALE = 'de-DE';

à votre script.