<?php
/**
 * Class to interact with the constant contact API
 * This class enables you to easily subscribe and unsubscribe members
 *
 * PHP versions 4 and 5
 *
 *
 * NOTE: 
 * Please visit http://www.constantcontact.com to register for a constant contact account.
 * Developers are required to go through Constant Contact (support@constantContact.com) to get access to the Constant Contact APIs (Specifically, developers are required to accept the API usage terms and conditions).
 *
 *
 * @package                ConstantContact
 * @license                http://www.php.net/license/3_01.txt PHP License 3.01
 * @author                 James Benson
 * @link                   http://www.jamesbenson.co.uk
 * @see                    http://www.constantcontact.com
 */


/**
 * Class to interact with the constant contact API
 * This class enables you to easily subscribe and unsubscribe members
 *
 *
 *
 *
 *
 * @package                ConstantContact
 * @license                http://www.php.net/license/3_01.txt PHP License 3.01
 * @author                 James Benson
 * @link                   http://www.jamesbenson.co.uk
 * @see                    http://www.constantcontact.com
 */
class ConstantContact {

    /**
     * API URL used to subscribe
     *
     * @var        string
     */
    var $add_subscriber_url = "http://ui.constantcontact.com/roving/wdk/API_AddSiteVisitor.jsp";
    
    /**
     * API URL used to unsubscribe
     *
     * @var        string
     */
    var $remove_subscriber_url = 'http://ui.constantcontact.com/roving/wdk/API_UnsubscribeSiteVisitor.jsp';
    
    /**
     * Your CC account username
     *
     * @var        string
     */
    var $_username = '';
    
    /**
     * Your CC account password
     *
     * @var        string
     */
    var $_password = '';
    
    /**
     * The category to subscribe a member to
     *
     * @var        string
     */
    var $_category = '';
	
	
    /**
     * Sets the username used to access the CC API
     *
	 * @param    string    The username for your CC account
     */
    function setUsername($username)
    {
        $this->username = $username;
    }
    
    
    /**
     * Sets the password used to access the CC API
     *
	 * @param    string    The password for your CC account
     */
    function setPassword($password)
    {
        $this->password = $password;
    }
    
    
    /**
     * Sets the category used to add subscribers into
     *
	 * @param    string    The interest category subscribers are added to
     */
    function setCategory($category)
    {
        $this->category = $category;
    }
    
    
    /**
     * Get the username used to access the CC API
     *
     */
    function getUsername()
    {
        return urlencode($this->username);
    }
    
    
    /**
     * Get the password used to access the CC API
     *
     */
    function getPassword()
    {
        return urlencode($this->password);
    }
    
    
    /**
     * Get the interest category
     *
     */
    function getCategory()
    {
        return urlencode($this->category);
    }
	
    
    /**
     * Add a subscriber to your constant contact account, can be used to update their details too
     *
	 *
	 * @param     string    The email to subscribe
	 * @param     array     An array of extra fields to pass to CC, see docs for possible values
	 * @return    bool      true on success false on failure
     */
    function add($email, $extra_fields = array())
    {
        $email = urlencode(strip_tags($email));
        
        $data = 'loginName=' . $this->getUsername();
        $data .= '&loginPassword=' . $this->getPassword();
        $data .= '&ea=' . $email;
        $data .= '&ic=' . $this->getCategory();
		
		if(is_array($extra_fields)):
		    foreach($extra_fields as $k => $v):
                $data .= "&" . urlencode(strip_tags($k)) . "=" . urlencode(strip_tags($v));
		    endforeach;
        endif;
		
        return $this->_send($data, $this->add_subscriber_url);
    }
    
    
    /**
     * Remove a subscriber from your constant contact account
     *
	 *
	 * @param     string    The email to unsubscribe
	 * @return    bool      true on success false on failure
     */
    function remove($email)
    {
        $email = urlencode(strip_tags($email));
        
        $data = 'loginName=' . $this->getUsername();
        $data .= '&loginPassword=' . $this->getPassword();
        $data .= '&ea=' . $email;
        
        return $this->_send($data, $this->remove_subscriber_url);
    }
    
    
    /**
     * Method used to send the data to the CC server
     *
     * @access        private
     */
    function _send($data, $url)
    {	
		if(!function_exists('fopen')):
			exit("fopen function does not exist");
		endif;
		
		if(!ini_get('allow_url_fopen')):
			exit("allow_url_fopen is not enabled in your php config file");
		endif;
		
        $handle = fopen("$url?$data", "rb");
        $contents = '';
		
        while (!feof($handle)) {
            $contents .= fread($handle, 192);
        }
		
        fclose($handle);
		
		if(trim($contents) == 0):
			return true;
		endif;
		
		return false;
    }


// ENDOF class
}

?>