XylotrechusZ
<?php
/**
* The Forminator_Consent class.
*
* @package Forminator
*/
if ( ! defined( 'ABSPATH' ) ) {
die();
}
/**
* Class Forminator_Consent
*
* @since 1.0.5
*/
class Forminator_Consent extends Forminator_Field {
/**
* Name
*
* @var string
*/
public $name = '';
/**
* Slug
*
* @var string
*/
public $slug = 'consent';
/**
* Type
*
* @var string
*/
public $type = 'consent';
/**
* Position
*
* @var int
*/
public $position = 21;
/**
* Options
*
* @var array
*/
public $options = array();
/**
* Icon
*
* @var string
*/
public $icon = 'sui-icon-gdpr';
/**
* Forminator_Consent constructor.
*
* @since 1.0.5
*/
public function __construct() {
parent::__construct();
$this->name = esc_html__( 'Consent', 'forminator' );
}
/**
* Field defaults
*
* @since 1.0.5
* @return array
*/
public function defaults() {
$privacy_url = get_privacy_policy_url();
$privacy_url = ! empty( $privacy_url ) ? $privacy_url : '#';
return array(
'required' => 'true',
'field_label' => 'Consent',
'consent_description' => sprintf(
/* Translators: 1. Opening <a> tag with link to the privacy url, 2. closing <a> tag 3. Opening <a> tag with # href, 4. closing <a> tag. */
esc_html__( 'Yes, I agree with the %1$sprivacy policy%2$s and %3$sterms and conditions%4$s.', 'forminator' ),
'<a href="' . esc_url( $privacy_url ) . '" target="_blank">',
'</a>',
'<a href="#" target="_blank">',
'</a>'
),
'required_message' => esc_html__( 'This field is required. Please check it.', 'forminator' ),
);
}
/**
* Autofill Setting
*
* @since 1.0.5
*
* @param array $settings Settings.
*
* @return array
*/
public function autofill_settings( $settings = array() ) {
// Unsupported Autofill.
$autofill_settings = array();
return $autofill_settings;
}
/**
* Field front-end markup
*
* @since 1.0.5
*
* @param array $field Field.
* @param Forminator_Render_Form $views_obj Forminator_Render_Form object.
*
* @return mixed
*/
public function markup( $field, $views_obj ) {
$settings = $views_obj->model->settings;
$this->field = $field;
$html = '';
$id = self::get_property( 'element_id', $field );
$name = $id;
$form_id = isset( $settings['form_id'] ) ? $settings['form_id'] : false;
$description = wp_kses_post( forminator_replace_variables( self::get_property( 'consent_description', $field ), $form_id ) );
$id = self::get_field_id( $id );
$label = esc_html( self::get_property( 'field_label', $field ) );
$required = self::get_property( 'required', $field, true );
$ariareq = $required ? 'true' : 'false';
$html .= '<div class="forminator-field">';
$html .= self::get_field_label( $label, $id, $required );
$html .= '<div class="forminator-checkbox__wrapper">';
$html .= sprintf( '<label id="%s__label" class="forminator-checkbox forminator-consent" aria-labelledby="%s" aria-hidden="true">', $id, $id . '-label' );
$html .= sprintf(
'<input type="checkbox" name="%1$s" id="%2$s" value="%3$s" aria-labelledby="%4$s"%5$s data-required="%6$s" aria-required="%7$s" />',
$name,
$id,
'checked',
$id . '-label',
( ! empty( $description ) ? ' aria-describedby="' . esc_attr( $id . '__description' ) . '"' : '' ),
$ariareq,
$ariareq
);
$html .= '<span class="forminator-checkbox-box" aria-hidden="true"></span>';
$html .= '</label>';
$html .= sprintf( '<div id="%s__description" class="forminator-checkbox__label forminator-consent__label">%s</div>', $id, $description );
$html .= '</div>';
$html .= '</div>';
return apply_filters( 'forminator_field_consent_markup', $html, $id, $description );
}
/**
* Return field inline validation rules
*
* @since 1.0.5
* @return string
*/
public function get_validation_rules() {
$field = $this->field;
$id = self::get_property( 'element_id', $field );
$is_required = $this->is_required( $field );
$rules = $is_required ? '"' . $this->get_id( $field ) . '":{"required":true},' : '';
return apply_filters( 'forminator_field_consent_validation_rules', $rules, $id, $field );
}
/**
* Return field inline validation errors
*
* @since 1.0.5
* @return string
*/
public function get_validation_messages() {
$field = $this->field;
$id = $this->get_id( $field );
$is_required = $this->is_required( $field );
$required_message = self::get_property( 'required_message', $field, '' );
$required_message = apply_filters(
'forminator_consent_field_required_validation_message',
( ! empty( $required_message ) ? $required_message : esc_html__( 'This field is required. Please check it.', 'forminator' ) ),
$id,
$field
);
$messages = $is_required
? '"' . $this->get_id( $field ) . '": {"required":"' . forminator_addcslashes( $required_message ) . '"},' . "\n"
: '';
return $messages;
}
/**
* Field back-end validation
*
* @since 1.15.3
*
* @param array $field Field.
* @param array|string $data Data.
*/
public function validate( $field, $data ) {
// value of consent checkbox is `string` *checked*.
$id = $this->get_id( $field );
if ( $this->is_required( $field ) && ( empty( $data ) || 'checked' !== $data ) ) {
$required_message = self::get_property( 'required_message', $field, '' );
$this->validation_message[ $id ] = apply_filters(
'forminator_consent_field_required_validation_message',
( ! empty( $required_message ) ? $required_message : esc_html__( 'This field is required. Please check it.', 'forminator' ) ),
$id,
$field
);
}
}
/**
* Sanitize data
*
* @since 1.0.5
*
* @param array $field Field.
* @param array|string $data - the data to be sanitized.
*
* @return array|string $data - the data after sanitization
*/
public function sanitize( $field, $data ) {
$original_data = $data;
// Sanitize.
$data = forminator_sanitize_field( $data );
return apply_filters( 'forminator_field_consent_sanitize', $data, $field, $original_data );
}
}