- How do I install keizah7/custom-date-filter in a Laravel Nova application?
- Run composer require keizah7/custom-date-filter and confirm the filter class is available via Composer autoloading. Before installing, verify that the source URL in the package's composer.json actually resolves to the GitHub repository you expect, since the Composer name and repository name differ. There is no evidence of a tagged release, so you may be pulling dev-master.
- Which Laravel Nova versions does this custom date filter support?
- The package targets the Nova filter contract, but the documentation does not clearly declare which Nova majors (3, 4, or 5) are supported. Nova's filter key, options, and Vue component semantics shifted between majors, so check composer.json constraints before relying on it. Test on a branch against your installed Nova version first.
- How do I add the custom date filter to a Nova resource?
- Add the filter class to the filters() method of your resource, for example return [new CustomDateFilter];. It hooks only the Nova index and lens query builder, so it is additive and reversible. Delete the entry to remove it.
- What value shape does apply() receive from this date filter?
- Expect either a start/end object or a from/to array to be passed into apply(Request $request, $query, $value). Confirm the exact keys by reading the filter's options() method and its Vue component. Handle null or partial ranges explicitly so an empty filter does not silently return the full table.
- Does this filter use whereDate() or whereBetween(), and does that hurt index performance?
- This matters: whereDate() on a datetime column wraps the column in a function and typically defeats your index, while whereBetween() on a raw column can use it. Read the apply() method in the source to see which one is used. For large tables prefer whereBetween() with properly bounded ranges.
- How does this package handle timezones in date filtering?
- Timezone handling is the classic defect in Nova date filters: filtering a UTC column with a non-UTC app timezone can produce off-by-one-day results around midnight. This package does not document its timezone strategy, so check whether it uses app config, the Nova user's timezone, or UTC only. Convert bounds before querying if your app timezone is not UTC.
- Is keizah7/custom-date-filter actively maintained?
- There is no evidence of a tagged release, CI pipeline, or test suite, and the repository shows a single author with no visible community adoption. Treat it as an unmaintained snippet rather than a dependency you can count on across Laravel and Nova upgrades. Reading the source before installing is cheap because the package is likely a single small class.
- What does this package do that Nova::dateFilter() does not?
- Nova 4 and later ship Nova::dateFilter() out of the box, covering most single-date and range needs with zero dependencies. This package advertises configurable presets and styling, but the delta is small. If the built-in filter covers your use case, use it; otherwise a short local filter class is usually enough.
- Can I add preset ranges like last 7 days or this month?
- The package advertises custom ranges, presets, and single dates, with presets typically defined in the filter's options() method. The exact preset keys depend on the Vue component shipped with the package, so read the source to see what is wired up. If you copy the class into your app, you can extend options() with your own presets.
- Should I install this as a Composer dependency or copy the filter class into app/Nova/Filters?
- For a zero-star, untagged, single-class filter, copying it into app/Nova/Filters/CustomDateFilter.php with attribution is usually the safer path. You keep the behavior while removing supply-chain and version-coupling risk, and you can fix whereDate and timezone issues yourself. Budget 60 to 90 minutes for the copy and audit.