Download the PHP package kreatif/laravel-codice-fiscale without Composer

Laravel Codice Fiscale Package

A comprehensive Laravel package for Italian Codice Fiscale (Tax Code) with Filament PHP v5 integration, validation, and multilingual geo-location support.

Features

• ✅ Unified Geo-Location Database: Single table for Italian municipalities AND foreign states
• ✅ Multilingual Support: Italian, German, and English denominations
• ✅ Action-Based Architecture: Reusable actions for all operations
• ✅ Validation Rules: Both basic and strict validation against personal data
• ✅ Console Commands: Easy data synchronization from official ANPR sources
• ✅ Alto Adige / Südtirol Support: Special handling for bilingual region
• ✅ Caching: Built-in caching for Belfiore code lookups
• ✅ Filament v5 Field Component: Full-featured custom field with generator and validator
• ✅ Filament Form Fields Trait: Ready-to-use trait with all CF fields (firstname, lastname, DOB, gender, country, place, CF)

Requirements

• PHP 8.2 | 8.3 | 8.4+
• Laravel 11.x | 12.x
• Filament 5.x (for previous version v1.0.0)
• Database: MySQL, PostgreSQL, MariaDB, or SQLite

Installation

Quick Start

1. Publish Configuration

2. Run Migrations

3. Sync Data

__You might need to configure the data_sources.csv.*.source to this __DIR__ . '/../vendor/kreatif/laravel-codice-fiscale/resources/data/csv/COL_VW_COMUNI_NAZIONI_ESTERE.csv'.__

4. (Optional) Publish German Translation Data

Usage

Calculate Codice Fiscale

Validate Codice Fiscale

Find Belfiore Code

Laravel Validation

Basic Validation

Strict Validation

Query Geo-Locations

Console Commands

Sync Municipalities

Documentation

Comprehensive documentation is available in the .docs/ directory:

• README.md - Package overview and quick start
• DEV_NOTES.md - Development notes and future enhancements

Filament Integration

Filament Form Fields Trait

The package provides a ready-to-use trait with pre-built Filament form fields for all Codice Fiscale data.

Out-of-the-Box (Simplest)

This single line gives you:

• ✅ Firstname & Lastname fields (grouped, responsive)
• ✅ Date of Birth with format (configurable creating format lang/{de,it,en,etc}/formats.php)
• ✅ Gender selector (M/F)
• ✅ Country of Birth (searchable, live updates)
• ✅ Place of Birth (dynamic: Select for Italy, TextInput for other countries)
• ✅ Codice Fiscale field with strict validation
• ✅ Multilingual labels (IT, EN, DE) for filamentphp fields

With Generator & Validator

Individual Field Methods

For more control, use individual field methods:

Composed Field Groups

Label Customization

All fields support label customization:

Available label getter methods:

Basic example of full user form fields

Dynamic Place of Birth

The Place of Birth field automatically switches between:

• Select dropdown when country is Italy (searchable Italian municipalities)
• Text input when country is anything else (free text for foreign locations)

This happens automatically based on the Country of Birth field value.

CodiceFiscale Field Component

Basic Usage

Full-Featured with Strict Validation

Conditional Behavior

Custom Actions (Advanced)

Override the default actions with your own implementations:

Credits

• Provincia Autonoma di Bolzano: German translation data (Pronotel)

License

MIT License - see LICENSE.md for details.

Made with ❤️ by Kreatif for the Italian community and Alto Adige / Südtirol region.