Weave Code
Weaver
Helps Laravel developers discover, compare, and choose open-source packages. See popularity, security, maintainers, and scores at a glance to make better decisions.
Feedback
Share your thoughts, report bugs, or suggest improvements.
Subject
Message
Log in Register
Home
Packages
Custom Fields
Changelog

Custom Fields Laravel Package

relaticle/custom-fields

Laravel/Filament plugin that adds dynamic custom fields to any Eloquent model without database migrations. Supports 20+ field types, conditional visibility, multi-tenancy, CSV import/export, optional encryption, and custom field types.

View on GitHub
Deep Wiki
Context7
v3.8.0

Deterministic record lookups, a configurable search minimum, and an option-count threshold for option-backed selects. All three are reachable from a new selects config block, so 3.7 behaviour can be restored exactly.

Deterministic record lookups

RecordSelectInputComponent ran limit(50) with no orderBy, so the initial page was whatever the database returned and could differ between two renders of the same form. It now orders by the model key descending, which is deterministic and backed by the primary key index.

Measured on a seeded 50,000-row tenant with EXPLAIN (ANALYZE, BUFFERS):

Variant Plan Time Shared buffers
Model key desc (the new default) Index Scan Backward on the primary key 0.036 ms 7
No ORDER BY (3.7 behaviour) Seq Scan stops at 50 rows 0.043 ms 4
updated_at desc, id desc Seq Scan 50,004 rows, top-N heapsort, Limit 7.59 ms 822

Determinism therefore costs nothing. Set record_lookup.order_column to 'updated_at' if you prefer most-recently-touched-first, and index that column when the lookup table is large. A configured column always gets the model key appended as a tiebreaker.

Minimum search length, configurable end to end

getSearchResultsForJs() returned [] below 2 characters. It now returns the unfiltered first page, and the minimum comes from record_lookup.min_search_length rather than a literal. The field's JavaScript reads the same value, so raising the minimum can no longer leave the client asking for a filtered search that the server answers with an unfiltered page.

Search box only above an option-count threshold (behaviour change)

SelectComponent and MultiSelectComponent called ->searchable() unconditionally, so a three-option status field rendered a search box above three items. They now gate on option count, default 10.

This is a taste change, not a bug fix. It carries no performance benefit: filtering for static options already happened client-side at zero server cost. The only effect is that the search box disappears on small option sets.

Opt-out: set custom-fields.selects.searchable_threshold to 0 to always render the search box, which is exactly the pre-3.8 behaviour.

Config

'selects' => [
    'searchable_threshold' => 10,   // 0 always shows the search box (pre-3.8 behaviour)

    'record_lookup' => [
        'order_column' => null,     // null means the model key, index-backed
        'order_direction' => 'desc',
        'limit' => 50,
        'min_search_length' => 2,
    ],
],

Consumers who published config/custom-fields.php before 3.8 do not have this block. Every read passes the same value as its default, so nothing breaks and the new defaults apply.

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.7.0...v3.8.0

v3.7.0

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.6.3...v3.7.0

v3.6.3

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.6.2...v3.6.3

v3.6.2

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.6.1...v3.6.2

v3.6.1

What's Changed

Other Changes

New Contributors

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.6.0...v3.6.1

v3.6.0

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.5.5...v3.6.0

v3.5.5

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.5.4...v3.5.5

v3.5.4

What's Changed

Other Changes

New Contributors

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.5.3...v3.5.4

v3.5.3

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.5.2...v3.5.3

v3.5.2

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.5.1...v3.5.2

v3.5.1

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.5.0...v3.5.1

v3.5.0

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.4.1...v3.5.0

v3.4.1

