Belongs To Many field to represent a many to many relationship in just a field. This field allow attaching relationships easily.
Also you can:
composer require benjacho/belongs-to-many-field
In the resource you need to pass:
use Benjacho\BelongsToManyField\BelongsToManyField;
public function fields(Request $request){
return [
..., //If you are using with BelongsToMany native Field, put this field after
BelongsToManyField::make('Role Label', 'roles', 'App\Nova\Role'),
];
}
Function | Param | default | description |
---|---|---|---|
optionsLabel |
String | 'name' | If you don't have column 'name' in your relationship table, use this method. This displays in index and detail Ejm (optionsLabel('full_role_name') ) you can also access nested object keys with dot notation like this (optionsLabel('name.en') ). Note that this field uses the relation resource title property, so if you want translated versions on your form change app.locale config value |
isAction |
Boolean | true | This method is when you need this field in actions, this puts height of field in 350px, and converts in action. |
setMultiselectProps |
Array | [] | this method allows you to set properties for the vue multiselect component |
dependsOn |
String, String | null, null | This method allows you to depend on belongsto field, this make an auto query |
canSelectAll |
String, Boolean | 'Select All', true | This method allows you to have a select all checkbox and display custom message |
showAsListInDetail |
Boolean | true | This method allows you to display as list in detail |
IMPORTANT
use Benjacho\BelongsToManyField\BelongsToManyField;
public function fields(Request $request){
BelongsToManyField::make('Role Label', 'roles', 'App\Nova\Role')->optionsLabel('full_role_name'),
}
public function handle(ActionFields $fields, Collection $models)
{
//note that roles is the many to many relationship function name
$values = array_column(json_decode(request()->roles, true),'id');
foreach ($models as $model) {
$model->roles()->sync($values);
}
}
BelongsToManyField::make('Role Label', 'roles', 'App\Nova\Role')
->options(\App\Role::all())
->setMultiselectProps([
'selectLabel' => 'click for select',
// and others from docs
]);
BelongsTo::make('Association', 'association', 'App\Nova\Association'),
BelongsToManyField::make('Participants', 'participant', 'App\Nova\Participant')
->dependsOn('association', 'association_id'),
BelongsToManyField::make('Participants', 'participant', 'App\Nova\Participant')
->canSelectAll('Seleccionar Todo'),
BelongsToManyField::make('Participants', 'participant', 'App\Nova\Participant')
->showAsListInDetail(),
This package implement all Laravel Validations, you need to pass the rules in rules method, rules are listed on laravel validations rules for arrays*.
use Benjacho\BelongsToManyField\BelongsToManyField;
public function fields(Request $request){
return [
...,
BelongsToManyField::make('Role Label', 'roles', 'App\Nova\Role')->rules('required', 'min:1', 'max:5', 'size:3', new CustomRule()),
];
}
To publish translations:
php artisan vendor:publish --provider="Benjacho\BelongsToManyField\FieldServiceProvider"
This package come with the following translation for the vue-multiselect plugin.
To translate validations use Laravel validation translations.
Credits to: https://github.com/manmohanjit/nova-belongs-to-dependency
This project was my first Open Source project, so I wanted to add a roadmap.
I migrated this package to use Nova 4, this migration considered only the detail, index and form views. It means that it can have bugs with other features.