PHPackages                             owl/address - 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. owl/address

AbandonedArchivedLibrary[Utility & Helpers](/categories/utility)

owl/address
===========

Address widget for OctoberCMS.

46703[2 issues](https://github.com/october-widgets/address/issues)JavaScript

Since Mar 7Pushed 10y ago2 watchersCompare

[ Source](https://github.com/october-widgets/address)[ Packagist](https://packagist.org/packages/owl/address)[ RSS](/packages/owl-address/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Address
=======

[](#address)

Address widget for [OctoberCMS](http://octobercms.com).

[![Packagist](https://camo.githubusercontent.com/228049b4345de3fae11fb2ecdceb998093fc4b574d13b329a84804d466ceaeab/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f776c2f616464726573732e737667)](https://camo.githubusercontent.com/228049b4345de3fae11fb2ecdceb998093fc4b574d13b329a84804d466ceaeab/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f776c2f616464726573732e737667)

### Installation

[](#installation)

To install the Address widget, add the following to your plugin's `composer.json` file.

```
"require": {
    "owl/address": "~1.0@dev"
}
```

Next, register the widget in your plugin's `Plugin.php` file.

```
public function registerFormWidgets()
{
    return [
        'Owl\FormWidgets\Address\Widget' => [
            'label' => 'Address',
            'code' => 'owl-address'
        ],
    ];
}
```

### Usage

[](#usage)

You can add this widget to your forms simply by decalring the field type as `owl-address`.

```
address:
    label: Address
    type: owl-address

```

This allows the form field to query the google maps public API and predict the location using autocomplete.

You can customize it further by using field maps, so that it automatically fills other fields with values based on the selected place i.e. such as latitude, longitude, etc. To do this first declare the form field with the field maps.

```
address:
    label: Address
    type: owl-address
    fieldMap:
        latitude: latitude
        longitude: longitude
        city: city
        zip: zip
        country: country_code
        state: state_code
        name: place_name
        address: place_address
        formataddress: fmt_address

```

Now define fields which should get filled up with the result values. The field name should be same as the value specified in the fieldMap fields.

```
city:
    label: City
zip:
    label: Zip
country_code:
    label: Country
state_code:
    label: State
latitude:
    label: Latitude
longitude:
    label: Longitude
place_name:
    label: Place Name
place_address:
    label: Place Address
fmt_address:
    label: Formatted Address

```

The widget automatically detects the presence of the fields and applies the correct values whenever a place is selected using the autocomplete.

Available mappings:

- street
- city
- zip
- state
- country
- country-long
- latitude
- longitude
- name
- address
- formataddress

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/904cc72c102eb3725fdc5191aaf7519724839af6feb847dc20dfa138f37e50b2?d=identicon)[scottbedard](/maintainers/scottbedard)

---

Top Contributors

[![mohsin](https://avatars.githubusercontent.com/u/1699753?v=4)](https://github.com/mohsin "mohsin (2 commits)")[![scottbedard](https://avatars.githubusercontent.com/u/7980426?v=4)](https://github.com/scottbedard "scottbedard (1 commits)")

### Embed Badge

![Health badge](/badges/owl-address/health.svg)

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

PHPackages © 2026

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