விளக்கம்
MDL Local Service Lead Validator helps local service businesses stop receiving leads from outside their service area. When a visitor fills in a phone number on a contact or lead form, the plugin checks the area or regional code against your configured service area. If the number is outside your allowed coverage, the submission is blocked and the visitor sees your warning message.
How it works
- You configure your service area in Lead Validator > Settings.
- The plugin builds and stores the allowed code list from your selected countries, regions, or manual entries, and also stores the structured picker selection used by the admin UI.
- When a visitor submits a form, the plugin validates the number in the browser for instant feedback and on the server for supported integrations.
- Valid numbers submit normally. Invalid numbers are blocked and show your warning message.
Admin screens
- Lead Validator > Settings: General, International, and Logging tabs
- Lead Validator > Form Overrides: per-form allowed code lists
- Lead Validator > Blocked Leads: blocked submission log with CSV export
Validation modes
- NANP: for standard US and Canada style numbers
- International: for non-NANP countries or multi-country setups
The General tab controls which countries and regional codes are allowed. The International tab controls how those selected countries are parsed when international mode is enabled.
Supported form plugins
- Contact Form 7 (free)
- WPForms (free and Pro)
- Gravity Forms
- Elementor Pro Forms
- Generic HTML forms — any
<form>on the page via client-side JS, plus an optional AJAX endpoint for custom server-side validation
Features
- Two-layer validation for supported integrations: client-side JavaScript (instant) + server-side PHP (secure)
- World country and region picker for building allowed code lists
- Configurable list of allowed codes (comma or newline separated)
- Customisable warning message
- Configurable CSS selectors for phone fields and target forms
- NANP and international parsing modes
- Country-specific international parsing overrides
- Per-form area code overrides
- Blocked lead logging with CSV export
- Multisite support with network-wide default codes
- Accessible warning UI (
role="alert", keyboard focus management) - Fully internationalised — translation-ready with
.potfile included - No external API calls — all validation is local
- Cleans up all data on plugin deletion
Privacy
This plugin does not transmit any data to external servers. All phone number validation is performed locally on your WordPress installation.
Screenshots
Installation
- Upload the
mdl-local-service-lead-validatorfolder to the/wp-content/plugins/directory. - Activate the plugin through the Plugins menu in WordPress.
- Go to Lead Validator > Settings > General and configure your service area.
- If needed, review Lead Validator > Settings > International for non-NANP or multi-country setups.
- Optionally enable blocked-lead logging under Lead Validator > Settings > Logging.
அடிக்கடி கேட்கப்படும் கேள்விகள்
-
Which phone number formats are supported?
-
In NANP mode, the plugin supports standard North American Numbering Plan formats, including:
*(212) 555-1234
*+1-718-555-0000
*917.555.8888
*3475551234In International mode, the plugin can also validate country-specific regional codes using the selected countries and parsing rules from the settings screens.
-
What happens if I leave the area codes list empty?
-
If no area codes are configured, the plugin allows all form submissions. This is safe — the plugin only blocks submissions once you have at least one area code saved.
-
Does this work with Elementor free?
-
Server-side validation requires Elementor Pro Forms. Client-side JavaScript validation can still work with forms rendered on Elementor pages, including forms provided by other plugins.
-
Can I use a custom CSS selector for my phone field?
-
Yes. Go to Lead Validator > Settings > General and update the Phone Field Selector to match your theme or form plugin’s phone input. The default selector is
input[name*="phone"], input[type="tel"]. -
Does every form get server-side validation?
-
No. Server-side validation is built in for Contact Form 7, WPForms, Gravity Forms, and Elementor Pro Forms. Generic HTML forms get frontend JavaScript validation by default, and can use the plugin’s AJAX endpoint if you want a custom server-side check too.
-
Does the plugin add any data to my database?
-
The plugin stores its settings in WordPress options, including your allowed codes, warning message, selectors, validation mode, international rules, logging preference, and per-form overrides. It also creates a custom blocked-leads table on activation. All plugin options are deleted and the log table is dropped on uninstall.
-
Is the plugin multisite compatible?
-
Yes. Version 1.0.0 includes multisite support, including a network admin settings screen for default area codes and a per-site option to inherit or override those network defaults.
-
Can I give one form a different service area?
-
Yes. Use Lead Validator > Form Overrides to assign a specific allowed-code list to an individual Contact Form 7, WPForms, Gravity Forms, Elementor, or native form ID.
-
Does the plugin log blocked submissions?
-
Yes, if you enable logging in Lead Validator > Settings > Logging. The plugin stores a masked phone number, extracted code, form type, form ID, page URL, and blocked timestamp. Full phone numbers are not stored.
Reviews
இந்த செருகுநிரலுக்கு மதிப்புரைகள் எதுவும் இல்லை.
பங்களிப்பாளர்கள் & உருவாக்குனர்கள்
“MDL Local Service Lead Validator” is open source software. The following people have contributed to this plugin.
பங்களிப்பாளர்கள்
Translate “MDL Local Service Lead Validator” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release.
- Area code validation for Contact Form 7, WPForms, Gravity Forms, Elementor Pro Forms, and generic HTML forms.
- Two-layer validation for supported integrations (client-side JS + server-side PHP).
- Per-form area code overrides.
- International phone number support.
- Blocked lead logging with CSV export.
- World country / region service area picker.
- Multisite / network admin support.
- Top-level Lead Validator admin menu with settings, overrides, and blocked leads screens.
- Accessible warning UI.
- Full i18n support with
.potfile.