PHPackages                             thelia/zip-code-module - 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. [Utility & Helpers](/categories/utility)
4. /
5. thelia/zip-code-module

ActiveThelia-module[Utility & Helpers](/categories/utility)

thelia/zip-code-module
======================

2.0.1(3y ago)13702[4 PRs](https://github.com/thelia-modules/ZipCode/pulls)LGPL-3.0+PHP

Since Aug 29Pushed 2y ago4 watchersCompare

[ Source](https://github.com/thelia-modules/ZipCode)[ Packagist](https://packagist.org/packages/thelia/zip-code-module)[ RSS](/packages/thelia-zip-code-module/feed)WikiDiscussions main Synced 6d ago

READMEChangelog (6)Dependencies (1)Versions (13)Used By (0)

Zip Code
========

[](#zip-code)

This module add two auto suggestion :

- for CITY, based on zipcode + country
- for ZIPCODE, based on city + country

(country is optionnal, by default the module will search in France)

Installation
------------

[](#installation)

### Manually

[](#manually)

- Copy the module into `/local/modules/` directory and be sure that the name of the module is ZipCode.
- Activate it in your thelia administration panel

### Composer

[](#composer)

Add it in your main thelia composer.json file

```
composer require thelia/zip-code-module:~2.0

```

Usage
-----

[](#usage)

To use this module you need to create an account here : then go to ZipCode module configuration and set your geonames username and that's all, if you have don't touch to the thelia hooks and inputs id (for zipcode and city) the module will now suggest zipcode and city in register and address creation form. Else if you have modify that you just have to puts all hooks describe below and add the ids `zipcode` and `city` to correponding inputs.

Hook
----

[](#hook)

`main.javascript-initialization` is used to add the javascript

`main.stylesheet` is used to add the stylesheet

`main.after-javascript-include` is used to add variable for javascript

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 63.6% 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 ~383 days

Recently: every ~477 days

Total

6

Last Release

1266d ago

Major Versions

1.0.5 → 2.0.12022-11-28

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2196919?v=4)[thelia](/maintainers/thelia)[@thelia](https://github.com/thelia)

---

Top Contributors

[![lopes-vincent](https://avatars.githubusercontent.com/u/6057206?v=4)](https://github.com/lopes-vincent "lopes-vincent (7 commits)")[![zawaze](https://avatars.githubusercontent.com/u/37273643?v=4)](https://github.com/zawaze "zawaze (2 commits)")[![anoziere](https://avatars.githubusercontent.com/u/118798868?v=4)](https://github.com/anoziere "anoziere (1 commits)")[![julescournut](https://avatars.githubusercontent.com/u/26310511?v=4)](https://github.com/julescournut "julescournut (1 commits)")

---

Tags

autocompletetheliazipcode

### Embed Badge

![Health badge](/badges/thelia-zip-code-module/health.svg)

```
[![Health](https://phpackages.com/badges/thelia-zip-code-module/health.svg)](https://phpackages.com/packages/thelia-zip-code-module)
```

PHPackages © 2026

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