_description = esc_html__( 'Get awesome by your form.', 'forminator' );
$this->is_multi_global = true;
}
/**
* Hook before save settings values
* to include @see Forminator_Mailjet::$_connected_account
* for future reference
*
* @param array $values Values to save.
*
* @return array
*/
public function before_save_settings_values( $values ) {
forminator_addon_maybe_log( __METHOD__, $values );
if ( ! empty( $this->_connected_account ) ) {
$values['connected_account'] = $this->_connected_account;
}
return $values;
}
/**
* Check if user already completed settings
*
* @return bool
*/
public function is_authorized() {
$setting_values = $this->get_settings_values();
// check api_key and connected_account exists and not empty.
return ! empty( $setting_values['api_key'] ) && ! empty( $setting_values['secret_key'] ) && ! empty( $setting_values['connected_account'] );
}
/**
* Return with true / false, you may update you setting update message too
*
* @param string $api_key API key.
* @param string $secret_key Secret key.
*
* @return bool
* @throws Forminator_Integration_Exception Throws Integration Exception.
*/
protected function validate_api_keys( $api_key, $secret_key ) {
try {
// Check API Key and Secret key.
$info = $this->get_api( $api_key, $secret_key )->get_info();
forminator_addon_maybe_log( __METHOD__, $info );
$this->_connected_account = array(
'account_name' => $info->data[0]->username ?? '',
'email' => $info->data[0]->email ?? '',
);
} 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.
* @param string|null $secret_key API secret Key.
*
* @return Forminator_Mailjet_Wp_Api|null
*/
public function get_api( $api_key = null, $secret_key = null ) {
if ( is_null( $api_key ) ) {
$api_key = $this->get_api_key();
}
if ( is_null( $secret_key ) ) {
$secret_key = $this->get_secret_key();
}
$api = Forminator_Mailjet_Wp_Api::get_instance( $api_key, $secret_key );
return $api;
}
/**
* Get currently saved api key
*
* @return string|null
*/
private function get_api_key() {
$setting_values = $this->get_settings_values();
if ( isset( $setting_values['api_key'] ) ) {
return $setting_values['api_key'];
}
return null;
}
/**
* Get currently saved secret key
*
* @return string|null
*/
private function get_secret_key() {
$setting_values = $this->get_settings_values( true );
if ( isset( $setting_values['secret_key'] ) ) {
return $setting_values['secret_key'];
}
return null;
}
/**
* Build settings help on settings
*
* @return string
*/
public function settings_help() {
// Display how to get mailjet API Key by default.
/* Translators: 1. Opening tag with link to the Mailjet API Key, 2. closing tag. */
$help = sprintf( esc_html__( 'Please get your Mailjet API keys %1$shere%2$s', 'forminator' ), '', '' );
$help = '' . $help . '';
$setting_values = $this->get_settings_values();
if (
! empty( $setting_values['api_key'] )
&& ! empty( $setting_values['secret_key'] )
&& ! empty( $setting_values['connected_account'] )
) {
// Show currently connected mailjet account if its already connected.
$help = '' . esc_html__( 'Change your API Key and Secret Key or disconnect this Mailjet Integration below.', 'forminator' ) . '';
}
return $help;
}
/**
* Settings description
*
* @return string
*/
public function settings_description() {
$description = '';
$setting_values = $this->get_settings_values();
if (
! empty( $setting_values['api_key'] )
&& ! empty( $setting_values['secret_key'] )
&& ! empty( $setting_values['connected_account'] )
) {
// Show currently connected mailjet account if its already connected.
$description .= '' . esc_html__( 'Please note that changing your API Key and Secret Key or disconnecting this integration will affect ALL of your connected forms.', 'forminator' ) . '';
}
return $description;
}
/**
* Connected account info
*
* @return string
*/
public function settings_account() {
$myaccount = '';
$settings = $this->get_settings_values();
if ( ! empty( $settings['api_key'] ) && ! empty( $settings['secret_key'] ) && ! empty( $settings['connected_account'] ) ) {
$connected_account = $settings['connected_account'];
// Show currently connected mailjet account if its already connected.
$notice = sprintf(
/* translators: placeholder is Name and Email of Connected MailJet Account */
esc_html__( 'Your Mailjet is connected to %1$s: %2$s.', 'forminator' ),
'' . esc_html( $connected_account['account_name'] ) . '',
sanitize_email( $connected_account['email'] )
);
$myaccount = Forminator_Admin::get_green_notice( $notice );
}
return $myaccount;
}
/**
* 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.
* @param int $form_id Form Id.
*
* @return array
*/
public function configure_api_key( $submitted_data, $form_id = 0 ) {
$error_message = '';
$api_key_error_message = '';
$secret_key_error = '';
$setting_values = $this->get_settings_values();
$identifier = $setting_values['identifier'] ?? '';
$api_key = $this->get_api_key();
$secret_key = $setting_values['secret_key'] ?? '';
$show_success = false;
// ON Submit.
if ( isset( $submitted_data['api_key'] ) ) {
$api_key = $submitted_data['api_key'];
$secret_key = $submitted_data['secret_key'] ?? '';
$identifier = $submitted_data['identifier'] ?? '';
if ( empty( $api_key ) ) {
$api_key_error_message = esc_html__( 'Please add valid Mailjet API Key.', 'forminator' );
} elseif ( empty( $secret_key ) ) {
$secret_key_error = esc_html__( 'Please add valid Mailjet Secret Key.', 'forminator' );
} else {
$real_secret_key = $this->get_real_value( $secret_key, 'secret_key' );
$api_key_validated = $this->validate_api_keys( $api_key, $real_secret_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_mailjet_validate_api_keys', $api_key_validated, $api_key, $secret_key );
if ( ! $api_key_validated ) {
$error_message = $this->_update_settings_error_message;
} else {
$save_values = array(
'api_key' => $api_key,
'secret_key' => $real_secret_key,
'identifier' => $identifier,
);
if ( ! forminator_addon_is_active( $this->_slug ) ) {
$activated = Forminator_Integration_Loader::get_instance()->activate_addon( $this->_slug );
if ( ! $activated ) {
$error_message = Forminator_Integration_Loader::get_instance()->get_last_error_message();
} else {
$this->save_settings_values( $save_values );
$show_success = true;
}
} else {
$this->save_settings_values( $save_values );
$show_success = true;
}
}
}
if ( $show_success ) {
if ( ! empty( $form_id ) ) {
// initiate form settings wizard.
return $this->get_form_settings_wizard( array(), $form_id, 0, 0 );
}
$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' ),
),
);
}
}
$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 .= '';
$html .= $this->settings_account();
return array(
'html' => $html,
'buttons' => $buttons,
'redirect' => false,
'has_errors' => ! empty( $error_message ) || ! empty( $api_key_error_message ) || ! empty( $secret_key_error ),
);
}
}