2137 lines
57 KiB
PHP
2137 lines
57 KiB
PHP
<?php
|
|
/**
|
|
* Contains various functions that may be potentially used throughout
|
|
* the WPForms plugin.
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
|
|
/**
|
|
* Helper function to trigger displaying a form.
|
|
*
|
|
* @since 1.0.2
|
|
*
|
|
* @param mixed $form_id Form ID.
|
|
* @param bool $title Form title.
|
|
* @param bool $desc Form description.
|
|
*/
|
|
function wpforms_display( $form_id = false, $title = false, $desc = false ) {
|
|
wpforms()->frontend->output( $form_id, $title, $desc );
|
|
}
|
|
|
|
/**
|
|
* Perform json_decode and unslash.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param string $data Data to decode.
|
|
*
|
|
* @return array|bool
|
|
*/
|
|
function wpforms_decode( $data ) {
|
|
|
|
if ( ! $data || empty( $data ) ) {
|
|
return false;
|
|
}
|
|
|
|
return wp_unslash( json_decode( $data, true ) );
|
|
}
|
|
|
|
/**
|
|
* Perform json_encode and wp_slash.
|
|
*
|
|
* @since 1.3.1.3
|
|
*
|
|
* @param mixed $data Data to encode.
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_encode( $data = false ) {
|
|
|
|
if ( empty( $data ) ) {
|
|
return false;
|
|
}
|
|
|
|
return wp_slash( wp_json_encode( $data ) );
|
|
}
|
|
|
|
/**
|
|
* Check if a string is a valid URL.
|
|
*
|
|
* @since 1.0.0
|
|
* @since 1.5.8 Changed the pattern used to validate the URL.
|
|
*
|
|
* @param string $url Input URL.
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_is_url( $url ) {
|
|
|
|
// The pattern taken from https://gist.github.com/dperini/729294.
|
|
// It is the best choice according to the https://mathiasbynens.be/demo/url-regex.
|
|
$pattern = '%^(?:(?:(?:https?|ftp):)?\/\/)(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z0-9\x{00a1}-\x{ffff}][a-z0-9\x{00a1}-\x{ffff}_-]{0,62})?[a-z0-9\x{00a1}-\x{ffff}]\.)+(?:[a-z\x{00a1}-\x{ffff}]{2,}\.?))(?::\d{2,5})?(?:[/?#]\S*)?$%iu';
|
|
|
|
if ( preg_match( $pattern, trim( $url ) ) ) {
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Get the current URL.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_current_url() {
|
|
|
|
$url = ( ! empty( $_SERVER['HTTPS'] ) ) ? 'https://' . $_SERVER['SERVER_NAME'] . $_SERVER['REQUEST_URI'] : 'http://' . $_SERVER['SERVER_NAME'] . $_SERVER['REQUEST_URI'];
|
|
|
|
return esc_url_raw( $url );
|
|
}
|
|
|
|
/**
|
|
* Convert object to an array.
|
|
*
|
|
* @since 1.1.7
|
|
*
|
|
* @param object $object Object to convert.
|
|
*
|
|
* @return mixed
|
|
*/
|
|
function wpforms_object_to_array( $object ) {
|
|
|
|
if ( ! is_object( $object ) && ! is_array( $object ) ) {
|
|
return $object;
|
|
}
|
|
|
|
if ( is_object( $object ) ) {
|
|
$object = get_object_vars( $object );
|
|
}
|
|
|
|
return array_map( 'wpforms_object_to_array', $object );
|
|
}
|
|
|
|
/**
|
|
* Get the value of a specific WPForms setting.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param string $key
|
|
* @param mixed $default
|
|
* @param string $option
|
|
*
|
|
* @return mixed
|
|
*/
|
|
function wpforms_setting( $key, $default = false, $option = 'wpforms_settings' ) {
|
|
|
|
$key = wpforms_sanitize_key( $key );
|
|
$options = get_option( $option, false );
|
|
$value = is_array( $options ) && ! empty( $options[ $key ] ) ? wp_unslash( $options[ $key ] ) : $default;
|
|
|
|
return $value;
|
|
}
|
|
|
|
/**
|
|
* Sanitize key, primarily used for looking up options.
|
|
*
|
|
* @since 1.3.9
|
|
*
|
|
* @param string $key
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_sanitize_key( $key = '' ) {
|
|
return preg_replace( '/[^a-zA-Z0-9_\-\.\:\/]/', '', $key );
|
|
}
|
|
|
|
/**
|
|
* Check if form provided contains the specified field type.
|
|
*
|
|
* @since 1.0.5
|
|
*
|
|
* @param array|string $type
|
|
* @param array|object $form
|
|
* @param bool $multiple
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_has_field_type( $type, $form, $multiple = false ) {
|
|
|
|
$form_data = '';
|
|
$field = false;
|
|
$type = (array) $type;
|
|
|
|
if ( $multiple ) {
|
|
foreach ( $form as $single_form ) {
|
|
$field = wpforms_has_field_type( $type, $single_form );
|
|
if ( $field ) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
return $field;
|
|
}
|
|
|
|
if ( is_object( $form ) && ! empty( $form->post_content ) ) {
|
|
$form_data = wpforms_decode( $form->post_content );
|
|
} elseif ( is_array( $form ) ) {
|
|
$form_data = $form;
|
|
}
|
|
|
|
if ( empty( $form_data['fields'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
foreach ( $form_data['fields'] as $single_field ) {
|
|
if ( in_array( $single_field['type'], $type, true ) ) {
|
|
$field = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
return $field;
|
|
}
|
|
|
|
/**
|
|
* Check if form provided contains a field which a specific setting.
|
|
*
|
|
* @since 1.4.5
|
|
*
|
|
* @param string $setting
|
|
* @param object|array $form
|
|
* @param bool $multiple
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_has_field_setting( $setting, $form, $multiple = false ) {
|
|
|
|
$form_data = '';
|
|
$field = false;
|
|
|
|
if ( $multiple ) {
|
|
foreach ( $form as $single_form ) {
|
|
$field = wpforms_has_field_setting( $setting, $single_form );
|
|
if ( $field ) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
return $field;
|
|
}
|
|
|
|
if ( is_object( $form ) && ! empty( $form->post_content ) ) {
|
|
$form_data = wpforms_decode( $form->post_content );
|
|
} elseif ( is_array( $form ) ) {
|
|
$form_data = $form;
|
|
}
|
|
|
|
if ( empty( $form_data['fields'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
foreach ( $form_data['fields'] as $single_field ) {
|
|
|
|
if ( ! empty( $single_field[ $setting ] ) ) {
|
|
$field = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
return $field;
|
|
}
|
|
|
|
/**
|
|
* Check if form provided contains page breaks, if so give details.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param mixed $form
|
|
*
|
|
* @return mixed
|
|
*/
|
|
function wpforms_has_pagebreak( $form = false ) {
|
|
|
|
$form_data = '';
|
|
$pagebreak = false;
|
|
$pages = 1;
|
|
|
|
if ( is_object( $form ) && ! empty( $form->post_content ) ) {
|
|
$form_data = wpforms_decode( $form->post_content );
|
|
} elseif ( is_array( $form ) ) {
|
|
$form_data = $form;
|
|
}
|
|
|
|
if ( empty( $form_data['fields'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
$fields = $form_data['fields'];
|
|
|
|
foreach ( $fields as $field ) {
|
|
if ( 'pagebreak' === $field['type'] && empty( $field['position'] ) ) {
|
|
$pagebreak = true;
|
|
$pages ++;
|
|
}
|
|
}
|
|
|
|
if ( $pagebreak ) {
|
|
return $pages;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Try to find and return a top or bottom pagebreak.
|
|
*
|
|
* @since 1.2.1
|
|
*
|
|
* @param mixed $form
|
|
* @param mixed $type
|
|
*
|
|
* @return array|bool
|
|
*/
|
|
function wpforms_get_pagebreak( $form = false, $type = false ) {
|
|
|
|
$form_data = '';
|
|
|
|
if ( is_object( $form ) && ! empty( $form->post_content ) ) {
|
|
$form_data = wpforms_decode( $form->post_content );
|
|
} elseif ( is_array( $form ) ) {
|
|
$form_data = $form;
|
|
}
|
|
|
|
if ( empty( $form_data['fields'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
$fields = $form_data['fields'];
|
|
$pages = array();
|
|
|
|
foreach ( $fields as $field ) {
|
|
if ( 'pagebreak' === $field['type'] ) {
|
|
$position = ! empty( $field['position'] ) ? $field['position'] : false;
|
|
if ( 'pages' === $type && 'bottom' !== $position ) {
|
|
$pages[] = $field;
|
|
} elseif ( $position === $type ) {
|
|
return $field;
|
|
}
|
|
}
|
|
}
|
|
|
|
if ( ! empty( $pages ) ) {
|
|
return $pages;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Return information about pages if the form has multiple pages.
|
|
*
|
|
* @since 1.3.7
|
|
*
|
|
* @param mixed $form
|
|
*
|
|
* @return mixed false or an array
|
|
*/
|
|
function wpforms_get_pagebreak_details( $form = false ) {
|
|
|
|
$form_data = '';
|
|
$details = array();
|
|
$pages = 1;
|
|
|
|
if ( is_object( $form ) && ! empty( $form->post_content ) ) {
|
|
$form_data = wpforms_decode( $form->post_content );
|
|
} elseif ( is_array( $form ) ) {
|
|
$form_data = $form;
|
|
}
|
|
|
|
if ( empty( $form_data['fields'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
foreach ( $form_data['fields'] as $field ) {
|
|
if ( 'pagebreak' === $field['type'] ) {
|
|
if ( empty( $field['position'] ) ) {
|
|
$pages ++;
|
|
$details['total'] = $pages;
|
|
$details['pages'][] = $field;
|
|
} elseif ( 'top' === $field['position'] ) {
|
|
$details['top'] = $field;
|
|
} elseif ( 'bottom' === $field['position'] ) {
|
|
$details['bottom'] = $field;
|
|
}
|
|
}
|
|
}
|
|
|
|
if ( ! empty( $details ) ) {
|
|
if ( empty( $details['top'] ) ) {
|
|
$details['top'] = array();
|
|
}
|
|
if ( empty( $details['bottom'] ) ) {
|
|
$details['bottom'] = array();
|
|
}
|
|
$details['current'] = 1;
|
|
|
|
return $details;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Format, sanitize, and return/echo HTML element ID, classes, attributes,
|
|
* and data attributes.
|
|
*
|
|
* @since 1.3.7
|
|
*
|
|
* @param string $id
|
|
* @param array $class
|
|
* @param array $datas
|
|
* @param array $atts
|
|
* @param bool $echo
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_html_attributes( $id = '', $class = array(), $datas = array(), $atts = array(), $echo = false ) {
|
|
|
|
$id = trim( $id );
|
|
$parts = array();
|
|
|
|
if ( ! empty( $id ) ) {
|
|
$id = sanitize_html_class( $id );
|
|
if ( ! empty( $id ) ) {
|
|
$parts[] = 'id="' . $id . '"';
|
|
}
|
|
}
|
|
|
|
if ( ! empty( $class ) ) {
|
|
$class = wpforms_sanitize_classes( $class, true );
|
|
if ( ! empty( $class ) ) {
|
|
$parts[] = 'class="' . $class . '"';
|
|
}
|
|
}
|
|
|
|
if ( ! empty( $datas ) ) {
|
|
foreach ( $datas as $data => $val ) {
|
|
$parts[] = 'data-' . sanitize_html_class( $data ) . '="' . esc_attr( $val ) . '"';
|
|
}
|
|
}
|
|
|
|
if ( ! empty( $atts ) ) {
|
|
foreach ( $atts as $att => $val ) {
|
|
if ( '0' == $val || ! empty( $val ) ) {
|
|
if ( '[' === $att[0] ) {
|
|
// Handle special case for bound attributes in AMP.
|
|
$escaped_att = '[' . sanitize_html_class( trim( $att, '[]' ) ) . ']';
|
|
} else {
|
|
$escaped_att = sanitize_html_class( $att );
|
|
}
|
|
$parts[] = $escaped_att . '="' . esc_attr( $val ) . '"';
|
|
}
|
|
}
|
|
}
|
|
|
|
$output = implode( ' ', $parts );
|
|
|
|
if ( $echo ) {
|
|
echo trim( $output ); // phpcs:ignore
|
|
} else {
|
|
return trim( $output );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Sanitize string of CSS classes.
|
|
*
|
|
* @since 1.2.1
|
|
*
|
|
* @param array|string $classes
|
|
* @param bool $convert True will convert strings to array and vice versa.
|
|
*
|
|
* @return string|array
|
|
*/
|
|
function wpforms_sanitize_classes( $classes, $convert = false ) {
|
|
|
|
$array = is_array( $classes );
|
|
$css = array();
|
|
|
|
if ( ! empty( $classes ) ) {
|
|
if ( ! $array ) {
|
|
$classes = explode( ' ', trim( $classes ) );
|
|
}
|
|
foreach ( $classes as $class ) {
|
|
if ( ! empty( $class ) ) {
|
|
$css[] = sanitize_html_class( $class );
|
|
}
|
|
}
|
|
}
|
|
if ( $array ) {
|
|
return $convert ? implode( ' ', $css ) : $css;
|
|
}
|
|
|
|
return $convert ? $css : implode( ' ', $css );
|
|
}
|
|
|
|
/**
|
|
* Convert a file size provided, such as "2M", to bytes.
|
|
*
|
|
* @link http://stackoverflow.com/a/22500394
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param string $size
|
|
*
|
|
* @return int
|
|
*/
|
|
function wpforms_size_to_bytes( $size ) {
|
|
|
|
if ( is_numeric( $size ) ) {
|
|
return $size;
|
|
}
|
|
|
|
$suffix = substr( $size, - 1 );
|
|
$value = substr( $size, 0, - 1 );
|
|
|
|
switch ( strtoupper( $suffix ) ) {
|
|
case 'P':
|
|
$value *= 1024;
|
|
case 'T':
|
|
$value *= 1024;
|
|
case 'G':
|
|
$value *= 1024;
|
|
case 'M':
|
|
$value *= 1024;
|
|
case 'K':
|
|
$value *= 1024;
|
|
break;
|
|
}
|
|
|
|
return $value;
|
|
}
|
|
|
|
/**
|
|
* Convert bytes to megabytes (or in some cases KB).
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param int $bytes Bytes to convert to a readable format.
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_size_to_megabytes( $bytes ) {
|
|
|
|
if ( $bytes < 1048676 ) {
|
|
return number_format( $bytes / 1024, 1 ) . ' KB';
|
|
}
|
|
|
|
return round( number_format( $bytes / 1048576, 1 ) ) . ' MB';
|
|
}
|
|
|
|
/**
|
|
* Convert a file size provided, such as "2M", to bytes.
|
|
*
|
|
* @link http://stackoverflow.com/a/22500394
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param bool $bytes
|
|
*
|
|
* @return mixed
|
|
*/
|
|
function wpforms_max_upload( $bytes = false ) {
|
|
|
|
$max = wp_max_upload_size();
|
|
if ( $bytes ) {
|
|
return $max;
|
|
}
|
|
|
|
return wpforms_size_to_megabytes( $max );
|
|
}
|
|
|
|
/**
|
|
* Retrieve actual fields from a form.
|
|
*
|
|
* Non-posting elements such as section divider, page break, and HTML are
|
|
* automatically excluded. Optionally a white list can be provided.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param mixed $form
|
|
* @param array $whitelist
|
|
*
|
|
* @return mixed boolean or array
|
|
*/
|
|
function wpforms_get_form_fields( $form = false, $whitelist = array() ) {
|
|
|
|
// Accept form (post) object or form ID.
|
|
if ( is_object( $form ) ) {
|
|
$form = wpforms_decode( $form->post_content );
|
|
} elseif ( is_numeric( $form ) ) {
|
|
$form = wpforms()->form->get(
|
|
$form,
|
|
array(
|
|
'content_only' => true,
|
|
)
|
|
);
|
|
}
|
|
|
|
if ( ! is_array( $form ) || empty( $form['fields'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
// White list of field types to allow.
|
|
$allowed_form_fields = array(
|
|
'text',
|
|
'textarea',
|
|
'number-slider',
|
|
'select',
|
|
'radio',
|
|
'checkbox',
|
|
'gdpr-checkbox',
|
|
'email',
|
|
'address',
|
|
'url',
|
|
'name',
|
|
'hidden',
|
|
'date-time',
|
|
'phone',
|
|
'number',
|
|
'file-upload',
|
|
'rating',
|
|
'likert_scale',
|
|
'signature',
|
|
'payment-single',
|
|
'payment-multiple',
|
|
'payment-checkbox',
|
|
'payment-select',
|
|
'payment-total',
|
|
'net_promoter_score',
|
|
);
|
|
$allowed_form_fields = apply_filters( 'wpforms_get_form_fields_allowed', $allowed_form_fields );
|
|
|
|
$whitelist = ! empty( $whitelist ) ? $whitelist : $allowed_form_fields;
|
|
|
|
$form_fields = $form['fields'];
|
|
|
|
foreach ( $form_fields as $id => $form_field ) {
|
|
if ( ! in_array( $form_field['type'], $whitelist, true ) ) {
|
|
unset( $form_fields[ $id ] );
|
|
}
|
|
}
|
|
|
|
return $form_fields;
|
|
}
|
|
|
|
/**
|
|
* Conditional logic form fields supported.
|
|
*
|
|
* @since 1.5.2
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_get_conditional_logic_form_fields_supported() {
|
|
|
|
$fields_supported = array(
|
|
'text',
|
|
'textarea',
|
|
'number-slider',
|
|
'select',
|
|
'radio',
|
|
'email',
|
|
'url',
|
|
'checkbox',
|
|
'number',
|
|
'payment-multiple',
|
|
'payment-checkbox',
|
|
'payment-select',
|
|
'hidden',
|
|
'rating',
|
|
'net_promoter_score',
|
|
);
|
|
|
|
return apply_filters( 'wpforms_get_conditional_logic_form_fields_supported', $fields_supported );
|
|
}
|
|
|
|
/**
|
|
* Get meta key value for a form field.
|
|
*
|
|
* @since 1.1.9
|
|
*
|
|
* @param int|string $id Field ID.
|
|
* @param string $key Meta key.
|
|
* @param mixed $form_data Form data array.
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_form_field_meta( $id = '', $key = '', $form_data = '' ) {
|
|
|
|
if ( empty( $id ) || empty( $key ) || empty( $form_data ) ) {
|
|
return '';
|
|
}
|
|
|
|
if ( ! empty( $form_data['fields'][ $id ]['meta'][ $key ] ) ) {
|
|
return $form_data['fields'][ $id ]['meta'][ $key ];
|
|
}
|
|
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* Get meta key value for a form field.
|
|
*
|
|
* @since 1.3.1
|
|
* @since 1.5.0 More strict parameters. Always return an array.
|
|
*
|
|
* @param string $key Meta key.
|
|
* @param string $value Meta value to check against.
|
|
* @param array $form_data Form data array.
|
|
*
|
|
* @return array|bool Empty array, when no data is found.
|
|
*/
|
|
function wpforms_get_form_fields_by_meta( $key, $value, $form_data ) {
|
|
|
|
$found = array();
|
|
|
|
if ( empty( $key ) || empty( $value ) || empty( $form_data['fields'] ) ) {
|
|
return $found;
|
|
}
|
|
|
|
foreach ( $form_data['fields'] as $id => $field ) {
|
|
|
|
if ( ! empty( $field['meta'][ $key ] ) && $value === $field['meta'][ $key ] ) {
|
|
$found[ $id ] = $field;
|
|
}
|
|
}
|
|
|
|
return $found;
|
|
}
|
|
|
|
/**
|
|
* US States.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_us_states() {
|
|
|
|
$states = array(
|
|
'AL' => esc_html__( 'Alabama', 'wpforms-lite' ),
|
|
'AK' => esc_html__( 'Alaska', 'wpforms-lite' ),
|
|
'AZ' => esc_html__( 'Arizona', 'wpforms-lite' ),
|
|
'AR' => esc_html__( 'Arkansas', 'wpforms-lite' ),
|
|
'CA' => esc_html__( 'California', 'wpforms-lite' ),
|
|
'CO' => esc_html__( 'Colorado', 'wpforms-lite' ),
|
|
'CT' => esc_html__( 'Connecticut', 'wpforms-lite' ),
|
|
'DE' => esc_html__( 'Delaware', 'wpforms-lite' ),
|
|
'DC' => esc_html__( 'District of Columbia', 'wpforms-lite' ),
|
|
'FL' => esc_html__( 'Florida', 'wpforms-lite' ),
|
|
'GA' => esc_html_x( 'Georgia', 'US State', 'wpforms-lite' ),
|
|
'HI' => esc_html__( 'Hawaii', 'wpforms-lite' ),
|
|
'ID' => esc_html__( 'Idaho', 'wpforms-lite' ),
|
|
'IL' => esc_html__( 'Illinois', 'wpforms-lite' ),
|
|
'IN' => esc_html__( 'Indiana', 'wpforms-lite' ),
|
|
'IA' => esc_html__( 'Iowa', 'wpforms-lite' ),
|
|
'KS' => esc_html__( 'Kansas', 'wpforms-lite' ),
|
|
'KY' => esc_html__( 'Kentucky', 'wpforms-lite' ),
|
|
'LA' => esc_html__( 'Louisiana', 'wpforms-lite' ),
|
|
'ME' => esc_html__( 'Maine', 'wpforms-lite' ),
|
|
'MD' => esc_html__( 'Maryland', 'wpforms-lite' ),
|
|
'MA' => esc_html__( 'Massachusetts', 'wpforms-lite' ),
|
|
'MI' => esc_html__( 'Michigan', 'wpforms-lite' ),
|
|
'MN' => esc_html__( 'Minnesota', 'wpforms-lite' ),
|
|
'MS' => esc_html__( 'Mississippi', 'wpforms-lite' ),
|
|
'MO' => esc_html__( 'Missouri', 'wpforms-lite' ),
|
|
'MT' => esc_html__( 'Montana', 'wpforms-lite' ),
|
|
'NE' => esc_html__( 'Nebraska', 'wpforms-lite' ),
|
|
'NV' => esc_html__( 'Nevada', 'wpforms-lite' ),
|
|
'NH' => esc_html__( 'New Hampshire', 'wpforms-lite' ),
|
|
'NJ' => esc_html__( 'New Jersey', 'wpforms-lite' ),
|
|
'NM' => esc_html__( 'New Mexico', 'wpforms-lite' ),
|
|
'NY' => esc_html__( 'New York', 'wpforms-lite' ),
|
|
'NC' => esc_html__( 'North Carolina', 'wpforms-lite' ),
|
|
'ND' => esc_html__( 'North Dakota', 'wpforms-lite' ),
|
|
'OH' => esc_html__( 'Ohio', 'wpforms-lite' ),
|
|
'OK' => esc_html__( 'Oklahoma', 'wpforms-lite' ),
|
|
'OR' => esc_html__( 'Oregon', 'wpforms-lite' ),
|
|
'PA' => esc_html__( 'Pennsylvania', 'wpforms-lite' ),
|
|
'RI' => esc_html__( 'Rhode Island', 'wpforms-lite' ),
|
|
'SC' => esc_html__( 'South Carolina', 'wpforms-lite' ),
|
|
'SD' => esc_html__( 'South Dakota', 'wpforms-lite' ),
|
|
'TN' => esc_html__( 'Tennessee', 'wpforms-lite' ),
|
|
'TX' => esc_html__( 'Texas', 'wpforms-lite' ),
|
|
'UT' => esc_html__( 'Utah', 'wpforms-lite' ),
|
|
'VT' => esc_html__( 'Vermont', 'wpforms-lite' ),
|
|
'VA' => esc_html__( 'Virginia', 'wpforms-lite' ),
|
|
'WA' => esc_html__( 'Washington', 'wpforms-lite' ),
|
|
'WV' => esc_html__( 'West Virginia', 'wpforms-lite' ),
|
|
'WI' => esc_html__( 'Wisconsin', 'wpforms-lite' ),
|
|
'WY' => esc_html__( 'Wyoming', 'wpforms-lite' ),
|
|
);
|
|
|
|
return apply_filters( 'wpforms_us_states', $states );
|
|
}
|
|
|
|
/**
|
|
* Countries.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_countries() {
|
|
|
|
$countries = array(
|
|
'AF' => esc_html__( 'Afghanistan', 'wpforms-lite' ),
|
|
'AX' => esc_html__( 'Åland Islands', 'wpforms-lite' ),
|
|
'AL' => esc_html__( 'Albania', 'wpforms-lite' ),
|
|
'DZ' => esc_html__( 'Algeria', 'wpforms-lite' ),
|
|
'AS' => esc_html__( 'American Samoa', 'wpforms-lite' ),
|
|
'AD' => esc_html__( 'Andorra', 'wpforms-lite' ),
|
|
'AO' => esc_html__( 'Angola', 'wpforms-lite' ),
|
|
'AI' => esc_html__( 'Anguilla', 'wpforms-lite' ),
|
|
'AQ' => esc_html__( 'Antarctica', 'wpforms-lite' ),
|
|
'AG' => esc_html__( 'Antigua and Barbuda', 'wpforms-lite' ),
|
|
'AR' => esc_html__( 'Argentina', 'wpforms-lite' ),
|
|
'AM' => esc_html__( 'Armenia', 'wpforms-lite' ),
|
|
'AW' => esc_html__( 'Aruba', 'wpforms-lite' ),
|
|
'AU' => esc_html__( 'Australia', 'wpforms-lite' ),
|
|
'AT' => esc_html__( 'Austria', 'wpforms-lite' ),
|
|
'AZ' => esc_html__( 'Azerbaijan', 'wpforms-lite' ),
|
|
'BS' => esc_html__( 'Bahamas', 'wpforms-lite' ),
|
|
'BH' => esc_html__( 'Bahrain', 'wpforms-lite' ),
|
|
'BD' => esc_html__( 'Bangladesh', 'wpforms-lite' ),
|
|
'BB' => esc_html__( 'Barbados', 'wpforms-lite' ),
|
|
'BY' => esc_html__( 'Belarus', 'wpforms-lite' ),
|
|
'BE' => esc_html__( 'Belgium', 'wpforms-lite' ),
|
|
'BZ' => esc_html__( 'Belize', 'wpforms-lite' ),
|
|
'BJ' => esc_html__( 'Benin', 'wpforms-lite' ),
|
|
'BM' => esc_html__( 'Bermuda', 'wpforms-lite' ),
|
|
'BT' => esc_html__( 'Bhutan', 'wpforms-lite' ),
|
|
'BO' => esc_html__( 'Bolivia (Plurinational State of)', 'wpforms-lite' ),
|
|
'BA' => esc_html__( 'Bosnia and Herzegovina', 'wpforms-lite' ),
|
|
'BW' => esc_html__( 'Botswana', 'wpforms-lite' ),
|
|
'BV' => esc_html__( 'Bouvet Island', 'wpforms-lite' ),
|
|
'BR' => esc_html__( 'Brazil', 'wpforms-lite' ),
|
|
'IO' => esc_html__( 'British Indian Ocean Territory', 'wpforms-lite' ),
|
|
'BN' => esc_html__( 'Brunei Darussalam', 'wpforms-lite' ),
|
|
'BG' => esc_html__( 'Bulgaria', 'wpforms-lite' ),
|
|
'BF' => esc_html__( 'Burkina Faso', 'wpforms-lite' ),
|
|
'BI' => esc_html__( 'Burundi', 'wpforms-lite' ),
|
|
'CV' => esc_html__( 'Cabo Verde', 'wpforms-lite' ),
|
|
'KH' => esc_html__( 'Cambodia', 'wpforms-lite' ),
|
|
'CM' => esc_html__( 'Cameroon', 'wpforms-lite' ),
|
|
'CA' => esc_html__( 'Canada', 'wpforms-lite' ),
|
|
'KY' => esc_html__( 'Cayman Islands', 'wpforms-lite' ),
|
|
'CF' => esc_html__( 'Central African Republic', 'wpforms-lite' ),
|
|
'TD' => esc_html__( 'Chad', 'wpforms-lite' ),
|
|
'CL' => esc_html__( 'Chile', 'wpforms-lite' ),
|
|
'CN' => esc_html__( 'China', 'wpforms-lite' ),
|
|
'CX' => esc_html__( 'Christmas Island', 'wpforms-lite' ),
|
|
'CC' => esc_html__( 'Cocos (Keeling) Islands', 'wpforms-lite' ),
|
|
'CO' => esc_html__( 'Colombia', 'wpforms-lite' ),
|
|
'KM' => esc_html__( 'Comoros', 'wpforms-lite' ),
|
|
'CG' => esc_html__( 'Congo', 'wpforms-lite' ),
|
|
'CD' => esc_html__( 'Congo (Democratic Republic of the)', 'wpforms-lite' ),
|
|
'CK' => esc_html__( 'Cook Islands', 'wpforms-lite' ),
|
|
'CR' => esc_html__( 'Costa Rica', 'wpforms-lite' ),
|
|
'CI' => esc_html__( 'Côte d\'Ivoire', 'wpforms-lite' ),
|
|
'HR' => esc_html__( 'Croatia', 'wpforms-lite' ),
|
|
'CU' => esc_html__( 'Cuba', 'wpforms-lite' ),
|
|
'CW' => esc_html__( 'Curaçao', 'wpforms-lite' ),
|
|
'CY' => esc_html__( 'Cyprus', 'wpforms-lite' ),
|
|
'CZ' => esc_html__( 'Czech Republic', 'wpforms-lite' ),
|
|
'DK' => esc_html__( 'Denmark', 'wpforms-lite' ),
|
|
'DJ' => esc_html__( 'Djibouti', 'wpforms-lite' ),
|
|
'DM' => esc_html__( 'Dominica', 'wpforms-lite' ),
|
|
'DO' => esc_html__( 'Dominican Republic', 'wpforms-lite' ),
|
|
'EC' => esc_html__( 'Ecuador', 'wpforms-lite' ),
|
|
'EG' => esc_html__( 'Egypt', 'wpforms-lite' ),
|
|
'SV' => esc_html__( 'El Salvador', 'wpforms-lite' ),
|
|
'GQ' => esc_html__( 'Equatorial Guinea', 'wpforms-lite' ),
|
|
'ER' => esc_html__( 'Eritrea', 'wpforms-lite' ),
|
|
'EE' => esc_html__( 'Estonia', 'wpforms-lite' ),
|
|
'ET' => esc_html__( 'Ethiopia', 'wpforms-lite' ),
|
|
'FK' => esc_html__( 'Falkland Islands (Malvinas)', 'wpforms-lite' ),
|
|
'FO' => esc_html__( 'Faroe Islands', 'wpforms-lite' ),
|
|
'FJ' => esc_html__( 'Fiji', 'wpforms-lite' ),
|
|
'FI' => esc_html__( 'Finland', 'wpforms-lite' ),
|
|
'FR' => esc_html__( 'France', 'wpforms-lite' ),
|
|
'GF' => esc_html__( 'French Guiana', 'wpforms-lite' ),
|
|
'PF' => esc_html__( 'French Polynesia', 'wpforms-lite' ),
|
|
'TF' => esc_html__( 'French Southern Territories', 'wpforms-lite' ),
|
|
'GA' => esc_html__( 'Gabon', 'wpforms-lite' ),
|
|
'GM' => esc_html__( 'Gambia', 'wpforms-lite' ),
|
|
'GE' => esc_html_x( 'Georgia', 'Country', 'wpforms-lite' ),
|
|
'DE' => esc_html__( 'Germany', 'wpforms-lite' ),
|
|
'GH' => esc_html__( 'Ghana', 'wpforms-lite' ),
|
|
'GI' => esc_html__( 'Gibraltar', 'wpforms-lite' ),
|
|
'GR' => esc_html__( 'Greece', 'wpforms-lite' ),
|
|
'GL' => esc_html__( 'Greenland', 'wpforms-lite' ),
|
|
'GD' => esc_html__( 'Grenada', 'wpforms-lite' ),
|
|
'GP' => esc_html__( 'Guadeloupe', 'wpforms-lite' ),
|
|
'GU' => esc_html__( 'Guam', 'wpforms-lite' ),
|
|
'GT' => esc_html__( 'Guatemala', 'wpforms-lite' ),
|
|
'GG' => esc_html__( 'Guernsey', 'wpforms-lite' ),
|
|
'GN' => esc_html__( 'Guinea', 'wpforms-lite' ),
|
|
'GW' => esc_html__( 'Guinea-Bissau', 'wpforms-lite' ),
|
|
'GY' => esc_html__( 'Guyana', 'wpforms-lite' ),
|
|
'HT' => esc_html__( 'Haiti', 'wpforms-lite' ),
|
|
'HM' => esc_html__( 'Heard Island and McDonald Islands', 'wpforms-lite' ),
|
|
'HN' => esc_html__( 'Honduras', 'wpforms-lite' ),
|
|
'HK' => esc_html__( 'Hong Kong', 'wpforms-lite' ),
|
|
'HU' => esc_html__( 'Hungary', 'wpforms-lite' ),
|
|
'IS' => esc_html__( 'Iceland', 'wpforms-lite' ),
|
|
'IN' => esc_html__( 'India', 'wpforms-lite' ),
|
|
'ID' => esc_html__( 'Indonesia', 'wpforms-lite' ),
|
|
'IR' => esc_html__( 'Iran (Islamic Republic of)', 'wpforms-lite' ),
|
|
'IQ' => esc_html__( 'Iraq', 'wpforms-lite' ),
|
|
'IE' => esc_html__( 'Ireland (Republic of)', 'wpforms-lite' ),
|
|
'IM' => esc_html__( 'Isle of Man', 'wpforms-lite' ),
|
|
'IL' => esc_html__( 'Israel', 'wpforms-lite' ),
|
|
'IT' => esc_html__( 'Italy', 'wpforms-lite' ),
|
|
'JM' => esc_html__( 'Jamaica', 'wpforms-lite' ),
|
|
'JP' => esc_html__( 'Japan', 'wpforms-lite' ),
|
|
'JE' => esc_html__( 'Jersey', 'wpforms-lite' ),
|
|
'JO' => esc_html__( 'Jordan', 'wpforms-lite' ),
|
|
'KZ' => esc_html__( 'Kazakhstan', 'wpforms-lite' ),
|
|
'KE' => esc_html__( 'Kenya', 'wpforms-lite' ),
|
|
'KI' => esc_html__( 'Kiribati', 'wpforms-lite' ),
|
|
'KP' => esc_html__( 'Korea (Democratic People\'s Republic of)', 'wpforms-lite' ),
|
|
'KR' => esc_html__( 'Korea (Republic of)', 'wpforms-lite' ),
|
|
'KW' => esc_html__( 'Kuwait', 'wpforms-lite' ),
|
|
'KG' => esc_html__( 'Kyrgyzstan', 'wpforms-lite' ),
|
|
'LA' => esc_html__( 'Lao People\'s Democratic Republic', 'wpforms-lite' ),
|
|
'LV' => esc_html__( 'Latvia', 'wpforms-lite' ),
|
|
'LB' => esc_html__( 'Lebanon', 'wpforms-lite' ),
|
|
'LS' => esc_html__( 'Lesotho', 'wpforms-lite' ),
|
|
'LR' => esc_html__( 'Liberia', 'wpforms-lite' ),
|
|
'LY' => esc_html__( 'Libya', 'wpforms-lite' ),
|
|
'LI' => esc_html__( 'Liechtenstein', 'wpforms-lite' ),
|
|
'LT' => esc_html__( 'Lithuania', 'wpforms-lite' ),
|
|
'LU' => esc_html__( 'Luxembourg', 'wpforms-lite' ),
|
|
'MO' => esc_html__( 'Macao', 'wpforms-lite' ),
|
|
'MK' => esc_html__( 'Macedonia (Republic of)', 'wpforms-lite' ),
|
|
'MG' => esc_html__( 'Madagascar', 'wpforms-lite' ),
|
|
'MW' => esc_html__( 'Malawi', 'wpforms-lite' ),
|
|
'MY' => esc_html__( 'Malaysia', 'wpforms-lite' ),
|
|
'MV' => esc_html__( 'Maldives', 'wpforms-lite' ),
|
|
'ML' => esc_html__( 'Mali', 'wpforms-lite' ),
|
|
'MT' => esc_html__( 'Malta', 'wpforms-lite' ),
|
|
'MH' => esc_html__( 'Marshall Islands', 'wpforms-lite' ),
|
|
'MQ' => esc_html__( 'Martinique', 'wpforms-lite' ),
|
|
'MR' => esc_html__( 'Mauritania', 'wpforms-lite' ),
|
|
'MU' => esc_html__( 'Mauritius', 'wpforms-lite' ),
|
|
'YT' => esc_html__( 'Mayotte', 'wpforms-lite' ),
|
|
'MX' => esc_html__( 'Mexico', 'wpforms-lite' ),
|
|
'FM' => esc_html__( 'Micronesia (Federated States of)', 'wpforms-lite' ),
|
|
'MD' => esc_html__( 'Moldova (Republic of)', 'wpforms-lite' ),
|
|
'MC' => esc_html__( 'Monaco', 'wpforms-lite' ),
|
|
'MN' => esc_html__( 'Mongolia', 'wpforms-lite' ),
|
|
'ME' => esc_html__( 'Montenegro', 'wpforms-lite' ),
|
|
'MS' => esc_html__( 'Montserrat', 'wpforms-lite' ),
|
|
'MA' => esc_html__( 'Morocco', 'wpforms-lite' ),
|
|
'MZ' => esc_html__( 'Mozambique', 'wpforms-lite' ),
|
|
'MM' => esc_html__( 'Myanmar', 'wpforms-lite' ),
|
|
'NA' => esc_html__( 'Namibia', 'wpforms-lite' ),
|
|
'NR' => esc_html__( 'Nauru', 'wpforms-lite' ),
|
|
'NP' => esc_html__( 'Nepal', 'wpforms-lite' ),
|
|
'NL' => esc_html__( 'Netherlands', 'wpforms-lite' ),
|
|
'NC' => esc_html__( 'New Caledonia', 'wpforms-lite' ),
|
|
'NZ' => esc_html__( 'New Zealand', 'wpforms-lite' ),
|
|
'NI' => esc_html__( 'Nicaragua', 'wpforms-lite' ),
|
|
'NE' => esc_html__( 'Niger', 'wpforms-lite' ),
|
|
'NG' => esc_html__( 'Nigeria', 'wpforms-lite' ),
|
|
'NU' => esc_html__( 'Niue', 'wpforms-lite' ),
|
|
'NF' => esc_html__( 'Norfolk Island', 'wpforms-lite' ),
|
|
'MP' => esc_html__( 'Northern Mariana Islands', 'wpforms-lite' ),
|
|
'NO' => esc_html__( 'Norway', 'wpforms-lite' ),
|
|
'OM' => esc_html__( 'Oman', 'wpforms-lite' ),
|
|
'PK' => esc_html__( 'Pakistan', 'wpforms-lite' ),
|
|
'PW' => esc_html__( 'Palau', 'wpforms-lite' ),
|
|
'PS' => esc_html__( 'Palestine (State of)', 'wpforms-lite' ),
|
|
'PA' => esc_html__( 'Panama', 'wpforms-lite' ),
|
|
'PG' => esc_html__( 'Papua New Guinea', 'wpforms-lite' ),
|
|
'PY' => esc_html__( 'Paraguay', 'wpforms-lite' ),
|
|
'PE' => esc_html__( 'Peru', 'wpforms-lite' ),
|
|
'PH' => esc_html__( 'Philippines', 'wpforms-lite' ),
|
|
'PN' => esc_html__( 'Pitcairn', 'wpforms-lite' ),
|
|
'PL' => esc_html__( 'Poland', 'wpforms-lite' ),
|
|
'PT' => esc_html__( 'Portugal', 'wpforms-lite' ),
|
|
'PR' => esc_html__( 'Puerto Rico', 'wpforms-lite' ),
|
|
'QA' => esc_html__( 'Qatar', 'wpforms-lite' ),
|
|
'RE' => esc_html__( 'Réunion', 'wpforms-lite' ),
|
|
'RO' => esc_html__( 'Romania', 'wpforms-lite' ),
|
|
'RU' => esc_html__( 'Russian Federation', 'wpforms-lite' ),
|
|
'RW' => esc_html__( 'Rwanda', 'wpforms-lite' ),
|
|
'BL' => esc_html__( 'Saint Barthélemy', 'wpforms-lite' ),
|
|
'SH' => esc_html__( 'Saint Helena, Ascension and Tristan da Cunha', 'wpforms-lite' ),
|
|
'KN' => esc_html__( 'Saint Kitts and Nevis', 'wpforms-lite' ),
|
|
'LC' => esc_html__( 'Saint Lucia', 'wpforms-lite' ),
|
|
'MF' => esc_html__( 'Saint Martin (French part)', 'wpforms-lite' ),
|
|
'PM' => esc_html__( 'Saint Pierre and Miquelon', 'wpforms-lite' ),
|
|
'VC' => esc_html__( 'Saint Vincent and the Grenadines', 'wpforms-lite' ),
|
|
'WS' => esc_html__( 'Samoa', 'wpforms-lite' ),
|
|
'SM' => esc_html__( 'San Marino', 'wpforms-lite' ),
|
|
'ST' => esc_html__( 'Sao Tome and Principe', 'wpforms-lite' ),
|
|
'SA' => esc_html__( 'Saudi Arabia', 'wpforms-lite' ),
|
|
'SN' => esc_html__( 'Senegal', 'wpforms-lite' ),
|
|
'RS' => esc_html__( 'Serbia', 'wpforms-lite' ),
|
|
'SC' => esc_html__( 'Seychelles', 'wpforms-lite' ),
|
|
'SL' => esc_html__( 'Sierra Leone', 'wpforms-lite' ),
|
|
'SG' => esc_html__( 'Singapore', 'wpforms-lite' ),
|
|
'SX' => esc_html__( 'Sint Maarten (Dutch part)', 'wpforms-lite' ),
|
|
'SK' => esc_html__( 'Slovakia', 'wpforms-lite' ),
|
|
'SI' => esc_html__( 'Slovenia', 'wpforms-lite' ),
|
|
'SB' => esc_html__( 'Solomon Islands', 'wpforms-lite' ),
|
|
'SO' => esc_html__( 'Somalia', 'wpforms-lite' ),
|
|
'ZA' => esc_html__( 'South Africa', 'wpforms-lite' ),
|
|
'GS' => esc_html__( 'South Georgia and the South Sandwich Islands', 'wpforms-lite' ),
|
|
'SS' => esc_html__( 'South Sudan', 'wpforms-lite' ),
|
|
'ES' => esc_html__( 'Spain', 'wpforms-lite' ),
|
|
'LK' => esc_html__( 'Sri Lanka', 'wpforms-lite' ),
|
|
'SD' => esc_html__( 'Sudan', 'wpforms-lite' ),
|
|
'SR' => esc_html__( 'Suriname', 'wpforms-lite' ),
|
|
'SJ' => esc_html__( 'Svalbard and Jan Mayen', 'wpforms-lite' ),
|
|
'SZ' => esc_html__( 'Swaziland', 'wpforms-lite' ),
|
|
'SE' => esc_html__( 'Sweden', 'wpforms-lite' ),
|
|
'CH' => esc_html__( 'Switzerland', 'wpforms-lite' ),
|
|
'SY' => esc_html__( 'Syrian Arab Republic', 'wpforms-lite' ),
|
|
'TW' => esc_html__( 'Taiwan, Province of China', 'wpforms-lite' ),
|
|
'TJ' => esc_html__( 'Tajikistan', 'wpforms-lite' ),
|
|
'TZ' => esc_html__( 'Tanzania (United Republic of)', 'wpforms-lite' ),
|
|
'TH' => esc_html__( 'Thailand', 'wpforms-lite' ),
|
|
'TL' => esc_html__( 'Timor-Leste', 'wpforms-lite' ),
|
|
'TG' => esc_html__( 'Togo', 'wpforms-lite' ),
|
|
'TK' => esc_html__( 'Tokelau', 'wpforms-lite' ),
|
|
'TO' => esc_html__( 'Tonga', 'wpforms-lite' ),
|
|
'TT' => esc_html__( 'Trinidad and Tobago', 'wpforms-lite' ),
|
|
'TN' => esc_html__( 'Tunisia', 'wpforms-lite' ),
|
|
'TR' => esc_html__( 'Turkey', 'wpforms-lite' ),
|
|
'TM' => esc_html__( 'Turkmenistan', 'wpforms-lite' ),
|
|
'TC' => esc_html__( 'Turks and Caicos Islands', 'wpforms-lite' ),
|
|
'TV' => esc_html__( 'Tuvalu', 'wpforms-lite' ),
|
|
'UG' => esc_html__( 'Uganda', 'wpforms-lite' ),
|
|
'UA' => esc_html__( 'Ukraine', 'wpforms-lite' ),
|
|
'AE' => esc_html__( 'United Arab Emirates', 'wpforms-lite' ),
|
|
'GB' => esc_html__( 'United Kingdom of Great Britain and Northern Ireland', 'wpforms-lite' ),
|
|
'US' => esc_html__( 'United States of America', 'wpforms-lite' ),
|
|
'UM' => esc_html__( 'United States Minor Outlying Islands', 'wpforms-lite' ),
|
|
'UY' => esc_html__( 'Uruguay', 'wpforms-lite' ),
|
|
'UZ' => esc_html__( 'Uzbekistan', 'wpforms-lite' ),
|
|
'VU' => esc_html__( 'Vanuatu', 'wpforms-lite' ),
|
|
'VA' => esc_html__( 'Vatican City State', 'wpforms-lite' ),
|
|
'VE' => esc_html__( 'Venezuela (Bolivarian Republic of)', 'wpforms-lite' ),
|
|
'VN' => esc_html__( 'Viet Nam', 'wpforms-lite' ),
|
|
'VG' => esc_html__( 'Virgin Islands (British)', 'wpforms-lite' ),
|
|
'VI' => esc_html__( 'Virgin Islands (U.S.)', 'wpforms-lite' ),
|
|
'WF' => esc_html__( 'Wallis and Futuna', 'wpforms-lite' ),
|
|
'EH' => esc_html__( 'Western Sahara', 'wpforms-lite' ),
|
|
'YE' => esc_html__( 'Yemen', 'wpforms-lite' ),
|
|
'ZM' => esc_html__( 'Zambia', 'wpforms-lite' ),
|
|
'ZW' => esc_html__( 'Zimbabwe', 'wpforms-lite' ),
|
|
);
|
|
|
|
return apply_filters( 'wpforms_countries', $countries );
|
|
}
|
|
|
|
/**
|
|
* Calendar Months.
|
|
*
|
|
* @since 1.3.7
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_months() {
|
|
|
|
$months = array(
|
|
'Jan' => esc_html__( 'January', 'wpforms-lite' ),
|
|
'Feb' => esc_html__( 'February', 'wpforms-lite' ),
|
|
'Mar' => esc_html__( 'March', 'wpforms-lite' ),
|
|
'Apr' => esc_html__( 'April', 'wpforms-lite' ),
|
|
'May' => esc_html__( 'May', 'wpforms-lite' ),
|
|
'Jun' => esc_html__( 'June', 'wpforms-lite' ),
|
|
'Jul' => esc_html__( 'July', 'wpforms-lite' ),
|
|
'Aug' => esc_html__( 'August', 'wpforms-lite' ),
|
|
'Sep' => esc_html__( 'September', 'wpforms-lite' ),
|
|
'Oct' => esc_html__( 'October', 'wpforms-lite' ),
|
|
'Nov' => esc_html__( 'November', 'wpforms-lite' ),
|
|
'Dec' => esc_html__( 'December', 'wpforms-lite' ),
|
|
);
|
|
|
|
return apply_filters( 'wpforms_months', $months );
|
|
}
|
|
|
|
/**
|
|
* Calendar Days.
|
|
*
|
|
* @since 1.3.7
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_days() {
|
|
|
|
$days = array(
|
|
'Sun' => esc_html__( 'Sunday', 'wpforms-lite' ),
|
|
'Mon' => esc_html__( 'Monday', 'wpforms-lite' ),
|
|
'Tue' => esc_html__( 'Tuesday', 'wpforms-lite' ),
|
|
'Wed' => esc_html__( 'Wednesday', 'wpforms-lite' ),
|
|
'Thu' => esc_html__( 'Thursday', 'wpforms-lite' ),
|
|
'Fri' => esc_html__( 'Friday', 'wpforms-lite' ),
|
|
'Sat' => esc_html__( 'Saturday', 'wpforms-lite' ),
|
|
);
|
|
|
|
return apply_filters( 'wpforms_days', $days );
|
|
}
|
|
|
|
/**
|
|
* Lookup user IP.
|
|
*
|
|
* There are many ways to do this, but we prefer the way EDD does it.
|
|
* https://github.com/easydigitaldownloads/easy-digital-downloads/blob/master/includes/misc-functions.php#L163
|
|
*
|
|
* @since 1.2.5
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_ip() {
|
|
|
|
$ip = false;
|
|
|
|
if ( ! empty( $_SERVER['HTTP_X_REAL_IP'] ) ) {
|
|
$ip = filter_var( wp_unslash( $_SERVER['HTTP_X_REAL_IP'] ), FILTER_VALIDATE_IP );
|
|
} elseif ( ! empty( $_SERVER['HTTP_CLIENT_IP'] ) ) {
|
|
// Check ip from share internet.
|
|
$ip = filter_var( wp_unslash( $_SERVER['HTTP_CLIENT_IP'] ), FILTER_VALIDATE_IP );
|
|
} elseif ( ! empty( $_SERVER['HTTP_X_FORWARDED_FOR'] ) ) {
|
|
// To check ip is pass from proxy.
|
|
// Can include more than 1 ip, first is the public one.
|
|
// WPCS: sanitization ok.
|
|
// phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
|
|
$ips = explode( ',', wp_unslash( $_SERVER['HTTP_X_FORWARDED_FOR'] ) );
|
|
if ( is_array( $ips ) ) {
|
|
$ip = filter_var( $ips[0], FILTER_VALIDATE_IP );
|
|
}
|
|
} elseif ( ! empty( $_SERVER['REMOTE_ADDR'] ) ) {
|
|
$ip = filter_var( wp_unslash( $_SERVER['REMOTE_ADDR'] ), FILTER_VALIDATE_IP );
|
|
}
|
|
|
|
$ip = false !== $ip ? $ip : '127.0.0.1';
|
|
$ip_array = explode( ',', $ip );
|
|
$ip_array = array_map( 'trim', $ip_array );
|
|
|
|
return sanitize_text_field( apply_filters( 'wpforms_get_ip', $ip_array[0] ) );
|
|
}
|
|
|
|
/**
|
|
* Sanitize hex color.
|
|
*
|
|
* @since 1.2.1
|
|
*
|
|
* @param string $color
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_sanitize_hex_color( $color ) {
|
|
|
|
if ( empty( $color ) ) {
|
|
return '';
|
|
}
|
|
|
|
// 3 or 6 hex digits, or the empty string.
|
|
if ( preg_match( '|^#([A-Fa-f0-9]{3}){1,2}$|', $color ) ) {
|
|
return $color;
|
|
}
|
|
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* Sanitize error message, primarily used during form frontend output.
|
|
*
|
|
* @since 1.3.7
|
|
*
|
|
* @param string $error
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_sanitize_error( $error = '' ) {
|
|
|
|
$allow = array(
|
|
'a' => array(
|
|
'href' => array(),
|
|
'title' => array(),
|
|
),
|
|
'br' => array(),
|
|
'em' => array(),
|
|
'strong' => array(),
|
|
'p' => array(),
|
|
);
|
|
|
|
return wp_kses( $error, $allow );
|
|
}
|
|
|
|
/**
|
|
* Sanitize a string, that can be a multiline.
|
|
* If WP core `sanitize_textarea_field()` exists (after 4.7.0) - use it.
|
|
* Otherwise - split onto separate lines, sanitize each one, merge again.
|
|
*
|
|
* @since 1.4.1
|
|
*
|
|
* @param string $string
|
|
*
|
|
* @return string If empty var is passed, or not a string - return unmodified. Otherwise - sanitize.
|
|
*/
|
|
function wpforms_sanitize_textarea_field( $string ) {
|
|
|
|
if ( empty( $string ) || ! is_string( $string ) ) {
|
|
return $string;
|
|
}
|
|
|
|
if ( function_exists( 'sanitize_textarea_field' ) ) {
|
|
$string = sanitize_textarea_field( $string );
|
|
} else {
|
|
$string = implode( "\n", array_map( 'sanitize_text_field', explode( "\n", $string ) ) );
|
|
}
|
|
|
|
return $string;
|
|
}
|
|
|
|
/**
|
|
* Sanitize an array, that consists of values as strings.
|
|
* After that - merge all array values into multiline string.
|
|
*
|
|
* @since 1.4.1
|
|
*
|
|
* @param array $array
|
|
*
|
|
* @return mixed If not an array is passed (or empty var) - return unmodified var. Otherwise - a merged array into multiline string.
|
|
*/
|
|
function wpforms_sanitize_array_combine( $array ) {
|
|
|
|
if ( empty( $array ) || ! is_array( $array ) ) {
|
|
return $array;
|
|
}
|
|
|
|
return implode( "\n", array_map( 'sanitize_text_field', $array ) );
|
|
}
|
|
|
|
/**
|
|
* Detect if we should use a light or dark color based on the color given.
|
|
*
|
|
* @since 1.2.5
|
|
* @link https://docs.woocommerce.com/wc-apidocs/source-function-wc_light_or_dark.html#608-627
|
|
*
|
|
* @param mixed $color
|
|
* @param string $dark (default: '#000000').
|
|
* @param string $light (default: '#FFFFFF').
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_light_or_dark( $color, $dark = '#000000', $light = '#FFFFFF' ) {
|
|
|
|
$hex = str_replace( '#', '', $color );
|
|
|
|
$c_r = hexdec( substr( $hex, 0, 2 ) );
|
|
$c_g = hexdec( substr( $hex, 2, 2 ) );
|
|
$c_b = hexdec( substr( $hex, 4, 2 ) );
|
|
|
|
$brightness = ( ( $c_r * 299 ) + ( $c_g * 587 ) + ( $c_b * 114 ) ) / 1000;
|
|
|
|
return $brightness > 155 ? $dark : $light;
|
|
}
|
|
|
|
/**
|
|
* Build and return either a taxonomy or post type object that is
|
|
* nested to accommodate any hierarchy.
|
|
*
|
|
* @since 1.3.9
|
|
* @since 1.5.0 Return array only. Empty array of no data.
|
|
*
|
|
* @param array $args Object arguments to pass to data retrieval function.
|
|
* @param bool $flat Preserve hierarchy or not. False by default - preserve it.
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_get_hierarchical_object( $args = array(), $flat = false ) {
|
|
|
|
if ( empty( $args['taxonomy'] ) && empty( $args['post_type'] ) ) {
|
|
return array();
|
|
}
|
|
|
|
$children = array();
|
|
$parents = array();
|
|
$ref_parent = '';
|
|
$ref_name = '';
|
|
|
|
if ( ! empty( $args['post_type'] ) ) {
|
|
|
|
$defaults = array(
|
|
'posts_per_page' => - 1,
|
|
'orderby' => 'title',
|
|
'order' => 'ASC',
|
|
);
|
|
$args = wp_parse_args( $args, $defaults );
|
|
$items = get_posts( $args );
|
|
$ref_parent = 'post_parent';
|
|
$ref_id = 'ID';
|
|
$ref_name = 'post_title';
|
|
|
|
} elseif ( ! empty( $args['taxonomy'] ) ) {
|
|
|
|
$defaults = array(
|
|
'hide_empty' => false,
|
|
);
|
|
$args = wp_parse_args( $args, $defaults );
|
|
$items = get_terms( $args );
|
|
$ref_parent = 'parent';
|
|
$ref_id = 'term_id';
|
|
$ref_name = 'name';
|
|
}
|
|
|
|
if ( empty( $items ) || is_wp_error( $items ) ) {
|
|
return array();
|
|
}
|
|
|
|
foreach ( $items as $item ) {
|
|
if ( $item->{$ref_parent} ) {
|
|
$children[ $item->{$ref_id} ] = $item;
|
|
$children[ $item->{$ref_id} ]->ID = (int) $item->{$ref_id};
|
|
} else {
|
|
$parents[ $item->{$ref_id} ] = $item;
|
|
$parents[ $item->{$ref_id} ]->ID = (int) $item->{$ref_id};
|
|
}
|
|
}
|
|
|
|
$children_count = count( $children );
|
|
while ( $children_count >= 1 ) {
|
|
foreach ( $children as $child ) {
|
|
_wpforms_get_hierarchical_object_search( $child, $parents, $children, $ref_parent );
|
|
// $children is modified by reference, so we need to recount to make sure we met the limits.
|
|
$children_count = count( $children );
|
|
}
|
|
}
|
|
|
|
if ( $flat ) {
|
|
$parents_flat = array();
|
|
_wpforms_get_hierarchical_object_flatten( $parents, $parents_flat, $ref_name );
|
|
|
|
return $parents_flat;
|
|
}
|
|
|
|
return $parents;
|
|
}
|
|
|
|
/**
|
|
* Search a given array and find the parent of the provided object.
|
|
*
|
|
* @since 1.3.9
|
|
*
|
|
* @param object $child Current child.
|
|
* @param array $parents Parents list.
|
|
* @param array $children Children list.
|
|
* @param string $ref_parent Parent reference.
|
|
*/
|
|
function _wpforms_get_hierarchical_object_search( $child, &$parents, &$children, $ref_parent ) {
|
|
|
|
foreach ( $parents as $id => $parent ) {
|
|
|
|
if ( $parent->ID === $child->{$ref_parent} ) {
|
|
|
|
if ( empty( $parent->children ) ) {
|
|
$parents[ $id ]->children = array(
|
|
$child->ID => $child,
|
|
);
|
|
} else {
|
|
$parents[ $id ]->children[ $child->ID ] = $child;
|
|
}
|
|
|
|
unset( $children[ $child->ID ] );
|
|
|
|
} elseif ( ! empty( $parent->children ) && is_array( $parent->children ) ) {
|
|
|
|
_wpforms_get_hierarchical_object_search( $child, $parent->children, $children, $ref_parent );
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Flatten a hierarchical object.
|
|
*
|
|
* @since 1.3.9
|
|
*
|
|
* @param array $array Array to process.
|
|
* @param array $output Processed output.
|
|
* @param string $ref_name Name reference.
|
|
* @param int $level Nesting level.
|
|
*/
|
|
function _wpforms_get_hierarchical_object_flatten( $array, &$output, $ref_name = 'name', $level = 0 ) {
|
|
|
|
foreach ( $array as $key => $item ) {
|
|
|
|
$indicator = apply_filters( 'wpforms_hierarchical_object_indicator', '—' );
|
|
$item->{$ref_name} = str_repeat( $indicator, $level ) . ' ' . $item->{$ref_name};
|
|
$item->depth = $level + 1;
|
|
$output[ $item->ID ] = $item;
|
|
|
|
if ( ! empty( $item->children ) ) {
|
|
|
|
_wpforms_get_hierarchical_object_flatten( $item->children, $output, $ref_name, $level + 1 );
|
|
unset( $output[ $item->ID ]->children );
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Return field choice properties for field configured with dynamic choices.
|
|
*
|
|
* @since 1.4.5
|
|
*
|
|
* @param array $field Field settings.
|
|
* @param int $form_id Form ID.
|
|
* @param array $form_data Form data and settings.
|
|
*
|
|
* @return false|array
|
|
*/
|
|
function wpforms_get_field_dynamic_choices( $field, $form_id, $form_data = array() ) {
|
|
|
|
if ( empty( $field['dynamic_choices'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
$choices = array();
|
|
|
|
if ( 'post_type' === $field['dynamic_choices'] ) {
|
|
|
|
if ( empty( $field['dynamic_post_type'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
$posts = wpforms_get_hierarchical_object(
|
|
apply_filters(
|
|
'wpforms_dynamic_choice_post_type_args',
|
|
array(
|
|
'post_type' => $field['dynamic_post_type'],
|
|
'posts_per_page' => -1,
|
|
'orderby' => 'title',
|
|
'order' => 'ASC',
|
|
),
|
|
$field,
|
|
$form_id
|
|
),
|
|
true
|
|
);
|
|
|
|
foreach ( $posts as $post ) {
|
|
$choices[] = array(
|
|
'value' => $post->ID,
|
|
'label' => $post->post_title,
|
|
'depth' => isset( $post->depth ) ? absint( $post->depth ) : 1,
|
|
);
|
|
}
|
|
} elseif ( 'taxonomy' === $field['dynamic_choices'] ) {
|
|
|
|
if ( empty( $field['dynamic_taxonomy'] ) ) {
|
|
return false;
|
|
}
|
|
|
|
$terms = wpforms_get_hierarchical_object(
|
|
apply_filters(
|
|
'wpforms_dynamic_choice_taxonomy_args',
|
|
array(
|
|
'taxonomy' => $field['dynamic_taxonomy'],
|
|
'hide_empty' => false,
|
|
),
|
|
$field,
|
|
$form_data
|
|
),
|
|
true
|
|
);
|
|
|
|
foreach ( $terms as $term ) {
|
|
$choices[] = array(
|
|
'value' => $term->term_id,
|
|
'label' => $term->name,
|
|
'depth' => isset( $term->depth ) ? absint( $term->depth ) : 1,
|
|
);
|
|
}
|
|
}
|
|
|
|
return $choices;
|
|
}
|
|
|
|
/**
|
|
* Insert an array into another array before/after a certain key.
|
|
*
|
|
* @link https://gist.github.com/scribu/588429
|
|
*
|
|
* @since 1.3.9
|
|
*
|
|
* @param array $array The initial array.
|
|
* @param array $pairs The array to insert.
|
|
* @param string $key The certain key.
|
|
* @param string $position Where to insert the array - before or after the key.
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_array_insert( $array, $pairs, $key, $position = 'after' ) {
|
|
|
|
$key_pos = array_search( $key, array_keys( $array ), true );
|
|
if ( 'after' === $position ) {
|
|
$key_pos ++;
|
|
}
|
|
|
|
if ( false !== $key_pos ) {
|
|
$result = array_slice( $array, 0, $key_pos );
|
|
$result = array_merge( $result, $pairs );
|
|
$result = array_merge( $result, array_slice( $array, $key_pos ) );
|
|
} else {
|
|
$result = array_merge( $array, $pairs );
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Recursively remove empty strings from an array.
|
|
*
|
|
* @since 1.3.9.1
|
|
*
|
|
* @param array $data
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_array_remove_empty_strings( $data ) {
|
|
|
|
foreach ( $data as $key => $value ) {
|
|
if ( is_array( $value ) ) {
|
|
$data[ $key ] = wpforms_array_remove_empty_strings( $data[ $key ] );
|
|
}
|
|
|
|
if ( '' === $data[ $key ] ) {
|
|
unset( $data[ $key ] );
|
|
}
|
|
}
|
|
|
|
return $data;
|
|
}
|
|
|
|
/**
|
|
* Check whether plugin works in a debug mode.
|
|
*
|
|
* @since 1.2.3
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_debug() {
|
|
|
|
$debug = false;
|
|
|
|
if ( ( defined( 'WPFORMS_DEBUG' ) && true === WPFORMS_DEBUG ) && is_super_admin() ) {
|
|
$debug = true;
|
|
}
|
|
|
|
$debug_option = get_option( 'wpforms_debug' );
|
|
|
|
if ( $debug_option ) {
|
|
$current_user = wp_get_current_user();
|
|
if ( $current_user->user_login === $debug_option ) {
|
|
$debug = true;
|
|
}
|
|
}
|
|
|
|
return apply_filters( 'wpforms_debug', $debug );
|
|
}
|
|
|
|
/**
|
|
* Helper function to display debug data.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param mixed $data What to dump, can be any type.
|
|
* @param bool $echo Whether to print or return. Default is to print.
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_debug_data( $data, $echo = true ) {
|
|
|
|
if ( wpforms_debug() ) {
|
|
|
|
$output = '<textarea style="background:#fff;margin: 20px 0;width:100%;height:500px;font-size:12px;font-family: Consolas,Monaco,monospace;direction: ltr;unicode-bidi: embed;line-height: 1.4;padding: 4px 6px 1px;" readonly>';
|
|
|
|
$output .= "=================== WPFORMS DEBUG ===================\n\n";
|
|
|
|
if ( is_array( $data ) || is_object( $data ) ) {
|
|
$output .= print_r( $data, true ); // phpcs:ignore
|
|
} else {
|
|
$output .= $data;
|
|
}
|
|
|
|
$output .= '</textarea>';
|
|
|
|
if ( $echo ) {
|
|
echo $output; // phpcs:ignore
|
|
} else {
|
|
return $output;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Log helper.
|
|
*
|
|
* @since 1.0.0
|
|
*
|
|
* @param string $title Title of a log message.
|
|
* @param mixed $message Content of a log message.
|
|
* @param array $args Expected keys: form_id, meta, parent.
|
|
*/
|
|
function wpforms_log( $title = '', $message = '', $args = array() ) {
|
|
|
|
// Require log title.
|
|
if ( empty( $title ) ) {
|
|
return;
|
|
}
|
|
|
|
// Force logging everything when in debug mode.
|
|
if ( ! wpforms_debug() ) {
|
|
|
|
/**
|
|
* Compare error levels to determine if we should log.
|
|
* Current supported levels:
|
|
* - Errors (error)
|
|
* - Spam (spam)
|
|
* - Entries (entry)
|
|
* - Payments (payment)
|
|
* - Providers (provider)
|
|
* - Conditional Logic (conditional_logic)
|
|
*/
|
|
$type = ! empty( $args['type'] ) ? (array) $args['type'] : array( 'error' );
|
|
$levels = array_intersect( $type, get_option( 'wpforms_logging', array() ) );
|
|
if ( empty( $levels ) ) {
|
|
return;
|
|
}
|
|
}
|
|
|
|
// Meta.
|
|
if ( ! empty( $args['form_id'] ) ) {
|
|
$meta = array(
|
|
'form' => absint( $args['form_id'] ),
|
|
);
|
|
} elseif ( ! empty( $args['meta'] ) ) {
|
|
$meta = $args['meta'];
|
|
} else {
|
|
$meta = '';
|
|
}
|
|
|
|
// Parent element.
|
|
$parent = ! empty( $args['parent'] ) ? $args['parent'] : 0;
|
|
|
|
// Make arrays and objects look nice.
|
|
if ( is_array( $message ) || is_object( $message ) ) {
|
|
$message = '<pre>' . print_r( $message, true ) . '</pre>'; // phpcs:ignore
|
|
}
|
|
|
|
// Create log entry.
|
|
wpforms()->logs->add( $title, $message, $parent, $parent, $meta );
|
|
}
|
|
|
|
/**
|
|
* Check whether the current page is in AMP mode or not.
|
|
* We need to check for specific functions, as there is no special AMP header.
|
|
*
|
|
* @since 1.4.1
|
|
*
|
|
* @param bool $check_theme_support Whether theme support should be checked. Defaults to true.
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_is_amp( $check_theme_support = true ) {
|
|
|
|
$is_amp = false;
|
|
|
|
if (
|
|
// AMP by Automattic; ampforwp.
|
|
( function_exists( 'is_amp_endpoint' ) && is_amp_endpoint() ) ||
|
|
// Better AMP.
|
|
( function_exists( 'is_better_amp' ) && is_better_amp() )
|
|
) {
|
|
$is_amp = true;
|
|
}
|
|
|
|
if ( $is_amp && $check_theme_support ) {
|
|
$is_amp = current_theme_supports( 'amp' );
|
|
}
|
|
|
|
return apply_filters( 'wpforms_is_amp', $is_amp );
|
|
}
|
|
|
|
/**
|
|
* Decode special characters, both alpha- (<) and numeric-based (').
|
|
*
|
|
* @since 1.4.1
|
|
*
|
|
* @param string $string Raw string to decode.
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_decode_string( $string ) {
|
|
|
|
if ( ! is_string( $string ) ) {
|
|
return $string;
|
|
}
|
|
|
|
return wp_kses_decode_entities( html_entity_decode( $string, ENT_QUOTES ) );
|
|
}
|
|
|
|
add_filter( 'wpforms_email_message', 'wpforms_decode_string' );
|
|
|
|
/**
|
|
* Get a suffix for assets, `.min` if debug is disabled.
|
|
*
|
|
* @since 1.4.1
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_min_suffix() {
|
|
return wpforms_debug() ? '' : '.min';
|
|
}
|
|
|
|
/**
|
|
* Get the required label text, with a filter.
|
|
*
|
|
* @since 1.4.4
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_required_label() {
|
|
return apply_filters( 'wpforms_required_label', esc_html__( 'This field is required.', 'wpforms-lite' ) );
|
|
}
|
|
|
|
/**
|
|
* Get the required field label HTML, with a filter.
|
|
*
|
|
* @since 1.4.8
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_field_required_label() {
|
|
|
|
$label_html = apply_filters_deprecated(
|
|
'wpforms_field_required_label',
|
|
array( ' <span class="wpforms-required-label">*</span>' ),
|
|
'1.4.8 of WPForms plugin',
|
|
'wpforms_get_field_required_label'
|
|
);
|
|
|
|
return apply_filters( 'wpforms_get_field_required_label', $label_html );
|
|
}
|
|
|
|
/**
|
|
* Get the default capability to manage everything for WPForms.
|
|
*
|
|
* @since 1.4.4
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_capability_manage_options() {
|
|
return apply_filters( 'wpforms_manage_cap', 'manage_options' );
|
|
}
|
|
|
|
/**
|
|
* Check WPForms permissions for currently logged in user.
|
|
* Both short (e.g. 'view_own_forms') or long (e.g. 'wpforms_view_own_forms') capability name can be used.
|
|
* Only WPForms capabilities get processed.
|
|
*
|
|
* @since 1.4.4
|
|
*
|
|
* @param array|string $caps Capability name(s).
|
|
* @param int $id ID of the specific object to check against if `$capability` is a "meta" cap.
|
|
* "Meta" capabilities, e.g. 'edit_post', 'edit_user', etc., are capabilities used
|
|
* by map_meta_cap() to map to other "primitive" capabilities, e.g. 'edit_posts',
|
|
* 'edit_others_posts', etc. Accessed via func_get_args() and passed to WP_User::has_cap(),
|
|
* then map_meta_cap().
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_current_user_can( $caps = array(), $id = 0 ) {
|
|
|
|
$user_can = wpforms()->get( 'access' )->current_user_can( $caps , $id );
|
|
|
|
return apply_filters( 'wpforms_current_user_can', $user_can, $caps, $id );
|
|
}
|
|
|
|
/**
|
|
* Get the certain date of a specified day in a specified format.
|
|
*
|
|
* @since 1.4.4
|
|
*
|
|
* @param string $period Supported values: start, end.
|
|
* @param string $timestamp Default is the current timestamp, if left empty.
|
|
* @param string $format Default is a MySQL format.
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_day_period_date( $period, $timestamp = '', $format = 'Y-m-d H:i:s' ) {
|
|
|
|
$date = '';
|
|
|
|
if ( empty( $timestamp ) ) {
|
|
$timestamp = time();
|
|
}
|
|
|
|
switch ( $period ) {
|
|
case 'start_of_day':
|
|
$date = date( $format, strtotime( 'today', $timestamp ) );
|
|
break;
|
|
|
|
case 'end_of_day':
|
|
$date = date( $format, strtotime( 'tomorrow', $timestamp ) - 1 );
|
|
break;
|
|
}
|
|
|
|
return $date;
|
|
}
|
|
|
|
/**
|
|
* Get an array of all possible provider addons.
|
|
*
|
|
* @since 1.5.5
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_get_providers_all() {
|
|
|
|
$providers = array(
|
|
array(
|
|
'name' => 'AWeber',
|
|
'slug' => 'aweber',
|
|
'img' => 'addon-icon-aweber.png',
|
|
'plugin' => 'wpforms-aweber/wpforms-aweber.php',
|
|
'plugin_slug' => 'wpforms-aweber',
|
|
),
|
|
array(
|
|
'name' => 'Campaign Monitor',
|
|
'slug' => 'campaign-monitor',
|
|
'img' => 'addon-icon-campaign-monitor.png',
|
|
'plugin' => 'wpforms-campaign-monitor/wpforms-campaign-monitor.php',
|
|
'plugin_slug' => 'wpforms-campaign-monitor',
|
|
),
|
|
array(
|
|
'name' => 'Drip',
|
|
'slug' => 'drip',
|
|
'img' => 'addon-icon-drip.png',
|
|
'plugin' => 'wpforms-drip/wpforms-drip.php',
|
|
'plugin_slug' => 'wpforms-drip',
|
|
),
|
|
array(
|
|
'name' => 'GetResponse',
|
|
'slug' => 'getresponse',
|
|
'img' => 'addon-icon-getresponse.png',
|
|
'plugin' => 'wpforms-getresponse/wpforms-getresponse.php',
|
|
'plugin_slug' => 'wpforms-getresponse',
|
|
),
|
|
array(
|
|
'name' => 'MailChimp',
|
|
'slug' => 'mailchimp',
|
|
'img' => 'addon-icon-mailchimp.png',
|
|
'plugin' => 'wpforms-mailchimp/wpforms-mailchimp.php',
|
|
'plugin_slug' => 'wpforms-mailchimp',
|
|
),
|
|
array(
|
|
'name' => 'Zapier',
|
|
'slug' => 'zapier',
|
|
'img' => 'addon-icon-zapier.png',
|
|
'plugin' => 'wpforms-zapier/wpforms-zapier.php',
|
|
'plugin_slug' => 'wpforms-zapier',
|
|
),
|
|
);
|
|
|
|
return $providers;
|
|
}
|
|
|
|
/**
|
|
* Get an array of all the active provider addons.
|
|
*
|
|
* @since 1.4.7
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_get_providers_available() {
|
|
return (array) apply_filters( 'wpforms_providers_available', array() );
|
|
}
|
|
|
|
/**
|
|
* Get options for all providers.
|
|
*
|
|
* @since 1.4.7
|
|
*
|
|
* @param string $provider Define a single provider to get options for this one only.
|
|
*
|
|
* @return array
|
|
*/
|
|
function wpforms_get_providers_options( $provider = '' ) {
|
|
|
|
$options = get_option( 'wpforms_providers', array() );
|
|
$provider = sanitize_key( $provider );
|
|
$data = $options;
|
|
|
|
if ( ! empty( $provider ) && isset( $options[ $provider ] ) ) {
|
|
$data = $options[ $provider ];
|
|
}
|
|
|
|
return (array) apply_filters( 'wpforms_get_providers_options', $data, $provider );
|
|
}
|
|
|
|
/**
|
|
* Update options for all providers.
|
|
*
|
|
* @since 1.4.7
|
|
*
|
|
* @param string $provider Provider slug.
|
|
* @param array|false $options If false is passed - provider will be removed. Otherwise saved.
|
|
* @param string $key Optional key to identify which connection to update. If empty - generate a new one.
|
|
*/
|
|
function wpforms_update_providers_options( $provider, $options, $key = '' ) {
|
|
|
|
$providers = wpforms_get_providers_options();
|
|
$id = ! empty( $key ) ? $key : uniqid();
|
|
$provider = sanitize_key( $provider );
|
|
|
|
if ( $options ) {
|
|
$providers[ $provider ][ $id ] = (array) $options;
|
|
} else {
|
|
unset( $providers[ $provider ] );
|
|
}
|
|
|
|
update_option( 'wpforms_providers', $providers );
|
|
}
|
|
|
|
/**
|
|
* Helper function to determine if loading an WPForms related admin page.
|
|
*
|
|
* Here we determine if the current administration page is owned/created by
|
|
* WPForms. This is done in compliance with WordPress best practices for
|
|
* development, so that we only load required WPForms CSS and JS files on pages
|
|
* we create. As a result we do not load our assets admin wide, where they might
|
|
* conflict with other plugins needlessly, also leading to a better, faster user
|
|
* experience for our users.
|
|
*
|
|
* @since 1.3.9
|
|
*
|
|
* @param string $slug Slug identifier for a specific WPForms admin page.
|
|
* @param string $view Slug identifier for a specific WPForms admin page view ("subpage").
|
|
*
|
|
* @return boolean
|
|
*/
|
|
function wpforms_is_admin_page( $slug = '', $view = '' ) {
|
|
|
|
// Check against basic requirements.
|
|
if (
|
|
! is_admin() ||
|
|
empty( $_REQUEST['page'] ) ||
|
|
strpos( $_REQUEST['page'], 'wpforms' ) === false
|
|
) {
|
|
return false;
|
|
}
|
|
|
|
// Check against page slug identifier.
|
|
if (
|
|
( ! empty( $slug ) && 'wpforms-' . $slug !== $_REQUEST['page'] ) ||
|
|
( empty( $slug ) && 'wpforms-builder' === $_REQUEST['page'] )
|
|
) {
|
|
return false;
|
|
}
|
|
|
|
// Check against sub-level page view.
|
|
if (
|
|
! empty( $view ) &&
|
|
( empty( $_REQUEST['view'] ) || $view !== $_REQUEST['view'] )
|
|
) {
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Get the ISO 639-2 Language Code from user/site locale.
|
|
*
|
|
* @see http://www.loc.gov/standards/iso639-2/php/code_list.php
|
|
*
|
|
* @since 1.5.0
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_language_code() {
|
|
|
|
$default_lang = 'en';
|
|
$locale = get_user_locale();
|
|
|
|
if ( ! empty( $locale ) ) {
|
|
$lang = explode( '_', $locale );
|
|
if ( ! empty( $lang ) && is_array( $lang ) ) {
|
|
$default_lang = strtolower( $lang[0] );
|
|
}
|
|
}
|
|
|
|
return $default_lang;
|
|
}
|
|
|
|
/**
|
|
* Determine if we should show the "Show Values" toggle for checkbox, radio, or
|
|
* select fields in form builder. Legacy.
|
|
*
|
|
* @since 1.5.0
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_show_fields_options_setting() {
|
|
|
|
return apply_filters( 'wpforms_fields_show_options_setting', false );
|
|
}
|
|
|
|
/**
|
|
* Check if a string is empty.
|
|
*
|
|
* @since 1.5.0
|
|
*
|
|
* @param string $string String to test.
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_is_empty_string( $string ) {
|
|
|
|
return is_string( $string ) && '' === $string;
|
|
}
|
|
|
|
/**
|
|
* Return URL to form preview page.
|
|
*
|
|
* @since 1.5.1
|
|
*
|
|
* @param int $form_id Form ID.
|
|
* @param bool $new_window New window flag.
|
|
*
|
|
* @return string
|
|
*/
|
|
function wpforms_get_form_preview_url( $form_id, $new_window = false ) {
|
|
|
|
$url = add_query_arg(
|
|
array(
|
|
'wpforms_form_preview' => absint( $form_id ),
|
|
),
|
|
home_url()
|
|
);
|
|
|
|
if ( $new_window ) {
|
|
$url = add_query_arg(
|
|
array(
|
|
'new_window' => 1,
|
|
),
|
|
$url
|
|
);
|
|
}
|
|
|
|
return $url;
|
|
}
|
|
|
|
/**
|
|
* Include a template - alias to \WPForms\Helpers\Template::get_html.
|
|
* Uses 'require' if $args are passed or 'load_template' if not.
|
|
*
|
|
* @since 1.5.6
|
|
*
|
|
* @param string $template_name Template name.
|
|
* @param array $args Arguments.
|
|
* @param bool $extract Extract arguments.
|
|
*
|
|
* @throws \RuntimeException If extract() tries to modify the scope.
|
|
*
|
|
* @return string Compiled HTML.
|
|
*/
|
|
function wpforms_render( $template_name, $args = array(), $extract = false ) {
|
|
|
|
return \WPForms\Helpers\Templates::get_html( $template_name, $args, $extract );
|
|
}
|
|
|
|
/**
|
|
* Chain monad, useful for chaining certain array or string related functions.
|
|
*
|
|
* @since 1.5.6
|
|
*
|
|
* @param mixed $value Any data.
|
|
*
|
|
* @return \WPForms\Helpers\Chain
|
|
*/
|
|
function wpforms_chain( $value ) {
|
|
|
|
return \WPForms\Helpers\Chain::of( $value );
|
|
}
|
|
|
|
/**
|
|
* Get the current installation license type (always lowercase).
|
|
*
|
|
* @since 1.5.6
|
|
*
|
|
* @return string|false
|
|
*/
|
|
function wpforms_get_license_type() {
|
|
|
|
$type = \wpforms_setting( 'type', '', 'wpforms_license' );
|
|
|
|
if ( empty( $type ) || ! \wpforms()->pro ) {
|
|
return false;
|
|
}
|
|
|
|
return strtolower( $type );
|
|
}
|
|
|
|
/**
|
|
* Detect if AJAX frontend form submit is being processed.
|
|
*
|
|
* @since 1.5.8.2
|
|
*
|
|
* @return bool
|
|
*/
|
|
function wpforms_is_frontend_ajax() {
|
|
|
|
// It's an AJAX request.
|
|
if ( ! wp_doing_ajax() ) {
|
|
return false;
|
|
}
|
|
|
|
// It targets admin-ajax.php.
|
|
if ( isset( $_SERVER['SCRIPT_FILENAME'] ) && basename( sanitize_text_field( wp_unslash( $_SERVER['SCRIPT_FILENAME'] ) ) ) !== 'admin-ajax.php' ) {
|
|
return false;
|
|
}
|
|
|
|
$ref = wp_get_referer();
|
|
|
|
if ( ! $ref ) {
|
|
return false;
|
|
}
|
|
|
|
$path = wp_parse_url( $ref, PHP_URL_PATH );
|
|
$admin_path = wp_parse_url( admin_url(), PHP_URL_PATH );
|
|
|
|
// It does not contain an admin path.
|
|
if ( strpos( $path, $admin_path ) !== false ) {
|
|
return false;
|
|
}
|
|
|
|
$action = isset( $_POST['action'] ) ? sanitize_key( $_POST['action'] ) : ''; // phpcs:ignore WordPress.Security.NonceVerification.Missing
|
|
|
|
// It's a WPForms request.
|
|
if ( strpos( $action, 'wpforms' ) !== 0 ) {
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|