Créer des merge tags personnalisés pour l’éditeur d’e-mails MailerPress

Vous pouvez créer vos propres merge tags pour l’éditeur d’e-mails standard de MailerPress en enregistrant un groupe en PHP. Ce groupe apparaît ensuite dans le sélecteur Personalization Tags, et MailerPress remplace ses tags pour chaque destinataire lors de l’envoi d’une campagne ou d’un e-mail d’automatisation. Cette fonction est disponible dans MailerPress Free ; Pro n’est pas nécessaire.

Enregistrer un groupe de merge tags personnalisés

Ajoutez l’extrait suivant dans un plugin personnalisé actif ou dans du code PHP du site chargé à chaque requête, y compris pendant le traitement des e-mails planifiés. Enregistrez le groupe sur l’action WordPress init et vérifiez que la fonction MailerPress existe avant de l’appeler.

add_action( 'init', static function (): void {
	if ( ! function_exists( 'mailerpress_register_merge_tag_group' ) ) {
		return;
	}

	mailerpress_register_merge_tag_group(
		'member',
		'Membership',
		[
			'name'        => 'Member name',
			'account_url' => [
				'label' => 'Account URL',
				'type'  => 'url',
			],
		],
		static function ( string $key, object $contact, array $context ): string {
			if ( 'name' === $key ) {
				return (string) ( $contact->first_name ?? '' );
			}

			return home_url( '/my-account/' );
		}
	);
} );

Remplacez /my-account/ par le chemin de la page de compte de votre site. Dans cet exemple, member.name utilise le prénom du destinataire et member.account_url fournit une URL. La fonction de rappel reçoit la clé du tag, un objet contact et un tableau de contexte ; utilisez ce contexte si votre logique en a besoin.

La fonction d’enregistrement accepte la clé du groupe, son libellé, les définitions des tags et une fonction de rappel, puis renvoie un booléen. Les clés de groupe et de tag doivent commencer par une lettre minuscule et ne contenir ensuite que des lettres minuscules, des chiffres ou des traits de soulignement. Fournissez un libellé non vide et au moins un tag ; n’enregistrez chaque clé de groupe qu’une fois. Un tag peut être défini par 'key' => 'Label', avec le type text par défaut, ou par un tableau contenant un label et un type égal à text ou url.

Insérer les tags dans l’éditeur d’e-mails

1. Ouvrez un e-mail de campagne ou d’automatisation dans l’éditeur standard de MailerPress et placez le curseur dans une zone de texte enrichi.
2. Cliquez sur Personalization Tags dans la barre d’outils, sélectionnez Membership, puis Member name et cliquez sur Insert.
3. Pour utiliser l’URL du compte comme lien, choisissez Account URL et cliquez sur Insert as link.

Vous pouvez aussi saisir directement {{member.name}} ou {{member.account_url}}. Ces groupes personnalisés apparaissent dans l’éditeur standard des campagnes et automatisations ; les sélecteurs spécialisés pour les e-mails WordPress et WooCommerce ne les affichent pas.

Définir une valeur de remplacement

Cliquez sur un tag inséré dans l’éditeur pour ouvrir Default value for tag. Saisissez la valeur à utiliser si le tag n’a pas de résultat, ou choisissez Leave empty if none, puis cliquez sur Update.

Avec la syntaxe à accolades, {{member.name default="friend"}} utilise friend comme valeur de remplacement. Ajoutez une valeur de remplacement uniquement avec la forme {{...}} ; l’autre syntaxe à pourcents ne la prend pas en charge.

Vérifier le résultat avec un vrai destinataire

MailerPress remplace les merge tags personnalisés pour chaque destinataire dans l’objet et le corps des e-mails de campagne et d’automatisation. Vérifiez l’e-mail reçu par un véritable destinataire pour confirmer que la fonction de rappel renvoie le nom et le lien attendus. L’e-mail de test de l’éditeur remplace les tags dynamiques par leur valeur de remplacement ou une valeur vide sans exécuter votre fonction de rappel : il ne permet donc pas de vérifier le résultat propre au destinataire.

Renvoyez une valeur scalaire ou une chaîne vide depuis la fonction de rappel. MailerPress échappe les valeurs text pour le HTML et les valeurs url pour les URL. Un résultat non scalaire ou une exception produit un remplacement vide : assurez-vous que la fonction de rappel fonctionne pendant les envois planifiés.