Skip to content

Latest commit

 

History

History
73 lines (58 loc) · 3.43 KB

README.md

File metadata and controls

73 lines (58 loc) · 3.43 KB

CF MailChimp

ColdFusion wrapper for the MailChimp 3.0 API

Work in Progress

This wrapper is a work in progress. I have prioritized building out the features needed for my projects. If there is a feature that you would like added, please open an issue or submit a pull request.

List of available methods

  • getLists - Retrieves all lists in the account
  • getList - Retrieves information about the specified list
  • getListMembers - Retrieves a list of all members of the specified list
  • getListMember - Retrieves details on a single member of the specified list
  • putListMembers - Uses a batch operation to add or update multiple members of the specified list
  • putListMember - Adds or updates a single member to the specified list
  • getMemberIdFromEmail - Generates the member ID, the MD5 hash of the email address
  • getGroups - Retrieves a list of all interest groups of the specified list
  • getGroup - Retrieves details on a single interest group of the specified list
  • getInterests - Retrieves a list of all interests in the specified group
  • getInterest - Retrieves details on a single interest in the specified group

Requirements

I have only tested on Adobe ColdFusion 11. I am confident that the wrapper will work in Lucee/Railo 4. It may work in ACF 10 and will NOT work in ACF 9-.

JSONUtil Dependency

CF MailChimp uses the JSONUtil library for JSON serialization/deserialization instead of ColdFusion's built-in serializer. MailChimp's API will reject data being sent as a boolean or numeric value when it is expecting a string. CF's serializer frequently and silently converts variable types and cannot be controlled.

If you put JSONUtil.cfc in the same folder as mailchimp.cfc, it will be found automatically.
If you want to keep JSONUtil.cfc in a different folder, then add the argument jsonUtil to your init, and pass it the normal ColdFusion dot-delimited path to the component.

If JSONUtil.cfc cannot be found, CF MailChimp will fall back to using ColdFusion's built-in serializer.

Community

Want to contribute to CF MailChimp? Awesome! See CONTRIBUTING for more information.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct to ensure that this project is a welcoming place for everyone to contribute to. By participating in this project you agree to abide by its terms.

Usage

mc = new mailchimp(
	apiKey = "YOURAPIKEY",	// see http://kb.mailchimp.com/accounts/management/about-api-keys
	serviceURL = "https://us1.api.mailchimp.com/3.0/",
	debug = true			// note debug setting
);

lists = mc.getLists();

newMember = mc.putListMember(
	listId = "YOURLISTID",	// see http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id
	data = {
		"email_address" = "[email protected]",
		"status" = "subscribed",
		"merge_fields" = {
			"FNAME" = "Hey",
			"Now" = "Finley",
			"COMPANY" = "Acme"
		}
	}
);

Resources

Contributors

This project is based on previous work by others. See CONTRIBUTORS for details.

License

This repository is licensed under the GNU Lesser General Public License v2.1. See LICENSE for details.