WP Manifestindependent plugin directory
manifest / forms / gravity-forms-reg-lookup

JSON Reg Look Up (Multi-Form, Refactored)

A powerful WordPress plugin designed to integrate Gravity Forms with the ukvehicledata API. It automates vehicle information retrieval (Make, Model, Year, MOT history, etc.) based on a registration number and populates form fields dynamically. It is built to handle multiple form instances, including mobile and sidebar variations.

by Darren Kandekore · github.com/kandekore/gravity-forms-reg-lookup · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/kandekore/gravity-forms-reg-lookup/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/kandekore/gravity-forms-reg-lookup ↗

JSON Reg Look Up (Multi-Form, Refactored) (v2.0)

A powerful WordPress plugin designed to integrate Gravity Forms with the ukvehicledata API. It automates vehicle information retrieval (Make, Model, Year, MOT history, etc.) based on a registration number and populates form fields dynamically. It is built to handle multiple form instances, including mobile and sidebar variations, with secure API key encryption and custom entry ID prefixing.

🚀 Key Features

  • Automated Vehicle Lookup: Fetches comprehensive data from ukvehicledata (VehicleAndMotHistory and VehicleImageData APIs) using just a registration number.
  • Dynamic Form Population: Forcibly populates both visible and hidden Gravity Forms fields with API data, including:
    • Make, Model, Year, and Colour.
    • MOT Expiry and Last recorded mileage.
    • Technical specs like Fuel Type, Engine Capacity, CO2 Emissions, and Transmission.
    • Vehicle Image URLs displayed directly in the form.
  • Multi-Form Support: Configurable settings to target a "Main Form," "Mobile Form," and "Sidebar Form" simultaneously.
  • Intelligent Fallbacks:
    • Manual Entry: If a lookup fails, the plugin displays a validation message and reveals manual input fields for the user to complete.
    • VIN Fallback: If no VIN is returned by the API, it automatically populates the VIN field with the user's phone number (cleaned of spaces).
  • Custom Entry ID Prefixing: Automatically generates a unique, prefixed reference ID (e.g., VCM-123) for every submission.
  • Enterprise-Grade Security: API keys are stored in the database using OpenSSL (AES-256-CBC) encryption for maximum security.

🛠 Installation

  1. Upload the gravity-forms-reg-lookup folder to your /wp-content/plugins/ directory.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Navigate to Settings > RegLookup to configure your global settings.

📖 Configuration

1. API & Entry ID Settings

  • ukvehicledata API Key: Enter your official API key. The plugin will encrypt this value upon saving.
  • Entry ID Prefix: Define the custom prefix for your submission references (e.g., REF- or VCM-).

2. Gravity Forms IDs

  • Enter the specific IDs for your Main, Mobile, and Sidebar forms as found in the Gravity Forms dashboard.

⚙️ Technical Details

  • Version: 2.0
  • Dependencies: Requires Gravity Forms to be installed and active.
  • Key Hooks:
    • gform_post_paging: Triggers the API lookup when moving from Page 1 to Page 2.
    • gform_pre_render: Dynamically injects vehicle images and summary lists into HTML fields.
    • gform_after_submission: Handles the generation of the prefixed entry ID.
  • Encryption: Utilizes openssl_encrypt with aes-256-cbc when available.

🏷️ Suggested Topics

wordpress-plugin gravity-forms vehicle-api ukvehicledata form-automation api-integration vehicle-registration-lookup data-encryption dynamic-form-fields mot-history vin-lookup custom-entry-ids