README

A Filament v5 plugin that integrates the Danish Address Web API (DAWA) into your Filament forms. Provides an autocomplete input field for Danish addresses, backed by a polymorphic Address model.

Requirements

PHP 8.2+
Laravel 11.28+
Filament 5+

Installation

Install via Composer:

composer require bazuka/filament-address

Publish and run the migration:

php artisan vendor:publish --tag=filament-address-migrations
php artisan migrate

Optionally publish the config:

php artisan vendor:publish --tag=filament-address-config

Custom Theme (required)

This plugin uses Tailwind CSS utility classes, so your Filament panel must have a custom theme. If you haven't created one yet:

php artisan make:filament-theme

Follow the output instructions to register the theme in your panel provider, then add the plugin's views as a Tailwind source in the generated theme CSS file (e.g. resources/css/filament/admin/theme.css):

@source '../../../../vendor/bazuka/filament-address/resources/views/**/*';

Then rebuild your assets:

npm run build

Register the plugin in your Filament panel provider:

use Bazuka\FilamentAddress\FilamentAddressPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FilamentAddressPlugin::make(),
        ]);
}

Usage

1. Prepare your model

Add the HasAddresses trait to any Eloquent model that should have addresses:

use Bazuka\FilamentAddress\Concerns\HasAddresses;

class Customer extends Model
{
    use HasAddresses;
}

This gives the model two relationships:

Method	Returns	Description
`address()`	`MorphOne`	The primary (first) address
`addresses()`	`MorphMany`	All addresses

2. Add the form field

Use AddressInput in any Filament form. When the user picks a suggestion, the address is automatically saved via the HasAddresses trait:

use Bazuka\FilamentAddress\Forms\Components\AddressInput;

AddressInput::make('address')
    ->label('Address')
    ->placeholder('Start typing an address…')
    ->suggestionCount(8),

The field calls the DAWA autocomplete API directly from the browser as the user types (debounced at 300 ms). No API key is required.

3. Reading the stored address

$customer = Customer::with('address')->find($id);

$customer->address->formatted_address; // "Amaliegade 18, 1256 København K"
$customer->address->street_name;       // "Amaliegade"
$customer->address->postal_code;       // "1256"
$customer->address->city;              // "København K"
$customer->address->latitude;          // 55.6810...
$customer->address->longitude;         // 12.5856...

Available Address Attributes

Attribute	Type	Description
`dawa_id`	string (UUID)	DAWA unique address identifier
`formatted_address`	string	Full formatted address string
`street_name`	string	Street name
`house_number`	string	House number
`floor`	string\|null	Floor
`door`	string\|null	Door
`postal_code`	string	Postal code
`city`	string	City name
`municipality_code`	string	Municipality code
`longitude`	float\|null	WGS84 longitude
`latitude`	float\|null	WGS84 latitude
`access_address_id`	string\|null	DAWA access address reference
`label`	string\|null	Optional label (e.g. `billing`, `shipping`)

Configuration

// config/filament-address.php
return [
    'address_model' => \Bazuka\FilamentAddress\Models\Address::class,
];

You can swap in your own model as long as it extends Bazuka\FilamentAddress\Models\Address:

'address_model' => \App\Models\Address::class,

AddressService

For programmatic address lookup outside of forms:

use Bazuka\FilamentAddress\Services\AddressService;

// Returns up to $count suggestions
$suggestions = AddressService::addressAutocomplete('Amalieg', 5);

// Returns the single best match, or null
$match = AddressService::bestAddressMatch('Amaliegade 18, København');

License

MIT — see LICENSE.

bazuka / filament-address

Maintainers

Package info

Statistics

Security