__( 'EZ Texting', 'advanced-form-integration' ),
'tasks' => array(
'create_contact' => __( 'Create Contact', 'advanced-form-integration' ),
),
);
return $actions;
}
add_filter( 'adfoin_settings_tabs', 'adfoin_eztexting_settings_tab', 10, 1 );
function adfoin_eztexting_settings_tab( $providers ) {
$providers['eztexting'] = __( 'EZ Texting', 'advanced-form-integration' );
return $providers;
}
add_action( 'adfoin_settings_view', 'adfoin_eztexting_settings_view', 10, 1 );
function adfoin_eztexting_settings_view( $current_tab ) {
if ( 'eztexting' !== $current_tab ) {
return;
}
if ( ! class_exists( 'ADFOIN_Account_Manager' ) ) {
require_once plugin_dir_path( __FILE__ ) . '../../includes/class-adfoin-account-manager.php';
}
$fields = array(
array(
'name' => 'appKey',
'label' => __( 'App Key', 'advanced-form-integration' ),
'type' => 'text',
'required' => true,
'mask' => true,
'show_in_table' => true,
),
array(
'name' => 'appSecret',
'label' => __( 'App Secret', 'advanced-form-integration' ),
'type' => 'text',
'required' => true,
'mask' => true,
'show_in_table' => false,
),
);
$instructions = sprintf(
'
- %s
- %s
',
esc_html__( 'In EZ Texting open your profile → API and create an App Key / App Secret pair.', 'advanced-form-integration' ),
esc_html__( 'Paste both below. AFI exchanges them for an access token at a.eztexting.com/v1/tokens/create and caches it until expiry.', 'advanced-form-integration' )
);
ADFOIN_Account_Manager::render_settings_view( 'eztexting', __( 'EZ Texting', 'advanced-form-integration' ), $fields, $instructions );
}
add_action( 'wp_ajax_adfoin_get_eztexting_credentials', 'adfoin_get_eztexting_credentials', 10, 0 );
function adfoin_get_eztexting_credentials() {
if ( ! class_exists( 'ADFOIN_Account_Manager' ) ) {
require_once plugin_dir_path( __FILE__ ) . '../../includes/class-adfoin-account-manager.php';
}
ADFOIN_Account_Manager::ajax_get_credentials_list( 'eztexting' );
}
add_action( 'wp_ajax_adfoin_save_eztexting_credentials', 'adfoin_save_eztexting_credentials', 10, 0 );
function adfoin_save_eztexting_credentials() {
if ( ! class_exists( 'ADFOIN_Account_Manager' ) ) {
require_once plugin_dir_path( __FILE__ ) . '../../includes/class-adfoin-account-manager.php';
}
ADFOIN_Account_Manager::ajax_save_credentials( 'eztexting', array( 'appKey', 'appSecret' ) );
}
if ( ! function_exists( 'adfoin_eztexting_credentials_list' ) ) :
function adfoin_eztexting_credentials_list() {
foreach ( adfoin_read_credentials( 'eztexting' ) as $option ) {
printf( '', esc_attr( $option['id'] ), esc_html( $option['title'] ) );
}
}
endif;
add_action( 'adfoin_action_fields', 'adfoin_eztexting_action_fields' );
function adfoin_eztexting_action_fields() {
?>
'phoneNumber', 'value' => __( 'Phone Number (E.164 or digits)', 'advanced-form-integration' ), 'required' => true ),
array( 'key' => 'firstName', 'value' => __( 'First Name', 'advanced-form-integration' ) ),
array( 'key' => 'lastName', 'value' => __( 'Last Name', 'advanced-form-integration' ) ),
array( 'key' => 'email', 'value' => __( 'Email', 'advanced-form-integration' ) ),
array( 'key' => 'note', 'value' => __( 'Note', 'advanced-form-integration' ), 'type' => 'textarea' ),
array( 'key' => 'groupIds', 'value' => __( 'Group IDs (comma separated)', 'advanced-form-integration' ) ),
);
}
add_action( 'adfoin_eztexting_job_queue', 'adfoin_eztexting_job_queue', 10, 1 );
function adfoin_eztexting_job_queue( $data ) {
adfoin_eztexting_send_data( $data['record'], $data['posted_data'] );
}
function adfoin_eztexting_send_data( $record, $posted_data ) {
if ( 'create_contact' !== ( $record['task'] ?? '' ) ) {
return;
}
$record_data = json_decode( $record['data'], true );
if ( adfoin_check_conditional_logic( $record_data['action_data']['cl'] ?? array(), $posted_data ) ) {
return;
}
$field_data = isset( $record_data['field_data'] ) ? $record_data['field_data'] : array();
$cred_id = isset( $field_data['credId'] ) ? $field_data['credId'] : '';
if ( ! $cred_id ) {
return;
}
$phone = isset( $field_data['phoneNumber'] )
? trim( (string) adfoin_get_parsed_values( $field_data['phoneNumber'], $posted_data ) )
: '';
if ( '' === $phone ) {
return;
}
$payload = array( 'phoneNumber' => $phone );
foreach ( array( 'firstName', 'lastName', 'email', 'note' ) as $key ) {
if ( empty( $field_data[ $key ] ) ) {
continue;
}
$value = trim( (string) adfoin_get_parsed_values( $field_data[ $key ], $posted_data ) );
if ( '' !== $value ) {
$payload[ $key ] = $value;
}
}
if ( ! empty( $field_data['groupIds'] ) ) {
$raw = adfoin_get_parsed_values( $field_data['groupIds'], $posted_data );
$groups = is_array( $raw )
? array_map( 'trim', array_map( 'strval', $raw ) )
: array_map( 'trim', explode( ',', (string) $raw ) );
$groups = array_values( array_filter( $groups, 'strlen' ) );
if ( ! empty( $groups ) ) {
$payload['groupIds'] = $groups;
}
}
$payload = apply_filters( 'adfoin_eztexting_contact_payload', $payload, $field_data, $posted_data );
adfoin_eztexting_request( 'contacts', 'POST', $payload, $record, $cred_id );
}
if ( ! function_exists( 'adfoin_eztexting_get_access_token' ) ) :
/**
* Exchange appKey + appSecret for an access token, cached per credential.
*
* @return string|WP_Error
*/
function adfoin_eztexting_get_access_token( $credentials, $force_refresh = false ) {
$app_key = isset( $credentials['appKey'] ) ? trim( (string) $credentials['appKey'] ) : '';
$app_secret = isset( $credentials['appSecret'] ) ? trim( (string) $credentials['appSecret'] ) : '';
if ( '' === $app_key || '' === $app_secret ) {
return new WP_Error( 'eztexting_missing_auth', __( 'EZ Texting App Key or App Secret is missing.', 'advanced-form-integration' ) );
}
$cred_id = isset( $credentials['id'] ) ? (string) $credentials['id'] : md5( $app_key );
$cache_key = 'adfoin_eztexting_token_' . $cred_id;
if ( ! $force_refresh ) {
$cached = get_transient( $cache_key );
if ( is_string( $cached ) && $cached ) {
return $cached;
}
}
$response = wp_remote_post( 'https://a.eztexting.com/v1/tokens/create', array(
'timeout' => 30,
'headers' => array(
'Content-Type' => 'application/json',
'Accept' => 'application/json',
),
'body' => wp_json_encode( array(
'appKey' => $app_key,
'appSecret' => $app_secret,
) ),
) );
if ( is_wp_error( $response ) ) {
return $response;
}
$body = json_decode( wp_remote_retrieve_body( $response ), true );
if ( empty( $body['accessToken'] ) ) {
$message = $body['message'] ?? __( 'Unable to obtain EZ Texting access token.', 'advanced-form-integration' );
return new WP_Error( 'eztexting_token_error', $message, array( 'status' => wp_remote_retrieve_response_code( $response ) ) );
}
$expires_in = isset( $body['expiresIn'] ) ? (int) $body['expiresIn'] : 3600;
set_transient( $cache_key, $body['accessToken'], max( 60, $expires_in - 60 ) );
return $body['accessToken'];
}
endif;
if ( ! function_exists( 'adfoin_eztexting_request' ) ) :
/**
* Call the EZ Texting v1 API. Bearer token via cached exchange.
*
* @param string $endpoint Path under /v1/.
* @param string $method HTTP verb.
* @param mixed $data Body (POST/PUT/PATCH) or query (GET).
* @param array $record Submission record for logging.
* @param string $cred_id Saved credential id.
*
* @return array|WP_Error
*/
function adfoin_eztexting_request( $endpoint, $method = 'POST', $data = array(), $record = array(), $cred_id = '' ) {
$credentials = $cred_id && function_exists( 'adfoin_get_credentials_by_id' )
? adfoin_get_credentials_by_id( 'eztexting', $cred_id )
: array();
if ( ! is_array( $credentials ) || empty( $credentials ) ) {
return new WP_Error( 'eztexting_missing_credentials', __( 'EZ Texting credentials not found.', 'advanced-form-integration' ) );
}
$token = adfoin_eztexting_get_access_token( $credentials );
if ( is_wp_error( $token ) ) {
if ( $record ) {
adfoin_add_to_log( $token, '', array(), $record );
}
return $token;
}
$url = 'https://api.eztexting.com/v1/' . ltrim( $endpoint, '/' );
$method = strtoupper( $method );
$args = array(
'timeout' => 30,
'method' => $method,
'headers' => array(
'Authorization' => 'Bearer ' . $token,
'Accept' => 'application/json',
),
);
if ( 'GET' === $method ) {
if ( is_array( $data ) && ! empty( $data ) ) {
$url = add_query_arg( $data, $url );
}
} else {
$args['headers']['Content-Type'] = 'application/json';
$args['body'] = wp_json_encode( $data );
}
$response = wp_remote_request( $url, $args );
if ( $record ) {
adfoin_add_to_log( $response, $url, $args, $record );
}
// One-shot reactive refresh on 401.
if ( ! is_wp_error( $response ) && 401 === (int) wp_remote_retrieve_response_code( $response ) ) {
$token = adfoin_eztexting_get_access_token( $credentials, true );
if ( ! is_wp_error( $token ) ) {
$args['headers']['Authorization'] = 'Bearer ' . $token;
$response = wp_remote_request( $url, $args );
if ( $record ) {
adfoin_add_to_log( $response, $url, $args, $record );
}
}
}
return $response;
}
endif;