June 13, 2024

Campaign Archive Block for Mailchimp Plugin

Adds a block to show an archive for Mailchimp campaigns.

In order to be able to use the plugin, you have to get API credentials from Mailchimp. You can find them in the API keys section of your Mailchimp account. If you already use the plugin “Mailchimp” or “Mailchimp for WooCommence”, the API key from these will automatically be used.

The plugin allows you to show all campaigns from the connected Mailchimp account. You can show up to 100 campaign (this is a hard limit of the Mailchimp marketing API). For each campaign, you can either show the “Title” or the “Subject”. You can also show the author/sender as well as the send date (and time).

This is not an official Mailchimp plugin. Mailchimp® is a registered trademark of The Rocket Science Group.

Screenshots

The block in the editor with its settings to adjust the output of the block and the API key settings
The block before setting up the API key

FAQ

I get a warning telling me, that I have to set up API credentials!

In order to be able to use the plugin, you have to get API credentials from Mailchimp. You can find them in the API keys section of your Mailchimp account. You can also find a guide on how to “Generate your API key” in the Mailchimp Marketing API documentation. This API key have to be saved in the block settings.

I already use the plugin “Mailchimp” or “Mailchimp for WooCommence”, do I need to get a new API key?

If you have successfully connected one of the two plugins to your Mailchimp account, this plugin will automatically use the existing API key from those plugins, so you are good to go without any further configuration. You can still use another key in the block settings.

I’ve just sent a new campaign/newsletter, but it is not showing up!

For better front end performance the campaign archive ist cached for 60 minutes. You just have to wait one hour (at most) for the new campaign to show up. You can also change the cache curation using the cabfm_cache_minutes filter.

Changelog

2.2.0

Adding the two filters cabfm_campaigns_query_args and cabfm_campaigns_markup to enable changes on the queried or rendered campaigns.

2.1.0

If one of the plugins “Mailchimp” or “Mailchimp for WooComemrce” already has an API key, use this for the plugin as well
Reduce caching duration to 60 minutes and add the cabfm_cache_minutes filter to change this value

2.0.1

Migrate previously entered API keys into new block settings

2.0.0

Remove the settings page and use the block settings for the API key
Prepare the block to be listed in the block directory

1.0.3

Remove horizontal margin from the unordered list as well

1.0.2

Optimize frontend CSS and remove horizontal margin from the list

1.0.1

Remove function loading the translations from the plugin folder

1.0.0

First stable version