HEX
Server: Apache/2.4.52 (Ubuntu)
System: Linux spn-python 5.15.0-89-generic #99-Ubuntu SMP Mon Oct 30 20:42:41 UTC 2023 x86_64
User: arjun (1000)
PHP: 8.1.2-1ubuntu2.20
Disabled: NONE
Upload Files
File: /var/www/html/TriadGov/wp-content/plugins/wpforms/src/Pro/Forms/Fields/Base/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;
}