_description = esc_html__( 'Get awesome by your form.', 'forminator' );
$this->is_multi_global = true;
}
/**
* Check if user already completed settings
*
* @return bool
*/
public function is_authorized() {
$setting_values = $this->get_settings_values();
return ! empty( $setting_values['api_key'] );
}
/**
* Return with true / false, you may update you setting update message too
*
* @param string $api_key API key.
*
* @return bool
*/
protected function validate_api_keys( $api_key ) {
try {
// Check API Key and Secret key.
$info = $this->get_api( $api_key )->get_info();
forminator_addon_maybe_log( __METHOD__, $info );
} catch ( Forminator_Integration_Exception $e ) {
$this->_update_settings_error_message = $e->getMessage();
return false;
}
return true;
}
/**
* Get API Instance
*
* @param string|null $api_key API key.
*
* @return Forminator_Mailerlite_Wp_Api|null
*/
public function get_api( $api_key = null ) {
if ( is_null( $api_key ) ) {
$api_key = $this->get_api_key();
}
$api = Forminator_Mailerlite_Wp_Api::get_instance( $api_key );
return $api;
}
/**
* Get currently saved api key
*
* @return string|null
*/
private function get_api_key() {
$setting_values = $this->get_settings_values( true );
if ( isset( $setting_values['api_key'] ) ) {
return $setting_values['api_key'];
}
return null;
}
/**
* Build settings help on settings
*
* @return string
*/
private function settings_help() {
$help = '';
if ( $this->is_authorized() ) {
// Show currently connected mailerlite account if it's already connected.
$help .= esc_html__( 'Change your API Key or disconnect this MailerLite Integration below.', 'forminator' );
} else {
// Display how to get mailerlite API Key by default.
/* Translators: 1. Opening tag with link to the MailerLite API Key, 2. closing tag. */
$help .= sprintf( esc_html__( 'Please get your MailerLite API Key %1$shere%2$s', 'forminator' ), '', '' );
}
$help .= '';
return $help;
}
/**
* Settings description
*
* @return string
*/
private function settings_description() {
$description = '';
if ( $this->is_authorized() ) {
// Show currently connected mailerlite account if its already connected.
$description .= '' . esc_html__( 'Please note that changing your API Key or disconnecting this integration will affect ALL of your connected forms.', 'forminator' ) . '';
}
return $description;
}
/**
* Settings wizard
*
* @return array
*/
public function settings_wizards() {
return array(
array(
'callback' => array( $this, 'configure_api_key' ),
'is_completed' => array( $this, 'is_authorized' ),
),
);
}
/**
* Wizard of configure_api_key
*
* @param array $submitted_data Submitted data.
*
* @return array
*/
public function configure_api_key( $submitted_data ) {
$setting_values = $this->get_settings_values();
$identifier = $setting_values['identifier'] ?? '';
$api_key = $this->get_api_key();
// ON Submit.
if ( isset( $submitted_data['api_key'] ) ) {
$api_key = $submitted_data['api_key'];
$identifier = $submitted_data['identifier'] ?? '';
if ( empty( $api_key ) ) {
$api_key_error_message = esc_html__( 'Please add valid MailerLite API Key.', 'forminator' );
} else {
$real_api_key = $this->get_real_value( $api_key, 'api_key' );
$api_key_validated = $this->validate_api_keys( $real_api_key );
/**
* Filter validating api key result
*
* @param bool $api_key_validated
* @param string $api_key API Key to be validated.
*/
$api_key_validated = apply_filters( 'forminator_addon_mailerlite_validate_api_keys', $api_key_validated, $api_key );
if ( ! $api_key_validated ) {
$error_message = $this->_update_settings_error_message;
$api_key_error_message = esc_html__( 'Invalid API key. Please check and try again.', 'forminator' );
} else {
$save_values = array(
'api_key' => $real_api_key,
'identifier' => $identifier,
);
if ( ! forminator_addon_is_active( $this->get_slug() ) ) {
$activated = Forminator_Integration_Loader::get_instance()->activate_addon( $this->get_slug() );
if ( ! $activated ) {
$error_message = Forminator_Integration_Loader::get_instance()->get_last_error_message();
} else {
$this->save_settings_values( $save_values );
}
} else {
$this->save_settings_values( $save_values );
}
}
}
$has_error = ! empty( $error_message ) || ! empty( $api_key_error_message );
if ( ! $has_error ) {
$html = $this->success_authorize();
return array(
'html' => $html,
'redirect' => false,
'has_errors' => false,
'notification' => array(
'type' => 'success',
'text' => '' . $this->get_title() . ' ' . esc_html__( 'is connected successfully.', 'forminator' ),
),
);
}
}
$error_message = $error_message ?? false;
$has_error = $has_error ?? '';
$buttons = array();
if ( $this->is_connected() ) {
$buttons['disconnect'] = array(
'markup' => self::get_button_markup( esc_html__( 'Disconnect', 'forminator' ), 'sui-button-ghost forminator-addon-disconnect' ),
);
$buttons['submit'] = array(
'markup' => '' .
self::get_button_markup( esc_html__( 'Save', 'forminator' ), 'forminator-addon-connect' ) .
'
',
);
} else {
$buttons['submit'] = array(
'markup' => self::get_button_markup( esc_html__( 'Connect', 'forminator' ), 'forminator-addon-connect' ),
);
}
$html = '';
$html .= '';
return array(
'html' => $html,
'buttons' => $buttons,
'redirect' => false,
'has_errors' => $has_error,
);
}
/**
* Flag for check if has lead form integration connected to a quiz
* by default it will check if last step of form settings already completed by user
*
* @param int $quiz_id Quiz Id.
*
* @return bool
* @throws Forminator_Integration_Exception Throws Integration Exception.
*/
public function is_quiz_lead_connected( $quiz_id ) {
try {
// initialize with null.
$quiz_settings_instance = null;
if ( ! $this->is_connected() ) {
throw new Forminator_Integration_Exception( esc_html__( 'MailerLite integration not connected.', 'forminator' ) );
}
$quiz_settings_instance = $this->get_addon_settings( $quiz_id, 'quiz' );
if ( ! $quiz_settings_instance instanceof Forminator_Mailerlite_Quiz_Settings ) {
throw new Forminator_Integration_Exception( esc_html__( 'Form settings instance is not valid.', 'forminator' ) );
}
$quiz_settings = $quiz_settings_instance->get_quiz_settings();
$is_quiz_connected = ! empty( $quiz_settings['hasLeads'] );
} catch ( Forminator_Integration_Exception $e ) {
$is_quiz_connected = false;
forminator_addon_maybe_log( __METHOD__, $e->getMessage() );
}
/**
* Filter connected status of mailerlite with the form
*
* @param bool $is_quiz_connected
* @param int $quiz_id Current Form ID.
* @param Forminator_Mailerlite_Quiz_Settings|null $quiz_settings_instance Instance of form settings, or null when unavailable.
*/
$is_quiz_connected = apply_filters( 'forminator_addon_mailerlite_is_quiz_lead_connected', $is_quiz_connected, $quiz_id, $quiz_settings_instance );
return $is_quiz_connected;
}
}