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 2w ago

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 52% 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

2049d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16007412?v=4)[christopherbolt](/maintainers/christopherbolt)[@christopherbolt](https://github.com/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

[silverstripe/userforms

UserForms enables CMS users to create dynamic forms via a drag and drop interface and without getting involved in any PHP code

1321.1M83](/packages/silverstripe-userforms)[dnadesign/silverstripe-elemental

Elemental pagetype and collection of Elements

1101.1M295](/packages/dnadesign-silverstripe-elemental)[bummzack/sortablefile

An extension for SilverStripe that adds sorting to UploadField.

67660.1k58](/packages/bummzack-sortablefile)[symbiote/silverstripe-advancedworkflow

Adds configurable workflow support to the CMS, with a GUI for creating custom workflow definitions.

46299.9k9](/packages/symbiote-silverstripe-advancedworkflow)[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.

4628.3k1](/packages/unclecheese-silverstripe-kickassets)[axllent/silverstripe-scaled-uploads

Automatically scale down and rotate uploaded images for Silverstripe

2483.3k9](/packages/axllent-silverstripe-scaled-uploads)

PHPackages © 2026

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