You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
281 lines
6.9 KiB
PHP
281 lines
6.9 KiB
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;
|
|
}
|
|
}
|