Email Service Integrations

// Access ActiveCampaign service
$service = new FLBuilderServiceActiveCampaign();

// MailChimp double opt-in filter
add_filter('fl_builder_mailchimp_double_option', '__return_true');

abstract class FLBuilderService {
    /**
     * Service ID (e.g., 'mailchimp', 'aweber')
     */
    public $id = '';

    /**
     * Test API connection
     * @param array $fields Connection fields
     * @return array {
     *     @type bool|string $error Error message or false
     *     @type array $data Connection data to save
     * }
     */
    abstract public function connect($fields = array());

    /**
     * Render connection settings form
     * @return string HTML markup
     */
    abstract public function render_connect_settings();

    /**
     * Render service-specific fields
     * @param string $account Account name
     * @param object $settings Module settings
     * @return array {
     *     @type bool|string $error Error message or false
     *     @type string $html Field markup
     * }
     */
    abstract public function render_fields($account, $settings);

    /**
     * Get saved account data
     * @param string $account Account name
     * @return array|bool Account data or false
     */
    public function get_account_data($account);
}

$mailchimp = new FLBuilderServiceMailChimp();
$account_data = $mailchimp->get_account_data('my-account');

if ($account_data) {
    $api_key = $account_data['api_key'];
    // Use account data
}

$mailchimp = new FLBuilderServiceMailChimp();

// Settings object from module
$settings = new stdClass();
$settings->service_account = 'my-account';
$settings->list_id = '1234567890';
$settings->tags = 'website,subscriber';

$result = $mailchimp->subscribe(
    $settings,
    '[email protected]',
    'John Doe'
);

if ($result['error']) {
    // Handle error
    echo $result['error'];
} else {
    // Success
    echo 'Subscribed successfully!';
}

$service = new FLBuilderServiceActiveCampaign();

$connection = $service->connect(array(
    'api_url' => 'https://account.api-us1.com',
    'api_key' => 'your-api-key'
));

if ($connection['error']) {
    echo 'Connection failed: ' . $connection['error'];
} else {
    // Save connection data
    $api_url = $connection['data']['api_url'];
    $api_key = $connection['data']['api_key'];
}

// Enable double opt-in
add_filter('fl_builder_mailchimp_double_option', '__return_true');

// Access groups
if (isset($settings->groups) && is_array($settings->groups)) {
    // Groups are saved as list_id_group_id_subgroup_id
}

// Use form instead of list
$settings->list_type = 'form';
$settings->form_id = '123';

// Add tags
$settings->tags = array('tag1', 'tag2');

// Tags as comma-separated string
$settings->tags = 'tag1, tag2, tag3';

// In a custom module
if (isset($settings->service)) {
    $service_class = 'FLBuilderService' . ucfirst($settings->service);
    
    if (class_exists($service_class)) {
        $service = new $service_class();
        // Use service
    }
}

// Load a specific service
if (class_exists('FLBuilderServiceMailChimp')) {
    $mailchimp = new FLBuilderServiceMailChimp();
} else {
    // Service not available
}

function handle_form_submission($email, $name, $settings) {
    // Get service class
    $service_name = $settings->service;
    $service_class = 'FLBuilderService' . ucfirst($service_name);
    
    if (!class_exists($service_class)) {
        return array('error' => 'Service not found');
    }
    
    // Create service instance
    $service = new $service_class();
    
    // Subscribe
    $result = $service->subscribe($settings, $email, $name);
    
    return $result;
}

function map_custom_fields($settings, $form_data) {
    // Get service
    $service = new FLBuilderServiceMailChimp();
    
    // Get account
    $account_data = $service->get_account_data($settings->service_account);
    
    if ($account_data) {
        $api = $service->get_api($account_data['api_key']);
        
        // Map custom fields
        $merge_fields = array(
            'FNAME' => $form_data['first_name'],
            'LNAME' => $form_data['last_name'],
            'PHONE' => $form_data['phone'],
        );
        
        // Subscribe with custom fields
    }
}

$mailchimp = new FLBuilderServiceMailChimp();
$api = $mailchimp->get_api($api_key);

// Use MailChimp API directly
$lists = $api->getLists();

$result = $service->subscribe($settings, $email, $name);

if ($result['error']) {
    // Handle error
    error_log('Subscription failed: ' . $result['error']);
    
    // Display user-friendly message
    return array(
        'success' => false,
        'message' => __('Unable to subscribe. Please try again.', 'your-plugin')
    );
}

// Success
return array(
    'success' => true,
    'message' => __('Successfully subscribed!', 'your-plugin')
);