编辑文件 - Submission.php

✏️ 正在编辑: Submission.php

路径: /home/ubuntu/plugins-bkp-26012025/wpforms-lite/src/Forms/Submission.php
提示: 您可以编辑任何文件（包括二进制文件），但请注意不当修改可能导致文件损坏。

<?php

namespace WPForms\Forms;

/**
 * Class Submission.
 *
 * @since 1.7.4
 */
class Submission {

/**
	 * The form fields.
	 *
	 * @since 1.7.4
	 *
	 * @var array
	 */
	protected $fields;

/**
	 * The form entry.
	 *
	 * @since 1.7.4
	 *
	 * @var array
	 */
	private $entry;

/**
	 * The form ID.
	 *
	 * @since 1.7.4
	 *
	 * @var int
	 */
	private $form_id;

/**
	 * The form data.
	 *
	 * @since 1.7.4
	 *
	 * @var array
	 */
	protected $form_data;

/**
	 * The date.
	 *
	 * @since 1.7.4
	 *
	 * @var string
	 */
	private $date;

/**
	 * Register the submission data.
	 *
	 * @since 1.7.4
	 * @since 1.8.2 Added a return of instance.
	 *
	 * @param array $fields    The form fields.
	 * @param array $entry     The form entry.
	 * @param int   $form_id   The form ID.
	 * @param array $form_data The form data.
	 *
	 * @return Submission
	 */
	public function register( array $fields, array $entry, $form_id, array $form_data = [] ) {

$this->fields    = $fields;
		$this->entry     = $entry;
		$this->form_id   = $form_id;
		$this->form_data = $form_data;
		$this->date      = gmdate( 'Y-m-d H:i:s' );

return $this;
	}

/**
	 * Prepare the submission data.
	 *
	 * @since 1.7.4
	 *
	 * @return array|void
	 */
	public function prepare_entry_data() {

/**
		 * Provide the opportunity to disable entry saving.
		 *
		 * @since 1.0.0
		 *
		 * @param bool  $entry_save Entry save flag. Defaults to true.
		 * @param array $fields     Fields data.
		 * @param array $entry      Entry data.
		 * @param array $form_data  Form data.
		 */
		if ( ! apply_filters( 'wpforms_entry_save', true, $this->fields, $this->entry, $this->form_data ) ) { // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
			return;
		}

$submitted_fields = $this->get_fields();
		$user_info        = $this->get_user_info( $submitted_fields );

/**
		 * Information about the entry, that is ready to be saved into the main entries table,
		 * which is used for displaying a list of entries and partially for search.
		 *
		 * @since 1.5.9
		 *
		 * @param array $entry_data Information about the entry, that will be saved into the DB.
		 * @param array $form_data  Form data.
		 */
		return (array) apply_filters( // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
			'wpforms_entry_save_args',
			[
				'form_id'    => absint( $this->form_id ),
				'user_id'    => absint( $user_info['user_id'] ),
				'fields'     => wp_json_encode( $submitted_fields ),
				'ip_address' => sanitize_text_field( $user_info['user_ip'] ),
				'user_agent' => sanitize_text_field( $user_info['user_agent'] ),
				'date'       => $this->date,
				'user_uuid'  => sanitize_text_field( $user_info['user_uuid'] ),
			],
			$this->form_data
		);
	}

/**
	 * Prepare the payment submission data.
	 *
	 * @since 1.8.2
	 *
	 * @return array
	 */
	public function prepare_payment_data() {

$submitted_fields = $this->get_fields();
		$total_amount     = wpforms_get_total_payment( $submitted_fields );

/**
		 * Information about the payment, that is ready to be saved into the main payments table,
		 * which is used for displaying a list of payments and partially for search.
		 *
		 * @since 1.8.2
		 *
		 * @param array $payment_data Information about the payment, that will be saved into the DB.
		 * @param array $fields       Final/sanitized submitted field data.
		 * @param array $form_data    Form data and settings.
		 */
		$payment_data = (array) apply_filters(
			'wpforms_forms_submission_prepare_payment_data',
			[
				'form_id'          => absint( $this->form_id ),
				'subtotal_amount'  => $total_amount,
				'total_amount'     => $total_amount,
				'currency'         => wpforms_get_currency(),
				'entry_id'         => absint( $this->entry['entry_id'] ),
				'date_created_gmt' => $this->date,
				'date_updated_gmt' => $this->date,
			],
			$submitted_fields,
			$this->form_data
		);

if ( empty( $payment_data['type'] ) ) {
			$payment_data['type'] = ! empty( $payment_data['subscription_id'] ) ? 'subscription' : 'one-time';
		}

return $payment_data;
	}

/**
	 * Prepare the payment meta data for each payment.
	 *
	 * @since 1.8.2
	 *
	 * @return array
	 */
	public function prepare_payment_meta() {

$submitted_fields = $this->get_fields();
		$user_info        = $this->get_user_info( $submitted_fields );

/**
		 * Payment meta that is ready to be saved into the payments_meta table.
		 *
		 * @since 1.8.2
		 *
		 * @param array $payment_meta Payment meta that will be saved into the DB.
		 * @param array $fields       Final/sanitized submitted field data.
		 * @param array $form_data    Form data and settings.
		 */
		return (array) apply_filters(
			'wpforms_forms_submission_prepare_payment_meta',
			[
				'fields'     => ! $this->entry['entry_id'] ? wp_json_encode( $submitted_fields ) : '',
				'user_id'    => absint( $user_info['user_id'] ),
				'user_agent' => sanitize_text_field( $user_info['user_agent'] ),
				'user_uuid'  => sanitize_text_field( $user_info['user_uuid'] ),
				'ip_address' => sanitize_text_field( $user_info['user_ip'] ),
			],
			$submitted_fields,
			$this->form_data
		);
	}

/**
	 * Get entry fields.
	 *
	 * @since 1.8.2
	 *
	 * @return array
	 */
	private function get_fields() {

/**
		 * Filter the entry data before saving.
		 *
		 * @since 1.0.0
		 *
		 * @param array $fields    Fields data.
		 * @param array $entry     Entry data.
		 * @param array $form_data Form data.
		 */
		return (array) apply_filters( 'wpforms_entry_save_data', $this->fields, $this->entry, $this->form_data ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
	}

/**
	 * Get user info.
	 *
	 * @since 1.8.2
	 *
	 * @param array $fields Fields data.
	 *
	 * @return array
	 */
	private function get_user_info( $fields ) {

$user_info = [
			'user_ip'    => '',
			'user_agent' => '',
			'user_id'    => is_user_logged_in() ? get_current_user_id() : 0,
			'user_uuid'  => wpforms_is_collecting_cookies_allowed() && ! empty( $_COOKIE['_wpfuuid'] ) ? sanitize_key( $_COOKIE['_wpfuuid'] ) : '',
		];

/**
		 * Allow developers disable saving user IP and User Agent within the entry.
		 *
		 * @since 1.5.1
		 *
		 * @param bool  $disable   True if you need to disable storing IP and UA within the entry. Defaults to false.
		 * @param array $fields    Fields data.
		 * @param array $form_data Form data.
		 */
		// phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
		$is_ip_disabled = apply_filters( 'wpforms_disable_entry_user_ip', '__return_false', $fields, $this->form_data );

// If GDPR enhancements are enabled and user details are disabled
		// globally or in the form settings, discard the IP and UA.
		if (
			! $is_ip_disabled ||
			! wpforms_is_collecting_ip_allowed( $this->form_data )
		) {
			return $user_info;
		}

$user_info['user_ip'] = wpforms_get_ip();

if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) {
			return $user_info;
		}

$user_info['user_agent'] = substr( sanitize_text_field( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ), 0, 256 );

return $user_info;
	}
}

← 返回文件管理器