Un shortcode est un court code entre crochets que WordPress remplace par du contenu. Le shortcode [mailerpress_optin] affiche un formulaire d’inscription MailerPress n’importe où sur votre site : dans un module ou un widget de constructeur de pages (Elementor, Bricks, Divi et autres), dans l’éditeur classique, ou dans les modèles PHP de votre thème. Il est inclus dans MailerPress (gratuit).
Vous utilisez l’éditeur de blocs ? Le bloc Formulaire d’abonnement est plus simple à configurer. Avec MailerPress Pro, Elementor, Bricks Builder et Divi disposent aussi d’intégrations dédiées : Elementor, Bricks Builder et Divi Builder.
Configuration rapide
Ajoutez ce shortcode à l’endroit où le formulaire doit apparaître :
[mailerpress_optin list="1"]Remplacez 1 par l’ID de votre liste. Sur la page des listes de MailerPress, la colonne Shortcode affiche un shortcode prêt à copier pour chaque liste. La page des étiquettes fait de même pour les étiquettes. Sans list, les nouveaux contacts vont dans votre liste par défaut (consultez Gérer votre liste de contacts).
Par défaut, le formulaire n’affiche que le champ e-mail et un bouton S’abonner. Ajoutez des attributs (des options écrites entre les crochets, comme list="1") pour le modifier.
Attributs du shortcode
| Attribut | Description | Par défaut |
|---|---|---|
list | ID des listes, séparés par des virgules, par exemple list="1,2". | Liste par défaut |
tags | ID des étiquettes, séparés par des virgules, par exemple tags="5,10". | Aucune |
show_first_name | Affiche le champ prénom. | false |
show_last_name | Affiche le champ nom. | false |
email_required | Rend le champ e-mail obligatoire. | true |
first_name_required | Rend le champ prénom obligatoire. | false |
last_name_required | Rend le champ nom obligatoire. | false |
email_label | Libellé du champ e-mail. | |
first_name_label | Libellé du champ prénom. | Prénom |
last_name_label | Libellé du champ nom. | Nom |
email_placeholder | Texte indicatif du champ e-mail. | Saisissez votre e-mail |
first_name_placeholder | Texte indicatif du champ prénom. | Saisissez votre prénom. |
last_name_placeholder | Texte indicatif du champ nom. | Saisissez votre nom. |
button_text | Texte du bouton. | S’abonner |
button_color | Couleur de fond du bouton (code hexadécimal, par exemple #0073aa). | #000 |
text_color | Couleur du texte du bouton (code hexadécimal). | #fff |
border_radius | Arrondi des angles du bouton, par exemple 8px. | 0px |
success_message | Message affiché après une inscription réussie. | Nous vous remercions de votre inscription. |
error_message | Message affiché en cas d’échec de l’inscription. | Oups ! Un problème est survenu. Veuillez réessayer. |
redirect | Page à ouvrir après une inscription réussie : l’ID d’un article, d’une page ou d’un autre type de publication, ou une URL complète. | Aucune |
Les libellés et messages par défaut s’affichent dans la langue de votre site.
Exemples
Formulaire simple avec un bouton personnalisé :
[mailerpress_optin list="1" button_text="S'inscrire"]Formulaire avec étiquettes :
[mailerpress_optin list="1" tags="5,10" button_text="Nous rejoindre"]Bouton stylisé :
[mailerpress_optin list="1" button_color="#e74c3c" text_color="#fff" border_radius="8px"]Redirection vers une page de remerciement (ID 123) après l’inscription :
[mailerpress_optin list="1" redirect="123"]Formulaire complet avec prénom obligatoire :
[mailerpress_optin list="1" tags="5" show_first_name="true" first_name_required="true" show_last_name="true" first_name_label="Prénom" last_name_label="Nom" email_label="E-mail" email_placeholder="[email protected]" button_text="S'abonner" button_color="#2c3e50" success_message="Merci pour votre inscription !"]Utiliser le shortcode dans un modèle PHP
Pour afficher le formulaire depuis votre thème ou thème enfant, ajoutez cette ligne dans un fichier de modèle :
<?php echo do_shortcode( '[mailerpress_optin list="1"]' ); ?>Bon à savoir
- Le double opt-in (le nouveau contact confirme en cliquant sur un lien dans un e-mail) suit le réglage MailerPress > Réglages > Confirmation d’abonnement, activé par défaut et recommandé. Aucun attribut du shortcode ne le modifie. Consultez Activer la confirmation de l’inscription (double opt-in).
- Les couleurs doivent être des codes hexadécimaux (par exemple
#000,#fffou#0073aa). Une couleur invalide est remplacée par la valeur par défaut. - Pour les attributs vrai/faux, utilisez
"true"ou"false". Les valeurs1,yesetonsignifient aussi vrai. - Les styles de votre thème s’appliquent au formulaire. Pour le cibler dans votre CSS personnalisé, utilisez la classe
mailerpress_shortcode-optin-form. Le bouton a aussi la classe standardbutton. - La limitation du débit (un plafond d’inscriptions sur une courte durée), définie dans MailerPress > Réglages > Protection contre les indésirables, s’applique aux formulaires du shortcode. Consultez Sécurité et protection anti-spam.