Edit file File name : class-base.php Content :<?php use WPForms\Providers\Provider\Settings\FormBuilder; use WPForms\Providers\Provider\Status; /** * Provider class. * * @since 1.0.0 */ 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; /** * Store 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(); $this->hooks(); } /** * Hooks. * * @since 1.6.8 */ private function hooks() { // Add to list of available providers. add_filter( 'wpforms_providers_available', [ $this, 'register_provider' ], $this->priority, 1 ); // Process builder AJAX requests. add_action( "wp_ajax_wpforms_provider_ajax_{$this->slug}", [ $this, 'process_ajax' ] ); // Process entry. add_action( 'wpforms_process_complete', [ $this, 'process_entry' ], 5, 4 ); // Fetch and store the current form data when in the builder. add_action( 'wpforms_builder_init', [ $this, 'builder_form_data' ] ); // Output builder sidebar. add_action( 'wpforms_providers_panel_sidebar', [ $this, 'builder_sidebar' ], $this->priority ); // Output builder content. add_action( 'wpforms_providers_panel_content', [ $this, 'builder_output' ], $this->priority ); // Remove provider from Settings Integrations tab. add_action( "wp_ajax_wpforms_settings_provider_disconnect_{$this->slug}", [ $this, 'integrations_tab_disconnect' ] ); // Add new provider from Settings Integrations tab. add_action( "wp_ajax_wpforms_settings_provider_add_{$this->slug}", [ $this, 'integrations_tab_add' ] ); // Add providers sections to the Settings Integrations tab. add_action( 'wpforms_settings_providers', [ $this, 'integrations_tab_options' ], $this->priority, 2 ); } /** * 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 = [] ) { $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( 'edit_forms' ) ) { wp_send_json_error( [ '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'] ) ) ) : []; //phpcs:ignore /* * Create new connection. */ if ( 'new_connection' === $task ) { $connection = $this->output_connection( '', [ 'connection_name' => $name, ], $id ); wp_send_json_success( [ '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( [ 'error' => $auth->get_error_message(), ] ); } else { $accounts = $this->output_accounts( $connection_id, [ 'account_id' => $auth, ] ); wp_send_json_success( [ 'html' => $accounts, ] ); } } /* * Select/Toggle Provider accounts. */ if ( 'select_account' === $task ) { $lists = $this->output_lists( $connection_id, [ 'account_id' => $account_id, ] ); if ( is_wp_error( $lists ) ) { wp_send_json_error( [ 'error' => $lists->get_error_message(), ] ); } else { wp_send_json_success( [ 'html' => $lists, ] ); } } /* * Select/Toggle Provider account lists. */ if ( 'select_list' === $task ) { $fields = $this->output_fields( $connection_id, [ 'account_id' => $account_id, 'list_id' => $list_id, ], $id ); if ( is_wp_error( $fields ) ) { wp_send_json_error( [ 'error' => $fields->get_error_message(), ] ); } else { $groups = $this->output_groups( $connection_id, [ 'account_id' => $account_id, 'list_id' => $list_id, ] ); $conditionals = $this->output_conditionals( $connection_id, [ 'account_id' => $account_id, 'list_id' => $list_id, ], [ 'id' => absint( $_POST['form_id'] ), //phpcs:ignore ] ); $options = $this->output_options( $connection_id, [ 'account_id' => $account_id, 'list_id' => $list_id, ] ); wp_send_json_success( [ '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'] ) || ! function_exists( 'wpforms_conditional_logic' ) ) { return true; } $process = wpforms_conditional_logic()->process( $fields, $form_data, $connection['conditionals'] ); if ( ! empty( $connection['conditional_type'] ) && $connection['conditional_type'] === 'stop' ) { $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 = [] ) { // Accept form (post) object or form ID. if ( is_object( $form ) ) { $form = wpforms_decode( $form->post_content ); } elseif ( is_numeric( $form ) ) { $form = wpforms()->get( 'form' )->get( $form, [ 'content_only' => true, ] ); } if ( ! is_array( $form ) || empty( $form['fields'] ) ) { return false; } // White list of field types to allow. $allowed_form_fields = [ '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 = [], $form_field_type = '' ) { if ( empty( $form_fields ) || empty( $form_field_type ) ) { return []; } $formatted = []; // Include only specific field types. foreach ( $form_fields as $id => $form_field ) { // Email. if ( 'email' === $form_field_type && ! in_array( $form_field['type'], [ 'text', 'email' ], true ) ) { unset( $form_fields[ $id ] ); } // Address. if ( 'address' === $form_field_type && ! in_array( $form_field['type'], [ '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[] = [ '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[] = [ '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[] = [ '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[] = [ '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[] = [ '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 = [], $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 = [], $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 = [] ) { 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-trash-o"></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 = [] ) { 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 = [] ) { 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 = [] ) { 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 = [], $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'] ) && (int) $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 Unique connection ID. * @param array $connection Configured connection properties. * @param string|array $form Form properties. * * @return string */ public function output_conditionals( $connection_id = '', $connection = [], $form = '' ) { if ( empty( $connection['account_id'] ) || ! function_exists( 'wpforms_conditional_logic' ) ) { return ''; } return wpforms_conditional_logic()->builder_block( [ '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 = [] ) { } /******************************************************** * 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() { // phpcs:disable WordPress.Security.NonceVerification.Recommended if ( empty( $_GET['form_id'] ) || ! empty( $this->form_data ) ) { return; } $revisions = wpforms()->get( 'revisions' ); $revision = $revisions ? $revisions->get_revision() : null; if ( $revision ) { // Setup form data based on the revision_id. $this->form_data = wpforms_decode( $revision->post_content ); return; } // Setup form data based on the ID. $form = wpforms()->get( 'form' ); if ( ! $form ) { return; } $this->form_data = $form->get( absint( $_GET['form_id'] ), [ 'content_only' => true ] ); // phpcs:enable WordPress.Security.NonceVerification.Recommended } /** * 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 ); } } } } } /** * Get provider configured status. * * @since 1.6.8 */ private function get_configured() { return ! empty( $this->form_data['id'] ) && Status::init( $this->slug )->is_ready( $this->form_data['id'] ) ? 'configured' : ''; } /** * Display content inside the panel sidebar area. * * @since 1.0.0 */ public function builder_sidebar() { $configured = $this->get_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>'; } /** * Wrap the builder content with the required markup. * * @since 1.0.0 */ public function builder_output() { $form_id = ! empty( $this->form_data['id'] ) ? $this->form_data['id'] : ''; ?> <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 esc_html( $this->name ); ?> <button class="wpforms-provider-connections-add" data-form_id="<?php echo absint( $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> <?php FormBuilder::display_content_default_screen( Status::init( $this->slug )->is_ready( $form_id ), $this->slug, $this->name, $this->icon ); ?> <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( [ 'error' => esc_html__( 'You do not have permission', 'wpforms-lite' ), ] ); } if ( empty( $_POST['provider'] ) || empty( $_POST['key'] ) ) { wp_send_json_error( [ '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( [ '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( [ 'error' => esc_html__( 'You do not have permission', 'wpforms-lite' ), ] ); } if ( empty( $_POST['data'] ) ) { wp_send_json_error( [ 'error' => esc_html__( 'Missing data', 'wpforms-lite' ), ] ); } $data = wp_parse_args( $_POST['data'], [] ); $auth = $this->api_auth( $data, '' ); if ( is_wp_error( $auth ) ) { wp_send_json_error( [ '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>'; $account .= '<span class="date">'; $account .= esc_html( sprintf( /* translators: %1$s - Connection date. */ __( 'Connected on: %1$s', 'wpforms-lite' ), wpforms_date_format( time(), '', true ) ) ); $account .= '</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( [ '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 ] : []; $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 printf( /* translators: %s - provider name. */ 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>'; echo '<span class="date">'; echo esc_html( sprintf( /* translators: %1$s - Connection date. */ __( 'Connected on: %1$s', 'wpforms-lite' ), wpforms_date_format( (int) $account['date'], '', true ) ) ); echo '</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 ); } } Save