Current Path : /var/www/ooareogundevinitiative/wp-content/plugins/forminator/library/fields/ |
Current File : /var/www/ooareogundevinitiative/wp-content/plugins/forminator/library/fields/text.php |
<?php if ( ! defined( 'ABSPATH' ) ) { die(); } /** * Class Forminator_Text * * @since 1.0 */ class Forminator_Text extends Forminator_Field { /** * @var string */ public $name = ''; /** * @var string */ public $slug = 'text'; /** * @var string */ public $type = 'text'; /** * @var int */ public $position = 6; /** * @var array */ public $options = array(); /** * @var string */ public $category = 'standard'; /** * @var bool */ public $is_input = true; /** * @var bool */ public $has_counter = true; /** * @var string */ public $icon = 'sui-icon-style-type'; /** * Forminator_Text constructor. * * @since 1.0 */ public function __construct() { parent::__construct(); $this->name = __( 'Input', Forminator::DOMAIN ); } /** * Field defaults * * @since 1.0 * @return array */ public function defaults() { return array( 'input_type' => 'line', 'limit_type' => 'characters', 'field_label' => __( 'Text', Forminator::DOMAIN ), 'placeholder' => __( 'E.g. text placeholder', Forminator::DOMAIN ), ); } /** * Autofill Setting * * @since 1.0.5 * * @param array $settings * * @return array */ public function autofill_settings( $settings = array() ) { $providers = apply_filters( 'forminator_field_' . $this->slug . '_autofill', array(), $this->slug ); $autofill_settings = array( 'text' => array( 'values' => forminator_build_autofill_providers( $providers ), ), ); return $autofill_settings; } /** * Field front-end markup * * @since 1.0 * * @param $field * @param $settings * * @return mixed */ public function markup( $field, $settings = array() ) { $this->field = $field; $this->form_settings = $settings; $this->init_autofill( $settings ); $html = ''; $id = self::get_property( 'element_id', $field ); $name = $id; $ariaid = $id; $id = 'forminator-field-' . $id; $required = self::get_property( 'required', $field, false ); $ariareq = 'false'; $default = esc_html( self::get_property( 'default', $field, false ) ); $placeholder = $this->sanitize_value( self::get_property( 'placeholder', $field ) ); $field_type = trim( self::get_property( 'input_type', $field ) ); $design = $this->get_form_style( $settings ); $label = esc_html( self::get_property( 'field_label', $field, '' ) ); $description = esc_html( self::get_property( 'description', $field, '' ) ); $limit = self::get_property( 'limit', $field, 0, 'num' ); $limit_type = self::get_property( 'limit_type', $field, '', 'str' ); $autofill_markup = $this->get_element_autofill_markup_attr( self::get_property( 'element_id', $field ), $this->form_settings ); if ( (bool) $required ) { $ariareq = 'true'; } if ( 'paragraph' === $field_type ) { $textarea = array( 'name' => $name, 'placeholder' => $placeholder, 'id' => $id, 'class' => 'forminator-textarea', 'aria-required' => $ariareq, ); // Add maxlength attribute if limit_type is characters if ( ! empty( $limit ) && 'characters' === $limit_type ) { $textarea['maxlength'] = $limit; } // Check if Pre-fill parameter used if ( $this->has_prefill( $field ) ) { // We have pre-fill parameter, use its value or $value $default = $this->get_prefill( $field, $default ); } if ( ! empty( $default ) ) { $textarea['content'] = $default; } elseif ( isset( $autofill_markup['value'] ) ) { $textarea['content'] = $autofill_markup['value']; unset( $autofill_markup['value'] ); } $textarea = array_merge( $textarea, $autofill_markup ); $html .= '<div class="forminator-field">'; $html .= self::create_textarea( $textarea, $label, '', $required, $design ); $html .= '</div>'; // Counter if ( ! empty( $description ) || ( ! empty( $limit ) && ! empty( $limit_type ) ) ) { $html .= '<span class="forminator-description">'; if ( ! empty( $description ) ) { $html .= $description; } if ( ( ! empty( $limit ) && ! empty( $limit_type ) ) ) { $html .= sprintf( '<span data-limit="%s" data-type="%s">0 / %s</span>', $limit, $limit_type, $limit ); } $html .= '</span>'; } } else { $input_text = array( 'type' => 'text', 'name' => $name, 'value' => $default, 'placeholder' => $placeholder, 'id' => $id, 'class' => 'forminator-input forminator-name--field', 'data-required' => $required, ); // Add maxlength attribute if limit_type is characters if ( ! empty( $limit ) && 'characters' === $limit_type ) { $input_text['maxlength'] = $limit; } // Check if Pre-fill parameter used if ( $this->has_prefill( $field ) ) { // We have pre-fill parameter, use its value or $value $default = $this->get_prefill( $field, $default ); } if ( ! empty( $default ) ) { $input_text['value'] = $default; } $input_text = array_merge( $input_text, $autofill_markup ); $html .= '<div class="forminator-field">'; $html .= self::create_input( $input_text, $label, '', $required, $design ); $html .= '</div>'; // Counter if ( ! empty( $description ) || ( ! empty( $limit ) && ! empty( $limit_type ) ) ) { $html .= '<span class="forminator-description">'; if ( ! empty( $description ) ) { $html .= $description; } if ( ( ! empty( $limit ) && ! empty( $limit_type ) ) ) { $html .= sprintf( '<span data-limit="%s" data-type="%s">0 / %s</span>', $limit, $limit_type, $limit ); } $html .= '</span>'; } } return apply_filters( 'forminator_field_text_markup', $html, $field ); } /** * Return field inline validation rules * * @since 1.0 * @return string */ public function get_validation_rules() { $field = $this->field; $id = self::get_property( 'element_id', $field ); $is_required = $this->is_required( $field ); $has_limit = $this->has_limit( $field ); $rules = ''; if ( ! isset( $field['limit'] ) ) { $field['limit'] = 0; } if ( $is_required || $has_limit ) { $rules = '"' . $this->get_id( $field ) . '": {'; if ( $is_required ) { $rules .= '"required": true,'; } if ( $has_limit ) { if ( isset( $field['limit_type'] ) && 'characters' === trim( $field['limit_type'] ) ) { $rules .= '"maxlength": ' . $field['limit'] . ','; } else { $rules .= '"maxwords": ' . $field['limit'] . ','; } } $rules .= '},'; } return apply_filters( 'forminator_field_text_validation_rules', $rules, $id, $field ); } /** * Return field inline validation errors * * @since 1.0 * @return string */ public function get_validation_messages() { $field = $this->field; $id = self::get_property( 'element_id', $field ); $is_required = $this->is_required( $field ); $has_limit = $this->has_limit( $field ); $messages = ''; $required_message = self::get_property( 'required_message', $field, '' ); if ( $is_required || $has_limit ) { $messages .= '"' . $this->get_id( $field ) . '": {'; if ( $is_required ) { $required_error = apply_filters( 'forminator_text_field_required_validation_message', ( ! empty( $required_message ) ? $required_message : __( 'This field is required. Please enter text.', Forminator::DOMAIN ) ), $id, $field ); $messages .= '"required": "' . forminator_addcslashes( $required_error ) . '",' . "\n"; } if ( $has_limit ) { if ( isset( $field['limit_type'] ) && 'characters' === trim( $field['limit_type'] ) ) { $max_length_error = apply_filters( 'forminator_text_field_characters_validation_message', __( 'You exceeded the allowed amount of characters. Please check again.', Forminator::DOMAIN ), $id, $field ); $messages .= '"maxlength": "' . forminator_addcslashes( $max_length_error ) . '",' . "\n"; } else { $max_words_error = apply_filters( 'forminator_text_field_words_validation_message', __( 'You exceeded the allowed amount of words. Please check again.', Forminator::DOMAIN ), $id, $field ); $messages .= '"maxwords": "' . forminator_addcslashes( $max_words_error ) . '",' . "\n"; } } $messages .= '},'; } return $messages; } /** * Field back-end validation * * @since 1.0 * * @param array $field * @param array|string $data * @param array $post_data */ public function validate( $field, $data, $post_data = array() ) { $id = self::get_property( 'element_id', $field ); if ( ! isset( $field['limit'] ) ) { $field['limit'] = 0; } if ( $this->is_required( $field ) ) { $required_message = self::get_property( 'required_message', $field, '' ); if ( empty( $data ) ) { $this->validation_message[ $id ] = apply_filters( 'forminator_text_field_required_validation_message', ( ! empty( $required_message ) ? $required_message : __( 'This field is required. Please enter text.', Forminator::DOMAIN ) ), $id, $field ); } } if ( $this->has_limit( $field ) ) { if ( ( isset( $field['limit_type'] ) && 'characters' === trim( $field['limit_type'] ) ) && ( mb_strlen( $data ) > $field['limit'] ) ) { $this->validation_message[ $id ] = apply_filters( 'forminator_text_field_characters_validation_message', __( 'You exceeded the allowed amount of characters. Please check again.', Forminator::DOMAIN ), $id, $field ); } elseif ( ( isset( $field['limit_type'] ) && 'words' === trim( $field['limit_type'] ) ) ) { $words = preg_split( '/\s+/', $data ); if ( is_array( $words ) && count( $words ) > $field['limit'] ) { $this->validation_message[ $id ] = apply_filters( 'forminator_text_field_words_validation_message', __( 'You exceeded the allowed amount of words. Please check again.', Forminator::DOMAIN ), $id, $field ); } } } } /** * Sanitize data * * @since 1.0.2 * * @param array $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_text_sanitize', $data, $field, $original_data ); } }