About this plugin
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.pot file 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.