MailChimpUtils.php

<?php
require 'MCAPI.class.php';

/**
 * Given a user, the name of a MailChimp list, and the MailChimp API credentials,
 * subscribe user to named list. <b>Will die() on any errors from MailChimp.</b>
 *
 * For the MailChimp API documentation pertinent to subscribing a user, see here:
 *  <a href="http://www.mailchimp.com/api/1.0/listsubscribe.func.php">MailChimp
 *  API</a>
 * 
 * @param array $user	Contains the information about the user to subscribe.  Keys:
 *                     'first_name'         => string; the user's first name
 *                     'last_name'          => string; the user's last name
 *                     'email'              => string; the user's email address
 *                     'format'  (optional) => string; list format preference,
 *																							        either 'html' or 'text'
 *                                             If not present, defaults to 'html'.
 *                     'confirm' (optional) => boolean; when true, send a
 *																							subscription confirmation.
 *                                              If not present, defaults to true.
 *
 * @param string $list_name     The name of the list to subscribe to.
 *
 * @param array $credentials    Contains the credentials for the MailChimp account
 *															 that owns the list.  Keys:
 *                               'user'              => string; MailChimp username
 *                               'pass'              => string; MailChimp password
 *
 * @return  boolean             Returns true if member subscribed to the list.
 */
function subscribe_user_to_list($user, $list_name, $credentials) {
  if (isset($credentials['apikey'])) {
    $credentials['user'] = $credentials['apikey'];    // With an API key, pass it as the first parameter to the MCAPI constructor.
  }

  $mc = new MCAPI($credentials['user']);

  $mc or die("Unable to connect to MailChimp API, error: ".$mc->errorMessage);

  $lists = $mc->lists() or die($mc->errorMessage);
  $list_id = null;


  foreach ($lists['data'] AS $list) { // Iterate, finding the list named $list_name
  if ($list['name'] == $list_name) {
    $list_id = $list['id'];
  }
}


	$list_id or die("Couldn't find a list named '$list_name'!");

  $retval = $mc->listSubscribe($list_id,
   $user['email'],
   array('FNAME' => $user['first_name'], 'LNAME' => $user['last_name']),
   isset($user['format']) ? $user['format'] : 'html',
   isset($user['confirm']) ? $user['confirm'] : true);

  ($retval or $mc->errorCode == 214 or preg_match("/already subscribed/i", $mc->errorMessage)) or
	 die("Unable to load listSubscribe()! ".
   "MailChimp reported error:\n\tCode=".$mc->errorCode.
   "\n\tMsg=".$mc->errorMessage."\n");

  return true;    // All's well.
}
?>