%9$s
%10$s
', esc_html__( 'Create an integration user', 'advanced-form-integration' ), esc_html__( 'Open SuperOffice Admin to register an application with REST API access.', 'advanced-form-integration' ), esc_html__( 'Generate a system user or OAuth access token with contact permissions.', 'advanced-form-integration' ), esc_html__( 'Copy the App Token if your environment requires the SO-AppToken header.', 'advanced-form-integration' ), esc_html__( 'Connect to AFI', 'advanced-form-integration' ), esc_html__( 'Paste the tenant REST base URL, for example https://sod.superoffice.com/api/v1/.', 'advanced-form-integration' ), esc_html__( 'Enter the bearer access token and optional App Token or Context Identifier, then save.', 'advanced-form-integration' ), esc_html__( 'Choose the saved credentials when you build an integration and map the fields you need.', 'advanced-form-integration' ), esc_html__( 'AFI sends Authorization, SO-AppToken, and SO-ContextIdentifier headers with every request.', 'advanced-form-integration' ), esc_html__( 'Upgrade to SuperOffice CRM [PRO] to sync people, sales, and user-defined fields automatically.', 'advanced-form-integration' ) ); echo adfoin_platform_settings_template( $title, $key, $arguments, $instructions ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped } add_action( 'adfoin_action_fields', 'adfoin_superoffice_action_fields' ); function adfoin_superoffice_action_fields() { ?> 'Name', 'value' => __( 'Company Name', 'advanced-form-integration' ), 'required' => true ), array( 'key' => 'Department', 'value' => __( 'Department', 'advanced-form-integration' ) ), array( 'key' => 'CategoryId', 'value' => __( 'Category ID', 'advanced-form-integration' ) ), array( 'key' => 'BusinessId', 'value' => __( 'Business ID', 'advanced-form-integration' ) ), array( 'key' => 'Number1', 'value' => __( 'Phone (Number1)', 'advanced-form-integration' ) ), array( 'key' => 'Number2', 'value' => __( 'Phone (Number2)', 'advanced-form-integration' ) ), array( 'key' => 'UrlAddress', 'value' => __( 'Website URL', 'advanced-form-integration' ) ), array( 'key' => 'Emails[0].Value', 'value' => __( 'Primary Email', 'advanced-form-integration' ) ), array( 'key' => 'Emails[0].Description', 'value' => __( 'Email Description', 'advanced-form-integration' ) ), array( 'key' => 'Phones[0].Value', 'value' => __( 'Primary Phone', 'advanced-form-integration' ) ), array( 'key' => 'Phones[0].Description', 'value' => __( 'Phone Description', 'advanced-form-integration' ) ), array( 'key' => 'PostalAddress.Address1', 'value' => __( 'Address Line 1', 'advanced-form-integration' ) ), array( 'key' => 'PostalAddress.Address2', 'value' => __( 'Address Line 2', 'advanced-form-integration' ) ), array( 'key' => 'PostalAddress.City', 'value' => __( 'City', 'advanced-form-integration' ) ), array( 'key' => 'PostalAddress.Zipcode', 'value' => __( 'Postal Code', 'advanced-form-integration' ) ), array( 'key' => 'PostalAddress.Country', 'value' => __( 'Country', 'advanced-form-integration' ) ), array( 'key' => 'Description', 'value' => __( 'Description', 'advanced-form-integration' ), 'type' => 'textarea' ), ); wp_send_json_success( $fields ); } add_action( 'adfoin_superoffice_job_queue', 'adfoin_superoffice_job_queue', 10, 1 ); function adfoin_superoffice_job_queue( $data ) { adfoin_superoffice_send_contact( $data['record'], $data['posted_data'] ); } function adfoin_superoffice_send_contact( $record, $posted_data ) { $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; } $credentials = adfoin_superoffice_get_credentials( $cred_id ); if ( is_wp_error( $credentials ) ) { return; } $mapped_fields = array(); foreach ( $field_data as $key => $value ) { if ( 'credId' === $key ) { continue; } $parsed = adfoin_get_parsed_values( $value, $posted_data ); if ( '' === $parsed || null === $parsed ) { continue; } $mapped_fields[ $key ] = $parsed; } if ( empty( $mapped_fields['Name'] ) ) { return; } $payload = adfoin_superoffice_build_payload( $mapped_fields ); if ( empty( $payload ) ) { return; } adfoin_superoffice_request( 'Contact', 'POST', $payload, $record, $credentials ); } if ( ! function_exists( 'adfoin_superoffice_credentials_list' ) ) : function adfoin_superoffice_credentials_list() { $credentials = adfoin_read_credentials( 'superoffice' ); foreach ( $credentials as $option ) { printf( '', esc_attr( $option['id'] ), esc_html( $option['title'] ) ); } } endif; if ( ! function_exists( 'adfoin_superoffice_get_credentials' ) ) : function adfoin_superoffice_get_credentials( $cred_id ) { $credentials = adfoin_get_credentials_by_id( 'superoffice', $cred_id ); if ( ! $credentials ) { return new WP_Error( 'missing_credentials', __( 'SuperOffice credentials not found.', 'advanced-form-integration' ) ); } return $credentials; } endif; if ( ! function_exists( 'adfoin_superoffice_request' ) ) : function adfoin_superoffice_request( $endpoint, $method = 'GET', $data = array(), $record = array(), $credentials = array() ) { if ( empty( $credentials ) ) { return new WP_Error( 'missing_credentials', __( 'SuperOffice credentials missing.', 'advanced-form-integration' ) ); } $base_url = isset( $credentials['restBaseUrl'] ) ? trim( $credentials['restBaseUrl'] ) : ''; if ( '' === $base_url ) { return new WP_Error( 'missing_base_url', __( 'SuperOffice REST base URL is not set.', 'advanced-form-integration' ) ); } $base_url = trailingslashit( $base_url ); $url = $base_url . ltrim( $endpoint, '/' ); $headers = array( 'Content-Type' => 'application/json', 'Accept' => 'application/json', ); if ( ! empty( $credentials['accessToken'] ) ) { $headers['Authorization'] = 'Bearer ' . $credentials['accessToken']; } if ( ! empty( $credentials['appToken'] ) ) { $headers['SO-AppToken'] = $credentials['appToken']; } if ( ! empty( $credentials['contextIdentifier'] ) ) { $headers['SO-ContextIdentifier'] = $credentials['contextIdentifier']; } $args = array( 'timeout' => 30, 'method' => strtoupper( $method ), 'headers' => $headers, ); if ( in_array( $args['method'], array( 'POST', 'PUT', 'PATCH' ), true ) ) { $args['body'] = wp_json_encode( $data ); } $response = wp_remote_request( $url, $args ); if ( $record ) { adfoin_add_to_log( $response, $url, $args, $record ); } return $response; } endif; if ( ! function_exists( 'adfoin_superoffice_build_payload' ) ) : function adfoin_superoffice_build_payload( $fields ) { $payload = array(); foreach ( $fields as $path => $value ) { adfoin_superoffice_assign_path( $payload, $path, adfoin_superoffice_normalize_value( $path, $value ) ); } return $payload; } endif; if ( ! function_exists( 'adfoin_superoffice_assign_path' ) ) : function adfoin_superoffice_assign_path( array &$target, $path, $value ) { if ( '' === $path ) { return; } $segments = explode( '.', $path ); $last = count( $segments ) - 1; $ref =& $target; foreach ( $segments as $index => $segment ) { if ( preg_match( '/^([^\[\]]+)\[(\d+)\]$/', $segment, $matches ) ) { $key = $matches[1]; $array_index = (int) $matches[2]; if ( ! isset( $ref[ $key ] ) || ! is_array( $ref[ $key ] ) ) { $ref[ $key ] = array(); } if ( ! isset( $ref[ $key ][ $array_index ] ) || ! is_array( $ref[ $key ][ $array_index ] ) ) { $ref[ $key ][ $array_index ] = array(); } if ( $index === $last ) { $ref[ $key ][ $array_index ] = $value; } else { $ref =& $ref[ $key ][ $array_index ]; } continue; } if ( $index === $last ) { $ref[ $segment ] = $value; } else { if ( ! isset( $ref[ $segment ] ) || ! is_array( $ref[ $segment ] ) ) { $ref[ $segment ] = array(); } $ref =& $ref[ $segment ]; } } } endif; if ( ! function_exists( 'adfoin_superoffice_normalize_value' ) ) : function adfoin_superoffice_normalize_value( $path, $value ) { if ( is_array( $value ) ) { return $value; } $trimmed = is_string( $value ) ? trim( $value ) : $value; $last_segment = $path; if ( false !== strpos( $path, '.' ) ) { $parts = explode( '.', $path ); $last_segment = end( $parts ); } if ( preg_match( '/^([^\[\]]+)\[(\d+)\]$/', $last_segment, $matches ) ) { $last_segment = $matches[1]; } $int_fields = array( 'CategoryId', 'BusinessId', 'AssociateId', 'OwnerContactId', 'NumberOfEmployees', 'ContactId', 'PersonId', 'CountryId' ); $float_fields = array( 'Amount', 'WeightedAmount' ); $bool_fields = array( 'HasConsent', 'ConsentGiven', 'ConsentObtained', 'Active', 'Done' ); if ( in_array( $last_segment, $int_fields, true ) && '' !== $trimmed ) { return (int) $trimmed; } if ( in_array( $last_segment, $float_fields, true ) && '' !== $trimmed ) { return (float) $trimmed; } if ( in_array( $last_segment, $bool_fields, true ) ) { if ( is_bool( $value ) ) { return $value; } $lower = strtolower( (string) $trimmed ); return in_array( $lower, array( '1', 'true', 'yes', 'on' ), true ); } return $value; } endif;