Alharthiweb Phone Country Code

Alharthiweb Phone Country Code adds a searchable country selector beside ordinary telephone fields. Free automatically discovers type="tel", autocomplete="tel", and common phone names such as phone, mobile and customer_phone. WooCommerce Classic Checkout uses billing_phone; customer_phone is a general form convention, not a WooCommerce standard. Choose favorite countries, set a fallback, or paste an international number. Arabic and Persian digits and the 00 international prefix are accepted. An international prefix takes priority over the billing address. Automatic suggestions never change the country after typing starts or after a manual choice. The plugin uses English by default, including on an Arabic site; the site translation is an explicit option. It does not change the site language or rewrite saved orders. Free includes country names, flags, calling codes, search, favorites, safe input normalization, keyboard controls, and optional disclosed IP country suggestion. It does not perform detailed number validation. Pro functionality is distributed separately from this Free package: local metadata validation with matching server checks for Classic Checkout billing_phone, optional mobile-only checks, additional field selectors, and custom plain-text messages. Other forms receive browser validation only. Pro availability and licensing are being prepared. Checkout Blocks and Store API are not supported in this version. Format validity does not prove that a phone exists, belongs to a visitor, or can receive SMS. No OTP or SMS service is provided. External services and privacy No external service is required. Phone processing and country data are local. Automatic country suggestion stays off until an administrator explicitly chooses Enable with FreeIPAPI and saves. The free endpoint needs no account, API key or subscription and permits commercial use under its current terms. For an empty phone field without a known country, the browser makes at most one request per page to https://free.freeipapi.com/api/v1/json/ . The service receives the visitor IP address, website origin and normal connection metadata, never phone numbers, order details, names or emails. The plugin sends no credentials or referrer, uses only the countryCode mapped to local calling codes, and does not save the IP or response. FreeIPAPI may keep request logs. See https://freeipapi.com/privacy and https://freeipapi.com/terms . The free service allows 10 requests per 10 seconds and 60 per minute, shared by domain and source IP, not per visitor; see https://freeipapi.com/rate-limit . Accuracy and availability are not guaranteed. After five seconds, an error or a rate limit, the current country stays usable; there is no retry or alternate provider. VPN results may reflect the network exit country. Add the service to your privacy notice and obtain visitor consent where required before enabling requests. A site integration can return false from the alhwpc_allow_country_suggestion filter to suppress requests for a visitor. The settings preview never contacts the provider. The plugin stores configuration only. WooCommerce or the containing form controls phone storage. No external phone-validation request is included. Optional Freemius account and usage sharing is described separately below. Source and licenses First-party source is GPL-3.0-or-later. Country data derives from intl-tel-input 29.5.5 (MIT), https://github.com/jackocnr/intl-tel-input/tree/v29.5.5 . Its notice is included under licenses/. Editable frontend source, country data and readable classic bundles are included. The deterministic bundle recipe is described in SOURCE.txt.

1. Install and activate the ZIP through Plugins > Add New > Upload Plugin.
2. Open Settings > Phone Country Code and try a number in the preview.
3. Open a normal phone form or Classic Checkout. Defaults work immediately.

When replacing QBF Phone Country Selector, deactivate the old plugin first. Saved legacy settings are retained; historical order numbers are untouched. Do not activate two editions together.

1.8.7

• Exclude development build scripts from installable distributions; retain readable runtime asset sources.

1.8.6

• Make every pinned country name discoverable by WordPress translation tools using literal gettext strings.
• Preserve English defaults, explicit translation choice, country data and saved settings.

1.8.5

• Preserve native and shared SDK update callbacks using the product-scoped Free update boundary.
• Pin the Phone commerce adapter independently from other products.

1.8.4

• Add optional Freemius account consent and supported in-plugin Pro license navigation to the commercial distribution.
• Keep English plugin descriptions correctly directed on RTL sites while preserving custom Arabic text.
• Show a readable country code while local flags load or when the image is unavailable.

1.8.3

• Restore optional automatic country suggestion with FreeIPAPI's commercial free endpoint and a concise provider approval choice.
• Preserve prior settings while requiring approval for the new provider; keep the admin preview local.
• Preserve provider approval and favorite countries when WordPress sanitizes a newly saved option twice.
• Bound each page to one lookup and a five-second deadline; preserve typed, prefilled and manual choices on late/error/rate-limited responses.
• Scope billing-country changes to the related billing phone instead of unrelated form fields.

1.8.2

• Restore decorated phone field names used by checkout and form builders.
• Load local country data and phone controls through conditional classic scripts, removing essential module-MIME and JSON-request dependencies.
• Keep local paid validation independent of module MIME support and recover bounded delayed configuration startup.

1.8.1

• Discover common phone/mobile names and telephone autocomplete safely; prioritize the actual billing_phone field.
• Handle delayed form inputs with bounded scans and form-only observation; keep helpers separate per field.
• Accept a plain custom field name, #id, .class or supported simple selector in Pro/Owner.
• Correct Tristan da Cunha area inference and use native TA metadata consistently.
• Preserve Norfolk Island five-digit local input in Free; detailed editions apply the metadata transform.
• Ignore IP-provider error payloads and disclose the current development-only keyless service limit.

1.8.0

• New English-first product identity and additive settings.
• Preserve explicit international prefixes and manual choices.
• Accept Arabic/Persian digits and 00 prefixes safely.
• Accessible local search and bounded dynamic field enhancement.
• Optional, disclosed IP country suggestion disabled by default.
• Separate Free, private Pro test and private Owner builds.