version = '1.3.6';
$this->name = 'Constant Contact';
$this->slug = 'constant-contact';
$this->priority = 14;
$this->icon = WPFORMS_PLUGIN_URL . 'assets/images/icon-provider-constant-contact.png';
if ( is_admin() ) {
// Admin notice requesting connecting.
$this->connect_request();
add_action( 'wpforms_admin_notice_dismiss_ajax', [ $this, 'connect_dismiss' ] );
add_filter( "wpforms_providers_provider_settings_formbuilder_display_content_default_screen_{$this->slug}", [ $this, 'builder_settings_default_content' ] );
// Provide option to override sign up link.
$sign_up = get_option( 'wpforms_constant_contact_signup', false );
if ( $sign_up ) {
$this->sign_up = esc_html( $sign_up );
}
}
}
/**
* Process and submit entry to provider.
*
* @since 1.3.6
*
* @param array $fields List of fields with their data and settings.
* @param array $entry Submitted entry values.
* @param array $form_data Form data and settings.
* @param int $entry_id Saved entry ID.
*
* @return void
*/
public function process_entry( $fields, $entry, $form_data, $entry_id = 0 ) {
// Only run if this form has a connections for this provider.
if ( empty( $form_data['providers'][ $this->slug ] ) ) {
return;
}
/*
* Fire for each connection.
*/
foreach ( $form_data['providers'][ $this->slug ] as $connection ) :
// Before proceeding make sure required fields are configured.
if ( empty( $connection['fields']['email'] ) ) {
continue;
}
// Setup basic data.
$list_id = $connection['list_id'];
$account_id = $connection['account_id'];
$email_data = explode( '.', $connection['fields']['email'] );
$email_id = $email_data[0];
$email = $fields[ $email_id ]['value'];
$this->api_connect( $account_id );
// Email is required and Access token are required.
if ( empty( $email ) || empty( $this->access_token ) ) {
continue;
}
// Check for conditionals.
$pass = $this->process_conditionals( $fields, $entry, $form_data, $connection );
if ( ! $pass ) {
wpforms_log(
'Constant Contact Subscription stopped by conditional logic',
$fields,
[
'type' => [ 'provider', 'conditional_logic' ],
'parent' => $entry_id,
'form_id' => $form_data['id'],
]
);
continue;
}
// Check to see if the lead already exists in Constant Contact.
$response = wp_remote_get( 'https://api.constantcontact.com/v2/contacts?api_key=' . $this->api_key . '&access_token=' . $this->access_token . '&email=' . $email );
$contact = json_decode( wp_remote_retrieve_body( $response ), true );
// Return early if there was a problem.
if ( isset( $contact['error_key'] ) ) {
wpforms_log(
'Constant Contact API Error',
$contact->get_error_message(),
[
'type' => [ 'provider', 'error' ],
'parent' => $entry_id,
'form_id' => $form_data['id'],
]
);
continue;
}
/*
* Setup Merge Vars
*/
$merge_vars = [];
foreach ( $connection['fields'] as $name => $merge_var ) {
// Don't include Email or Full name fields.
if ( 'email' === $name ) {
continue;
}
// Check if merge var is mapped.
if ( empty( $merge_var ) ) {
continue;
}
$merge_var = explode( '.', $merge_var );
$id = $merge_var[0];
$key = ! empty( $merge_var[1] ) ? $merge_var[1] : 'value';
// Check if mapped form field has a value.
if ( empty( $fields[ $id ][ $key ] ) ) {
continue;
}
$value = $fields[ $id ][ $key ];
// Constant Contact doesn't native URL field so it has to be
// stored in a custom field.
if ( $name === 'url' ) {
$merge_vars['custom_fields'] = [
[
'name' => 'custom_field_1',
'value' => $value,
],
];
continue;
}
// Constant Contact stores name in two fields, so we have to
// separate it.
if ( $name === 'full_name' ) {
$names = explode( ' ', $value );
if ( ! empty( $names[0] ) ) {
$merge_vars['first_name'] = $names[0];
}
if ( ! empty( $names[1] ) ) {
$merge_vars['last_name'] = $names[1];
}
continue;
}
// Constant Contact stores address in multiple fields, so we
// have to separate it.
if ( $name === 'address' ) {
// Only support Address fields.
if ( $fields[ $id ]['type'] !== 'address' ) {
continue;
}
// Postal code may be in extended US format.
$postal = [
'code' => '',
'subcode' => '',
];
if ( ! empty( $fields[ $id ]['postal'] ) ) {
$p = explode( '-', $fields[ $id ]['postal'] );
$postal['code'] = ! empty( $p[0] ) ? $p[0] : '';
$postal['subcode'] = ! empty( $p[1] ) ? $p[1] : '';
}
$merge_vars['addresses'] = [
[
'address_type' => 'BUSINESS',
'city' => ! empty( $fields[ $id ]['city'] ) ? $fields[ $id ]['city'] : '',
'country_code' => ! empty( $fields[ $id ]['country'] ) ? $fields[ $id ]['country'] : '',
'line1' => ! empty( $fields[ $id ]['address1'] ) ? $fields[ $id ]['address1'] : '',
'line2' => ! empty( $fields[ $id ]['address2'] ) ? $fields[ $id ]['address2'] : '',
'postal_code' => $postal['code'],
'state' => ! empty( $fields[ $id ]['state'] ) ? $fields[ $id ]['state'] : '',
'sub_postal_code' => $postal['subcode'],
],
];
continue;
}
$merge_vars[ $name ] = $value;
}
/*
* Process in API
*/
// If we have a previous contact, only update the list association.
if ( ! empty( $contact['results'] ) ) {
$data = $contact['results'][0];
// Check if they are already assigned to lists.
if ( ! empty( $data['lists'] ) ) {
foreach ( $data['lists'] as $list ) {
// If they are already assigned to this list, return early.
if ( isset( $list['id'] ) && (string) $list_id === (string) $list['id'] ) {
return;
}
}
// Otherwise, add them to the list.
$data['lists'][ count( $data['lists'] ) ] = [
'id' => $list_id,
'status' => 'ACTIVE',
];
} else {
// Add the contact to the list.
$data['lists'][0] = [
'id' => $list_id,
'status' => 'ACTIVE',
];
}
// Combine merge vars into data before sending.
$data = array_merge( $data, $merge_vars );
// Args to use.
$args = [
'body' => wp_json_encode( $data ),
'method' => 'PUT',
'headers' => [
'Content-Type' => 'application/json',
],
];
$update = wp_remote_request( 'https://api.constantcontact.com/v2/contacts/' . $data['id'] . '?api_key=' . $this->api_key . '&access_token=' . $this->access_token . '&action_by=ACTION_BY_VISITOR', $args );
$res = json_decode( wp_remote_retrieve_body( $update ), true );
} else {
// Add a new contact.
$data = [
'email_addresses' => [ [ 'email_address' => $email ] ],
'lists' => [ [ 'id' => $list_id ] ],
];
// Combine merge vars into data before sending.
$data = array_merge( $data, $merge_vars );
// Args to use.
$args = [
'body' => wp_json_encode( $data ),
'headers' => [
'Content-Type' => 'application/json',
],
];
$add = wp_remote_post( 'https://api.constantcontact.com/v2/contacts?api_key=' . $this->api_key . '&access_token=' . $this->access_token . '&action_by=ACTION_BY_VISITOR', $args );
$res = json_decode( wp_remote_retrieve_body( $add ), true );
}
// Check for errors.
if ( isset( $res['error_key'] ) ) {
wpforms_log(
'Constant Contact API Error',
$res->get_error_message(),
[
'type' => [ 'provider', 'error' ],
'parent' => $entry_id,
'form_id' => $form_data['id'],
]
);
}
endforeach;
}
/************************************************************************
* API methods - these methods interact directly with the provider API. *
************************************************************************/
/**
* Authenticate with the API.
*
* @since 1.3.6
*
* @param array $data Contact data.
* @param string $form_id Form ID.
*
* @return WP_Error|string Unique ID or error object
*/
public function api_auth( $data = [], $form_id = '' ) {
$this->access_token = isset( $data['authcode'] ) ? $data['authcode'] : '';
$user = $this->get_account_information();
if ( is_wp_error( $user ) ) {
return $user;
}
$id = uniqid();
wpforms_update_providers_options(
$this->slug,
[
'access_token' => sanitize_text_field( $data['authcode'] ),
'label' => sanitize_text_field( $data['label'] ),
'date' => time(),
],
$id
);
return $id;
}
/**
* Get account information.
*
* @since 1.7.6
*
* @return array|WP_Error
*/
public function get_account_information() {
$response = wp_remote_get( 'https://api.constantcontact.com/v2/account/info?api_key=' . $this->api_key . '&access_token=' . $this->access_token );
if ( is_wp_error( $response ) ) {
return $response;
}
$user = json_decode( wp_remote_retrieve_body( $response ), true );
if ( ! empty( $user[0]['error_key'] ) ) {
$message = ! empty( $user[0]['error_message'] ) ? $user[0]['error_message'] : '';
return new WP_Error( $this->slug . '_error', $message );
}
return $response;
}
/**
* Establish connection object to API.
*
* @since 1.3.6
*
* @param string $account_id
*
* @return mixed array or error object.
*/
public function api_connect( $account_id ) {
if ( ! empty( $this->api[ $account_id ] ) ) {
return $this->api[ $account_id ];
} else {
$providers = wpforms_get_providers_options();
if ( ! empty( $providers[ $this->slug ][ $account_id ] ) ) {
$this->api[ $account_id ] = true;
$this->access_token = $providers[ $this->slug ][ $account_id ]['access_token'];
} else {
return $this->error( 'API error' );
}
}
}
/**
* Retrieve provider account lists.
*
* @since 1.3.6
*
* @param string $connection_id
* @param string $account_id
*
* @return mixed array or error object
*/
public function api_lists( $connection_id = '', $account_id = '' ) {
$this->api_connect( $account_id );
$request = wp_remote_get( 'https://api.constantcontact.com/v2/lists?api_key=' . $this->api_key . '&access_token=' . $this->access_token );
$lists = json_decode( wp_remote_retrieve_body( $request ), true );
if ( empty( $lists ) ) {
wpforms_log(
'Constant Contact API Error',
'',
[
'type' => [ 'provider', 'error' ],
]
);
return $this->error( esc_html__( 'API list error: Constant API error', 'wpforms-lite' ) );
}
return $lists;
}
/**
* Retrieve provider account list fields.
*
* @since 1.3.6
*
* @param string $connection_id
* @param string $account_id
* @param string $list_id
*
* @return mixed array or error object
*/
public function api_fields( $connection_id = '', $account_id = '', $list_id = '' ) {
$provider_fields = [
[
'name' => 'Email',
'field_type' => 'email',
'req' => '1',
'tag' => 'email',
],
[
'name' => 'Full Name',
'field_type' => 'name',
'tag' => 'full_name',
],
[
'name' => 'First Name',
'field_type' => 'first',
'tag' => 'first_name',
],
[
'name' => 'Last Name',
'field_type' => 'last',
'tag' => 'last_name',
],
[
'name' => 'Phone',
'field_type' => 'text',
'tag' => 'work_phone',
],
[
'name' => 'Website',
'field_type' => 'text',
'tag' => 'url',
],
[
'name' => 'Address',
'field_type' => 'address',
'tag' => 'address',
],
[
'name' => 'Job Title',
'field_type' => 'text',
'tag' => 'job_title',
],
[
'name' => 'Company',
'field_type' => 'text',
'tag' => 'company_name',
],
];
return $provider_fields;
}
/*************************************************************************
* Output methods - these methods generally return HTML for the builder. *
*************************************************************************/
/**
* Provider account authorize fields HTML.
*
* @since 1.3.6
*
* @return string
*/
public function output_auth() {
$providers = wpforms_get_providers_options();
$class = ! empty( $providers[ $this->slug ] ) ? 'hidden' : '';
ob_start();
?>
%s',
esc_url( admin_url( 'admin.php?page=wpforms-page&view=constant-contact' ) ),
esc_html__( 'Learn more about the power of email marketing.', 'wpforms-lite' )
);
?>
slug ) {
return;
}
// phpcs:ignore WordPress.Security.NonceVerification, WordPress.Security.ValidatedSanitizedInput
$data = ! empty( $_POST['data'] ) ? wp_parse_args( wp_unslash( $_POST['data'] ), [] ) : [];
if ( empty( $data['authcode'] ) ) {
wp_send_json_error(
[
'error_msg' => esc_html__( 'The "Authorization Code" is required.', 'wpforms-lite' ),
]
);
}
if ( empty( $data['label'] ) ) {
wp_send_json_error(
[
'error_msg' => esc_html__( 'The "Account Nickname" is required.', 'wpforms-lite' ),
]
);
}
parent::integrations_tab_add();
}
/**
* Form fields to add a new provider account.
*
* @since 1.3.6
*/
public function integrations_tab_new_form() {
?>
',
esc_attr( $this->name ),
esc_attr__( 'Authorization Code', 'wpforms-lite' )
);
printf(
'
WPForms plugin — use it with an active Constant Contact account.', 'wpforms-lite' ),
[
'strong' => [],
]
);
?>
power of email marketing', 'wpforms-lite' ),
esc_url( $learn_more )
),
[
'a' => [
'href' => [],
],
]
);
?>
\WPForms\Admin\Notice::DISMISS_GLOBAL,
'slug' => 'constant_contact_connect',
'autop' => false,
'class' => 'wpforms-constant-contact-notice',
]
);
}
/**
* Dismiss the Constant Contact admin notice.
*
* @since 1.3.6
* @since 1.6.7.1 Added parameter $notice_id.
*
* @param string $notice_id Notice ID (slug).
*/
public function connect_dismiss( $notice_id = '' ) {
if ( $notice_id !== 'global-constant_contact_connect' ) {
return;
}
delete_option( 'wpforms_constant_contact' );
wp_send_json_success();
}
}
new WPForms_Constant_Contact();