/home/altere25/infinet.finance/wp-content/plugins/wpforms/includes/providers
Edit: /home/altere25/infinet.finance/wp-content/plugins/wpforms/includes/providers/class-base.php (34771B)
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()->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( '
', $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 .= '
';
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 = '';
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 = '
';
$output .= sprintf( '
%s ', esc_html__( 'Select Account', 'wpforms-lite' ) );
$output .= sprintf( '', $this->slug, $connection_id );
foreach ( $providers[ $this->slug ] as $key => $provider_details ) {
$selected = ! empty( $connection['account_id'] ) ? $connection['account_id'] : '';
$output .= sprintf(
'%s ',
$key,
selected( $selected, $key, false ),
esc_html( $provider_details['label'] )
);
}
$output .= sprintf( '%s', esc_html__( 'Add New Account', 'wpforms-lite' ) );
$output .= ' ';
$output .= '';
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 = '
';
$output .= sprintf( '
%s ', esc_html__( 'Select List', 'wpforms-lite' ) );
$output .= sprintf( '', $this->slug, $connection_id );
if ( ! empty( $lists ) ) {
foreach ( $lists as $list ) {
$output .= sprintf(
'%s ',
esc_attr( $list['id'] ),
selected( $selected, $list['id'], false ),
esc_attr( $list['name'] )
);
}
}
$output .= ' ';
$output .= '';
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 = '
';
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 = '
';
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 '';
}
/**
* 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'] : '';
?>
builder_output_before(); ?>
name ); ?>
type )
);
?>
slug )->is_ready( $form_id ),
$this->slug,
$this->name,
$this->icon
);
?>
builder_output_after(); ?>
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 = '
';
$account .= '' . sanitize_text_field( $data['label'] ) . ' ';
/* translators: %s - Connection date. */
$account .= '' . sprintf( esc_html__( 'Connected on: %s', 'wpforms-lite' ), date_i18n( get_option( 'date_format', time() ) ) ) . ' ';
$account .= '' . esc_html__( 'Disconnect', 'wpforms-lite' ) . ' ';
$account .= ' ';
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';
}
}
?>
slug . '-error', $message );
}
}