- How do I install ariaieboy/filament-currency in a Laravel Filament panel?
- Run composer require ariaieboy/filament-currency, register the plugin in your panel provider, and publish the config file so you can set your default currency and locale. After that, replace existing TextInput and TextColumn usages with the plugin's currency field and column. Integration is typically a few hours of work rather than days, because the package adds no migrations, queues, or external services.
- Does filament-currency convert money between currencies or fetch exchange rates?
- No. Despite the word conversion in the package description, it is a presentation-layer plugin that formats a stored numeric value using a configured currency and locale. It owns no wallets, no FX rates, no ledger, and no rounding policy. Real currency conversion and monetary arithmetic belong in your domain layer, with this package only rendering the result.
- Which Filament and Laravel versions does filament-currency support?
- Version 2.1.0 is a compatibility release that adds Laravel 13 support on the v2 line, with no API changes or deprecations noted. Because a minor bump can widen or replace the illuminate constraint, diff composer.json between versions instead of trusting the changelog. Confirm the Filament major, PHP 8.2 to 8.4, and Laravel 11, 12, and 13 matrix explicitly, then pin the verified combination.
- How do I change the default currency and locale in filament-currency?
- Publish the package config and set the default currency and locale there; fields and columns inherit those defaults unless overridden. Locale output comes from PHP's intl extension, so the symbol and separators follow the ICU data in your runtime image. Keep the same values in local, staging, and production configs so formatting snapshots stay stable.
- Can I show a different currency on each record with filament-currency?
- The published config supplies global defaults, and the field accepts a currency argument so you can typically pass a per-record value. Verify the exact behavior in the version you install rather than assuming full multi-currency support. If you need multi-currency arithmetic or per-record exchange rates, handle that in the domain layer and let the plugin only render the result.
- Does filament-currency handle rounding and precision for money?
- No, rounding and precision are your responsibility. The plugin formats whatever value you store, so a float column can display correctly and still drift over time. Store amounts as integer minor units or a decimal money type, and apply your rounding policy before the value reaches the field or column.
- Is ext-intl required for filament-currency and why does formatting differ between containers?
- Formatting is locale-aware, which in PHP means the intl extension and its ICU data. Different base images ship different ICU versions, so the same code can render a different symbol or separator in another container. Confirm ext-intl is present and version-pinned in your runtime images, and deploy to staging on the production image to catch parity issues.
- How do I test currency fields and columns in a Filament panel?
- Add a formatting snapshot test that runs representative amounts and locales through the field and column, alongside your existing panel test suite. Run it against the same container image you use in production so ICU differences surface before deploy. Re-run the suite after every composer update, since minor releases can shift version constraints.
- Does the filament-currency input respect locale separators like 1.234,56?
- The field is built for masked, locale-aware entry and parses what the user types into a stored value. Test the cases you care about, including thousands separators, decimal comma versus decimal point, negatives, and parenthesised amounts, against your configured locale before rollout. Parsing behavior can vary between versions, so verify it rather than assume it.
- Is ariaieboy/filament-currency maintained and safe to use in production?
- It is a narrow, low-coupling UI plugin with a single primary maintainer, tracking Filament's roughly annual majors. Version 2.1.0 is compatibility-only and a v3 line exists, which makes v2 the trailing branch with an unstated support window. Pin the version, record the verified compatibility matrix in an ADR, and note that replacing the field or column with a custom formatter requires no domain code changes.