namespace WPForms\Integrations\WPMailSMTP;
use WPForms\Integrations\IntegrationInterface;
* WP Mail SMTP hints inside form builder notifications.
class Notifications implements IntegrationInterface {
* Indicate if current integration is allowed to load.
public function allow_load() {
return wpforms_is_admin_page( 'builder' ) && function_exists( 'wp_mail_smtp' );
$this->options = new Options();
protected function hooks() {
add_filter( 'wpforms_builder_notifications_from_name_after', [ $this, 'from_name_after' ] );
add_filter( 'wpforms_builder_notifications_from_email_after', [ $this, 'from_email_after' ] );
add_filter( 'wpforms_builder_notifications_sender_name_settings', [ $this, 'change_from_name_settings' ], 10, 3 );
add_filter( 'wpforms_builder_notifications_sender_address_settings', [ $this, 'change_from_email_settings' ], 10, 3 );
add_action( 'wpforms_form_settings_notifications_single_after', [ $this, 'add_hidden_from_name_field' ], 10, 2 );
add_action( 'wpforms_form_settings_notifications_single_after', [ $this, 'add_hidden_from_email_field' ], 10, 2 );
* Redefine From Name settings with data from WP Mail SMTP.
* @param array $args Field settings.
* @param array $form_data Form data.
* @param int $id Notification ID.
public function change_from_name_settings( $args, $form_data, $id ) {
if ( ! $this->options->get( 'mail', 'from_name_force' ) ) {
$args['value'] = $this->options->get( 'mail', 'from_name' );
unset( $args['smarttags'] );
* Redefine From Email settings with data from WP Mail SMTP.
* @param array $args Field settings.
* @param array $form_data Form data.
* @param int $id Notification ID.
public function change_from_email_settings( $args, $form_data, $id ) {
if ( ! $this->options->get( 'mail', 'from_email_force' ) ) {
$args['value'] = $this->options->get( 'mail', 'from_email' );
unset( $args['smarttags'] );
* Add hidden From Name field to overwrite value from WP Mail SMTP.
* @param array $settings Form settings.
* @param int $id Notification id.
public function add_hidden_from_name_field( $settings, $id ) {
if ( empty( $settings->form_data['settings']['notifications'][ $id ]['sender_name'] ) || ! $this->options->get( 'mail', 'from_name_force' ) ) {
'class' => 'wpforms-hidden',
'value' => $settings->form_data['settings']['notifications'][ $id ]['sender_name'],
* Add hidden From Email field to overwrite value from WP Mail SMTP.
* @param array $settings Form settings.
* @param int $id Notification id.
public function add_hidden_from_email_field( $settings, $id ) {
if ( empty( $settings->form_data['settings']['notifications'][ $id ]['sender_address'] ) || ! $this->options->get( 'mail', 'from_email_force' ) ) {
'class' => 'wpforms-hidden',
'value' => $settings->form_data['settings']['notifications'][ $id ]['sender_address'],
* Display hint if WP Mail SMTP is forcing from name.
* @param string $after Text displayed after setting.
public function from_name_after( $after ) {
if ( ! $this->options->get( 'mail', 'from_name_force' ) ) {
wp_kses( /* translators: %s - URL WP Mail SMTP settings. */
__( 'This setting is disabled because you have the "Force From Name" setting enabled in the <a href="%s" target="_blank">WP Mail SMTP</a> plugin.', 'wpforms-lite' ),
esc_url( admin_url( 'options-general.php?page=wp-mail-smtp#wp-mail-smtp-setting-row-from_name' ) )
* Display hint if WP Mail SMTP is forcing from email.
* @param string $after Text displayed after setting.
public function from_email_after( $after ) {
if ( ! $this->options->get( 'mail', 'from_email_force' ) ) {
wp_kses( /* translators: %s - URL WP Mail SMTP settings. */
__( 'This setting is disabled because you have the "Force From Email" setting enabled in the <a href="%s" target="_blank">WP Mail SMTP</a> plugin.', 'wpforms-lite' ),
esc_url( admin_url( 'options-general.php?page=wp-mail-smtp#wp-mail-smtp-setting-row-from_email' ) )