/home/arranoyd/eventrify/wp-content/plugins/wpforms/pro/includes/fields/class-phone.php
<?php
/**
* Phone number field.
*
* @since 1.0.0
*/
class WPForms_Field_Phone extends WPForms_Field {
/**
* Primary class constructor.
*
* @since 1.0.0
*/
public function init() {
// Define field type information.
$this->name = esc_html__( 'Phone', 'wpforms' );
$this->type = 'phone';
$this->icon = 'fa-phone';
$this->order = 50;
$this->group = 'fancy';
// Define additional field properties.
add_filter( 'wpforms_field_properties_phone', array( $this, 'field_properties' ), 5, 3 );
// Form frontend CSS enqueues.
add_action( 'wpforms_frontend_css', array( $this, 'enqueue_frontend_css' ) );
// Form frontend JS enqueues.
add_action( 'wpforms_frontend_js', array( $this, 'enqueue_frontend_js' ) );
// Add frontend strings.
add_action( 'wpforms_frontend_strings', array( $this, 'add_frontend_strings' ) );
}
/**
* Define additional field properties.
*
* @since 1.3.8
*
* @param array $properties Field properties.
* @param array $field Field settings.
* @param array $form_data Form data and settings.
*
* @return array
*/
public function field_properties( $properties, $field, $form_data ) {
// Smart: add validation rule and class.
if ( 'smart' === $field['format'] ) {
$properties['inputs']['primary']['class'][] = 'wpforms-smart-phone-field';
$properties['inputs']['primary']['data']['rule-smart-phone-field'] = 'true';
}
// US: add input mask and class.
if ( 'us' === $field['format'] ) {
$properties['inputs']['primary']['class'][] = 'wpforms-masked-input';
$properties['inputs']['primary']['data']['inputmask'] = "'mask': '(999) 999-9999'";
$properties['inputs']['primary']['data']['rule-us-phone-field'] = 'true';
}
// International: add validation rule and class.
if ( 'international' === $field['format'] ) {
$properties['inputs']['primary']['data']['rule-int-phone-field'] = 'true';
}
return $properties;
}
/**
* Form frontend CSS enqueues.
*
* @since 1.5.2
*/
public function enqueue_frontend_css() {
$min = \wpforms_get_min_suffix();
// International Telephone Input library CSS.
wp_enqueue_style(
'wpforms-smart-phone-field',
WPFORMS_PLUGIN_URL . "pro/assets/css/vendor/intl-tel-input{$min}.css",
array(),
'17.0.3'
);
}
/**
* Form frontend JS enqueues.
*
* @since 1.5.2
*/
public function enqueue_frontend_js() {
$min = \wpforms_get_min_suffix();
// Load International Telephone Input library - https://github.com/jackocnr/intl-tel-input.
wp_enqueue_script(
'wpforms-smart-phone-field',
WPFORMS_PLUGIN_URL . "pro/assets/js/vendor/jquery.intl-tel-input{$min}.js",
array( 'jquery' ),
'17.0.3',
true
);
}
/**
* Add phone validation error to frontend strings.
*
* @since 1.5.8
*
* @param array $strings Frontend strings.
*
* @return array Frontend strings.
*/
public function add_frontend_strings( $strings ) {
$strings['val_phone'] = wpforms_setting( 'validation-phone', esc_html__( 'Please enter a valid phone number.', 'wpforms' ) );
return $strings;
}
/**
* Field options panel inside the builder.
*
* @since 1.0.0
*
* @param array $field Field data.
*/
public function field_options( $field ) {
/*
* Basic field options.
*/
// Options open markup.
$args = array(
'markup' => 'open',
);
$this->field_option( 'basic-options', $field, $args );
// Label.
$this->field_option( 'label', $field );
// Format.
$lbl = $this->field_element(
'label',
$field,
array(
'slug' => 'format',
'value' => esc_html__( 'Format', 'wpforms' ),
'tooltip' => esc_html__( 'Select format for the phone form field', 'wpforms' ),
),
false
);
$fld = $this->field_element(
'select',
$field,
array(
'slug' => 'format',
'value' => ! empty( $field['format'] ) ? esc_attr( $field['format'] ) : 'smart',
'options' => array(
'smart' => esc_html__( 'Smart', 'wpforms' ),
'us' => esc_html__( 'US', 'wpforms' ),
'international' => esc_html__( 'International', 'wpforms' ),
),
),
false
);
$args = array(
'slug' => 'format',
'content' => $lbl . $fld,
);
$this->field_element( 'row', $field, $args );
// Description.
$this->field_option( 'description', $field );
// Required toggle.
$this->field_option( 'required', $field );
// Options close markup.
$args = array(
'markup' => 'close',
);
$this->field_option( 'basic-options', $field, $args );
/*
* Advanced field options.
*/
// Options open markup.
$args = array(
'markup' => 'open',
);
$this->field_option( 'advanced-options', $field, $args );
// Size.
$this->field_option( 'size', $field );
// Placeholder.
$this->field_option( 'placeholder', $field );
// Hide Label.
$this->field_option( 'label_hide', $field );
// Default value.
$this->field_option( 'default_value', $field );
// Custom CSS classes.
$this->field_option( 'css', $field );
// Options close markup.
$args = array(
'markup' => 'close',
);
$this->field_option( 'advanced-options', $field, $args );
}
/**
* Field preview inside the builder.
*
* @since 1.0.0
*
* @param array $field Field data.
*/
public function field_preview( $field ) {
// Define data.
$placeholder = ! empty( $field['placeholder'] ) ? $field['placeholder'] : '';
// Label.
$this->field_preview_option( 'label', $field );
// Primary input.
echo '<input type="text" placeholder="' . esc_attr( $placeholder ) . '" class="primary-input" disabled>';
// Description.
$this->field_preview_option( 'description', $field );
}
/**
* Field display on the form front-end.
*
* @since 1.0.0
*
* @param array $field Field data and settings.
* @param array $deprecated Deprecated field attributes. Use field properties.
* @param array $form_data Form data and settings.
*/
public function field_display( $field, $deprecated, $form_data ) {
// Define data.
$primary = $field['properties']['inputs']['primary'];
// Allow input type to be changed for this particular field.
$type = apply_filters( 'wpforms_phone_field_input_type', 'tel' );
// Primary field.
printf(
'<input type="%s" %s %s>',
esc_attr( $type ),
wpforms_html_attributes( $primary['id'], $primary['class'], $primary['data'], $primary['attr'] ),
$primary['required']
);
}
/**
* Validate field on form submit.
*
* @since 1.5.8
*
* @param int $field_id Field ID.
* @param mixed $field_submit Submitted value.
* @param array $form_data Form data and settings.
*/
public function validate( $field_id, $field_submit, $form_data ) {
$form_id = $form_data['id'];
$value = $this->sanitize_value( $field_submit );
// If field is marked as required, check for entry data.
if (
! empty( $form_data['fields'][ $field_id ]['required'] ) &&
empty( $value )
) {
wpforms()->process->errors[ $form_id ][ $field_id ] = wpforms_get_required_label();
}
if (
empty( $value ) ||
empty( $form_data['fields'][ $field_id ]['format'] )
) {
return;
}
$value = preg_replace( '/[^\d]/', '', $value );
$length = strlen( $value );
if ( $form_data['fields'][ $field_id ]['format'] === 'us' ) {
$error = $length !== 10;
} else {
$error = $length === 0;
}
if ( $error ) {
wpforms()->process->errors[ $form_id ][ $field_id ] = wpforms_setting( 'validation-phone', esc_html__( 'Please enter a valid phone number.', 'wpforms' ) );
}
}
/**
* Format and sanitize field.
*
* @since 1.5.8
*
* @param int $field_id Field id.
* @param string $field_submit Submitted value.
* @param array $form_data Form data.
*/
public function format( $field_id, $field_submit, $form_data ) {
$name = ! empty( $form_data['fields'][ $field_id ]['label'] ) ? $form_data['fields'][ $field_id ]['label'] : '';
// Set final field details.
wpforms()->process->fields[ $field_id ] = array(
'name' => sanitize_text_field( $name ),
'value' => $this->sanitize_value( $field_submit ),
'id' => absint( $field_id ),
'type' => $this->type,
);
}
/**
* Sanitize the value.
*
* @since 1.5.8
*
* @param string $value The Phone field submitted value.
*
* @return string
*/
private function sanitize_value( $value ) {
return preg_replace( '/[^-+0-9() ]/', '', $value );
}
}
new WPForms_Field_Phone();