Poser le bouton Drope sur votre site
Le bouton « Personnaliser en 3D » ouvre le configurateur de Drope au-dessus de votre page produit. Une seule ligne pour tout le site suffit ; les options avancées servent un emplacement précis, les fiches partagées et les sites React ou Vue. Votre clé et vos références sont déjà remplies dans le back-office, écran Installation.
Où coller la ligne sur Shopify, WooCommerce, PrestaShop, Squarespace, Wix ou Google Tag Manager, et toutes les étapes avant le bouton : le guide d'installation.
1. Le cas simple : une ligne pour tout le site
Une seule fois, dans le gabarit du site, juste avant </body> (ou dans une balise « HTML personnalisé » de Google Tag Manager, sur toutes les pages) :
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="pk_live_votre_cle" async></script>- Sur la fiche de chaque produit, dans le back-office, collez l'adresse de sa page sur votre site (« Adresse de la page sur votre site »).
- Le bouton apparaît tout seul sous le bouton « Ajouter au panier » de ces pages, tant que le produit est en ligne. Un produit hors ligne, ou une page dont l'adresse n'est sur aucune fiche, n'a pas de bouton.
- Sans bouton d'ajout au panier reconnaissable sur la page, le bouton s'affiche en bas à droite de l'écran.
- Les paramètres de l'adresse (après « ? ») et la barre finale ne comptent pas : /produits/sweat?couleur=noir est la page /produits/sweat.
2. Options avancées : une ligne par produit, un emplacement précis
Pour placer le bouton à un endroit précis, ou sans renseigner l'adresse des pages : la ligne d'un produit, à la place du script unique, là où le bouton doit apparaître. Elle porte la référence du produit.
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="pk_live_votre_cle" data-produit="sweat-brode" async></script>Quand une même fiche sert à plusieurs produits, ou que les pages se montent sans recharger (React, Vue) : gardez le script unique, et posez un emplacement sur chaque fiche.
<!-- Une fois : le script unique, dans le gabarit du site -->
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="pk_live_votre_cle" async></script>
<!-- Sur chaque fiche, là où le bouton doit apparaître -->
<div data-drope-produit="sweat-brode"></div>- Un emplacement ajouté plus tard (fenêtre, page montée par React ou Vue) reçoit son bouton tout seul.
- Sur une fiche partagée, changez simplement data-drope-produit quand le produit affiché change : la référence est relue au clic.
- Attributs facultatifs de l'emplacement : data-drope-titre (titre de la fenêtre), data-drope-texte (texte du bouton, 40 caractères au plus), data-drope-couleur (couleur de fond, #rrggbb), data-drope-fin (libellé du bouton final du récapitulatif, par exemple « Ajouter au panier », 40 caractères au plus : le résultat part à votre page comme avant ; posé sur la balise du script, il vaut pour toute la page).
- Sur la ligne d'un produit, les mêmes réglages s'écrivent : data-titre, data-texte, data-couleur.
3. Le style du bouton
Le bouton prend la police de votre site. Ses couleurs, son arrondi, sa hauteur, sa bordure, le focus et l'erreur se règlent avec des variables, et tout le reste avec ::part, sans toucher à son code.
/* Sur votre page : le bouton garde votre police, et se règle sans toucher à son code */
[data-drope-produit] {
--drope-fond: #1f3a2e; /* fond du bouton */
--drope-texte: #ffffff; /* texte du bouton */
--drope-rayon: 6px; /* arrondi (999px : pilule, par défaut) */
--drope-hauteur: 48px; /* hauteur minimale (44px par défaut) */
--drope-bordure: 1px solid #1f3a2e;
--drope-focus: #1f3a2e; /* anneau du focus clavier, doublé d'un liseré blanc */
--drope-erreur: #b3261e; /* texte de l'erreur, sur --drope-erreur-fond (blanc) */
}
[data-drope-produit]::part(bouton) { text-transform: uppercase; letter-spacing: .04em; }
[data-drope-produit]::part(erreur) { font-style: italic; }
/* Conteneur caché tant que le bouton n'est pas affiché (produit hors ligne, attente) */
.ma-zone:has([data-drope-etat="masque"]) { display: none; }Pour qu'il ressemble à vos boutons, ajoutez data-drope-style=".mon-bouton" (sur la ligne du script ou l'emplacement) : il reprend la police, les couleurs, l'arrondi, la hauteur, la marge intérieure et la bordure du premier élément de la page qui répond à ce sélecteur. L'état du bouton est écrit sur l'emplacement (data-drope-etat : attente, visible ou masque, et la classe drope-attente, drope-visible ou drope-masque) : de quoi cacher en CSS une zone restée vide.
Pour un bouton entièrement à vous, un développeur peut garder le sien et ouvrir Drope au clic (écran Installation, « Autres façons de poser le bouton », « Votre bouton »).
4. Recevoir la demande du client
Avec « Formulaire Drope », rien à faire : la demande vous arrive par email. Avec « Formulaire de mon site », votre page reçoit la personnalisation dans l'événement drope:devis : Récupérer les demandes sur votre site.
document.addEventListener("drope:devis", (evenement) => {
const { brief, fichiers, captures } = evenement.detail;
// brief : choix du client ; fichiers : ses logos ; captures : aperçus face et dos
});
document.addEventListener("drope:ferme", () => {
// Le client a fermé sans demander de devis
});
document.addEventListener("drope:erreur", (evenement) => {
// evenement.detail.raison : voir le tableau des erreurs
});5. Les erreurs
Votre client lit une phrase simple sous le bouton. La cause et la correction s'écrivent dans la console du navigateur, pour vous ou votre développeur (outils de développement, onglet Console, lignes « Drope : … »).
| Raison | Ce que lit le client | Ce qu'il faut corriger |
|---|---|---|
cle-invalide | La personnalisation 3D est indisponible pour le moment. | Clé inconnue, ou l'adresse de la page n'est pas dans les domaines autorisés (back-office, Installation, Domaines). localhost n'est admis que si « Autoriser les essais sur cet ordinateur » est coché. |
produit-inconnu | Ce produit n'est pas personnalisable pour le moment. | Référence inconnue, ou produit hors ligne : vérifiez data-produit et l'interrupteur « En ligne » du produit. |
aucun-emplacement | Ce produit n'est pas personnalisable pour le moment. | Le produit n'a aucune zone avec une technique : réglez ses zones dans le back-office. |
indisponible | La personnalisation 3D est indisponible pour le moment. | Navigateur trop ancien, script bloqué (bloqueur de publicité, politique de sécurité du site) ou service injoignable. |
6. Tester sur votre ordinateur
- Une page ouverte en double-cliquant sur le fichier (adresse en file://) ne peut pas ouvrir la personnalisation : servez-la en http, par exemple avec « npx serve » ou « python -m http.server 8000 ».
- Dans Installation, Domaines autorisés, cochez « Autoriser les essais sur cet ordinateur (localhost) » : http://localhost et http://127.0.0.1 sont admis sur tout port. Décochez-la une fois vos essais finis.
- Dans le back-office, « Vérifier mon installation » lit une page de votre site en ligne et y cherche la ligne, la clé et la référence.
7. Drape et Drope
Drope s'appelait Drape. Le moteur garde ses noms techniques pour ne pas casser les sites déjà intégrés : le script drape.js, l'objet window.Drape et Drape.open. Le bouton prêt à poser porte le nouveau nom : drope-bouton.js, les attributs data-drope-… et les événements drope:…. Les deux viennent de Drope et fonctionnent ensemble.