Un champ de formulaire avec une clé stable
wp-field="key" Sans attribut, un champ de formulaire arrive dans la demande sous son libellé du design. Remplacez « Votre nom » par « Nom », et un modèle d’e-mail avec {{ Votre nom }} ou un envoi au CRM reçoit en silence une valeur vide, alors que les demandes continuent d’arriver. wp-field fixe la clé.
Où le placer
Sur le champ lui-même ou sur son conteneur « libellé + champ ». La valeur est une clé en lettres latines : name, phone, guests.
La génération écrit la clé dans name et data-name du champ ; le thème, lui, ne change pas.
Exemple : un formulaire de réservation
<form class="form">
<label wp-field="name">Your name
<input type="text" name="field" data-name="Your name"></label>
<label wp-field="phone">Phone
<input type="tel" name="field" data-name="Phone"></label>
<input type="submit" value="Send">
</form>- name: Anna Kowalski
- phone: +1 (555) 010-0142
Your name
Phone
SendDans la demande, les champs portent leurs clés, pas le texte de leur libellé.
À retenir
- Dans le modèle d’e-mail et les réglages d’envoi, écrivez la clé :
{{ name }}. - L’attribut est facultatif : sans lui, le formulaire fonctionne avec les libellés, comme avant.
- Pour les commentaires, les avis et la commande, WordPress fixe lui-même le nom des champs : n’y mettez pas l’attribut.
Erreurs fréquentes
Le journal de génération est l’onglet « Journaux » de votre projet sur themeforge.pro ; la vérification gratuite du balisage affiche les mêmes remarques.
<label wp-field="action">Your name
<input type="text" name="field" data-name="Your name"></label>Un nom réservé comme action, ou une clé écrite dans un autre alphabet : la génération ne l’applique pas, le signale dans le journal, et le champ part sous son libellé.
<label wp-field="name">Your name
<input type="text" name="field" data-name="Your name"></label>Votre propre clé, en lettres latines sans accents.