Elementor #2722 - Door of Clubs

File Manager

Current Directory: wp-content/plugins/wpforms/src/Pro/Forms/Fields/Base

Linux appserver-0d5e4f1e-php-cc8da225320a42ba9b7d66cba40b1f03 6.6.123+ #1 SMP PREEMPT_DYNAMIC Wed Mar 11 09:04:28 UTC 2026 x86_64

Edit File: Notifications.php

<?php

namespace WPForms\Pro\Forms\Fields\Base;

use RuntimeException;
use WPForms\Emails\Notifications as EmailNotifications;

/**
 * Base notifications class.
 *
 * @since 1.9.3
 */
abstract class Notifications {

/**
	 * Email type (Plain or HTML).
	 *
	 * @since 1.9.3
	 *
	 * @var string
	 */
	private $email_type;

/**
	 * Current field notification type.
	 *
	 * @since 1.9.3
	 *
	 * @var string
	 */
	protected $field_type;

/**
	 * Field data.
	 *
	 * @since 1.9.3
	 *
	 * @var array
	 */
	protected $field;

/**
	 * Fields data.
	 *
	 * @since 1.9.3
	 *
	 * @var array
	 */
	protected $fields;

/**
	 * Form data.
	 *
	 * @since 1.9.3
	 *
	 * @var array
	 */
	protected $form_data;

/**
	 * Email notification object.
	 *
	 * @since 1.9.3
	 *
	 * @var EmailNotifications
	 */
	private $notifications;

/**
	 * Whether to display empty fields in the email.
	 *
	 * @since 1.9.3
	 *
	 * @var bool
	 */
	private $show_empty_fields;

/**
	 * List of field types.
	 *
	 * @since 1.9.3
	 *
	 * @var array
	 */
	private $other_fields;

/**
	 * Initialize.
	 *
	 * @since 1.9.3
	 *
	 * @throws RuntimeException When the `$field_type` property is not defined.
	 */
	public function init() {

if ( empty( $this->field_type ) ) {
			throw new RuntimeException( 'Please define the `$field_type` property.' );
		}

$this->hooks();
	}

/**
	 * Hooks.
	 *
	 * @since 1.9.3
	 */
	private function hooks() {

add_filter( 'wpforms_emails_notifications_field_message_plain', [ $this, 'get_field_plain' ], 10, 6 );
		add_filter( 'wpforms_emails_notifications_field_message_html', [ $this, 'get_field_html' ], 10, 7 );
		add_filter( 'wpforms_emails_notifications_field_ignored', [ $this, 'notifications_field_ignored' ], 10, 3 );
	}

/**
	 * Check if the field is a layout field.
	 *
	 * @since 1.9.3
	 *
	 * @param array $field Field data.
	 *
	 * @return bool
	 */
	private function is_current_field( array $field ): bool {

return isset( $field['type'] ) && $field['type'] === $this->field_type;
	}

/**
	 * Get the layout field HTML markup.
	 *
	 * @since 1.9.3
	 *
	 * @param string|mixed       $message           Field message.
	 * @param array              $field             Field data.
	 * @param bool               $show_empty_fields Whether to display empty fields in the email.
	 * @param array              $other_fields      List of field types.
	 * @param array              $form_data         Form data.
	 * @param array              $fields            List of submitted fields.
	 * @param EmailNotifications $notifications     Notifications instance.
	 *
	 * @return string
	 */
	public function get_field_html( $message, array $field, bool $show_empty_fields, array $other_fields, array $form_data, array $fields, EmailNotifications $notifications ): string {

$message = (string) $message;

if ( ! $this->is_current_field( $field ) ) {
			return $message;
		}

$this->email_type        = 'html';
		$this->field             = $field;
		$this->form_data         = $form_data;
		$this->notifications     = $notifications;
		$this->show_empty_fields = $show_empty_fields;
		$this->other_fields      = $other_fields;
		$this->fields            = $fields;

if ( $notifications->get_current_template() === 'compact' ) {
			return $this->get_plain_message();
		}

return $this->get_html_message();
	}

/**
	 * Get the layout field plain text markup.
	 *
	 * @since 1.9.3
	 *
	 * @param string|mixed       $message           Field message.
	 * @param array              $field             Field data.
	 * @param bool               $show_empty_fields Whether to display empty fields in the email.
	 * @param array              $form_data         Form data.
	 * @param array              $fields            List of submitted fields.
	 * @param EmailNotifications $notifications     Notifications instance.
	 *
	 * @return string
	 */
	public function get_field_plain( $message, array $field, bool $show_empty_fields, array $form_data, array $fields, EmailNotifications $notifications ): string {

$message = (string) $message;

if ( ! $this->is_current_field( $field ) ) {
			return $message;
		}

$this->email_type        = 'plain';
		$this->field             = $field;
		$this->form_data         = $form_data;
		$this->notifications     = $notifications;
		$this->show_empty_fields = $show_empty_fields;
		$this->fields            = $fields;

return $this->get_plain_message();
	}

/**
	 * Get layout subfield markup for email.
	 *
	 * @since 1.9.3
	 *
	 * @param array $field Field data.
	 *
	 * @return string
	 */
	protected function get_subfield_message( array $field ): string {

return $this->email_type === 'html' ?
			$this->notifications->get_field_html( $field, $this->show_empty_fields, $this->other_fields ) :
			$this->notifications->get_field_plain( $field, $this->show_empty_fields );
	}

/**
	 * Get field header.
	 *
	 * @since 1.9.3
	 *
	 * @param string $label Field label.
	 *
	 * @return string
	 */
	protected function get_header( string $label ): string {

if ( ! empty( $this->field['label_hide'] ) || ! isset( $this->field['label'] ) || wpforms_is_empty_string( $this->field['label'] ) ) {
			return '';
		}

if ( $this->email_type === 'html' ) {
			return '<tr><td class="field-repeater-name field-name"><strong>' . esc_html( $label ) . '</strong></td><td class="field-value"></td></tr>';
		}

// In plain email all HTML tags deleted automatically before sending, so we can skip escaping at all.
		return '--- ' . esc_html( $label ) . " ---\r\n\r\n";
	}

/**
	 * Check if the field should be ignored in the email.
	 *
	 * @since 1.9.3
	 *
	 * @param bool  $ignore    Whether to ignore the field.
	 * @param array $field     Field data.
	 * @param array $form_data Form data.
	 *
	 * @return bool
	 */
	abstract public function notifications_field_ignored( $ignore, array $field, array $form_data ): bool;

/**
	 * Get field markup for plain email template.
	 *
	 * @since 1.9.3
	 *
	 * @return string
	 */
	abstract protected function get_plain_message(): string;

/**
	 * Get field markup for an HTML email template.
	 *
	 * @since 1.9.3
	 *
	 * @return string
	 */
	abstract protected function get_html_message(): string;
}

Upload File

Directory Listing

Name	Type	Size	Actions
.. (Parent Directory)	Dir
EntriesEdit.php	File	2.10 KB	Rename \| Delete \| Edit
Notifications.php	File	6.06 KB	Rename \| Delete \| Edit

File Manager

Edit File: Notifications.php

Upload File

Directory Listing

Resources

Company

Office