justbetter/statamic-postcodenl

There is no license information available for the latest version (4.0.2) of this package.

Package for adding Postcode.nl form fields

4.0.2 2026-04-09 12:23 UTC

Requires

• php: ^8.4
• laravel/framework: *
• statamic/cms: ^6.0

Unknown License

• Kevin Meijer

README

Statamic Postcode.nl

This addon adds Postcode.nl field types to the Form Builder.

Installation

composer require justbetter/statamic-postcodenl

Configuration

Add the following items to your .env, these settings consist of the Key and Secret provided by Postcode.nl.

POSTCODENL_KEY=""
POSTCODENL_SECRET=""

How to Use

Form settings

When building a form it's now possible to make use of the Postcode.nl fields. When selecting the Postcode.nl field you need to select the according field type, these consist of:

• Zipcode (Required)
• House number (Required)
• House number addition (Optional)
• Street (Required)
• City (Required)

Make sure to add all the required field types to your form as they are needed for this to work.

Usage

First of all import the javascript in your projects javascript file:

import './../../vendor/justbetter/statamic-postcodenl/resources/js/postcodenl.js'

After that, you can use the alpinejs x-data on a wrapper of the fields:

<div
    x-data="postcodeNL('zipcode', 'house_number', 'house_number_addition', 'street', 'city')"
>

The parameters are the id's of the postcodeNL fields. This can be left empty if the examples above are used as ID.

As the Postcode.nl field types are an extend of the normal text field type, you can use this type the same way as the text field type for your forms. For example you could still look at the input_type field to determine the field type you need to load into your form.

Make sure you're using the correct variable when passing the formId, this variable should be the handle of your form. i.e 'contact'.