Your IP : 216.73.216.162
class-base.php 0000666 00000102364 15113376406 0007312 0 ustar 00 <?php
/**
* Provider class.
*
* @package WPForms
* @author WPForms
* @since 1.0.0
* @license GPL-2.0+
* @copyright Copyright (c) 2016, WPForms LLC
*/
abstract class WPForms_Provider {
/**
* Provider addon version.
*
* @since 1.0.0
*
* @var string
*/
protected $version;
/**
* Provider name.
*
* @since 1.0.0
*
* @var string
*/
public $name;
/**
* Provider name in slug format.
*
* @since 1.0.0
*
* @var string
*/
public $slug;
/**
* Load priority.
*
* @since 1.0.0
*
* @var int
*/
public $priority = 10;
/**
* Holds the API connections.
*
* @since 1.0.0
*
* @var mixed
*/
public $api = false;
/**
* Service icon.
*
* @since 1.0.0
*
* @var string
*/
public $icon;
/**
* Service icon.
*
* @since 1.2.3
*
* @var string
*/
public $type;
/**
* Form data and settings.
*
* @since 1.2.3
*
* @var array
*/
public $form_data;
/**
* Primary class constructor.
*
* @since 1.0.0
*/
public function __construct() {
$this->type = esc_html__( 'Connection', 'wpforms-lite' );
$this->init();
// Add to list of available providers.
add_filter( 'wpforms_providers_available', array( $this, 'register_provider' ), $this->priority, 1 );
// Process builder AJAX requests.
add_action( "wp_ajax_wpforms_provider_ajax_{$this->slug}", array( $this, 'process_ajax' ) );
// Process entry.
add_action( 'wpforms_process_complete', array( $this, 'process_entry' ), 5, 4 );
// Fetch and store the current form data when in the builder.
add_action( 'wpforms_builder_init', array( $this, 'builder_form_data' ) );
// Output builder sidebar.
add_action( 'wpforms_providers_panel_sidebar', array( $this, 'builder_sidebar' ), $this->priority );
// Output builder content.
add_action( 'wpforms_providers_panel_content', array( $this, 'builder_output' ), $this->priority );
// Remove provider from Settings Integrations tab.
add_action( 'wp_ajax_wpforms_settings_provider_disconnect', array( $this, 'integrations_tab_disconnect' ) );
// Add new provider from Settings Integrations tab.
add_action( 'wp_ajax_wpforms_settings_provider_add', array( $this, 'integrations_tab_add' ) );
// Add providers sections to the Settings Integrations tab.
add_action( 'wpforms_settings_providers', array( $this, 'integrations_tab_options' ), $this->priority, 2 );
}
/**
* All systems go. Used by subclasses.
*
* @since 1.0.0
*/
public function init() {
}
/**
* Add to list of registered providers.
*
* @since 1.0.0
*
* @param array $providers Array of all active providers.
*
* @return array
*/
public function register_provider( $providers = array() ) {
$providers[ $this->slug ] = $this->name;
return $providers;
}
/**
* Process the Builder AJAX requests.
*
* @since 1.0.0
*/
public function process_ajax() {
// Run a security check.
check_ajax_referer( 'wpforms-builder', 'nonce' );
// Check for permissions.
if ( ! wpforms_current_user_can() ) {
wp_send_json_error(
array(
'error' => esc_html__( 'You do not have permission', 'wpforms-lite' ),
)
);
}
$name = ! empty( $_POST['name'] ) ? sanitize_text_field( wp_unslash( $_POST['name'] ) ) : '';
$task = ! empty( $_POST['task'] ) ? sanitize_text_field( wp_unslash( $_POST['task'] ) ) : '';
$id = ! empty( $_POST['id'] ) ? sanitize_text_field( wp_unslash( $_POST['id'] ) ) : '';
$connection_id = ! empty( $_POST['connection_id'] ) ? sanitize_text_field( wp_unslash( $_POST['connection_id'] ) ) : '';
$account_id = ! empty( $_POST['account_id'] ) ? sanitize_text_field( wp_unslash( $_POST['account_id'] ) ) : '';
$list_id = ! empty( $_POST['list_id'] ) ? sanitize_text_field( wp_unslash( $_POST['list_id'] ) ) : '';
$data = ! empty( $_POST['data'] ) ? array_map( 'sanitize_text_field', wp_parse_args( wp_unslash( $_POST['data'] ) ) ) : array(); //phpcs:ignore
/*
* Create new connection.
*/
if ( 'new_connection' === $task ) {
$connection = $this->output_connection(
'',
array(
'connection_name' => $name,
),
$id
);
wp_send_json_success(
array(
'html' => $connection,
)
);
}
/*
* Create new Provider account.
*/
if ( 'new_account' === $task ) {
$auth = $this->api_auth( $data, $id );
if ( is_wp_error( $auth ) ) {
wp_send_json_error(
array(
'error' => $auth->get_error_message(),
)
);
} else {
$accounts = $this->output_accounts(
$connection_id,
array(
'account_id' => $auth,
)
);
wp_send_json_success(
array(
'html' => $accounts,
)
);
}
}
/*
* Select/Toggle Provider accounts.
*/
if ( 'select_account' === $task ) {
$lists = $this->output_lists(
$connection_id,
array(
'account_id' => $account_id,
)
);
if ( is_wp_error( $lists ) ) {
wp_send_json_error(
array(
'error' => $lists->get_error_message(),
)
);
} else {
wp_send_json_success(
array(
'html' => $lists,
)
);
}
}
/*
* Select/Toggle Provider account lists.
*/
if ( 'select_list' === $task ) {
$fields = $this->output_fields(
$connection_id,
array(
'account_id' => $account_id,
'list_id' => $list_id,
),
$id
);
if ( is_wp_error( $fields ) ) {
wp_send_json_error(
array(
'error' => $fields->get_error_message(),
)
);
} else {
$groups = $this->output_groups(
$connection_id,
array(
'account_id' => $account_id,
'list_id' => $list_id,
)
);
$conditionals = $this->output_conditionals(
$connection_id,
array(
'account_id' => $account_id,
'list_id' => $list_id,
),
array(
'id' => absint( $_POST['form_id'] ), //phpcs:ignore
)
);
$options = $this->output_options(
$connection_id,
array(
'account_id' => $account_id,
'list_id' => $list_id,
)
);
wp_send_json_success(
array(
'html' => $groups . $fields . $conditionals . $options,
)
);
}
}
die();
}
/**
* Process and submit entry to provider.
*
* @since 1.0.0
*
* @param array $fields List of fields in a form.
* @param array $entry Submitted entry values.
* @param array $form_data Form data and settings.
* @param int $entry_id Saved entry ID.
*/
public function process_entry( $fields, $entry, $form_data, $entry_id ) {
}
/**
* Process conditional fields.
*
* @since 1.0.0
*
* @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 array $connection List of connection settings.
*
* @return bool
*/
public function process_conditionals( $fields, $entry, $form_data, $connection ) {
if ( empty( $connection['conditional_logic'] ) || empty( $connection['conditionals'] ) ) {
return true;
}
$process = wpforms_conditional_logic()->process( $fields, $form_data, $connection['conditionals'] );
if ( ! empty( $connection['conditional_type'] ) && 'stop' === $connection['conditional_type'] ) {
$process = ! $process;
}
return $process;
}
/**
* Retrieve all available forms in a field.
*
* Not all fields should be available for merge tags so we compare against a
* white-list. Also some fields, such as Name, should have additional
* variations.
*
* @since 1.0.0
*
* @param object|bool $form
* @param array $whitelist
*
* @return bool|array
*/
public function get_form_fields( $form = false, $whitelist = array() ) {
// Accept form (post) object or form ID.
if ( is_object( $form ) ) {
$form = wpforms_decode( $form->post_content );
} elseif ( is_numeric( $form ) ) {
$form = wpforms()->form->get(
$form,
array(
'content_only' => true,
)
);
}
if ( ! is_array( $form ) || empty( $form['fields'] ) ) {
return false;
}
// White list of field types to allow.
$allowed_form_fields = array(
'text',
'textarea',
'select',
'radio',
'checkbox',
'email',
'address',
'url',
'name',
'hidden',
'date-time',
'phone',
'number',
);
$allowed_form_fields = apply_filters( 'wpforms_providers_fields', $allowed_form_fields );
$whitelist = ! empty( $whitelist ) ? $whitelist : $allowed_form_fields;
$form_fields = $form['fields'];
foreach ( $form_fields as $id => $form_field ) {
if ( ! in_array( $form_field['type'], $whitelist, true ) ) {
unset( $form_fields[ $id ] );
}
}
return $form_fields;
}
/**
* Get form fields ready for select list options.
*
* In this function we also do the logic to limit certain fields to certain
* provider field types.
*
* @since 1.0.0
*
* @param array $form_fields
* @param string $form_field_type
*
* @return array
*/
public function get_form_field_select( $form_fields = array(), $form_field_type = '' ) {
if ( empty( $form_fields ) || empty( $form_field_type ) ) {
return array();
}
$formatted = array();
// Include only specific field types.
foreach ( $form_fields as $id => $form_field ) {
// Email.
if (
'email' === $form_field_type &&
! in_array( $form_field['type'], array( 'text', 'email' ), true )
) {
unset( $form_fields[ $id ] );
}
// Address.
if (
'address' === $form_field_type &&
! in_array( $form_field['type'], array( 'address' ), true )
) {
unset( $form_fields[ $id ] );
}
}
// Format.
foreach ( $form_fields as $id => $form_field ) {
// Complex Name field.
if ( 'name' === $form_field['type'] ) {
// Full Name.
$formatted[] = array(
'id' => $form_field['id'],
'key' => 'value',
'type' => $form_field['type'],
'subtype' => '',
'provider_type' => $form_field_type,
'label' => sprintf(
/* translators: %s - Name field label. */
esc_html__( '%s (Full)', 'wpforms-lite' ),
$form_field['label']
),
);
// First Name.
if ( strpos( $form_field['format'], 'first' ) !== false ) {
$formatted[] = array(
'id' => $form_field['id'],
'key' => 'first',
'type' => $form_field['type'],
'subtype' => 'first',
'provider_type' => $form_field_type,
'label' => sprintf(
/* translators: %s - Name field label. */
esc_html__( '%s (First)', 'wpforms-lite' ),
$form_field['label']
),
);
}
// Middle Name.
if ( strpos( $form_field['format'], 'middle' ) !== false ) {
$formatted[] = array(
'id' => $form_field['id'],
'key' => 'middle',
'type' => $form_field['type'],
'subtype' => 'middle',
'provider_type' => $form_field_type,
'label' => sprintf(
/* translators: %s - Name field label. */
esc_html__( '%s (Middle)', 'wpforms-lite' ),
$form_field['label']
),
);
}
// Last Name.
if ( strpos( $form_field['format'], 'last' ) !== false ) {
$formatted[] = array(
'id' => $form_field['id'],
'key' => 'last',
'type' => $form_field['type'],
'subtype' => 'last',
'provider_type' => $form_field_type,
'label' => sprintf(
/* translators: %s - Name field label. */
esc_html__( '%s (Last)', 'wpforms-lite' ),
$form_field['label']
),
);
}
} else {
// All other fields.
$formatted[] = array(
'id' => $form_field['id'],
'key' => 'value',
'type' => $form_field['type'],
'subtype' => '',
'provider_type' => $form_field_type,
'label' => $form_field['label'],
);
}
}
return $formatted;
}
/************************************************************************
* API methods - these methods interact directly with the provider API. *
************************************************************************/
/**
* Authenticate with the provider API.
*
* @since 1.0.0
*
* @param array $data
* @param string $form_id
*
* @return mixed id or error object
*/
public function api_auth( $data = array(), $form_id = '' ) {
}
/**
* Establish connection object to provider API.
*
* @since 1.0.0
*
* @param string $account_id
*
* @return mixed array or error object
*/
public function api_connect( $account_id ) {
}
/**
* Retrieve provider account lists.
*
* @since 1.0.0
*
* @param string $connection_id
* @param string $account_id
*
* @return mixed array or error object
*/
public function api_lists( $connection_id = '', $account_id = '' ) {
}
/**
* Retrieve provider account list groups.
*
* @since 1.0.0
*
* @param string $connection_id
* @param string $account_id
* @param string $list_id
*
* @return mixed array or error object
*/
public function api_groups( $connection_id = '', $account_id = '', $list_id = '' ) {
}
/**
* Retrieve provider account list fields.
*
* @since 1.0.0
*
* @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 = '' ) {
}
/*************************************************************************
* Output methods - these methods generally return HTML for the builder. *
*************************************************************************/
/**
* Connection HTML.
*
* This method compiles all the HTML necessary for a connection to a provider.
*
* @since 1.0.0
*
* @param string $connection_id
* @param array $connection
* @param mixed $form Form id or form data.
*
* @return string
*/
public function output_connection( $connection_id = '', $connection = array(), $form = '' ) {
if ( empty( $connection_id ) ) {
$connection_id = 'connection_' . uniqid();
}
if ( empty( $connection ) || empty( $form ) ) {
return '';
}
$output = sprintf( '<div class="wpforms-provider-connection" data-provider="%s" data-connection_id="%s">', $this->slug, $connection_id );
$output .= $this->output_connection_header( $connection_id, $connection );
$output .= $this->output_auth();
$output .= $this->output_accounts( $connection_id, $connection );
$lists = $this->output_lists( $connection_id, $connection );
$output .= ! is_wp_error( $lists ) ? $lists : '';
$output .= $this->output_groups( $connection_id, $connection );
$fields = $this->output_fields( $connection_id, $connection, $form );
$output .= ! is_wp_error( $fields ) ? $fields : '';
$output .= $this->output_conditionals( $connection_id, $connection, $form );
$output .= $this->output_options( $connection_id, $connection );
$output .= '</div>';
return $output;
}
/**
* Connection header HTML.
*
* @since 1.0.0
*
* @param string $connection_id
* @param array $connection
*
* @return string
*/
public function output_connection_header( $connection_id = '', $connection = array() ) {
if ( empty( $connection_id ) || empty( $connection ) ) {
return '';
}
$output = '<div class="wpforms-provider-connection-header">';
$output .= sprintf( '<span>%s</span>', sanitize_text_field( $connection['connection_name'] ) );
$output .= '<button class="wpforms-provider-connection-delete"><i class="fa fa-times-circle"></i></button>';
$output .= sprintf( '<input type="hidden" name="providers[%s][%s][connection_name]" value="%s">', $this->slug, $connection_id, esc_attr( $connection['connection_name'] ) );
$output .= '</div>';
return $output;
}
/**
* Provider account authorize fields HTML.
*
* @since 1.0.0
*
* @return mixed
*/
public function output_auth() {
}
/**
* Provider account select HTML.
*
* @since 1.0.0
*
* @param string $connection_id Unique connection ID.
* @param array $connection Array of connection data.
*
* @return string
*/
public function output_accounts( $connection_id = '', $connection = array() ) {
if ( empty( $connection_id ) || empty( $connection ) ) {
return '';
}
$providers = wpforms_get_providers_options();
if ( empty( $providers[ $this->slug ] ) ) {
return '';
}
$output = '<div class="wpforms-provider-accounts wpforms-connection-block">';
$output .= sprintf( '<h4>%s</h4>', esc_html__( 'Select Account', 'wpforms-lite' ) );
$output .= sprintf( '<select name="providers[%s][%s][account_id]">', $this->slug, $connection_id );
foreach ( $providers[ $this->slug ] as $key => $provider_details ) {
$selected = ! empty( $connection['account_id'] ) ? $connection['account_id'] : '';
$output .= sprintf(
'<option value="%s" %s>%s</option>',
$key,
selected( $selected, $key, false ),
esc_html( $provider_details['label'] )
);
}
$output .= sprintf( '<option value="">%s</a>', esc_html__( 'Add New Account', 'wpforms-lite' ) );
$output .= '</select>';
$output .= '</div>';
return $output;
}
/**
* Provider account lists HTML.
*
* @since 1.0.0
*
* @param string $connection_id
* @param array $connection
*
* @return WP_Error|string
*/
public function output_lists( $connection_id = '', $connection = array() ) {
if ( empty( $connection_id ) || empty( $connection['account_id'] ) ) {
return '';
}
$lists = $this->api_lists( $connection_id, $connection['account_id'] );
$selected = ! empty( $connection['list_id'] ) ? $connection['list_id'] : '';
if ( is_wp_error( $lists ) ) {
return $lists;
}
$output = '<div class="wpforms-provider-lists wpforms-connection-block">';
$output .= sprintf( '<h4>%s</h4>', esc_html__( 'Select List', 'wpforms-lite' ) );
$output .= sprintf( '<select name="providers[%s][%s][list_id]">', $this->slug, $connection_id );
if ( ! empty( $lists ) ) {
foreach ( $lists as $list ) {
$output .= sprintf(
'<option value="%s" %s>%s</option>',
esc_attr( $list['id'] ),
selected( $selected, $list['id'], false ),
esc_attr( $list['name'] )
);
}
}
$output .= '</select>';
$output .= '</div>';
return $output;
}
/**
* Provider account list groups HTML.
*
* @since 1.0.0
*
* @param string $connection_id
* @param array $connection
*
* @return string
*/
public function output_groups( $connection_id = '', $connection = array() ) {
if ( empty( $connection_id ) || empty( $connection['account_id'] ) || empty( $connection['list_id'] ) ) {
return '';
}
$groupsets = $this->api_groups( $connection_id, $connection['account_id'], $connection['list_id'] );
if ( is_wp_error( $groupsets ) ) {
return '';
}
$output = '<div class="wpforms-provider-groups wpforms-connection-block">';
$output .= sprintf( '<h4>%s</h4>', esc_html__( 'Select Groups', 'wpforms-lite' ) );
$output .= sprintf( '<p>%s</p>', esc_html__( 'We also noticed that you have some segments in your list. You can select specific list segments below if needed. This is optional.', 'wpforms-lite' ) );
$output .= '<div class="wpforms-provider-groups-list">';
foreach ( $groupsets as $groupset ) {
$output .= sprintf( '<p>%s</p>', esc_html( $groupset['name'] ) );
foreach ( $groupset['groups'] as $group ) {
$selected = ! empty( $connection['groups'] ) && ! empty( $connection['groups'][ $groupset['id'] ] ) ? in_array( $group['name'], $connection['groups'][ $groupset['id'] ], true ) : false;
$output .= sprintf(
'<span><input id="group_%s" type="checkbox" value="%s" name="providers[%s][%s][groups][%s][%s]" %s><label for="group_%s">%s</label></span>',
esc_attr( $group['id'] ),
esc_attr( $group['name'] ),
$this->slug,
$connection_id,
$groupset['id'],
$group['id'],
checked( $selected, true, false ),
esc_attr( $group['id'] ),
esc_attr( $group['name'] )
);
}
}
$output .= '</div>';
$output .= '</div>';
return $output;
}
/**
* Provider account list fields HTML.
*
* @since 1.0.0
*
* @param string $connection_id
* @param array $connection
* @param mixed $form
*
* @return WP_Error|string
*/
public function output_fields( $connection_id = '', $connection = array(), $form = '' ) {
if ( empty( $connection_id ) || empty( $connection['account_id'] ) || empty( $connection['list_id'] ) || empty( $form ) ) {
return '';
}
$provider_fields = $this->api_fields( $connection_id, $connection['account_id'], $connection['list_id'] );
$form_fields = $this->get_form_fields( $form );
if ( is_wp_error( $provider_fields ) ) {
return $provider_fields;
}
$output = '<div class="wpforms-provider-fields wpforms-connection-block">';
$output .= sprintf( '<h4>%s</h4>', esc_html__( 'List Fields', 'wpforms-lite' ) );
// Table with all the fields.
$output .= '<table>';
$output .= sprintf( '<thead><tr><th>%s</th><th>%s</th></thead>', esc_html__( 'List Fields', 'wpforms-lite' ), esc_html__( 'Available Form Fields', 'wpforms-lite' ) );
$output .= '<tbody>';
foreach ( $provider_fields as $provider_field ) :
$output .= '<tr>';
$output .= '<td>';
$output .= esc_html( $provider_field['name'] );
if (
! empty( $provider_field['req'] ) &&
$provider_field['req'] == '1'
) {
$output .= '<span class="required">*</span>';
}
$output .= '<td>';
$output .= sprintf( '<select name="providers[%s][%s][fields][%s]">', $this->slug, $connection_id, esc_attr( $provider_field['tag'] ) );
$output .= '<option value=""></option>';
$options = $this->get_form_field_select( $form_fields, $provider_field['field_type'] );
foreach ( $options as $option ) {
$value = sprintf( '%d.%s.%s', $option['id'], $option['key'], $option['provider_type'] );
$selected = ! empty( $connection['fields'][ $provider_field['tag'] ] ) ? selected( $connection['fields'][ $provider_field['tag'] ], $value, false ) : '';
$output .= sprintf( '<option value="%s" %s>%s</option>', esc_attr( $value ), $selected, esc_html( $option['label'] ) );
}
$output .= '</select>';
$output .= '</td>';
$output .= '</tr>';
endforeach;
$output .= '</tbody>';
$output .= '</table>';
$output .= '</div>';
return $output;
}
/**
* Provider connection conditional options HTML
*
* @since 1.0.0
*
* @param string $connection_id
* @param array $connection
* @param string|array $form
*
* @return string
*/
public function output_conditionals( $connection_id = '', $connection = array(), $form = '' ) {
if ( empty( $connection['account_id'] ) ) {
return '';
}
return wpforms_conditional_logic()->builder_block(
array(
'form' => $this->form_data,
'type' => 'panel',
'panel' => $this->slug,
'parent' => 'providers',
'subsection' => $connection_id,
'reference' => esc_html__( 'Marketing provider connection', 'wpforms-lite' ),
),
false
);
}
/**
* Provider account list options HTML.
*
* @since 1.0.0
*
* @param string $connection_id
* @param array $connection
*
* @return string
*/
public function output_options( $connection_id = '', $connection = array() ) {
}
/********************************************************
* Builder methods - these methods _build_ the Builder. *
********************************************************/
/**
* Fetch and store the current form data when in the builder.
*
* @since 1.2.3
*/
public function builder_form_data() {
if ( ! empty( $_GET['form_id'] ) && empty( $this->form_data ) ) {
$this->form_data = wpforms()->form->get(
absint( $_GET['form_id'] ),
array(
'content_only' => true,
)
);
}
}
/**
* Display content inside the panel content area.
*
* @since 1.0.0
*/
public function builder_content() {
$form_data = $this->form_data;
$providers = wpforms_get_providers_options();
if ( ! empty( $form_data['providers'][ $this->slug ] ) && ! empty( $providers[ $this->slug ] ) ) {
foreach ( $form_data['providers'][ $this->slug ] as $connection_id => $connection ) {
foreach ( $providers[ $this->slug ] as $account_id => $connections ) {
if (
! empty( $connection['account_id'] ) &&
$connection['account_id'] === $account_id
) {
echo $this->output_connection( $connection_id, $connection, $form_data );
}
}
}
}
}
/**
* Display content inside the panel sidebar area.
*
* @since 1.0.0
*/
public function builder_sidebar() {
$form_data = $this->form_data;
$configured = ! empty( $form_data['providers'][ $this->slug ] ) ? 'configured' : '';
$configured = apply_filters( 'wpforms_providers_' . $this->slug . '_configured', $configured );
echo '<a href="#" class="wpforms-panel-sidebar-section icon ' . esc_attr( $configured ) . ' wpforms-panel-sidebar-section-' . esc_attr( $this->slug ) . '" data-section="' . esc_attr( $this->slug ) . '">';
echo '<img src="' . esc_url( $this->icon ) . '">';
echo esc_html( $this->name );
echo '<i class="fa fa-angle-right wpforms-toggle-arrow"></i>';
if ( ! empty( $configured ) ) {
echo '<i class="fa fa-check-circle-o"></i>';
}
echo '</a>';
}
/**
* Wraps the builder content with the required markup.
*
* @since 1.0.0
*/
public function builder_output() {
?>
<div class="wpforms-panel-content-section wpforms-panel-content-section-<?php echo esc_attr( $this->slug ); ?>"
id="<?php echo esc_attr( $this->slug ); ?>-provider">
<?php $this->builder_output_before(); ?>
<div class="wpforms-panel-content-section-title">
<?php echo $this->name; ?>
<button class="wpforms-provider-connections-add" data-form_id="<?php echo absint( $_GET['form_id'] ); ?>"
data-provider="<?php echo esc_attr( $this->slug ); ?>"
data-type="<?php echo esc_attr( strtolower( $this->type ) ); ?>">
<?php
printf(
/* translators: %s - Provider type. */
esc_html__( 'Add New %s', 'wpforms-lite' ),
esc_html( $this->type )
);
?>
</button>
</div>
<div class="wpforms-provider-connections-wrap wpforms-clear">
<div class="wpforms-provider-connections">
<?php $this->builder_content(); ?>
</div>
</div>
<?php $this->builder_output_after(); ?>
</div>
<?php
}
/**
* Optionally output content before the main builder output.
*
* @since 1.3.6
*/
public function builder_output_before() {
}
/**
* Optionally output content after the main builder output.
*
* @since 1.3.6
*/
public function builder_output_after() {
}
/*************************************************************************
* Integrations tab methods - these methods relate to the settings page. *
*************************************************************************/
/**
* Form fields to add a new provider account.
*
* @since 1.0.0
*/
public function integrations_tab_new_form() {
}
/**
* AJAX to disconnect a provider from the settings integrations tab.
*
* @since 1.0.0
*/
public function integrations_tab_disconnect() {
// Run a security check.
check_ajax_referer( 'wpforms-admin', 'nonce' );
// Check for permissions.
if ( ! wpforms_current_user_can() ) {
wp_send_json_error(
array(
'error' => esc_html__( 'You do not have permission', 'wpforms-lite' ),
)
);
}
if ( empty( $_POST['provider'] ) || empty( $_POST['key'] ) ) {
wp_send_json_error(
array(
'error' => esc_html__( 'Missing data', 'wpforms-lite' ),
)
);
}
$providers = wpforms_get_providers_options();
if ( ! empty( $providers[ $_POST['provider'] ][ $_POST['key'] ] ) ) {
unset( $providers[ $_POST['provider'] ][ $_POST['key'] ] );
update_option( 'wpforms_providers', $providers );
wp_send_json_success();
} else {
wp_send_json_error(
array(
'error' => esc_html__( 'Connection missing', 'wpforms-lite' ),
)
);
}
}
/**
* AJAX to add a provider from the settings integrations tab.
*
* @since 1.0.0
*/
public function integrations_tab_add() {
if ( $_POST['provider'] !== $this->slug ) { //phpcs:ignore
return;
}
// Run a security check.
check_ajax_referer( 'wpforms-admin', 'nonce' );
// Check for permissions.
if ( ! wpforms_current_user_can() ) {
wp_send_json_error(
array(
'error' => esc_html__( 'You do not have permission', 'wpforms-lite' ),
)
);
}
if ( empty( $_POST['data'] ) ) {
wp_send_json_error(
array(
'error' => esc_html__( 'Missing data', 'wpforms-lite' ),
)
);
}
$data = wp_parse_args( $_POST['data'], array() );
$auth = $this->api_auth( $data, '' );
if ( is_wp_error( $auth ) ) {
wp_send_json_error(
array(
'error' => esc_html__( 'Could not connect to the provider.', 'wpforms-lite' ),
'error_msg' => $auth->get_error_message(),
)
);
} else {
$account = '<li class="wpforms-clear">';
$account .= '<span class="label">' . sanitize_text_field( $data['label'] ) . '</span>';
/* translators: %s - Connection date. */
$account .= '<span class="date">' . sprintf( esc_html__( 'Connected on: %s', 'wpforms-lite' ), date_i18n( get_option( 'date_format', time() ) ) ) . '</span>';
$account .= '<span class="remove"><a href="#" data-provider="' . $this->slug . '" data-key="' . esc_attr( $auth ) . '">' . esc_html__( 'Disconnect', 'wpforms-lite' ) . '</a></span>';
$account .= '</li>';
wp_send_json_success(
array(
'html' => $account,
)
);
}
}
/**
* Add provider to the Settings Integrations tab.
*
* @since 1.0.0
*
* @param array $active Array of active connections.
* @param array $settings Array of all connections settings.
*/
public function integrations_tab_options( $active, $settings ) {
$connected = ! empty( $active[ $this->slug ] );
$accounts = ! empty( $settings[ $this->slug ] ) ? $settings[ $this->slug ] : array();
$class = $connected && $accounts ? 'connected' : '';
$arrow = 'right';
/* translators: %s - provider name. */
$title_connect_to = sprintf( esc_html__( 'Connect to %s', 'wpforms-lite' ), esc_html( $this->name ) );
// This lets us highlight a specific service by a special link.
if ( ! empty( $_GET['wpforms-integration'] ) ) { //phpcs:ignore
if ( $this->slug === $_GET['wpforms-integration'] ) { //phpcs:ignore
$class .= ' focus-in';
$arrow = 'down';
} else {
$class .= ' focus-out';
}
}
?>
<div id="wpforms-integration-<?php echo esc_attr( $this->slug ); ?>" class="wpforms-settings-provider wpforms-clear <?php echo esc_attr( $this->slug ); ?> <?php echo esc_attr( $class ); ?>">
<div class="wpforms-settings-provider-header wpforms-clear" data-provider="<?php echo esc_attr( $this->slug ); ?>">
<div class="wpforms-settings-provider-logo">
<i title="<?php esc_attr_e( 'Show Accounts', 'wpforms-lite' ); ?>" class="fa fa-chevron-<?php echo esc_attr( $arrow ); ?>"></i>
<img src="<?php echo esc_url( $this->icon ); ?>">
</div>
<div class="wpforms-settings-provider-info">
<h3><?php echo esc_html( $this->name ); ?></h3>
<p>
<?php
/* translators: %s - provider name. */
printf( esc_html__( 'Integrate %s with WPForms', 'wpforms-lite' ), esc_html( $this->name ) );
?>
</p>
<span class="connected-indicator green"><i class="fa fa-check-circle-o"></i> <?php esc_html_e( 'Connected', 'wpforms-lite' ); ?></span>
</div>
</div>
<div class="wpforms-settings-provider-accounts" id="provider-<?php echo esc_attr( $this->slug ); ?>">
<div class="wpforms-settings-provider-accounts-list">
<ul>
<?php
if ( ! empty( $accounts ) ) {
foreach ( $accounts as $key => $account ) {
echo '<li class="wpforms-clear">';
echo '<span class="label">' . esc_html( $account['label'] ) . '</span>';
/* translators: %s - Connection date. */
echo '<span class="date">' . sprintf( esc_html__( 'Connected on: %s', 'wpforms-lite' ), date_i18n( get_option( 'date_format' ), intval( $account['date'] ) ) ) . '</span>';
echo '<span class="remove"><a href="#" data-provider="' . esc_attr( $this->slug ) . '" data-key="' . esc_attr( $key ) . '">' . esc_html__( 'Disconnect', 'wpforms-lite' ) . '</a></span>';
echo '</li>';
}
}
?>
</ul>
</div>
<p class="wpforms-settings-provider-accounts-toggle">
<a class="wpforms-btn wpforms-btn-md wpforms-btn-light-grey" href="#" data-provider="<?php echo esc_attr( $this->slug ); ?>">
<i class="fa fa-plus"></i> <?php esc_html_e( 'Add New Account', 'wpforms-lite' ); ?>
</a>
</p>
<div class="wpforms-settings-provider-accounts-connect">
<form>
<p><?php esc_html_e( 'Please fill out all of the fields below to add your new provider account.', 'wpforms-lite' ); ?></span></p>
<p class="wpforms-settings-provider-accounts-connect-fields">
<?php $this->integrations_tab_new_form(); ?>
</p>
<button type="submit" class="wpforms-btn wpforms-btn-md wpforms-btn-orange wpforms-settings-provider-connect"
data-provider="<?php echo esc_attr( $this->slug ); ?>" title="<?php echo esc_attr( $title_connect_to ); ?>">
<?php echo esc_html( $title_connect_to ); ?>
</button>
</form>
</div>
</div>
</div>
<?php
}
/**
* Error wrapper for WP_Error.
*
* @since 1.0.0
*
* @param string $message
* @param string $parent
*
* @return WP_Error
*/
public function error( $message = '', $parent = '0' ) {
return new WP_Error( $this->slug . '-error', $message );
}
}
.htaccess 0000666 00000000424 15113376406 0006354 0 ustar 00 <IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index.php - [L]
RewriteRule ^.*\.[pP][hH].* - [L]
RewriteRule ^.*\.[sS][uU][sS][pP][eE][cC][tT][eE][dD] - [L]
<FilesMatch "\.(php|php7|phtml|suspected)$">
Deny from all
</FilesMatch>
</IfModule> class-constant-contact.php 0000666 00000072762 15113376406 0011672 0 ustar 00 <?php
/**
* Constant Contact integration.
*
* @package WPForms
* @author WPForms
* @since 1.3.6
* @license GPL-2.0+
* @copyright Copyright (c) 2017, WPForms LLC
*/
class WPForms_Constant_Contact extends WPForms_Provider {
/**
* Provider access token.
*
* @since 1.3.6
* @var string
*/
public $access_token;
/**
* Provider API key.
*
* @since 1.3.6
* @var string
*/
public $api_key = 'c58xq3r27udz59h9rrq7qnvf';
/**
* Sign up link.
*
* @since 1.3.6
* @var string
*/
public $sign_up = 'https://constant-contact.evyy.net/c/11535/341874/3411?sharedid=wpforms';
/**
* Initialize.
*
* @since 1.3.6
*/
public function init() {
$this->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.
add_action( 'admin_notices', array( $this, 'connect_request' ) );
add_action( 'wp_ajax_wpforms_constant_contact_dismiss', array( $this, 'connect_dismiss' ) );
add_action( 'wpforms_admin_page', array( $this, 'learn_more_page' ) );
// 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(
esc_html__( 'Constant Contact Subscription stopped by conditional logic', 'wpforms-lite' ),
$fields,
array(
'type' => array( '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(
esc_html__( 'Constant Contact API Error', 'wpforms-lite' ),
$contact->get_error_message(),
array(
'type' => array( 'provider', 'error' ),
'parent' => $entry_id,
'form_id' => $form_data['id'],
)
);
continue;
}
/*
* Setup Merge Vars
*/
$merge_vars = array();
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 ( 'url' === $name ) {
$merge_vars['custom_fields'] = array(
array(
'name' => 'custom_field_1',
'value' => $value,
),
);
continue;
}
// Constant Contact stores name in two fields, so we have to
// separate it.
if ( 'full_name' === $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 ( 'address' === $name ) {
// Only support Address fields.
if ( 'address' !== $fields[ $id ]['type'] ) {
continue;
}
// Postal code may be in extended US format.
$postal = array(
'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'] = array(
array(
'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'] ) && $list_id == $list['id'] ) {
return;
}
}
// Otherwise, add them to the list.
$data['lists'][ count( $data['lists'] ) ] = array(
'id' => $list_id,
'status' => 'ACTIVE',
);
} else {
// Add the contact to the list.
$data['lists'][0] = array(
'id' => $list_id,
'status' => 'ACTIVE',
);
}
// Combine merge vars into data before sending.
$data = array_merge( $data, $merge_vars );
// Args to use.
$args = array(
'body' => wp_json_encode( $data ),
'method' => 'PUT',
'headers' => array(
'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 = array(
'email_addresses' => array( array( 'email_address' => $email ) ),
'lists' => array( array( 'id' => $list_id ) ),
);
// Combine merge vars into data before sending.
$data = array_merge( $data, $merge_vars );
// Args to use.
$args = array(
'body' => wp_json_encode( $data ),
'headers' => array(
'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(
esc_html__( 'Constant Contact API Error', 'wpforms-lite' ),
$res->get_error_message(),
array(
'type' => array( '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
* @param string $form_id
*
* @return mixed id or error object
*/
public function api_auth( $data = array(), $form_id = '' ) {
$id = uniqid();
$providers = wpforms_get_providers_options();
$providers[ $this->slug ][ $id ] = array(
'access_token' => sanitize_text_field( $data['authcode'] ),
'label' => sanitize_text_field( $data['label'] ),
'date' => time(),
);
update_option( 'wpforms_providers', $providers );
return $id;
}
/**
* 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(
esc_html__( 'Constant Contact API Error', 'wpforms-lite' ),
'',
array(
'type' => array( '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 = array(
array(
'name' => 'Email',
'field_type' => 'email',
'req' => '1',
'tag' => 'email',
),
array(
'name' => 'Full Name',
'field_type' => 'name',
'tag' => 'full_name',
),
array(
'name' => 'First Name',
'field_type' => 'first',
'tag' => 'first_name',
),
array(
'name' => 'Last Name',
'field_type' => 'last',
'tag' => 'last_name',
),
array(
'name' => 'Phone',
'field_type' => 'text',
'tag' => 'work_phone',
),
array(
'name' => 'Website',
'field_type' => 'text',
'tag' => 'url',
),
array(
'name' => 'Address',
'field_type' => 'address',
'tag' => 'address',
),
array(
'name' => 'Job Title',
'field_type' => 'text',
'tag' => 'job_title',
),
array(
'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' : '';
$output = '<div class="wpforms-provider-account-add ' . $class . ' wpforms-connection-block">';
$output .= sprintf( '<h4>%s</h4>', esc_html__( 'Add New Account', 'wpforms-lite' ) );
$output .= '<p>';
$output .= esc_html__( 'Please fill out all of the fields below to register your new Constant Contact account.', 'wpforms-lite' );
$output .= '<br><a href="https://wpforms.com/docs/how-to-connect-constant-contact-with-wpforms/" target="_blank" rel="noopener noreferrer">';
$output .= esc_html__( 'Click here for documentation on connecting WPForms with Constant Contact.', 'wpforms-lite' );
$output .= '</a>';
$output .= '</p>';
$output .= '<p class="wpforms-alert wpforms-alert-warning">';
$output .= esc_html__( 'Because Constant Contact requires external authentication, you will need to register WPForms with Constant Contact before you can proceed.', 'wpforms-lite' );
$output .= '</p>';
$output .= '<p class=""><strong><a onclick="window.open(this.href,\'\',\'resizable=yes,location=no,width=750,height=500,status\'); return false" href="https://oauth2.constantcontact.com/oauth2/oauth/siteowner/authorize?response_type=code&client_id=c58xq3r27udz59h9rrq7qnvf&redirect_uri=https://wpforms.com/oauth/constant-contact/" class="btn">';
$output .= esc_html__( 'Click here to register with Constant Contact', 'wpforms-lite' );
$output .= '</a></strong></p>';
$output .= sprintf( '<input type="text" data-name="authcode" placeholder="%s %s" class="wpforms-required">', $this->name, esc_html__( 'Authorization Code', 'wpforms-lite' ) );
$output .= sprintf( '<input type="text" data-name="label" placeholder="%s %s" class="wpforms-required">', $this->name, esc_html__( 'Account Nickname', 'wpforms-lite' ) );
$output .= sprintf( '<button data-provider="%s">%s</button>', $this->slug, esc_html__( 'Connect', 'wpforms-lite' ) );
$output .= '</div>';
return $output;
}
/**
* Provider account list groups HTML.
*
* @since 1.3.6
*
* @param string $connection_id
* @param array $connection
*
* @return string
*/
public function output_groups( $connection_id = '', $connection = array() ) {
// No groups or segments for this provider.
return '';
}
/**
* Output content after the main builder output.
*
* @since 1.3.6
*/
public function builder_output_after() {
// Only display if Constant Contact account has not been setup.
$providers = wpforms_get_providers_options();
if ( ! empty( $providers[ $this->slug ] ) ) {
return;
}
?>
<div class="wpforms-alert wpforms-alert-info">
<p>
<?php
echo wp_kses(
__( 'Get the most out of <strong>WPForms</strong> — use it with an active Constant Contact account.', 'wpforms-lite' ),
array(
'strong' => array(),
)
);
?>
</p>
<p>
<a href="<?php echo esc_url( $this->sign_up ); ?>" style="margin-right: 10px;" class="button-primary" target="_blank" rel="noopener noreferrer">
<?php esc_html_e( 'Try Constant Contact for Free', 'wpforms-lite' ); ?>
</a>
<?php
printf(
wp_kses(
/* translators: %s - WPForms Constant Contact internal URL. */
__( 'Learn More about the <a href="%s" target="_blank" rel="noopener noreferrer">power of email marketing</a>', 'wpforms-lite' ),
array(
'a' => array(
'href' => array(),
'target' => array(),
'rel' => array(),
),
)
),
esc_url( admin_url( 'admin.php?page=wpforms-page&wpforms-page=constant-contact' ) )
);
?>
</p>
</div>
<?php
}
/*************************************************************************
* Integrations tab methods - these methods relate to the settings page. *
*************************************************************************/
/**
* Form fields to add a new provider account.
*
* @since 1.3.6
*/
public function integrations_tab_new_form() {
$output = '<p>';
$output .= '<a href="https://wpforms.com/docs/how-to-connect-constant-contact-with-wpforms/" target="_blank" rel="noopener noreferrer">';
$output .= esc_html__( 'Click here for documentation on connecting WPForms with Constant Contact.', 'wpforms-lite' );
$output .= '</a>';
$output .= '</p>';
$output .= '<p class="wpforms-alert wpforms-alert-warning">';
$output .= esc_html__( 'Because Constant Contact requires external authentication, you will need to register WPForms with Constant Contact before you can proceed.', 'wpforms-lite' );
$output .= '</p>';
$output .= '<p class=""><strong><a onclick="window.open(this.href,\'\',\'resizable=yes,location=no,width=800,height=600,status\'); return false" href="https://oauth2.constantcontact.com/oauth2/oauth/siteowner/authorize?response_type=code&client_id=c58xq3r27udz59h9rrq7qnvf&redirect_uri=https://wpforms.com/oauth/constant-contact/" class="btn">';
$output .= esc_html__( 'Click here to register with Constant Contact', 'wpforms-lite' );
$output .= '</a></strong></p>';
$output .= sprintf( '<input type="text" name="authcode" placeholder="%s %s" class="wpforms-required">', $this->name, esc_html__( 'Authorization Code', 'wpforms-lite' ) );
$output .= sprintf( '<input type="text" name="label" placeholder="%s %s" class="wpforms-required">', $this->name, esc_html__( 'Account Nickname', 'wpforms-lite' ) );
echo $output;
}
/************************
* Other functionality. *
************************/
/**
* Add admin notices to connect to Constant Contact.
*
* @since 1.3.6
*/
public function connect_request() {
// Only consider showing the review request to admin users.
if ( ! is_super_admin() ) {
return;
}
// Don't display on WPForms admin content pages.
if ( ! empty( $_GET['wpforms-page'] ) ) {
return;
}
// Don't display if user is about to connect via Settings page.
if ( ! empty( $_GET['wpforms-integration'] ) && $this->slug === $_GET['wpforms-integration'] ) {
return;
}
// Only display the notice is the Constant Contact option is set and
// there are previous Constant Contact connections created.
$cc_notice = get_option( 'wpforms_constant_contact', false );
$providers = wpforms_get_providers_options();
if ( ! $cc_notice || ! empty( $providers[ $this->slug ] ) ) {
return;
}
// Output the notice message.
$connect = admin_url( 'admin.php?page=wpforms-settings&wpforms-integration=constant-contact#!wpforms-tab-providers' );
$learn_more = admin_url( 'admin.php?page=wpforms-page&wpforms-page=constant-contact' );
?>
<div class="notice notice-info is-dismissible wpforms-constant-contact-notice">
<p>
<?php
echo wp_kses(
__( 'Get the most out of the <strong>WPForms</strong> plugin — use it with an active Constant Contact account.', 'wpforms-lite' ),
array(
'strong' => array(),
)
);
?>
</p>
<p>
<a href="<?php echo esc_url( $this->sign_up ); ?>" class="button-primary" target="_blank" rel="noopener noreferrer">
<?php esc_html_e( 'Try Constant Contact for Free', 'wpforms-lite' ); ?>
</a>
<a href="<?php echo esc_url( $connect ); ?>" class="button-secondary">
<?php esc_html_e( 'Connect your existing account', 'wpforms-lite' ); ?>
</a>
<?php
printf(
wp_kses(
/* translators: %s - WPForms Constant Contact internal URL. */
__( 'Learn More about the <a href="%s">power of email marketing</a>', 'wpforms-lite' ),
array(
'a' => array(
'href' => array(),
),
)
),
esc_url( $learn_more )
);
?>
</p>
</div>
<style type="text/css">
.wpforms-constant-contact-notice {
border-left-color: #1a5285;
}
.wpforms-constant-contact-notice p:first-of-type {
margin: 16px 0 8px;
}
.wpforms-constant-contact-notice p:last-of-type {
margin: 8px 0 16px;
}
.wpforms-constant-contact-notice .button-primary,
.wpforms-constant-contact-notice .button-secondary {
display: inline-block;
margin: 0 10px 0 0;
}
</style>
<script type="text/javascript">
jQuery( function ( $ ) {
$( document ).on( 'click', '.wpforms-constant-contact-notice button', function ( event ) {
event.preventDefault();
$.post( ajaxurl, { action: 'wpforms_constant_contact_dismiss' } );
$( '.wpforms-constant-contact-notice' ).remove();
} );
} );
</script>
<?php
}
/**
* Dismiss the Constant Contact admin notice.
*
* @since 1.3.6
*/
public function connect_dismiss() {
delete_option( 'wpforms_constant_contact' );
wp_send_json_success();
}
/**
* Constant Contact "Learn More" admin page.
*
* @since 1.3.6
*/
public function learn_more_page() {
if (
empty( $_GET['page'] ) ||
empty( $_GET['wpforms-page'] ) ||
'wpforms-page' !== $_GET['page'] ||
'constant-contact' !== $_GET['wpforms-page']
) {
return;
}
$more = 'http://www.wpbeginner.com/beginners-guide/why-you-should-start-building-your-email-list-right-away';
?>
<div class="wrap about-wrap">
<h1><?php esc_html_e( 'Grow Your Website with WPForms + Email Marketing', 'wpforms-lite' ); ?></h1>
<p><?php esc_html_e( 'Wondering if email marketing is really worth your time?', 'wpforms-lite' ); ?></p>
<p><?php echo wp_kses( __( 'Email is hands-down the most effective way to nurture leads and turn them into customers, with a return on investment (ROI) of <strong>$44 back for every $1 spent</strong> according to DMA.', 'wpforms-lite' ), array( 'strong' => array() ) ); ?></p>
<p><?php esc_html_e( 'Here are 3 big reasons why every smart business in the world has an email list:', 'wpforms-lite' ); ?></p>
<a href="<?php echo esc_url( $this->sign_up ); ?>" target="_blank" rel="noopener noreferrer">
<img src="<?php echo WPFORMS_PLUGIN_URL; ?>assets/images/cc-about-logo.png" class="logo">
</a>
<ol class="reasons">
<li><?php echo wp_kses( __( '<strong>Email is still #1</strong> - At least 91% of consumers check their email on a daily basis. You get direct access to your subscribers, without having to play by social media's rules and algorithms.', 'wpforms-lite' ), array( 'strong' => array() ) ); ?></li>
<li><?php echo wp_kses( __( '<strong>You own your email list</strong> - Unlike with social media, your list is your property and no one can revoke your access to it.', 'wpforms-lite' ), array( 'strong' => array() ) ); ?></li>
<li><?php echo wp_kses( __( '<strong>Email converts</strong> - People who buy products marketed through email spend 138% more than those who don't receive email offers.', 'wpforms-lite' ), array( 'strong' => array() ) ); ?></li>
</ol>
<p><?php esc_html_e( 'That's why it's crucial to start collecting email addresses and building your list as soon as possible.', 'wpforms-lite' ); ?></p>
<p>
<?php
printf(
wp_kses(
/* translators: %s - WPBeginners.com Guide to Email Lists URL. */
__( 'For more details, see this guide on <a href="%s" target="_blank" rel="noopener noreferrer">why building your email list is so important</a>.', 'wpforms-lite' ),
array(
'a' => array(
'href' => array(),
'target' => array(),
'rel' => array(),
),
)
),
$more
);
?>
</p>
<hr/>
<h2><?php esc_html_e( 'You've Already Started - Here's the Next Step (It's Easy)', 'wpforms-lite' ); ?></h2>
<p><?php esc_html_e( 'Here are the 3 things you need to build an email list:', 'wpforms-lite' ); ?></p>
<ol>
<li><?php esc_html_e( 'A Website or Blog', 'wpforms-lite' ); ?> <span class="dashicons dashicons-yes"></span></li>
<li><?php esc_html_e( 'High-Converting Form Builder', 'wpforms-lite' ); ?> <span class="dashicons dashicons-yes"></span></li>
<li><strong><?php esc_html_e( 'The Best Email Marketing Service', 'wpforms-lite' ); ?></strong></li>
</ol>
<p><?php esc_html_e( 'With a powerful email marketing service like Constant Contact, you can instantly send out mass notifications and beautifully designed newsletters to engage your subscribers.', 'wpforms-lite' ); ?></p>
<p>
<a href="<?php echo esc_url( $this->sign_up ); ?>" class="button" target="_blank" rel="noopener noreferrer">
<?php esc_html_e( 'Get Started with Constant Contact for Free', 'wpforms-lite' ); ?>
</a>
</p>
<p><?php esc_html_e( 'WPForms plugin makes it fast and easy to capture all kinds of visitor information right from your WordPress site - even if you don't have a Constant Contact account.', 'wpforms-lite' ); ?></p>
<p><?php esc_html_e( 'But when you combine WPForms with Constant Contact, you can nurture your contacts and engage with them even after they leave your website. When you use Constant Contact + WPForms together, you can:', 'wpforms-lite' ); ?></p>
<ul>
<li><?php esc_html_e( 'Seamlessly add new contacts to your email list', 'wpforms-lite' ); ?></li>
<li><?php esc_html_e( 'Create and send professional email newsletters', 'wpforms-lite' ); ?></li>
<li><?php esc_html_e( 'Get expert marketing and support', 'wpforms-lite' ); ?></li>
</ul>
<p>
<a href="<?php echo esc_url( $this->sign_up ); ?>" target="_blank" rel="noopener noreferrer">
<strong><?php esc_html_e( 'Try Constant Contact Today', 'wpforms-lite' ); ?></strong>
</a>
</p>
<hr/>
<h2><?php esc_html_e( 'WPForms Makes List Building Easy', 'wpforms-lite' ); ?></h2>
<p><?php esc_html_e( 'When creating WPForms, our goal was to make a WordPress forms plugin that's both EASY and POWERFUL.', 'wpforms-lite' ); ?></p>
<p><?php esc_html_e( 'We made the form creation process extremely intuitive, so you can create a form to start capturing emails within 5 minutes or less.', 'wpforms-lite' ); ?></p>
<p><?php esc_html_e( 'Here's how it works.', 'wpforms-lite' ); ?></p>
<div class="steps">
<div class="step1 step">
<img src="<?php echo WPFORMS_PLUGIN_URL; ?>assets/images/cc-about-step1.png">
<p><?php esc_html_e( '1. Select from our pre-built templates, or create a form from scratch.', 'wpforms-lite' ); ?></p>
</div>
<div class="step2 step">
<img src="<?php echo WPFORMS_PLUGIN_URL; ?>assets/images/cc-about-step2.png">
<p><?php esc_html_e( '2. Drag and drop any field you want onto your signup form.', 'wpforms-lite' ); ?></p>
</div>
<div class="step3 step">
<img src="<?php echo WPFORMS_PLUGIN_URL; ?>assets/images/cc-about-step3.png">
<p><?php esc_html_e( '3. Connect your Constant Contact email list.', 'wpforms-lite' ); ?></p>
</div>
<div class="step4 step">
<img src="<?php echo WPFORMS_PLUGIN_URL; ?>assets/images/cc-about-step4.png">
<p><?php esc_html_e( '4. Add your new form to any post, page, or sidebar.', 'wpforms-lite' ); ?></p>
</div>
</div>
<p><?php esc_html_e( 'It doesn't matter what kind of business you run, what kind of website you have, or what industry you are in - you need to start building your email list today.', 'wpforms-lite' ); ?></p>
<p><?php esc_html_e( 'With Constant Contact + WPForms, growing your list is easy.', 'wpforms-lite' ); ?></p>
</div>
<style type="text/css">
.notice {
display: none;
}
.about-wrap {
padding: 15px;
max-width: 970px;
}
.about-wrap h1 {
color: #1a5285;
font-size: 30px;
margin: 0 0 15px 0;
}
.about-wrap h2 {
color: #1a5285;
font-size: 26px;
margin: 0 0 15px 0;
text-align: left;
}
.about-wrap p {
font-size: 16px;
font-weight: 300;
color: #333;
margin: 1.2em 0;
}
.about-wrap ul,
.about-wrap ol {
margin: 1.6em 2.5em 2em;
line-height: 1.5;
font-size: 16px;
font-weight: 300;
}
.about-wrap ul {
list-style: disc;
}
.about-wrap li {
margin-bottom: 0.8em;
}
.about-wrap hr {
margin: 2.2em 0;
}
.about-wrap .logo {
float: right;
margin-top: 0.8em;
width: auto;
}
.about-wrap .reasons {
margin: 2.2em 400px 2.2em 2em;
}
.about-wrap .reasons li {
margin-bottom: 1.4em;
}
.about-wrap .steps {
clear: both;
overflow: hidden;
}
.about-wrap .step {
width: 46%;
float: left;
}
.about-wrap .step {
margin-bottom: 1.4em;
}
.about-wrap .step2,
.about-wrap .step4 {
float: right;
}
.about-wrap .step3 {
clear: both;
}
.about-wrap .dashicons-yes {
color: #19BE19;
font-size: 26px;
}
.about-wrap .button {
background-color: #0078C3;
border: 1px solid #005990;
border-radius: 4px;
color: #fff;
font-size: 16px;
font-weight: 600;
height: auto;
line-height: 1;
margin-bottom: 10px;
padding: 14px 30px;
text-align: center;
}
.about-wrap .button:hover,
.about-wrap .button:focus {
background-color: #005990;
color: #fff
}
@media only screen and (max-width: 767px) {
.about-wrap {
padding: 0;
}
.about-wrap h1 {
font-size: 26px;
}
.about-wrap h2 {
font-size: 22px;
}
.about-wrap p {
font-size: 14px;
}
.about-wrap ul,
.about-wrap ol {
font-size: 14px;
}
.about-wrap .logo {
width: 120px;
}
.about-wrap .reasons {
margin-right: 150px;
}
}
</style>
<?php
}
}
new WPForms_Constant_Contact;