Download the PHP package atomicsmash/ultimate-mailchimp-plugin without Composer

On this page you can find all versions of the php package atomicsmash/ultimate-mailchimp-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package ultimate-mailchimp-plugin

Ultimate MailChimp Plugin - v0.0.1

WooCommerce MailChimp signups

This plugin may break your site 💀 or even MailChimp account 💀💀💀. Please only use in development environments.

What does this plugin actually do?

On almost all of the WordPress sites that Atomic Smash create and maintain, we do some form of MailChimp syncing. Most existing plugins rely on the need to record information within WP to then sync with MailChimp at a later point.

We found this can become very cumbersome. List members are able to interact with MailChimp outside of the website via the list communication preferences (or even by just unsubscribing from the list). This boils down to a member being able to change there details without your WP site being involved. Of course, you can setup webhooks to notify your site when a change is made via MailChimp blah blah blah... BUT... Just keep it simple. Maintain MailChimp as the 'single source of truth' and forgot about needing to keep subscription preferences in line with the WP site.

Thanks to this separation, WordPress and MailChimp are completable replaceable in the future.

When does this plugin talk to MailChimp?

This plugin communicates with MailChimp at these points:

More points of interaction will be added in the future.

Know of another time you would like to talk to MailChimp? Please add an issue! 😉

Sign up form

Users will be shown a description of what MailChimp does as a marketing platform, then .. CHECKBOX OPTIONS

All of this text in editable via the available via these filters. 😎

Features

Complete site setup

Step 1 - Add project to your composer file

Run this in the root of your project:

Step 2 - Add configs

Add these config details to your wp-config.php

ULTIMATE_MAILCHIMP_LIST_ID - This is the list you would sync with. This can be found here.

ULTIMATE_MAILCHIMP_API_KEY - This is your key can be found in your account.

ULTIMATE_MAILCHIMP_GDPR_FIELDS -

Step 3 - Enable double opt-in in your MailChimp list (encouraged)

By default, when someone checks the "Sign me up to the MailChimp newsletter", the subscriber status is set to 'pending'. This will trigger a confirmation email from MailChimp.

To make sure this functionality is active, go to your primary list > Settings > 'List name and campaign' and check the "Enable double opt-in" checkbox and save. Like this

Step 4 - GDPR fields

MailChimp have added a series of 'marketing permission' (GDPR) fields to it's API. To be able to interact with these, we need a few pieces of information.

Other Config

Here are some extra config options. We would recommend only using these in a development or testing environment.

ULTIMATE_MAILCHIMP_LOGGING - This enables logging to the file: wp-content/uploads/ultimate-mailchimp.log via monolog.

ULTIMATE_MAILCHIMP_DEBUG - When in debug mode, WooCommerce checkout will not complete (There will be a JSON error) yet MailChimp will be called. This allows you to run through the checkout process without having to create a new order each time.

ULTIMATE_MAILCHIMP_DOUBLE_OPTIN - If you would like to disable the double opt-in and force the new users to be subscribed by default on sync, add this constant to your config and set to false.

Merge fields

These merge fields are sent by default are:

To edit the merge fields sent to MailChimp, use the merge field filter here.

All available filters

View filters here

Upcoming features

All versions of ultimate-mailchimp-plugin with dependencies

PHP Build Version
Package Version
Requires drewm/mailchimp-api Version *
monolog/monolog Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package atomicsmash/ultimate-mailchimp-plugin contains the following files

Loading the files please wait ....