ariaieboy/filament-currency

Bring back laravel-money formatter for Filament Text Column

Fund package maintenance!
ariaieboy

1.4.0 2024-04-01 08:33 UTC

This package is auto-updated.

Last update: 2024-05-01 08:45:42 UTC


README

filament currency Latest Version on Packagist GitHub Code Style Action Status Total Downloads

Filament V3 unlike V2 that uses laravel-money package for formatting money TextColumns uses PHP native NumberFormatter class.

This package will add a new currency(string | Closure $currency = null, bool $shouldConvert = false) method to the TextColumn that uses the Filament V2 money formatter.

By using this package you can configure the formatter using laravel-money config.

For example, you can customize the symbol, symbol_first, decimal_mark, and thousands_separator for each currency. Or if you want you can add your custom currency to the config and use it in the currency() method instead of standard money.

We also have a currencyMask() method for TextInput that lets you mask your numbers in front-end and return the plain number to back-end.

Installation

You can install the package via Composer:

composer require ariaieboy/filament-currency

You can publish the laravel-money config file with:

php artisan vendor:publish --tag=money

Usage

\Filament\Tables\Columns\TextColumn::make('money')
    ->currency('USD');

\Filament\Forms\Components\TextInput::make('money')
    ->currencyMask(thousandSeparator: ',',decimalSeparator: '.',precision: 2)

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.