PHPackages                             inspiredminds/contao-address-verification - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Validation &amp; Sanitization](/categories/validation)
4. /
5. inspiredminds/contao-address-verification

ActiveContao-bundle[Validation &amp; Sanitization](/categories/validation)

inspiredminds/contao-address-verification
=========================================

Contao extension to provide an address verification module.

1.2.1(2y ago)121[1 issues](https://github.com/inspiredminds/contao-address-verification/issues)LGPL-3.0-or-laterPHPPHP ^7.2 || ^8.0

Since Aug 10Pushed 2y ago2 watchersCompare

[ Source](https://github.com/inspiredminds/contao-address-verification)[ Packagist](https://packagist.org/packages/inspiredminds/contao-address-verification)[ Docs](https://github.com/inspiredminds/contao-address-verification)[ GitHub Sponsors](https://github.com/sponsors/fritzmg)[ RSS](/packages/inspiredminds-contao-address-verification/feed)WikiDiscussions main Synced today

READMEChangelog (6)Dependencies (11)Versions (7)Used By (0)

Contao Address Verification
===========================

[](#contao-address-verification)

This extension allows you to manage addresses in the back end which can then be verified against in the front end.

The extension provides a module where front end visitors can enter their address. This address will be verified against the stored addresses and different content will then be shown (or different redirects will be executed), depending on the verification result. The module also provides a simple autocomplete script by default. All the entered addresses in the back end will be provided for autocompletion on the *street* input field of the address. The chosen autocompleted result will be filled in in all input fields (street, number, apartment, city and country).

Address Management
------------------

[](#address-management)

Addresses are divided by *Address Groups*. Each address group has a name and you can also optionally define custom content via [nodes](https://github.com/terminal42/contao-node) that will be displayed when an address has been verified for the selected groups. Each address currently consists of the following properties:

- Street
- Number (house number)
- Apartment (apartment number or living unit)
- Postal code
- City (*Note:* only the postal code will be used for verification)
- Country (can optionally be included in the verification)

When editing an address group you also have the possibility to import addresses in bulk through a CSV file. The CSV file needs to have the following format:

```
street,number,apartment,postal code,city,country

```

The country, or city and country together, can be omitted from the CSV file.

*Note:* the country needs to be in the ISO 3166-1 Alpha-2 format, e.g. "at" for Austria, "de" for Germany, etc. (upper or lower case does not matter).

Front End Modules
-----------------

[](#front-end-modules)

The extension currently provides two modules in total: one for the actual address verification and one module to automatically redirect to a redirect page, if no address verification session was started yet.

### Address verification

[](#address-verification)

This module handles the actual address verification process and show the form as well as the subsequent content in the front end. It provides the following settings:

- **Address groups:** addresses are grouped in the back end, similar to news archives for example. Select the address groups against which the entered address should be verified against.
- **Include country:** includes the country in the output of the front end form and includes it also for the verification process itself.
- **Nodes:** content to be shown for either a verified address or an unverified address.
- **Redirect page:** redirects to the defined page directly, instead of showing the nodes based content.

### Require address verification session

[](#require-address-verification-session)

This module provides a possibility to redirect to a defined page in the front end, if no address verification session was started yet, i.e. if the front end visitor did not enter an address via the *Address verification module* yet. You can use this module to prevent access to certain pages in such a case.

Session Variable
----------------

[](#session-variable)

Once a front end visitor has entered their address, a session will be started and the entered address is available via the `address-verification` session variable. This variable will contain an array consisting of the entered address, which can then be used in other places in your process.

Modify Form Event
-----------------

[](#modify-form-event)

The *Address verification* module provides an `InspiredMinds\ContaoAddressVerification\Event\BuildAddressVerificationFormEvent` event with which you can modify the form based on [`Haste\Form\Form`](https://github.com/codefog/contao-haste/blob/master/docs/Form/Form.md). You can use this event to add additional form fields or validators etc. to the form.

Autocompletion
--------------

[](#autocompletion)

This extension integrates [autoComplete.js](https://tarekraafat.github.io/autoComplete.js/) for autocompletion, but does not integrate any of its CSS styles by default, as you need to take care of styling yourself. As a starting point you could download the *autoComplete.js* package and use one of its stylesheets for your own purposes. The stylesheets are also present under `web/bundles/contaoaddressverification/css/`, so you could also add the following code to a custom `mod_address_verification` template (or elsewhere):

```
// templates/mod_address_verification.html5
$GLOBALS['TL_CSS'][] = 'bundles/contaoaddressverification/css/autoComplete.02.css';
$this->extend('mod_address_verification');
```

Likewise, if you want to customize the JavaScript itself or the initialisation of the script, create your own copy of the `mod_address_verification` template and modify the JavaScript accordingly.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~155 days

Recently: every ~193 days

Total

6

Last Release

957d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/25f6ec05570f72d0fcc4d0a4fef2309799d53badf8b30484284e73724661e0d8?d=identicon)[fritzmg](/maintainers/fritzmg)

---

Top Contributors

[![fritzmg](https://avatars.githubusercontent.com/u/4970961?v=4)](https://github.com/fritzmg "fritzmg (27 commits)")

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/inspiredminds-contao-address-verification/health.svg)

```
[![Health](https://phpackages.com/badges/inspiredminds-contao-address-verification/health.svg)](https://phpackages.com/packages/inspiredminds-contao-address-verification)
```

###  Alternatives

[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[terminal42/dcawizard

dcaWizard extension for Contao Open Source CMS

10370.7k15](/packages/terminal42-dcawizard)[codefog/contao-haste

haste extension for Contao Open Source CMS

42650.8k139](/packages/codefog-contao-haste)[contao/manager-bundle

Provides the Contao Managed Edition

181.3M61](/packages/contao-manager-bundle)[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3183.3k6](/packages/codefog-contao-news-categories)[terminal42/contao-node

Node bundle for Contao Open Source CMS

3172.5k4](/packages/terminal42-contao-node)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
