PHPackages                             benjacho/belongs-to-many-field - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. benjacho/belongs-to-many-field

ActiveLibrary[Admin Panels](/categories/admin)

benjacho/belongs-to-many-field
==============================

belongsToMany nova representation in field.

2.0(4y ago)158811.4k↑16.7%85[19 PRs](https://github.com/Benjacho/belongs-to-many-field-nova/pulls)1MITPHPPHP >=7.1.0

Since Mar 13Pushed 2y ago3 watchersCompare

[ Source](https://github.com/Benjacho/belongs-to-many-field-nova)[ Packagist](https://packagist.org/packages/benjacho/belongs-to-many-field)[ RSS](/packages/benjacho-belongs-to-many-field/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)DependenciesVersions (39)Used By (1)

Belongs To Many Field Nova With Dependant
=========================================

[](#belongs-to-many-field-nova-with-dependant)

Belongs To Many field to represent a many to many relationship in just a field. This field allow attaching relationships easily.

- Use version 3 for Nova 4
- Use version 2 for Nova 3

Also you can:

- Pass query to the multiple select
- Depends on BelongsTo field
- It is available in index, detail and forms!

[![image](https://user-images.githubusercontent.com/11976865/54318738-46290000-45b5-11e9-8ea0-941adb4b79ba.png)](https://user-images.githubusercontent.com/11976865/54318738-46290000-45b5-11e9-8ea0-941adb4b79ba.png)

### Installation

[](#installation)

```
composer require benjacho/belongs-to-many-field
```

### Usage

[](#usage)

In the resource you need to pass:

- Method make ('label', 'many to many relationship function name', 'Nova Resource Relationship')

```
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'),
    ];
}
```

### Functions

[](#functions)

FunctionParamdefaultdescription`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`BooleantrueThis 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](https://vue-multiselect.js.org/#sub-props)`dependsOn`String, Stringnull, nullThis method allows you to depend on belongsto field, this make an auto query`canSelectAll`String, Boolean'Select All', trueThis method allows you to have a select all checkbox and display custom message`showAsListInDetail`BooleantrueThis method allows you to display as list in detail- Method optionsLabel('columnName'), this method is when you don't have column 'name' in your table and you want to label by another column name. By default it tracks by label 'name'.

IMPORTANT

- If you want to label by another column name when displaying in forms, you need to set the title() method on your relationship resource, this method returns an string that is used to label it, also don't forget to add optionsLabel() method to show in detail and index.

```
use Benjacho\BelongsToManyField\BelongsToManyField;

public function fields(Request $request){
    BelongsToManyField::make('Role Label', 'roles', 'App\Nova\Role')->optionsLabel('full_role_name'),
}
```

- To obtain the data that was sent in action:

```
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);
    }
}
```

- Method setMultiselectProps($props), this method allows you to set properties for the [vue multiselect component](https://vue-multiselect.js.org/#sub-props)

```
     BelongsToManyField::make('Role Label', 'roles', 'App\Nova\Role')
     ->options(\App\Role::all())
     ->setMultiselectProps([
        'selectLabel' => 'click for select',
        // and others from docs
     ]);
```

- Method dependsOn($dependsOnvalue, $dependsOnKey), This method allows you to depend on belongsto field, this make an auto query

```
     BelongsTo::make('Association', 'association', 'App\Nova\Association'),

     BelongsToManyField::make('Participants', 'participant', 'App\Nova\Participant')
     ->dependsOn('association', 'association_id'),
```

- Method canSelectAll($messageSelectAll), This method allows you to display select all checkbox, if you dont pass message default is displayed

```
     BelongsToManyField::make('Participants', 'participant', 'App\Nova\Participant')
     ->canSelectAll('Seleccionar Todo'),
```

- Method showAsListInDetail(), This method allows you to change the default view to list in detail

```
     BelongsToManyField::make('Participants', 'participant', 'App\Nova\Participant')
     ->showAsListInDetail(),
```

### Validations

[](#validations)

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()),
    ];
}
```

[![image](https://raw.githubusercontent.com/Benjacho/belongs-to-many-field-nova/master/validation.png)](https://raw.githubusercontent.com/Benjacho/belongs-to-many-field-nova/master/validation.png)

### Translations

[](#translations)

To publish translations:

```
php artisan vendor:publish --provider="Benjacho\BelongsToManyField\FieldServiceProvider"

```

This package come with the following translation for the vue-multiselect plugin.

- en, ru, and nl.

To translate validations use Laravel validation translations.

Credits to:

### TODO

[](#todo)

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.

- Add Tests to the Project, adding test will add a certain level of quality code. Also it will help to achieve the other features.
- Test all functions implemented and improve wiki.
- Implement native dependability from Nova, this considers only to have dependsOn a BelongsTo field
- Implement translations with Spatie Translatable to es, fr, de
- Support for inline creation via native Nova 4
- builtin theme inherited from nova theme

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity57

Moderate usage in the ecosystem

Community28

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 60.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~51 days

Recently: every ~243 days

Total

29

Last Release

1180d ago

Major Versions

0.8 → 1.02019-10-18

1.9 → 2.02021-08-21

2.0 → 3.0-beta2023-02-24

PHP version history (2 changes)0.1PHP >=7.1.0

3.0-betaPHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/4163f3a3b3aded8a8c27be1012d909c505934acc864a670efc6cfedcfcd2a870?d=identicon)[Benjacho](/maintainers/Benjacho)

---

Top Contributors

[![Benjacho](https://avatars.githubusercontent.com/u/11976865?v=4)](https://github.com/Benjacho "Benjacho (67 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")[![smskin](https://avatars.githubusercontent.com/u/3227797?v=4)](https://github.com/smskin "smskin (6 commits)")[![angelsk](https://avatars.githubusercontent.com/u/606510?v=4)](https://github.com/angelsk "angelsk (5 commits)")[![danieleugoletti](https://avatars.githubusercontent.com/u/115441?v=4)](https://github.com/danieleugoletti "danieleugoletti (4 commits)")[![vhcraig](https://avatars.githubusercontent.com/u/52801576?v=4)](https://github.com/vhcraig "vhcraig (4 commits)")[![alafrance1999](https://avatars.githubusercontent.com/u/88724332?v=4)](https://github.com/alafrance1999 "alafrance1999 (3 commits)")[![bnoordsij](https://avatars.githubusercontent.com/u/8420034?v=4)](https://github.com/bnoordsij "bnoordsij (2 commits)")[![semihkeskindev](https://avatars.githubusercontent.com/u/32278879?v=4)](https://github.com/semihkeskindev "semihkeskindev (2 commits)")[![ericphamhoangdev](https://avatars.githubusercontent.com/u/268210294?v=4)](https://github.com/ericphamhoangdev "ericphamhoangdev (2 commits)")[![infostreams](https://avatars.githubusercontent.com/u/1132744?v=4)](https://github.com/infostreams "infostreams (2 commits)")[![MaxKorlaar](https://avatars.githubusercontent.com/u/8917249?v=4)](https://github.com/MaxKorlaar "MaxKorlaar (2 commits)")[![dormadekhin](https://avatars.githubusercontent.com/u/32381310?v=4)](https://github.com/dormadekhin "dormadekhin (1 commits)")[![Athlon1600](https://avatars.githubusercontent.com/u/1063088?v=4)](https://github.com/Athlon1600 "Athlon1600 (1 commits)")[![abr4xas](https://avatars.githubusercontent.com/u/405484?v=4)](https://github.com/abr4xas "abr4xas (1 commits)")[![makkinga](https://avatars.githubusercontent.com/u/3294611?v=4)](https://github.com/makkinga "makkinga (1 commits)")

---

Tags

laravelnovabelongsToManyMany to Many Field

### Embed Badge

![Health badge](/badges/benjacho-belongs-to-many-field/health.svg)

```
[![Health](https://phpackages.com/badges/benjacho-belongs-to-many-field/health.svg)](https://phpackages.com/packages/benjacho-belongs-to-many-field)
```

###  Alternatives

[pdmfc/nova-action-button

A Laravel Nova field to run actions.

37733.0k1](/packages/pdmfc-nova-action-button)[khalin/nova-link-field

A Laravel Nova Link field.

31562.2k2](/packages/khalin-nova-link-field)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)