PHPackages                             christopherbolt/silverstripe-addressfinderfield - 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. [File & Storage](/categories/file-storage)
4. /
5. christopherbolt/silverstripe-addressfinderfield

ActiveSilverstripe-module[File & Storage](/categories/file-storage)

christopherbolt/silverstripe-addressfinderfield
===============================================

Save address information based on the AddressFinderNZ API into DataObject fields.

v1.0.2(5y ago)1751PHPPHP >=5.3.0

Since Sep 4Pushed 5y ago1 watchersCompare

[ Source](https://github.com/christopherbolt/silverstripe-addressfinderfield)[ Packagist](https://packagist.org/packages/christopherbolt/silverstripe-addressfinderfield)[ Docs](https://github.com/christopherbolt/silverstripe-addressfinderfield)[ RSS](/packages/christopherbolt-silverstripe-addressfinderfield/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (2)Versions (5)Used By (0)

DEVELOPMENT - SilverStripe AddressFinderNZ Field
================================================

[](#development---silverstripe-addressfindernz-field)

A custom field for integrating the AddressFinderNZ API as both a backend and frontend field.

```
AddressFinderField::create(DataObject $data, $name, $title = null, $databaseFields = array(), $hiddenFields = false)

```

By default the field will pull the full address from the API and will save it into the database field 'Address'.

Alternatively you can specifiy multiple fields from the API to be saved to the database. You can do this by passing in the alternative database fields array as the 3rd variable of the field constructor. The key of the array is the database field and the value should match the meta data returned by the API.

### Requirements

[](#requirements)

This installer requires you have the following:

- Composer

### Configuration

[](#configuration)

1. Add your AddressFinderNZ API information to the config.yml:

```
AddressFinderField:
  Key: 'key-here'
  Secret: 'secret-here'

```

### Usage

[](#usage)

1. Add the database fields to your page or object

```
private static $db = array(
        'Address' => 'Text'
);

```

2. Add the field to your fieldset

```
AddressFinderField::create($this, 'AddressFinder', 'Search address')

```

### Advanced Usage

[](#advanced-usage)

1. Add the multiple database fields to your page or object

```
private static $db = array(
  'Address' => 'Text',
  'City' => 'Varchar',
  'Street' => 'Varchar'
);

```

2. Specify multiple address fields to save to your object NOTE: The key of the array is the database field and the value should match the meta data returned by the API.

```
$addressConfig = array(
  'Address' => 'a',
  'City' => 'city',
  'Street' => 'street'
);

```

3. Add the field to your fieldset

```
AddressFinderField::create($this, 'AddressFinder', 'Search address', $addressConfig)

```

### Frontend Usage

[](#frontend-usage)

1. Add the address field but don't forget to specify the DataObject

```
AddressFinderField::create($this->data(), 'AddressFinder', 'Address Finder', $addressConfig, false)

```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

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

###  Release Activity

Cadence

Every ~268 days

Total

4

Last Release

2001d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a485d2a5011de981a03627bcbb43deb9a868a46e2507b3037e81516d89117df6?d=identicon)[christopherbolt](/maintainers/christopherbolt)

---

Top Contributors

[![dawb](https://avatars.githubusercontent.com/u/777930?v=4)](https://github.com/dawb "dawb (15 commits)")[![christopherbolt](https://avatars.githubusercontent.com/u/16007412?v=4)](https://github.com/christopherbolt "christopherbolt (10 commits)")[![nigelramsay](https://avatars.githubusercontent.com/u/6838?v=4)](https://github.com/nigelramsay "nigelramsay (1 commits)")

---

Tags

addresssilverstripefinderaddressfinderfield

### Embed Badge

![Health badge](/badges/christopherbolt-silverstripe-addressfinderfield/health.svg)

```
[![Health](https://phpackages.com/badges/christopherbolt-silverstripe-addressfinderfield/health.svg)](https://phpackages.com/packages/christopherbolt-silverstripe-addressfinderfield)
```

###  Alternatives

[bummzack/sortablefile

An extension for SilverStripe that adds sorting to UploadField.

70622.7k55](/packages/bummzack-sortablefile)[unclecheese/silverstripe-kickassets

Provides an alternative file management interface for SilverStripe CMS with drag-and-drop, multi-selection, and several other desktop-like UI conventions.

4728.3k1](/packages/unclecheese-silverstripe-kickassets)[unclecheese/dropzone

An HTML5 upload field for the CMS and frontend forms.

46130.7k6](/packages/unclecheese-dropzone)[silverstripe/s3

Adds SilverStripe support for using the S3 adapter for Flysystem

20297.0k1](/packages/silverstripe-s3)[unclecheese/kickassets

Provides an alternative file management interface for SilverStripe CMS with drag-and-drop, multi-selection, and several other desktop-like UI conventions.

484.0k](/packages/unclecheese-kickassets)[silverstripe/selectupload

Enables files to be uploaded into a user-designated folder

2779.1k1](/packages/silverstripe-selectupload)

PHPackages © 2026

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