Fixed

  • Date validation "After another field" reference dropdown now populates when creating a field. The reference-field selector showed "No options available" while creating a new date custom field — it only worked when editing an existing one. The options closure resolved the entity type through the relative state path $get('../../../entity_type'), which inside the field-management action modal (mountedActions.0.data.*) climbed past the form-data scope to the Livewire root and returned null, short-circuiting to an empty list. It now resolves entity_type/code via absolute data-scope paths, correct in both the action-modal and page-form contexts (#172).

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.4.0...v3.4.1

v3.4.0

Fixed

  • Visibility condition value no longer wiped when only the operator changes. Editing a saved section/field visibility condition and changing its operator (e.g. Is in → Is not in) reset the stored value to null, silently turning the condition into an "is in / is not in nothing" match. The value is now preserved whenever the new operator still takes one, and only cleared for value-less operators (is empty / is not empty) (#170).

Added

  • Configurable section modal width. The add/edit section modal width is now resolved through CustomFieldsPlugin::make()->sectionModalWidth(...) (a Width case or closure) or the custom-fields.management.section_modal_width config key. The default widens to screen-lg when section conditional visibility is enabled — previously the add-section modal stayed at 2xl, cramping the conditions row — and the create/edit modals now resolve to the same width (#170).

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.3.0...v3.4.0

v3.3.0

Added

  • SectionForm::extendSchemaUsing() — extend the custom-field section management form from application code (e.g. a service provider), with no subclassing or vendor patching. A single registration applies to both the Add and Edit section modals, and the callback receives the current schema plus the section's entity type, so extensions can be scoped per entity (#165).
  • Free-form extra bag on CustomFieldSectionSettingsData — consumer-defined section settings bound under settings.extra.* now round-trip through the typed settings DTO (and through config import/export). Enables, for example, flagging a section to render as its own tab (#165).

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.2.1...v3.3.0

v3.2.1

Fixed

  • Apply section-level conditional visibility on infolists (#162). Section-level visibility conditions (including cross-record relation conditions) were only honored on forms; on infolists a section rendered for every record whenever it had any visible field. InfolistBuilder now evaluates each section's visibility against the record, mirroring the form path. Sections without conditions and field-level visibility are unaffected.
v3.2.0

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.1.7...v3.2.0

v3.1.7

What's Changed

Other Changes

New Contributors

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.1.6...v3.1.7

v3.1.6

What's Changed

  • Adds Laravel 13 support — the package now installs and tests cleanly on both Laravel 12 and Laravel 13.
  • Replaces transitive postare/blade-mdi dependency with manukminasyan/blade-mdi, a Packagist-published fork that widens the illuminate/support constraint to include ^13.0. Same Postare\BladeMdi\ namespace, no source changes.
  • CI matrix now runs against Laravel 12.* + 13.* on every push.

Compatibility

  • Laravel 12 users: drop-in compatible, no changes required.
  • Laravel 13 users: composer require relaticle/custom-fields now works without extra setup.

PR: https://github.com/relaticle/custom-fields/pull/145

v3.1.5

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.1.4...v3.1.5

v3.1.4

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.1.3...v3.1.4

v3.1.3

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.1.2...v3.1.3

v3.1.2

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.1.1...v3.1.2

v3.1.1

What's Changed

Other Changes

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.1.0...v3.1.1

v3.1.0

What's Changed

New Features

  • Model attribute conditions: Conditional field/section visibility based on model attributes (#74)
  • Section conditional visibility support

Fixes

  • Fix null dereference in normalizeValueForEvaluation
  • Replace addslashes with json_encode for JS string escaping
  • Remove duplicate docblock on getNormalizedFieldValues
  • Resolve rector issues for CI compatibility with rector 2.3.9
  • Add explicit success notification to createSection action
  • Update tests badge to correct workflow filename and branch
  • Use full URL for git ls-remote in changelog workflow

Maintenance

  • Remove Ukrainian translation for maintainability
  • Add release notes configuration for auto-generated changelogs
  • Add auto-release workflow and normalize CI naming
  • Update actions/setup-node to v6, actions/checkout to v6

Full Changelog: https://github.com/relaticle/custom-fields/compare/v3.0.14...v3.1.0

3.0.0

Added

  • Record Field Type: New field type for entity references with avatar support
  • Phone Input Component: Country selector with validation via propaganistas/laravel-phone
  • Email/Phone Columns: Table columns with clipboard support and improved display
  • RichTextColumn: Better rich editor display in tables
  • Tags Filter: Colored badges and filters for tags input
  • Upgrade Command: Automated migration tool (vendor/bin/custom-fields-upgrade)
  • Optional Sections: SYSTEM_SECTIONS feature flag for sectionless mode
  • Field Search: Search functionality in custom fields management page
  • Field Deactivation: Soft-disable non-system-defined fields and sections
  • Avatar Configuration: Display options for entity references

Changed

  • Filament 5 Required: Upgraded from Filament 4 to Filament 5
  • Laravel 12 Required: Upgraded from Laravel 11 to Laravel 12
  • Phone Field Format: Now stores structured JSON with country codes instead of plain strings
  • Email Field Format: Now stores JSON arrays to support multiple values

Removed

  • Lookup Fields on Non-Record Types: lookup_type setting removed from text, number, date, and other non-relational field types

Migration

Run vendor/bin/custom-fields-upgrade to automatically migrate phone/email formats and lookup field settings.

2.0.0

Added

  • Fluent Builder API: New CustomFields::form(), CustomFields::table(), CustomFields::infolist() builders
  • Field Type Configurator: Fluent configuration for enabling/disabling field types
  • BaseFieldType with FieldSchema: Cleaner field type definitions with less boilerplate
  • Settings JSON Column: Added to custom_field_options table

Changed

  • Namespace Changes: InteractsWithCustomFields trait moved to Relaticle\CustomFields\Concerns
  • Filament 4 Required: Upgraded from Filament 3 to Filament 4

Deprecated

  • Component-based integration (CustomFieldsComponent::make()) in favor of builder API
1.0.0
  • Initial release
Weaver

How can I help you explore Laravel packages today?

Conversation history is not saved when not logged in.
Prompt
Add packages to context
No packages found.
adachsoft/changelog-linter
adachsoft/collection
payerurl/telegrambot-crypto-payment-instant-payout
dskripchenko/laravel-hybrid-search
riorizkyrainey/lara-ced
mehedimi/static-vel
zharp/zharp
nonsapiens/bigquery-model-sync
lgu-bayambang-ict-office/lgu-laravel-development-standards
andydefer/laravel-support
se7enxweb/flysystem
lampwick/laravel
jeslage/statamic-emojis
micahdshackelford/rmap-laravel
draftsmaninc/draftsman
square-bit/laravel-volition
himito/laravel-mailman
htinlynn/genius-helper
maco-studios/hephaestus
elmogy/larafast