<?php

[0] Fix | Delete

[1] Fix | Delete

/**

[2] Fix | Delete

* Manages email provider class instances.

[3] Fix | Delete

*/

[4] Fix | Delete

class ET_Core_API_Email_Providers {

[5] Fix | Delete

[6] Fix | Delete

private static $_instance;

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* @var ET_Core_Data_Utils

[10] Fix | Delete

*/

[11] Fix | Delete

protected static $_;

[12] Fix | Delete

[13] Fix | Delete

protected static $_any_custom_field_type;

[14] Fix | Delete

protected static $_custom_fields_support;

[15] Fix | Delete

protected static $_fields;

[16] Fix | Delete

protected static $_metadata;

[17] Fix | Delete

protected static $_names;

[18] Fix | Delete

protected static $_names_by_slug;

[19] Fix | Delete

protected static $_name_field_only = array();

[20] Fix | Delete

protected static $_slugs;

[21] Fix | Delete

[22] Fix | Delete

public static $providers = array();

[23] Fix | Delete

[24] Fix | Delete

public function __construct() {

[25] Fix | Delete

if ( null === self::$_metadata ) {

[26] Fix | Delete

$this->_initialize();

[27] Fix | Delete

}

[28] Fix | Delete

}

[29] Fix | Delete

[30] Fix | Delete

protected function _initialize() {

[31] Fix | Delete

self::$_ = ET_Core_Data_Utils::instance();

[32] Fix | Delete

self::$_metadata = et_core_get_components_metadata();

[33] Fix | Delete

$third_party_providers = et_core_get_third_party_components( 'api/email' );

[34] Fix | Delete

[35] Fix | Delete

$load_fields = is_admin() || et_core_is_saving_builder_modules_cache() || et_core_is_fb_enabled() || isset( $_GET['et_fb'] ); // phpcs:ignore WordPress.Security.NonceVerification.NoNonceVerification

[36] Fix | Delete

$all_names = array(

[37] Fix | Delete

'official' => self::$_metadata['groups']['api/email']['members'],

[38] Fix | Delete

'third-party' => array_keys( $third_party_providers ),

[39] Fix | Delete

);

[40] Fix | Delete

[41] Fix | Delete

$_names_by_slug = array();

[42] Fix | Delete

$_custom_fields_support = array( 'dynamic' => array(), 'predefined' => array(), 'none' => array() );

[43] Fix | Delete

$_any_custom_field_type = array();

[44] Fix | Delete

[45] Fix | Delete

foreach ( $all_names as $provider_type => $provider_names ) {

[46] Fix | Delete

$_names_by_slug[ $provider_type ] = array();

[47] Fix | Delete

[48] Fix | Delete

foreach ( $provider_names as $provider_name ) {

[49] Fix | Delete

if ( 'Fields' === $provider_name || self::$_->includes( $provider_name, 'Provider' ) ) {

[50] Fix | Delete

continue;

[51] Fix | Delete

}

[52] Fix | Delete

[53] Fix | Delete

if ( 'official' === $provider_type ) {

[54] Fix | Delete

$class_name = self::$_metadata[ $provider_name ];

[55] Fix | Delete

$provider_slug = self::$_metadata[ $class_name ]['slug'];

[56] Fix | Delete

$provider = $load_fields ? new $class_name( 'ET_Core', '' ) : null;

[57] Fix | Delete

} else {

[58] Fix | Delete

$provider = $third_party_providers[ $provider_name ];

[59] Fix | Delete

$provider_slug = is_object( $provider ) ? $provider->slug : '';

[60] Fix | Delete

}

[61] Fix | Delete

[62] Fix | Delete

if ( ! $provider_slug ) {

[63] Fix | Delete

continue;

[64] Fix | Delete

}

[65] Fix | Delete

[66] Fix | Delete

$_names_by_slug[ $provider_type ][ $provider_slug ] = $provider_name;

[67] Fix | Delete

[68] Fix | Delete

if ( $load_fields && is_object( $provider ) ) {

[69] Fix | Delete

self::$_fields[ $provider_slug ] = $provider->get_account_fields();

[70] Fix | Delete

[71] Fix | Delete

if ( $scope = $provider->custom_fields ) {

[72] Fix | Delete

$_custom_fields_support[ $scope ][ $provider_slug ] = $provider_name;

[73] Fix | Delete

[74] Fix | Delete

if ( ! self::$_->array_get( $provider->data_keys, 'custom_field_type' ) ) {

[75] Fix | Delete

$_any_custom_field_type[] = $provider_slug;

[76] Fix | Delete

}

[77] Fix | Delete

} else {

[78] Fix | Delete

$_custom_fields_support['none'][ $provider_slug ] = $provider_name;

[79] Fix | Delete

}

[80] Fix | Delete

}

[81] Fix | Delete

}

[82] Fix | Delete

}

[83] Fix | Delete

[84] Fix | Delete

/**

[85] Fix | Delete

* Filters the enabled email providers.

[86] Fix | Delete

*

[87] Fix | Delete

* @param array[] {

[88] Fix | Delete

*

[89] Fix | Delete

* @type string[] $provider_type {

[90] Fix | Delete

*

[91] Fix | Delete

* @type string $slug Provider name

[92] Fix | Delete

* }

[93] Fix | Delete

* }

[94] Fix | Delete

*/

[95] Fix | Delete

self::$_names_by_slug = apply_filters( 'et_core_api_email_enabled_providers', $_names_by_slug );

[96] Fix | Delete

[97] Fix | Delete

foreach ( array_keys( $all_names ) as $provider_type ) {

[98] Fix | Delete

self::$_names[ $provider_type ] = array_values( self::$_names_by_slug[ $provider_type ] );

[99] Fix | Delete

self::$_slugs[ $provider_type ] = array_keys( self::$_names_by_slug[ $provider_type ] );

[100] Fix | Delete

}

[101] Fix | Delete

[102] Fix | Delete

self::$_name_field_only = self::$_metadata['groups']['api/email']['name_field_only'];

[103] Fix | Delete

self::$_custom_fields_support = $_custom_fields_support;

[104] Fix | Delete

self::$_any_custom_field_type = $_any_custom_field_type;

[105] Fix | Delete

}

[106] Fix | Delete

[107] Fix | Delete

/**

[108] Fix | Delete

* Returns the email provider accounts array from core.

[109] Fix | Delete

*

[110] Fix | Delete

* @return array|mixed

[111] Fix | Delete

*/

[112] Fix | Delete

public function accounts() {

[113] Fix | Delete

return ET_Core_API_Email_Provider::get_accounts();

[114] Fix | Delete

}

[115] Fix | Delete

[116] Fix | Delete

/**

[117] Fix | Delete

* @see {@link \ET_Core_API_Email_Provider::account_exists()}

[118] Fix | Delete

*/

[119] Fix | Delete

public function account_exists( $provider, $account_name ) {

[120] Fix | Delete

return ET_Core_API_Email_Provider::account_exists( $provider, $account_name );

[121] Fix | Delete

}

[122] Fix | Delete

[123] Fix | Delete

public function account_fields( $provider = 'all' ) {

[124] Fix | Delete

if ( 'all' !== $provider ) {

[125] Fix | Delete

return isset( self::$_fields[ $provider ] ) ? self::$_fields[ $provider ] : array();

[126] Fix | Delete

}

[127] Fix | Delete

[128] Fix | Delete

return self::$_fields;

[129] Fix | Delete

}

[130] Fix | Delete

[131] Fix | Delete

public function custom_fields_data() {

[132] Fix | Delete

$enabled_providers = self::slugs();

[133] Fix | Delete

$custom_fields_data = array();

[134] Fix | Delete

[135] Fix | Delete

foreach ( $this->accounts() as $provider_slug => $accounts ) {

[136] Fix | Delete

if ( ! in_array( $provider_slug, $enabled_providers ) ) {

[137] Fix | Delete

continue;

[138] Fix | Delete

}

[139] Fix | Delete

[140] Fix | Delete

foreach ( $accounts as $account_name => $account_details ) {

[141] Fix | Delete

if ( empty( $account_details['lists'] ) ) {

[142] Fix | Delete

continue;

[143] Fix | Delete

}

[144] Fix | Delete

[145] Fix | Delete

if ( ! empty( $account_details['custom_fields'] ) ) {

[146] Fix | Delete

$custom_fields_data[$provider_slug][$account_name]['custom_fields'] = $account_details['custom_fields'];

[147] Fix | Delete

continue;

[148] Fix | Delete

}

[149] Fix | Delete

[150] Fix | Delete

foreach ( (array) $account_details['lists'] as $list_id => $list_details ) {

[151] Fix | Delete

if ( ! empty( $list_details['custom_fields'] ) ) {

[152] Fix | Delete

$custom_fields_data[$provider_slug][$account_name][$list_id] = $list_details['custom_fields'];

[153] Fix | Delete

}

[154] Fix | Delete

}

[155] Fix | Delete

}

[156] Fix | Delete

}

[157] Fix | Delete

[158] Fix | Delete

return $custom_fields_data;

[159] Fix | Delete

}

[160] Fix | Delete

[161] Fix | Delete

/**

[162] Fix | Delete

* Get class instance for a provider. Instance will be created if necessary.

[163] Fix | Delete

*

[164] Fix | Delete

* @param string $name_or_slug The provider's name or slug.

[165] Fix | Delete

* @param string $account_name The identifier for the desired account with the provider.

[166] Fix | Delete

* @param string $owner The owner for the instance.

[167] Fix | Delete

*

[168] Fix | Delete

* @return bool|ET_Core_API_Email_Provider The provider instance or `false` if not found.

[169] Fix | Delete

*/

[170] Fix | Delete

public function get( $name_or_slug, $account_name, $owner = 'ET_Core' ) {

[171] Fix | Delete

$name_or_slug = str_replace( ' ', '', $name_or_slug );

[172] Fix | Delete

$is_official = isset( self::$_metadata[ $name_or_slug ] );

[173] Fix | Delete

[174] Fix | Delete

if ( ! $is_official && ! $this->is_third_party( $name_or_slug ) ) {

[175] Fix | Delete

return false;

[176] Fix | Delete

}

[177] Fix | Delete

[178] Fix | Delete

if ( ! in_array( $name_or_slug, array_merge( self::names(), self::slugs() ) ) ) {

[179] Fix | Delete

return false;

[180] Fix | Delete

}

[181] Fix | Delete

[182] Fix | Delete

// Make sure we have the component name

[183] Fix | Delete

if ( $is_official ) {

[184] Fix | Delete

$class_name = self::$_metadata[ $name_or_slug ];

[185] Fix | Delete

$name = self::$_metadata[ $class_name ]['name'];

[186] Fix | Delete

} else {

[187] Fix | Delete

$components = et_core_get_third_party_components( 'api/email' );

[188] Fix | Delete

[189] Fix | Delete

if ( ! $name = array_search( $name_or_slug, self::$_names_by_slug['third-party'] ) ) {

[190] Fix | Delete

$name = $name_or_slug;

[191] Fix | Delete

}

[192] Fix | Delete

}

[193] Fix | Delete

[194] Fix | Delete

if ( ! isset( self::$providers[ $name ][ $owner ] ) ) {

[195] Fix | Delete

self::$providers[ $name ][ $owner ] = $is_official

[196] Fix | Delete

? new $class_name( $owner, $account_name )

[197] Fix | Delete

: $components[ $name ];

[198] Fix | Delete

}

[199] Fix | Delete

[200] Fix | Delete

return self::$providers[ $name ][ $owner ];

[201] Fix | Delete

}

[202] Fix | Delete

[203] Fix | Delete

public static function instance() {

[204] Fix | Delete

if ( null === self::$_instance ) {

[205] Fix | Delete

self::$_instance = new self;

[206] Fix | Delete

}

[207] Fix | Delete

[208] Fix | Delete

return self::$_instance;

[209] Fix | Delete

}

[210] Fix | Delete

[211] Fix | Delete

public function is_third_party( $name_or_slug ) {

[212] Fix | Delete

$is_third_party = in_array( $name_or_slug, self::$_names['third-party'] );

[213] Fix | Delete

[214] Fix | Delete

return $is_third_party ? $is_third_party : in_array( $name_or_slug, self::$_slugs['third-party'] );

[215] Fix | Delete

}

[216] Fix | Delete

[217] Fix | Delete

/**

[218] Fix | Delete

* Returns the names of available providers. List can optionally be filtered.

[219] Fix | Delete

*

[220] Fix | Delete

* @param string $type The component type to include ('official'|'third-party'|'all'). Default is 'all'.

[221] Fix | Delete

*

[222] Fix | Delete

* @return array

[223] Fix | Delete

*/

[224] Fix | Delete

public function names( $type = 'all' ) {

[225] Fix | Delete

if ( 'all' === $type ) {

[226] Fix | Delete

$names = array_merge( self::$_names['third-party'], self::$_names['official'] );

[227] Fix | Delete

} else {

[228] Fix | Delete

$names = self::$_names[ $type ];

[229] Fix | Delete

}

[230] Fix | Delete

[231] Fix | Delete

return $names;

[232] Fix | Delete

}

[233] Fix | Delete

[234] Fix | Delete

/**

[235] Fix | Delete

* Returns an array mapping the slugs of available providers to their names. List can optionally be filtered.

[236] Fix | Delete

*

[237] Fix | Delete

* @param string $type The component type to include ('official'|'third-party'|'all'). Default is 'all'.

[238] Fix | Delete

* @param string $filter Optionally filter the list by a condition.

[239] Fix | Delete

* Accepts 'name_field_only', 'predefined_custom_fields', 'dynamic_custom_fields',

[240] Fix | Delete

* 'no_custom_fields', 'any_custom_field_type', 'custom_fields'.

[241] Fix | Delete

*

[242] Fix | Delete

* @return array

[243] Fix | Delete

*/

[244] Fix | Delete

public function names_by_slug( $type = 'all', $filter = '' ) {

[245] Fix | Delete

if ( 'all' === $type ) {

[246] Fix | Delete

$names_by_slug = array_merge( self::$_names_by_slug['third-party'], self::$_names_by_slug['official'] );

[247] Fix | Delete

} else {

[248] Fix | Delete

$names_by_slug = self::$_names_by_slug[ $type ];

[249] Fix | Delete

}

[250] Fix | Delete

[251] Fix | Delete

if ( 'name_field_only' === $filter ) {

[252] Fix | Delete

$names_by_slug = self::$_name_field_only;

[253] Fix | Delete

} else if ( 'predefined_custom_fields' === $filter ) {

[254] Fix | Delete

$names_by_slug = self::$_custom_fields_support['predefined'];

[255] Fix | Delete

} else if ( 'dynamic_custom_fields' === $filter ) {

[256] Fix | Delete

$names_by_slug = self::$_custom_fields_support['dynamic'];

[257] Fix | Delete

} else if ( 'no_custom_fields' === $filter ) {

[258] Fix | Delete

$names_by_slug = self::$_custom_fields_support['none'];

[259] Fix | Delete

} else if ( 'any_custom_field_type' === $filter ) {

[260] Fix | Delete

$names_by_slug = self::$_any_custom_field_type;

[261] Fix | Delete

} else if ( 'custom_fields' === $filter ) {

[262] Fix | Delete

$names_by_slug = array_merge( self::$_custom_fields_support['predefined'], self::$_custom_fields_support['dynamic'] );

[263] Fix | Delete

}

[264] Fix | Delete

[265] Fix | Delete

return $names_by_slug;

[266] Fix | Delete

}

[267] Fix | Delete

[268] Fix | Delete

/**

[269] Fix | Delete

* @see {@link \ET_Core_API_Email_Provider::remove_account()}

[270] Fix | Delete

*/

[271] Fix | Delete

public function remove_account( $provider, $account_name ) {

[272] Fix | Delete

ET_Core_API_Email_Provider::remove_account( $provider, $account_name );

[273] Fix | Delete

}

[274] Fix | Delete

[275] Fix | Delete

/**

[276] Fix | Delete

* Returns the slugs of available providers. List can optionally be filtered.

[277] Fix | Delete

*

[278] Fix | Delete

* @param string $type The component type to include ('official'|'third-party'|'all'). Default is 'all'.

[279] Fix | Delete

*

[280] Fix | Delete

* @return array

[281] Fix | Delete

*/

[282] Fix | Delete

public function slugs( $type = 'all' ) {

[283] Fix | Delete

if ( 'all' === $type ) {

[284] Fix | Delete

$names = array_merge( self::$_slugs['third-party'], self::$_slugs['official'] );

[285] Fix | Delete

} else {

[286] Fix | Delete

$names = self::$_slugs[ $type ];

[287] Fix | Delete

}

[288] Fix | Delete

[289] Fix | Delete

return $names;

[290] Fix | Delete

}

[291] Fix | Delete

[292] Fix | Delete

/**

[293] Fix | Delete

* @see {@link \ET_Core_API_Email_Provider::update_account()}

[294] Fix | Delete

*/

[295] Fix | Delete

public function update_account( $provider, $account, $data ) {

[296] Fix | Delete

ET_Core_API_Email_Provider::update_account( $provider, $account, $data );

[297] Fix | Delete

}

[298] Fix | Delete

}

[299] Fix | Delete

[300] Fix | Delete