GF French Address Autocomplete WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

Instant French address autocomplete for Gravity Forms — powered by the free Base Adresse Nationale API, no API key required.

Autocomplete

• Instant suggestions: Address dropdown appears after 3 characters (configurable)
• Smart field mapping: Automatically populates all Address sub-fields: street, city, postal code, region and country
• Restrict by type: Filter results to house numbers, streets, or municipalities
• Keyboard navigation: Full arrow key / Enter / Escape support
• Configurable debounce: Reduce API calls with an adjustable delay

Privacy & Results

• No API Key: Uses the free French government BAN API — no registration, no quota, no cost
• Privacy-Friendly: Only the address query is sent to api-adresse.data.gouv.fr (IGN / French government infrastructure)
• Geolocation bias (optional): Results can be biased toward the user's location via the Browser Geolocation API
• Coordinates saved: Selected address latitude / longitude are saved as Gravity Forms entry meta

Key Features

• No API Key: Uses the free French government BAN API — no registration needed
• Privacy-Friendly: Only the address query is sent to api-adresse.data.gouv.fr (IGN)
• Smart Field Mapping: Automatically populates all Address sub-fields (street, city, ZIP, region, country)
• Multilingual: Works with content in any language
• Translation-Ready: All strings are internationalized
• Secure: Nonce-verified, all output escaped
• GitHub Updates: Automatic updates from GitHub releases

Requirements

• Gravity Forms 2.7 or higher
• WordPress 6.0 or higher
• PHP 7.4 or higher
• Internet access to reach api-adresse.data.gouv.fr

Installation

1. Upload the gf-french-address-autocomplete folder to /wp-content/plugins/
2. Activate the plugin through the Plugins menu in WordPress
3. Go to Forms → Settings → French Autocomplete to configure the global options (result limit, debounce delay, geolocation)
4. Open any form, go to Settings → French Autocomplete and enable autocomplete for that form
5. Address fields on that form will now display BAN suggestions on the frontend

FAQ

Does this work outside France?

No — the Base Adresse Nationale (BAN) only covers French addresses (including DOM-TOM territories). For international addresses, use a different API.

Is the BAN API free?

Yes. The BAN is maintained by the French government (IGN) and is completely free, with no API key and no rate limit that would affect normal usage (50 req/IP/sec).

Does the plugin save GPS coordinates?

Yes — when the user selects a suggestion, latitude and longitude are saved as Gravity Forms entry meta (gffaa_lat_{fieldId} and gffaa_lng_{fieldId}). The full selected address object is also saved as gffaa_place_{fieldId}.

How can I customise which API fields map to which GF sub-fields?

Use the gffaa_field_mapping JavaScript event on document:

document.addEventListener( 'gffaa_field_mapping', function ( e ) {
    // e.detail.value is the mapping object { 1: line1, 3: city, 4: region, 5: zip, 6: country }
    // e.detail.extra[0] is the BAN feature object
    e.detail.value[4] = e.detail.extra[0].properties.context.split(', ')[1]; // dept name instead of region
} );

What about GDPR?

The only data sent to a third-party server is the address string typed by the user. This is sent to api-adresse.data.gouv.fr, which is French government infrastructure operated by IGN. No personal identifiers are transmitted.

Project Structure

.
├── gf-french-address-autocomplete.php   # Main plugin file (bootstrap)
├── uninstall.php                        # Cleanup on uninstall
├── README.md
├── CHANGELOG.md
├── LICENSE
├── assets/
│   ├── css/
│   │   └── gffaa-autocomplete.css       # Dropdown styles
│   └── js/
│       └── gffaa-autocomplete.js        # Frontend autocomplete logic
├── includes/
│   ├── class-gf-french-address-autocomplete.php  # Main GFAddOn class
│   └── class-github-updater.php                  # GitHub auto-updates
└── languages/
    └── gf-french-address-autocomplete.pot         # Translation template

Changelog

1.0.1 — 2026-03-30

• Improved: Rewritten GitHub updater with README.md parsing for the "View details" modal
• New: "View details" thickbox link in the plugin row meta
• New: Parsedown.php dependency for Markdown-to-HTML conversion
• New: Gravity Forms version requirement shown in plugin details sidebar

1.0.0 — 2026-03-13

• New: Initial release
• New: BAN API autocomplete on Gravity Forms Address fields
• New: Lat/lng and full place object saved as entry meta on submission
• New: ARIA-compliant dropdown with keyboard navigation
• New: GitHub auto-update support

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.

Made with love for the WordPress community