orlyapps / nova-belongsto-depend
A Laravel Nova field.
Installs: 708 149
Dependents: 1
Suggesters: 0
Security: 0
Stars: 182
Watchers: 3
Forks: 65
Open Issues: 44
Requires
- php: >=7.1.0
This package is auto-updated.
Last update: 2024-10-21 23:53:19 UTC
README
Using an older version of Laravel?
This version is compatible with Laravel 5.8 and newer.
If you use an older version of Laravel you can use an older version of the package. These aren't maintained anymore, but they should be pretty stable. We still accept small bugfixes.
Installation
You can install the package in to a Laravel app that uses Nova via composer:
composer require orlyapps/nova-belongsto-depend
Use this field in your Nova Resource
use Orlyapps\NovaBelongsToDepend\NovaBelongsToDepend; public function fields(Request $request) { return [ ID::make()->sortable(), Text::make('Name')->rules('required', 'max:255'), NovaBelongsToDepend::make('Company') ->placeholder('Optional Placeholder') // Add this just if you want to customize the placeholder ->options(\App\Company::all()), NovaBelongsToDepend::make('Department') ->placeholder('Optional Placeholder') // Add this just if you want to customize the placeholder ->optionsResolve(function ($company) { // Reduce the amount of unnecessary data sent return $company->departments()->get(['id','name']); }) ->dependsOn('Company'), NovaBelongsToDepend::make('Location') ->placeholder('Optional Placeholder') // Add this just if you want to customize the placeholder ->optionsResolve(function ($company) { // Reduce the amount of unnecessary data sent return $company->locations()->get(['id','name']); }) ->fallback( Text::make('Location Name')->rules('required', 'max:255'), ) ->hideLinkToResourceFromDetail() ->hideLinkToResourceFromIndex() ->nullable() ->dependsOn('Company'), ]; }
Method dependsOn
takes the name
property of the fields it depends on.
Use the field's attribute
value if you specified it manually.
Options
placeholder('Optional Placeholder')
openDirection('top')
See options values from vue-multiselect
Translation
The following strings are translatable (add then in your language file located in resources/lan/vendor/nova/*.json).
- 'Oops! No elements found. Consider changing the search query.'
- 'List is empty'
- 'Select'
- 'Press enter to select'
- 'Selected'
- 'Press enter to remove'
If you do use nova-translatable and would like to return the translated name add this to your translatable model:
/** * @return mixed */ public function getNameAttribute() { return $this->getTranslations('name')[app()->getLocale()]; }
Performance Tips
When attaching this field to a resource, you may include the field relation in the $with
property for that resource to prevent n+1 issues when loading an index page for that resource.
class Company extends Resource { public static $with = []; } class Department extends Resource { public static $with = ['company']; } class Location extends Resource { public static $with = ['department', 'company']; }
You may also choose to cache your top-level model to reduce the number of queries made to the database for each row in an index.
NovaBelongsToDepend::make('Company') ->options(Cache::remember( 'companies', 60, function () { return Company::all(); } )), NovaBelongsToDepend::make('Department') ->dependsOn('Company') ->optionsResolve(function($company) { return $company->departments; })
Sample
- Warehouse hasMany Articles
- Articles belongsToMany Suppliers
- Suppliers belongsToMany Articles
- Select a Warehouse and get all articles of the warehouse
- Select a Article and get all suppliers who has this article
public function fields(Request $request) { return [ ID::make()->sortable(), Text::make('Name')->rules('required', 'max:255'), NovaBelongsToDepend::make('Warehouse') ->options(\App\Warehouse::all()) ->rules('required'), NovaBelongsToDepend::make('Article') ->optionsResolve(function ($warehouse) { return $warehouse->articles; }) ->dependsOn('Warehouse') ->rules('required'), NovaBelongsToDepend::make('Supplier') ->optionsResolve(function ($article) { return \App\Supplier::whereHas('articles', function ($q) use ($article) { $q->where('article_id', $article->id); })->get(); }) ->dependsOn('Article') ->rules('required'), ]; }
Depend on several fields
CleanShot.2021-05-25.at.13.25.38.mp4
From version 3 of this package you can depend on several fields. Just pass them comma separated in the dependsOn method.
->dependsOn('classification', 'brand')
Here an example:
- Classification hasMany Models && belongsToMany Brands
- Brand hasMany Models && belongsToMany Classification
- Model belongsTo Classification && belongsTo Brand
- Select a Classification and get all Brands of the classification
- Select a Brand and get all Models that has this Classification and Brand
public function fields(Request $request) { return [ ID::make(__('ID'), 'id')->sortable(), NovaBelongsToDepend::make('Classification', 'classification') ->options(\App\Models\Classification::all()), NovaBelongsToDepend::make('Brand', 'brand') ->optionsResolve(function ($classification) { return $classification->brands()->get(['brands.id', 'brands.name']); }) ->dependsOn('classification'), NovaBelongsToDepend::make('Model', 'model', VehicleModel::class) ->optionsResolve(function ($depends) { return \App\Models\VehicleModel::query() ->where('classification_id', $depends->classification->id) ->where('brand_id', $depends->brand->id) ->get(); }) ->dependsOn('classification', 'brand'), ]; }
Security
If you discover any security related issues, please email info@orlyapps.de instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.