TappNetwork / nova-prepopulate-searchable

A tool to allow BelongsTo searchable fields to be pre-populated with data

Prepoulate Searchable for Laravel Nova

A tool to allow BelongsTo searchable fields to be pre-populated with data

- Alert: the namespace of this repo has changed from `alexbowers/nova-prepopulate-searchable`
- to `genealabs/nova-prepopulate-searchable`. Please update your composer.json file before updating!

Requirements

• PHP 7.3+
• Laravel 7.0+
• Nova 3.8.4+

Installation

You can install the package in to a Laravel app that uses Nova via composer:

composer require genealabs/nova-prepopulate-searchable

Usage

On any BelongsTo fields in your resources that are searchable(), you can also add prepopulate() to the method chain and the field will be prepopulated with values to choose from.

You may optionally pass through a search query to the prepopulate method, and the keywords passed will be used for the search initially, before resetting the search to being empty (as it currently is).

Limiting Pre-Populated Items

You can limit the prepopulated items by passing in a search string to the prepopulated() method like so:

    BelongsTo::make("Archive")
        ->searchable()
        ->prepopulate("test").

This would prepopulate all archives that have test in their display field.

Preview Links

You can display a link to a resource's detail view (after selection) using the previewLink method.

    BelongsTo::make("Archive")
        ->searchable()
        ->prepopulate().
        ->previewLink(),

The previewLink method accepts a boolean and can be conditionally hidden, i.e: when 'Creating Via' a resource.

    BelongsTo::make("Archive")
        ->searchable()
        ->prepopulate().
        ->previewLink(! $request->viaResource),

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

Alex Bowers

Alex is the original developer of this package and has done a great job with initial development.

Mike Bronner

I started using this package and didn't want it to fall to the way-side, as it helps improve the UX of Nova significantly. Alex graceously allowed me to continue development and maintenance on his original package.

License

The MIT License (MIT). Please see License File for more information.