- How do I install ariaieboy/filament-jalali-datetime in a Laravel Filament app?
- Install it with Composer using composer require ariaieboy/filament-jalali-datetime, then register the plugin or service provider as described in the package documentation for your Filament panel. Because it is a Filament UI plugin, it belongs in Laravel applications that already use Filament admin panels. After registration, use the provided Jalali form fields and table columns in your resources.
- Does filament-jalali-datetime store dates as Jalali or Gregorian in the database?
- The package is UI-layer focused, so the intended pattern is to keep dates stored as Gregorian in the database and convert to Jalali only for display and input. Do not store Jalali strings unless your application already has a localized-date storage convention, because that would require data remediation. Validate storage and conversion behavior in staging before rollout.
- Which Filament versions are supported by ariaieboy/filament-jalali-datetime?
- The provided release notes do not explicitly list supported Filament major versions, so check the package composer.json constraints and README before installing. The main compatibility question is Filament v3 versus v4 support, not PHP 8.4. If you are on Filament v4, verify explicit support before production rollout.
- Does ariaieboy/filament-jalali-datetime support PHP 8.4?
- Release 1.4.2 adds PHP 8.4 to composer.json, which is a compatibility signal rather than a feature change. Confirm whether the constraint was widened or older PHP versions were dropped by reviewing the composer.json diff. Existing 1.4.x installs should see low risk because the patch does not introduce new APIs or deprecations.
- How do I replace Filament's default DateTimePicker with a Jalali date picker?
- Register the plugin, then replace standard Filament DateTimePicker fields and date table columns with the Jalali equivalents provided by the package. Start with a limited set of fields in staging and verify validation, filtering, and display. Keep existing Gregorian storage unchanged unless your app already stores localized date strings.
- Can I use this package for Jalali date columns in Filament tables?
- Yes, the package is described as a Jalali datetime column for Filament table builder and also provides Jalali date picker components for forms. Use the provided column classes in your Filament resources instead of the default date columns. Confirm that filtering and sorting still behave as expected in your Filament version.
- How does filament-jalali-datetime handle timezones and Asia/Tehran offsets?
- Timezone handling, DST behavior, and Asia/Tehran offsets are not detailed in the provided assessment, so do not assume they are covered without testing. Validate conversion around midnight boundaries and DST transitions in a staging environment. Keep database values Gregorian and apply timezone conversion deliberately at the UI boundary.
- Is ariaieboy/filament-jalali-datetime actively maintained and production-ready?
- It appears community-maintained with support through GitHub issues and maintainer availability, not a commercial SLA. The package itself is low-risk for runtime scaling because conversion and formatting happen at the UI layer. For production, document a fallback to standard Filament date components with server-side conversion if compatibility breaks.
- What are alternatives to this package for Persian dates in Laravel and Filament?
- If you do not use Filament, this is not the right package; choose a general Laravel Jalali date library or implement server-side conversion. Within Filament, alternatives include standard Filament date components plus custom Jalali formatting and conversion, or other community Jalali date plugins. Evaluate maintenance, Filament version support, and timezone behavior before switching.
- How should I test Jalali date conversion and validation before deploying?
- Test in a non-production branch by installing 1.4.2, registering the plugin, and replacing a small set of date fields and columns. Verify Gregorian storage, Jalali display, timezone conversion, validation rules, and table filtering. Also review the package CI matrix and composer constraints for PHP, Laravel, and Filament combinations.