README

BelongsToMany create & edit form UI for Laravel Nova. Enables attaching relationships easily and includes validation.

Forked from dillingham/nova-attach-many.

Installation

composer require blendbyte/nova-attach-many

Quick Start

use NovaAttachMany\AttachMany;

public function fields(Request $request)
{
    return [
        AttachMany::make('Permissions'),
    ];
}

You can explicitly define the relationship & Nova resource:

AttachMany::make('Field Name', 'relationshipName', RelatedResource::class);

Pivot Values

You can pass additional parameters for any pivot value. See the Laravel docs on syncing associations for details.

AttachMany::make('Field Name', 'relationshipName', RelatedResource::class, ['pivot_name' => value]);

Display on Detail

This package only provides the create/edit views that BelongsToMany does not. Use BelongsToMany for displaying the table on detail views:

public function fields(Request $request)
{
    return [
        AttachMany::make('Permissions'),
        BelongsToMany::make('Permissions'),
    ];
}

Validation

You can set min, max, size or custom rule objects:

->rules('min:5', 'max:10', 'size:10', new CustomRule)

Options

Method	Description
`->showCounts()`	Shows "selected / total"
`->showPreview()`	Shows only selected items
`->hideToolbar()`	Removes search & select all
`->height('500px')`	Set custom height
`->fullWidth()`	Set to full width
`->showRefresh()`	Request the resources again
`->showSubtitle()`	Show the resource's subtitle
`->help('<b>Tip:</b> help text')`	Set the help text

Relatable

The attachable resources will be filtered by relatableQuery(), so you can control which resources are available for attachment.

Being Notified of Changes

Add a method to the resource to be notified of sync changes. The method must be a camel-cased version of the attribute name, followed by Synced:

public function fields(Request $request)
{
    return [
        AttachMany::make('Permissions'),
    ];
}

public function permissionsSynced(array $changes)
{
    $changes['attached']; // IDs of attached models
    $changes['detached']; // IDs of detached models
    $changes['updated'];  // IDs of updated models
}

Authorization

This field respects policies. For example, with a Role / Permission setup:

RolePolicy: attachAnyPermission($user, $role)
RolePolicy: attachPermission($user, $role, $permission)
PermissionPolicy: viewAny($user)

Maintained by Blendbyte

Blendbyte builds cloud infrastructure, web apps, and developer tools.
We've been shipping software to production for 20+ years.

This package runs in our own stack, which is why we keep it maintained.
Issues and PRs get read. Good ones get merged.

blendbyte.com · hello@blendbyte.com

blendbyte / nova-attach-many

Maintainers

Package info

Statistics

Security