cloudcatch/gravityforms-phone-validation

A Gravity Forms plugin that adds phone number validation using libphonenumber-for-php

1.0.0 2025-03-13 10:41 UTC

Requires

• php: >=8.1
• giggsey/libphonenumber-for-php: ^8.13

GPL-2.0-or-later

• CloudCatch

• validation
• phone
• libphonenumber
• gravityforms

README

This plugin uses the libphonenumber for PHP to validate Gravity Forms phone number fields against a given region specified through the plugin settings. This plugin was created to help mitigate form submissions that contain invalid / fake phone numbers.

Installation

composer require cloudcatch/gravityforms-phone-validation

You can manually install this plugin by cloning this repository, and installing the requires dependencies:

# Clone the repository
git clone https://github.com/CloudCatch/gravityforms-phone-validation.git

# Change directory
cd gravityforms-phone-validation

# Install dependencies
composer install --no-dev

# Optionally generate a plugin zip which will output in the ./dist directory
composer run plugin-zip

How to use

• Install and activate the plugin
• Navigate to the Gravity Forms settings page: Forms > Settings
• On this main settings page, towards the bottom is a field labeled Phone Validation Region, specify the region in which you want to validate phone numbers against, and save.

Usage

This plugin by default will validate against US based phone numbers unless otherwise specified in the Gravity Forms settings.

Submitting any form containing a Phone field type will now validate the phone number against the region.