Installer Drope sur votre site, pas à pas
Comptez une demi-heure pour un premier produit en ligne. Chaque étape renvoie à l'écran du back-office où elle se fait. Si un développeur ou une agence s'occupe de votre site, envoyez-lui cette page : les étapes 6 et 7 sont pour lui.
1. Ce qu'il vous faut
- Un compte Drope : créez-le ici.
- Des photos de la pièce vierge : une de face, une de dos (fortement conseillée, sinon le dos est imaginé). Fond uni, pièce entière dans le cadre, bonne lumière, 800 pixels de côté au moins.
- L'accès à l'administration de votre site (Shopify, WooCommerce, PrestaShop…), ou quelqu'un qui l'a.
2. Créer votre boutique
À la première connexion, Drope vous guide en quatre écrans : votre boutique (son nom, l'adresse de votre site et votre métier), un premier produit, ses zones de marquage, puis la ligne à poser. L'adresse donnée ici devient votre premier domaine autorisé (étape 6).
Vous pouvez quitter ces écrans à tout moment : tout se retrouve ensuite dans le back-office, onglets Produits, Demandes, Statistiques et Réglages (catalogue, apparence, installation).
3. Ajouter un produit
- Onglet Produits, « Nouveau produit » : choisissez le type (t-shirt, sweat, hoodie, polo, casquette, tote bag, mug, gourde…) ou « Autre produit » pour un objet hors liste, puis ses couleurs (un nom et une teinte chacune) et ses photos.
- La référence identifie le produit : lettres, chiffres, point, tiret ou soulignement, sans espace, 64 caractères au plus. Le plus simple : reprendre la fin de l'adresse de la page produit (sur Shopify, le « handle » ; sur WooCommerce, le « slug ») ; elle sert aux options avancées de l'étape 7.
- Collez l'adresse de la page du produit sur votre site dans « Adresse de la page sur votre site » : c'est elle qui fait apparaître le bouton sur cette page (étape 7). Son domaine doit être autorisé (étape 6).
- Drope détoure vos photos puis prépare la pièce en 3D, en quelques minutes. Si un détourage semble douteux, la fabrication s'arrête et la fiche affiche « Vos photos détourées attendent votre accord » : validez, ou reprenez une photo.
- Vérifiez la pièce sous ses quatre angles et réglez ses zones de marquage (position, taille, techniques permises). Une pièce qui ne vous paraît pas juste peut être refaite.
- Passez enfin l'interrupteur « En ligne » : sans lui, le produit reste invisible pour vos clients. Le nombre de produits en ligne dépend de votre offre.
4. Choisir vos techniques
Onglet Réglages, partie Catalogue : vos clients ne choisissent que parmi ce que vous produisez. Ajoutez-les depuis un catalogue (broderie, DTF, sérigraphie, flocage, écusson, gravure laser, sublimation), sous le nom de votre choix ; chacune a un rendu (impression à plat, broderie en relief, gravure laser ou sublimation). Pour le texte, cochez les polices proposées et la palette de couleurs de marquage ; sans police cochée, le texte n'est pas proposé.
Facultatif : onglet Réglages, partie Apparence, la couleur d'action et l'arrondi du configurateur, avec l'option Thème.
5. Choisir comment recevoir les demandes
Onglet Installation, « Quand votre client a terminé sa pièce » :
- Formulaire Drope : Drope recueille les coordonnées du client (nom, email, téléphone, date souhaitée), puis vous envoie la demande avec ses fichiers et ses aperçus, à l'« Email de réception des demandes ». Rien à programmer : c'est le bon choix pour commencer.
- Formulaire de votre site : votre page reçoit la personnalisation et garde son propre devis ou son panier. Il faut un développeur : récupérer les demandes sur votre site.
Dans les deux cas, chaque demande s'affiche aussi dans l'onglet Demandes.
6. Autoriser vos domaines
Le configurateur ne s'ouvre que depuis les adresses que vous autorisez (onglet Réglages, partie Installation, « Autorisez vos domaines ») : une autre boutique ne peut pas se servir de votre clé.
- Collez l'adresse d'une page de votre site, Drope en garde l'origine (par exemple https://www.exemple.fr).
- Avec et sans www sont deux adresses différentes : ajoutez celles par lesquelles vos clients arrivent.
- Shopify : ajoutez aussi l'adresse en .myshopify.com si elle reste accessible.
- Un site de préproduction, ou un test sur votre ordinateur (http://localhost:8000), s'ajoute comme les autres. 20 adresses au plus.
7. Poser le bouton sur votre site
Deux gestes : une ligne collée une seule fois dans le gabarit de votre site, puis l'adresse de chaque page produit sur sa fiche Drope. La ligne porte votre clé publique, qui n'a rien de secret ; votre vraie ligne est déjà remplie dans le back-office, onglet Réglages, partie Installation.
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="pk_live_votre_cle" async></script>- Collez cette ligne une fois, juste avant la balise </body> du gabarit de votre site : elle sert à toutes vos pages (où la coller selon votre plateforme, ci-dessous).
- Dans Drope, onglet Produits, ouvrez chaque produit personnalisable et collez dans « Adresse de la page sur votre site » l'adresse de sa page (par exemple https://www.exemple.fr/produits/sweat-brode). Les paramètres après « ? » ne comptent pas.
- Le bouton « Personnaliser en 3D » apparaît alors tout seul sous le bouton « Ajouter au panier » de cette page, tant que le produit est en ligne ; un produit hors ligne n'a pas de bouton. Si la page n'a pas de bouton d'ajout au panier reconnaissable, le bouton s'affiche en bas à droite de l'écran.
Avec une IA (ChatGPT, Claude, Cursor…)
Une IA peut vous guider pas à pas, ou poser la ligne elle-même si elle a accès au code de votre site. Copiez cette consigne et collez-la dans votre outil, en remplaçant les passages entre crochets. Dans le back-office, onglet Réglages, partie Installation, « Installer avec une IA » copie la même consigne déjà remplie : votre clé, vos produits, vos domaines.
Bonjour. Je voudrais votre aide pour installer Drope sur le site de ma boutique.
Drope ajoute un bouton « Personnaliser en 3D » sur mes pages produit : mon client y personnalise sa pièce en 3D (logo, texte), puis me demande un devis. Guidez-moi pas à pas : je ne suis pas forcément développeur. Expliquez chaque geste simplement et attendez ma confirmation avant de passer au suivant. Si vous avez accès au code de mon site, montrez-moi chaque changement avant de l'appliquer.
## 1. La ligne à poser
Une seule ligne, une seule fois, dans le gabarit commun à toutes les pages du site, juste avant </body> :
```html
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="[VOTRE CLÉ, écran Installation]" async></script>
```
Remplacez [VOTRE CLÉ, écran Installation] par la clé publique de ma boutique (elle commence par pk_live_) : je la trouve dans Drope, écran Installation. Ce n'est pas un secret. Ne changez rien d'autre à la ligne.
## 2. Où la coller
Demandez-moi sur quelle plateforme tourne mon site si vous ne le voyez pas, puis guidez-moi :
- Shopify : Boutique en ligne, Thèmes, « Modifier le code », fichier theme.liquid, juste avant </body>.
- WooCommerce, WordPress : Dans le pied de page du site, avec une extension d'en-têtes et pieds de page (par exemple WPCode).
- PrestaShop : Dans le pied de page, avec un module d'injection de code, ou dans le gabarit du thème, juste avant </body>.
- Squarespace : Paramètres, Avancé, « Injection de code », zone Pied de page.
- Google Tag Manager : Une balise « HTML personnalisé », déclenchée sur toutes les pages.
- Autre plateforme ou site sur mesure : dans le gabarit commun à toutes les pages, juste avant </body>.
## 3. Mes produits
Le bouton apparaît tout seul sous « Ajouter au panier » de chaque page produit dont l'adresse est renseignée sur la fiche du produit dans Drope (onglet Produits, « Adresse de la page sur votre site »), tant que le produit est en ligne.
Mes produits en ligne :
[MES PRODUITS EN LIGNE : nom, référence et adresse de la page de chacun, onglet Produits de Drope]
Pour chaque produit sans adresse : trouvez sur mon site la page qui lui correspond, donnez-m'en l'adresse, et dites-moi de la coller dans Drope, sur la fiche du produit, « Adresse de la page sur votre site ».
## 4. Les adresses autorisées
Le configurateur ne s'ouvre que depuis les adresses autorisées dans Drope : [MES DOMAINES AUTORISÉS, écran Installation, « Autorisez vos domaines »].
Si mon site répond aussi à une autre adresse (avec ou sans www, en .myshopify.com), dites-moi de l'ajouter dans Drope, écran Installation, « Autorisez vos domaines ».
## 5. Après la personnalisation
Mode choisi : [FORMULAIRE DROPE ou FORMULAIRE DE MON SITE, écran Installation, « Après la personnalisation »].
- Avec « Formulaire Drope » : Drope recueille les coordonnées du client et m'envoie sa demande par email : rien d'autre à programmer.
- Avec « Formulaire de mon site » seulement : Ma page reçoit la personnalisation du client (ses choix, ses fichiers, deux aperçus) dans l'événement drope:devis. Ajoutez ce code sur mes pages produit, après la ligne, et reliez-le à mon formulaire de devis ou à mon panier :
```js
document.addEventListener("drope:devis", (evenement) => {
const { brief, fichiers, captures } = evenement.detail;
// brief : choix du client ; fichiers : ses logos ; captures : aperçus face et dos
});
```
Ce que contient la demande, avec deux exemples complets : https://drape.alohria.com/aide/formulaire-de-mon-site
## 6. Les règles
- Ne modifiez pas le bouton « Ajouter au panier », ni le reste de mes pages produit.
- Collez la ligne une seule fois, juste avant </body> : pas une fois par produit, pas dans l'en-tête.
- N'inventez ni clé, ni adresse, ni code : servez-vous seulement de ceux de cette consigne.
- Ne publiez rien (thème, extension, code) sans ma validation : montrez-moi d'abord ce qui va changer.
## 7. Vérifier
1. Ouvrez avec moi une page produit publiée (pas l'aperçu de l'éditeur) : le bouton « Personnaliser en 3D » doit apparaître sous « Ajouter au panier ».
2. S'il n'apparaît pas : rechargez la page sans cache, puis ouvrez les outils de développement du navigateur, onglet Console : les lignes « Drope : … » disent la cause.
3. Pour finir, je lance dans Drope, écran Installation, « Vérifier mon installation » avec l'adresse de cette page.
Le guide complet : https://drape.alohria.com/aide/installation. Le bouton en détail (emplacement précis, style, erreurs) : https://drape.alohria.com/aide/bouton.Shopify
Boutique en ligne, Thèmes, puis « … » et « Modifier le code » du thème publié : dans Layout, ouvrez theme.liquid, collez la ligne juste avant </body> et enregistrez. Si vous changez de thème, recollez-la dans le nouveau. L'aperçu de l'éditeur de thème passe par une autre adresse que votre boutique : jugez sur la page publiée.
WooCommerce (WordPress)
Avec une extension d'en-têtes et pieds de page (par exemple WPCode, « Header & Footer »), collez la ligne dans la zone Pied de page (Footer), puis enregistrez. Une extension de cache ou d'optimisation qui retarde le JavaScript doit laisser passer drope-bouton.js.
PrestaShop
Avec un module d'injection de code dans le pied de page, ou, pour votre développeur, dans le gabarit d'un thème enfant (templates/layouts/layout-both-columns.tpl), juste avant </body>. Videz ensuite le cache de PrestaShop (Paramètres avancés, Performances).
Squarespace
Paramètres, Avancé, « Injection de code » : collez la ligne dans la zone Pied de page, puis enregistrez. Squarespace n'exécute le code que sur la page publiée, et seulement avec une offre qui autorise l'injection de code.
Wix (à essayer)
Avec une offre payante et votre domaine connecté : Paramètres du site, Avancé, « Code personnalisé », « Ajouter un code » ; collez la ligne, choisissez « Toutes les pages » et l'emplacement « Corps, fin ». Le script place le bouton tout seul sous « Ajouter au panier », sans bloc à ajouter sur la fiche. Nous n'avons pas encore pu le tester sur une boutique Wix : écrivez-nous si votre boutique y est, pour l'essayer ensemble.
Google Tag Manager
Nouvelle balise de type « HTML personnalisé », collez la ligne, déclencheur « All Pages » (toutes les pages), puis publiez le conteneur. « Vérifier mon installation » ne voit pas une ligne ajoutée par Tag Manager (elle n'est pas dans le code de la page) : jugez sur la page publiée.
Options avancées : la ligne d'un produit
Pour placer le bouton à un endroit précis de la fiche, ou sans renseigner l'adresse des pages, collez à la place du script unique la ligne d'un produit, là où le bouton doit apparaître. Elle porte la référence du produit dans Drope (data-produit) :
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="pk_live_votre_cle" data-produit="sweat-brode" async></script>Sur une boutique en ligne, la même fiche sert à tous les produits : la référence s'y écrit avec la variable de la plateforme, et le bouton ne s'affiche que sur les produits que vous rendez personnalisables.
Shopify : donnez à chaque produit Drope la même référence que son handle Shopify (la fin de son adresse, sweat-brode pour /products/sweat-brode), ajoutez l'étiquette « drope » aux produits personnalisables, puis, dans Thèmes, Personnaliser, modèle Produits, ajoutez sous le bouton d'achat un bloc « Liquid personnalisé » :
{% if product.tags contains 'drope' %}
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="pk_live_votre_cle" data-produit="{{ product.handle }}" async></script>
{% endif %}WooCommerce : même référence que le slug du produit, étiquette « drope » sur les produits personnalisables, puis cet extrait PHP avec l'extension Code Snippets (ou le functions.php d'un thème enfant), à exécuter sur le site :
add_action('woocommerce_after_add_to_cart_form', function () {
global $product;
if (!$product || !has_term('drope', 'product_tag', $product->get_id())) return;
printf(
'<script src="%s" data-cle="%s" data-produit="%s" async></script>',
esc_url('https://drape.alohria.com/drope-bouton.js'),
esc_attr('pk_live_votre_cle'),
esc_attr($product->get_slug())
);
});PrestaShop : dans le gabarit de la fiche produit d'un thème enfant (templates/catalog/product.tpl), près du bouton d'ajout au panier. La référence Drope est l'adresse du produit (sa « réécriture d'URL ») ; la condition limite le bouton à la catégorie de vos produits personnalisables.
{* Catégorie des produits personnalisables : remplacez 12 par son numéro *}
{if $product.id_category_default == 12}
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="pk_live_votre_cle" data-produit="{$product.link_rewrite}" async></script>
{/if}Site sur mesure, React, Vue : gardez le script unique, et posez un emplacement là où le bouton doit apparaître ; les emplacements ajoutés plus tard reçoivent leur bouton tout seuls :
<div data-drope-produit="sweat-brode"></div>Le style du bouton (couleurs, arrondi, ::part), les événements et le bouton entièrement à vous : le guide du bouton.
8. Vérifier et faire un essai
- Onglet Installation, « Vérifier mon installation » : collez l'adresse d'une page produit publiée. Drope la lit et dit ce qui est bon, ce qui est à corriger et ce qui est à savoir, dont, avec la ligne unique, si une fiche produit a l'adresse de cette page.
- Ouvrez cette page comme un client, cliquez sur « Personnaliser en 3D », posez un logo et un texte, puis envoyez une demande de test.
- Avec le formulaire Drope, l'email arrive à votre adresse de réception ; la demande apparaît aussi dans l'onglet Demandes.
9. Si le bouton ne marche pas
| Ce que vous voyez | La cause probable |
|---|---|
| Le bouton n'apparaît pas du tout. | L'adresse de la page n'est sur aucune fiche produit, le produit est hors ligne, ou la ligne n'est pas sur la page publiée (thème non enregistré, cache du site), ou un bloqueur de publicité la retient. Rechargez la page sans cache, puis lancez « Vérifier mon installation » : il dit si une fiche produit a cette adresse. |
| « La personnalisation 3D est indisponible pour le moment. » | L'adresse exacte de la page n'est pas dans vos domaines autorisés (avec ou sans www, myshopify.com), ou la clé est mal recopiée. |
| « Ce produit n'est pas personnalisable pour le moment. » | La référence de la page ne correspond à aucun produit Drope, ou le produit n'est pas « En ligne », ou il n'a aucune zone avec une technique. |
| Le bouton n'apparaît qu'après un premier clic ou un défilement. | Une extension d'optimisation retarde les scripts (WP Rocket, Autoptimize, etc.) : excluez drope-bouton.js du « retard du JavaScript ». |
| Rien dans l'éditeur de votre plateforme. | Certains éditeurs (Squarespace, aperçu du thème Shopify) n'exécutent pas les scripts ou passent par une autre adresse : jugez sur la page publiée. |
La cause exacte s'écrit dans la console du navigateur (outils de développement, onglet Console, lignes « Drope : … ») ; le détail de chaque erreur est dans le guide du bouton.
10. La liste avant d'annoncer la nouveauté
- Le produit est « En ligne », ses zones ont au moins une technique.
- L'adresse de chaque page est sur la fiche de son produit (ou, en option avancée, la référence de la page est celle du produit dans Drope).
- Toutes les adresses de votre site sont autorisées (avec et sans www).
- « Vérifier mon installation » ne signale rien à corriger.
- Une demande de test est arrivée, par email ou sur votre site.