wordpress-mailchimp-tools
MailChimp Tools for WordPress
What is this?
This project aims to provide a simple set of tools for author MailChimp Campaigns via the WordPress post editor.
Right now, it provides:
- A settings panel to add/save your MailChimp API Key.
- A campaign editor meta box.
- A campaign preview meta box.
- A settings panel for setting campaign defaults on a per-post-type basis.
Getting started
This tool set is not a plugin. You won’t see it available in the WordPress dashboard for activation.
You must include the library in your plugin.
You can add the tools via Composer:
composer require inn/wordpress-mailchimp-tools:dev-master
A simple example
require_once __DIR__ . '/vendor/autoload.php';
function my_plugin_init() {
register_post_type('newsletter', array(
'label' => 'Newsletter',
'labels' => array(
'name' => 'Newsletters',
'singular_name' => 'Newsletter'
),
'show_ui' => true,
'public' => true
));
}
add_action( 'init', 'my_plugin_init' );
Templates
The campaign editor relies on an mc:edit="body"
editable content area specified in whatever template you use.
When creating or updating a campaign, the tools will add the WordPress post’s body to the element of your template that has the mc:edit="body"
attribute.
A simple-one-column.html
with the mc:edit="body"
placemarker is included in the templates/
directory. You can copy the contents on simple-one-column.html
and use MailChimp’s template importer to add the template to your account.
Read more about MailChimp’s templates here.
Set default content for your post type
You can use the default_content
filter to load boilerplate markup into the post editor for your custom post type:
function my_default_content($content) {
$screen = $screen = get_current_screen();
if ( $screen->post_type == 'newsletter' ) {
$default_content = file_get_contents( __DIR__ . '/templates/my-newsletter-default-markup.html' );
return $default_content;
}
return $content;
}
add_filter( 'default_content', 'my_default_content' );