Deux façons de capturer la personnalisation
Shopify possède la vitrine et le paiement, donc le champ est ajouté via des mécanismes natifs Shopify. Choisissez une voie.
- Propriété de ligne d'article — un champ personnalisé sur la page produit. Fonctionne sur toutes les formules Shopify. Nécessite une petite modification de thème.
- Extension d'interface de paiement — un bloc personnalisé rendu à l'intérieur du paiement. Shopify Plus uniquement. Pas de modification de thème, mais un développeur déploie une application personnalisée.
Les deux méthodes produisent le même résultat : une propriété attachée à la ligne d'article. Tant qu'elle s'appelle Customization Request, Alva extrait automatiquement la valeur.
Méthode 1 — Propriété de ligne d'article
1. Ouvrez le modèle de produit
Dans l'admin Shopify, allez dans Boutique en ligne → Thèmes, cliquez sur Modifier le code et ouvrez sections/main-product.liquid (ou product-template.liquid sur les anciens thèmes).
Éditeur de code de thème Shopify. Afficher l'arborescence des fichiers à gauche avec main-product.liquid mis en évidence, et le fichier Liquid ouvert à droite, défilé jusqu'au bloc du formulaire produit. Aucune donnée de boutique réelle visible.
2. Ajoutez le champ dans le formulaire produit
À l'intérieur du bloc {% form 'product' %}, ajoutez un label et un champ texte. L'attribut name doit utiliser la syntaxe à crochets properties[Customization Request] — c'est ce qui indique à Shopify d'attacher la valeur à la ligne d'article.
<label for="customization">Personalisation request</label>
<input type="text"
id="customization"
name="properties[Customization Request]"
maxlength="200"
required>3. Définissez les contraintes requises et de longueur
Ajoutez required pour que les clients ne puissent pas le laisser vide, et maxlength="200" pour qu'ils ne puissent pas coller un paragraphe. Gardez le label concret — Prénom à broder est mieux que Personnalisation.
4. Enregistrez et passez une commande de test
Enregistrez le modèle, affichez le produit sur la vitrine, remplissez le champ et passez une commande de test. La valeur apparaît dans Shopify sous Commande → Articles et dans Alva sur la page de détail de la commande personnalisée.
Une page produit sur la vitrine avec le champ de personnalisation rendu au-dessus du bouton Ajouter au panier. Champ étiqueté « Prénom à broder » avec un exemple de placeholder. Aucune image de marque réelle requise.
Méthode 2 — Extension d'interface de paiement
Les marchands Plus peuvent afficher le champ dans le paiement lui-même. Alva Digital Downloads ne fournit pas cette extension — la construire est une tâche de développeur Shopify. Voir la référence des extensions d'interface de paiement Shopify pour l'API actuelle.
1. Initialisez une extension
Depuis une application Shopify personnalisée, exécutez shopify app generate extension et choisissez Checkout UI extension. Sélectionnez la cible purchase.checkout.block.render.
2. Écrivez la propriété de ligne d'article
Utilisez l'API de propriété de ligne d'article de @shopify/ui-extensions-react/checkout pour attacher la valeur à la ligne d'article sous la clé Customization Request.
3. Déployez et placez le bloc
Exécutez shopify app deploy, puis dans Paramètres → Paiement → Personnaliser, déposez le nouveau bloc dans la mise en page et passez une commande de test.
Où la valeur apparaît dans Alva
Lorsque Shopify déclenche le webhook orders/paid, Alva lit toute propriété de ligne d'article nommée exactement Customization Request et la stocke contre l'achat. La page de détail de la commande personnalisée rend la valeur au-dessus du téléverseur de fichier, et le même texte est inclus dans l'e-mail de notification du marchand.
FAQ
Puis-je rendre le champ de personnalisation obligatoire ?
Oui. Ajoutez l'attribut HTML required. Shopify bloque Ajouter au panier tant que le champ n'a pas de valeur. La méthode d'extension d'interface de paiement expose une option requise dans les paramètres de l'extension.
Puis-je capturer plus d'un champ par produit ?
Oui, mais Alva n'extrait automatiquement que la propriété nommée Customization Request. Les autres propriétés de ligne d'article apparaissent toujours sur la commande Shopify et sont visibles dans Alva sur la page de détail de la commande.
Le client peut-il modifier le champ après le paiement de la commande ?
Non. Les propriétés de ligne d'article sont immuables une fois la commande passée. Si une correction est nécessaire, demandez au client de l'envoyer par e-mail et mettez à jour les notes de commande manuellement avant de téléverser le fichier.
Voir aussi
Cet article vous a-t-il été utile ?
Dernière mise à jour 2026-05-06