omar-haris/filament-timezone-field

A Laravel Filament component that enables users to choose a specific timezone grouped by regions, with support for multiple languages.

v2.0.0 2024-09-29 13:03 UTC

This package is auto-updated.

Last update: 2024-10-29 13:16:25 UTC


README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads Total Stars

A Laravel Filament component that enables users to choose a specific timezone grouped by regions, with support for multiple languages.

Requirements

  • PHP 8.1^
  • Filament v3

Installation

You can install the package via composer:

composer require omar-haris/filament-timezone-field

You can publish the translation languages files with:

php artisan vendor:publish --tag="filament-timezone-field-translations"

Supported languages

  • Arabic
  • English

Usage

Add to your filament form resource:

use OmarHaris\FilamentTimezoneField\Forms\Components\Timezone as TimezoneComponent;
 
public static function form(Form $form): Form
{
    return $form
        ->schema([
            // ...
            TimezoneComponent::make('timezone')
                ->searchable()
                ->required(),
            // ...
        ]);
}

Add to your filament table resource:

use OmarHaris\FilamentTimezoneField\Tables\Columns\Timezone as TimezoneColumn;
 
public static function form(Form $form): Form
{
    return $form
        ->columns([
            // ...
            TimezoneColumn::make('timezone')
                ->sortable()
                ->toggleable(),
            // ...
        ]);
}

You can use it as a table filter

use OmarHaris\FilamentTimezoneField\Tables\Filters\Timezone as TimezoneFilter;

public static function table(Table $table): Table
{
    return $table
        //...
        ->filters([
            TimezoneFilter::make('timezone'),
            // ...
        ])
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.