mailerpress icon black white

Documentation

Comment afficher vos newsletters envoyées avec le shortcode d’archive de campagne

Prérequis

Le shortcode [mailerpress_archive] vous permet d’afficher la liste de toutes vos campagnes envoyees directement sur n’importe quelle page ou article de votre site WordPress. C’est ideal pour creer une page d’archives publique ou vos visiteurs peuvent consulter et lire vos anciens emails.

Le shortcode fonctionne avec n’importe quel constructeur de pages WordPress, l’editeur de blocs ou directement dans vos templates PHP.

Mise en place rapide

Ajoutez simplement le shortcode suivant dans n’importe quelle page ou article :

[mailerpress_archive]

Cela affichera toutes vos campagnes envoyees, triees par date (les plus recentes en premier).

Parametres

ParametreDescriptionExemple
yearFiltrer les campagnes par annee. Laisser vide pour afficher toutes les annees.year="2025"
limitNombre maximum de campagnes a afficher. Utilisez -1 pour tout afficher (par defaut).limit="10"
orderOrdre de tri par date. DESC pour les plus recentes en premier (par defaut), ASC pour les plus anciennes en premier.order="ASC"

Exemples courants

Afficher toutes les campagnes envoyees (par defaut)

[mailerpress_archive]

Afficher uniquement les campagnes de 2025

[mailerpress_archive year="2025"]

Afficher les 5 campagnes les plus recentes

[mailerpress_archive limit="5"]

Afficher les 10 campagnes les plus anciennes en premier

[mailerpress_archive limit="10" order="ASC"]

Afficher toutes les campagnes de 2024, les plus anciennes en premier

[mailerpress_archive year="2024" order="ASC"]

Integration en PHP

Vous pouvez egalement utiliser le shortcode directement dans vos templates PHP :

echo do_shortcode('[mailerpress_archive limit="10"]');

Ou avec plusieurs parametres :

echo do_shortcode('[mailerpress_archive year="2025" limit="5" order="DESC"]');

Rendu

Le shortcode genere une liste stylisee ou chaque element affiche :

  • Le nom de la campagne (avec un lien vers la version publique de l’email, s’ouvre dans un nouvel onglet)
  • La date d’envoi (formatee selon les reglages de date de votre WordPress)

Si aucune campagne envoyee n’est trouvee, le message « No campaigns found. » est affiche.

Classes CSS

Le shortcode inclut un style minimal et propre. Vous pouvez personnaliser l’apparence en utilisant les classes CSS suivantes :

Classe CSSElement
.mp-archive-listLe conteneur <ul> de la liste des campagnes
.mp-archive-itemChaque entree <li> de campagne
.mp-archive-linkLe lien <a> englobant chaque campagne
.mp-archive-nameLe <span> contenant le nom de la campagne
.mp-archive-dateLe <span> contenant la date d’envoi
.mp-archive-emptyLe <p> affiche lorsqu’aucune campagne n’est trouvee

Important

  • Seules les campagnes avec le statut « sent » (envoyee) sont affichees. Les brouillons et les campagnes programmees ne sont pas inclus.
  • Le parametre order accepte uniquement ASC ou DESC. Toute autre valeur sera remplacee par DESC.
  • Le parametre year doit etre une valeur numerique (ex : 2025).
  • Les liens des campagnes s’ouvrent dans un nouvel onglet du navigateur.
  • Le format de date suit la configuration de votre WordPress dans Reglages > General > Format de date.