Récupérer les demandes sur votre site
En mode « Formulaire de mon site », le client personnalise sa pièce sur votre page et clique « Faire une demande de devis ». Drope remet alors toute la personnalisation à votre page : ses choix, ses fichiers et deux aperçus. À vous de la relier à votre formulaire de devis ou à votre serveur. Cette page s'adresse à la personne qui s'occupe de votre site.
1. Collez la ligne du bouton
Sur la page du produit, là où le bouton « Personnaliser en 3D » doit apparaître. Votre clé et la référence du produit sont déjà remplies dans le back-office (Installation, ou la fiche du produit).
<script src="https://drape.alohria.com/drope-bouton.js" data-cle="pk_live_votre_cle" data-produit="votre-reference" async></script>Le site doit faire partie des domaines autorisés de la boutique (Installation, Domaines).
2. Écoutez la demande du client
Quand le client demande son devis, le configurateur se ferme et la page reçoit l'événement « drope:devis ». Il remonte jusqu'au document : un seul écouteur suffit, même avec plusieurs boutons sur la page.
document.addEventListener("drope:devis", (evenement) => {
const { brief, fichiers, captures } = evenement.detail;
// brief : ce que le client a choisi ; fichiers : ses logos ; captures : les aperçus face et dos
});3. Ce que vous recevez
| Champ | Contenu |
|---|---|
brief.produit | La référence du produit dans Drope (celle de data-produit). |
brief.couleur.label | Le coloris choisi, tel que vous l'avez nommé (« Bleu marine »). |
brief.emplacements | Un élément par emplacement personnalisé, dans l'ordre du client. |
… .emplacement | Le nom de l'emplacement (« Cœur », « Dos »). |
… .emplacementId | Sa référence : celle saisie dans l'éditeur de zones, sinon son code (les codes des emplacements standard). |
… .technique | L'identifiant de la technique : un identifiant standard (« broderie », « dtf », liste ci-dessous), ou la référence chez votre site saisie pour cette technique. |
… .tailleCm | La taille réelle du visuel, en centimètres (largeur, hauteur), avant rotation. |
… .position | Le centre du visuel dans la zone : u de gauche à droite, v de bas en haut, 0,5 au centre. |
… .rotation | L'angle en degrés, sens horaire (absent : 0). |
… .texte | Seulement pour un texte : ses lignes, sa police, sa couleur, son alignement. |
… .texteAjoute | Un texte posé sous un logo, dans le même emplacement (lignes, taille, position). |
… .alertes | Les avertissements à lire avant de produire, par exemple un logo trop léger pour l'impression. |
… .visuel.fichierId | Le fichier du client à utiliser : celui de fichiers qui porte cet id. |
fichiers | Les fichiers envoyés par le client ({ id, file }), 4 au plus, 20 Mo chacun au plus. |
captures | Deux aperçus de la pièce personnalisée (face et dos, 1 200 px), absents si l'appareil ne peut pas les produire. |
Un emplacement a trois formes : un logo seul, un texte seul (champ texte), ou un logo avec un texte dessous (champ texteAjoute). Les aperçus montrent toujours l'ensemble.
Les identifiants de technique
Une technique ajoutée dans Réglages, partie Catalogue, est choisie dans un catalogue : son identifiant est le même dans toutes les boutiques Drope, quel que soit le nom affiché à vos clients (« Broderie premium » arrive en broderie). Votre site peut donc s'y fier.
| Identifiant | Technique |
|---|---|
broderie | Broderie |
dtf | Impression DTF |
serigraphie | Sérigraphie |
flocage | Flocage |
ecusson | Écusson |
gravure-laser | Gravure laser |
sublimation | Sublimation |
- Votre site attend un autre code ? Dans Réglages, partie Catalogue, « Nom affiché et code » de la technique : le code chez votre site saisie part à la place de l'identifiant.
- Une technique libre (options avancées) garde un identifiant tiré de son nom. Une boutique créée avant ce catalogue garde ses identifiants (par exemple impression-dtf) tant que vous ne choisissez pas « Passer à l'identifiant standard ».
Exemple : préremplir votre formulaire de devis
Le résumé de la personnalisation va dans un champ texte, les fichiers du client sont joints au formulaire. Le client n'a plus qu'à ajouter ses coordonnées et envoyer.
<!-- Votre formulaire de devis, déjà sur la page -->
<form id="devis" action="/devis" method="post" enctype="multipart/form-data">
<textarea name="personnalisation" rows="6"></textarea>
<input type="file" name="fichiers" multiple hidden>
<button type="submit">Envoyer ma demande</button>
</form>
<script>
document.addEventListener("drope:devis", (evenement) => {
const { brief, fichiers } = evenement.detail;
const formulaire = document.getElementById("devis");
// Le résumé lisible de la personnalisation
const lignes = [`Couleur : ${brief.couleur.label}`];
for (const e of brief.emplacements) {
const contenu = e.texte ? `texte « ${e.texte.lignes.join(" / ")} »` : `logo ${e.visuel.nom}`;
lignes.push(`${e.emplacement} : ${contenu}, ${e.technique}, ${e.tailleCm.largeur} × ${e.tailleCm.hauteur} cm`);
for (const alerte of e.alertes) lignes.push(` Attention : ${alerte}`);
}
formulaire.elements.personnalisation.value = lignes.join("\n");
// Les fichiers du client, joints au formulaire
const transfert = new DataTransfer();
for (const f of fichiers) transfert.items.add(f.file);
formulaire.elements.fichiers.files = transfert.files;
formulaire.scrollIntoView({ behavior: "smooth" });
});
</script>Exemple : envoyer la demande à votre serveur
Tout part d'un coup : la personnalisation en JSON, les fichiers et les aperçus.
document.addEventListener("drope:devis", async (evenement) => {
const { brief, fichiers, captures } = evenement.detail;
const envoi = new FormData();
envoi.append("brief", JSON.stringify(brief));
for (const f of fichiers) envoi.append(`fichier-${f.id}`, f.file, f.file.name);
if (captures) {
envoi.append("apercu-face", captures.face, "face.webp");
envoi.append("apercu-dos", captures.dos, "dos.webp");
}
const reponse = await fetch("/api/devis", { method: "POST", body: envoi });
if (reponse.ok) alert("Merci, votre demande est envoyée.");
});Relisez la personnalisation sur votre serveur avant de vous en servir : elle vient du navigateur du client. Tailles de 0,1 à 60 cm, positions entre 0 et 1, 4 fichiers au plus, PNG, JPEG, WebP ou SVG de 20 Mo au plus.
Les autres événements
document.addEventListener("drope:ferme", () => {
// Le client a fermé sans demander de devis
});
document.addEventListener("drope:erreur", (evenement) => {
console.warn("Drope :", evenement.detail.raison);
// Le bouton affiche déjà un message au client : rien d'autre à faire
});Raisons possibles de « drope:erreur » : produit-inconnu (produit hors ligne ou référence inconnue), aucun-emplacement, cle-invalide (clé inconnue ou site hors des domaines autorisés), indisponible (navigateur trop ancien ou service indisponible).
Sur WordPress
- Sur une page ou une fiche produit : ajoutez un bloc « HTML personnalisé » là où le bouton doit apparaître, et collez-y la ligne du bouton.
- Avec WooCommerce, pour tous les produits d'un coup : donnez à chaque produit dans Drope la même référence que son identifiant WooCommerce (le « slug »), puis collez une seule fois la ligne dans le modèle de la fiche produit, avec data-produit égal au slug du produit affiché.
- Le code de l'étape 2 se colle dans un bloc « HTML personnalisé » sur la même page, ou dans le pied de page du thème.
Vérifier
Dans le back-office, Installation, « Vérifier mon installation » lit une page de votre site et y cherche la ligne, la clé et la référence du produit. Vous préférez recevoir les demandes par email, sans code ? Choisissez « Formulaire Drope » dans « Après la personnalisation ».