sureforms / inc / fields / phone-markup.php

phone-markup.php in SureForms – Contact Form Builder, AI Forms, Payment Form, Survey & Quiz 2.12.7, at inc/fields/phone-markup.php

168 lines 6.0 KB

Raw Download Zip

1	<?php
2	/**
3	* Sureforms Phone Markup Class file.
4	*
5	* @package sureforms.
6	* @since 0.0.1
7	*/
8
9	namespace SRFM\Inc\Fields;
10
11	use SRFM\Inc\Helper;
12
13	if ( ! defined( 'ABSPATH' ) ) {
14	exit; // Exit if accessed directly.
15	}
16
17	/**
18	* Sureforms_Phone_Markup Class.
19	*
20	* @since 0.0.1
21	*/
22	class Phone_Markup extends Base {
23	/**
24	* Stores the boolean string indicating if the country should be automatically determined.
25	*
26	* @var string
27	* @since 0.0.2
28	*/
29	protected $auto_country;
30
31	/**
32	* Stores the default country code when auto country is disabled.
33	*
34	* @var string
35	* @since 1.12.1
36	*/
37	protected $default_country;
38
39	/**
40	* Enable country filter toggle.
41	*
42	* @var bool
43	* @since 2.3.0
44	*/
45	protected $enable_country_filter;
46
47	/**
48	* Country filter type (include or exclude).
49	*
50	* @var string
51	* @since 2.3.0
52	*/
53	protected $country_filter_type;
54
55	/**
56	* Array of country codes to include.
57	*
58	* @var array
59	* @since 2.3.0
60	*/
61	protected $include_countries;
62
63	/**
64	* Array of country codes to exclude.
65	*
66	* @var array
67	* @since 2.3.0
68	*/
69	protected $exclude_countries;
70
71	/**
72	* Initialize the properties based on block attributes.
73	*
74	* @param array<mixed> $attributes Block attributes.
75	* @since 0.0.2
76	*/
77	public function __construct( $attributes ) {
78	$this->set_properties( $attributes );
79	$this->set_input_label( __( 'Phone', 'sureforms' ) );
80	$this->set_error_msg( $attributes, 'srfm_phone_block_required_text' );
81	$this->set_duplicate_msg( $attributes, 'srfm_phone_block_unique_text' );
82	$this->slug = 'phone';
83	$this->auto_country = $attributes['autoCountry'] ?? '';
84	$this->default_country = $attributes['defaultCountry'] ?? '';
85	$this->enable_country_filter = $attributes['enableCountryFilter'] ?? false;
86	$this->country_filter_type = $attributes['countryFilterType'] ?? 'include';
87	$this->include_countries = $attributes['includeCountries'] ?? [];
88	$this->exclude_countries = $attributes['excludeCountries'] ?? [];
89
90	// When auto country is enabled, resolve a best-effort country here at render
91	// time to seed the baked `default-country` attribute (a sensible flag before
92	// any JS runs). The authoritative per-visitor detection happens client-side:
93	// phone.js applies an immediate network-free Intl guess and then refines it
94	// from the same-origin geo-country REST endpoint — so it stays correct even on
95	// full-page-cached sites, where this baked value would otherwise be the first
96	// visitor's country.
97	//
98	// Why not get_locale()?
99	// WordPress get_locale() returns the site's configured language (e.g. 'en_US'),
100	// not the visitor's physical location. A site set to English would show 'US' for
101	// every visitor worldwide — defeating the purpose of auto-country detection.
102	//
103	// Why resolve server-side at all (vs. a browser geo-IP fetch)?
104	// A client-side fetch('https://ipapi.co/json') caused CORS failures, 429 rate
105	// limits on high-traffic sites, and exposed visitor IPs to a third party from the
106	// browser. The server path (CDN header first, then a capped, cached ipapi.co
107	// lookup in Helper::get_geo_country()) avoids all three.
108	if ( $this->auto_country ) {
109	// Pass the configured default as the fallback so a detection failure
110	// degrades to the user's chosen country instead of a hardcoded 'us'.
111	$fallback = ! empty( $this->default_country ) && is_string( $this->default_country )
112	? strtolower( $this->default_country )
113	: 'us';
114	$this->default_country = Helper::get_geo_country( $fallback );
115	}
116	$this->set_unique_slug();
117	$this->set_field_name( $this->unique_slug );
118	$this->set_markup_properties( $this->input_label, true );
119	$this->set_aria_described_by();
120	$this->set_label_as_placeholder( $this->input_label );
121	}
122
123	/**
124	* Render the sureforms phone classic styling
125	*
126	* @since 0.0.2
127	* @return string\|bool
128	*/
129	public function markup() {
130	ob_start(); ?>
131	<div data-block-id="<?php echo esc_attr( $this->block_id ); ?>" class="srfm-block-single srfm-block srfm-<?php echo esc_attr( $this->slug ); ?>-block srf-<?php echo esc_attr( $this->slug ); ?>-<?php echo esc_attr( $this->block_id ); ?>-block<?php echo esc_attr( $this->block_width ); ?><?php echo esc_attr( $this->class_name ); ?> <?php echo esc_attr( $this->conditional_class ); ?>">
132	<?php echo wp_kses_post( $this->label_markup ); ?>
133	<?php echo wp_kses_post( $this->help_markup ); ?>
134	<div class="srfm-block-wrap">
135	<input type="tel"
136	class="srfm-input-common srfm-input-<?php echo esc_attr( $this->slug ); ?>"
137	name="<?php echo esc_attr( $this->field_name ); ?>"
138	id="<?php echo esc_attr( $this->unique_slug ); ?>"
139	<?php echo ! empty( $this->aria_described_by ) ? "aria-describedby='" . esc_attr( trim( $this->aria_described_by ) ) . "'" : ''; ?>
140	data-required="<?php echo esc_attr( $this->data_require_attr ); ?>"
141	aria-required="<?php echo esc_attr( $this->data_require_attr ); ?>"
142	default-country="<?php echo esc_attr( $this->default_country ); ?>"
143	<?php if ( $this->auto_country ) { ?>
144	data-auto-country="true"
145	<?php } ?>
146	<?php if ( $this->enable_country_filter ) { ?>
147	data-enable-country-filter="true"
148	data-country-filter-type="<?php echo esc_attr( $this->country_filter_type ); ?>"
149	<?php if ( 'include' === $this->country_filter_type && ! empty( $this->include_countries ) ) { ?>
150	data-include-countries="<?php echo esc_attr( Helper::get_string_value( wp_json_encode( $this->include_countries ) ) ); ?>"
151	<?php } elseif ( 'exclude' === $this->country_filter_type && ! empty( $this->exclude_countries ) ) { ?>
152	data-exclude-countries="<?php echo esc_attr( Helper::get_string_value( wp_json_encode( $this->exclude_countries ) ) ); ?>"
153	<?php } ?>
154	<?php } ?>
155	value="<?php echo esc_attr( $this->default ); ?>"
156	<?php echo wp_kses_post( $this->placeholder_attr ); ?>
157	data-unique="<?php echo esc_attr( $this->aria_unique ); ?>">
158	</div>
159	<div class="srfm-error-wrap">
160	<?php echo wp_kses_post( $this->duplicate_msg_markup ); ?>
161	</div>
162	</div>
163	<?php
164	return ob_get_clean();
165	}
166
167	}
168