README

A Laravel Nova field that provides a searchable interface for belongs-to-many relationships with the ability to create new related resources.

Requirements

PHP >=8.2
Laravel 11.x | 12.x
Laravel Nova 4.x | 5.x

Installation

You can install the package via composer:

composer require metasync-site/nova-belongs-to-many

Usage

use MetasyncSite\NovaBelongsToMany\BelongsToManySearchable;

 BelongsToManySearchable::make('Products')
            ->relationshipConfig(
                resourceClass: ProductResource::class,
                relationName: 'products',
            ),

Full api

use MetasyncSite\NovaBelongsToMany\BelongsToManySearchable;

public function fields(NovaRequest $request)
{
    return [
        BelongsToManySearchable::make('Products')
            ->relationshipConfig(
                resourceClass: ProductResource::class,
                relationName: 'products',
                pivotTable: 'category_product',
                foreignPivotKey: 'category_id',
                relatedPivotKey: 'product_id',
                displayCallback: fn($product) => "{$product->name} (${$product->price})"
            )
            ->withCreateButton(true, 'Add New Product'),
    ];
}

Features

🔍 Searchable interface for belongs-to-many relationships
✨ Custom display formatting with callback support
➕ Optional "Create New" button with modal
🎨 Dark mode support
🎯 Type-safe implementation
🔄 Automatic pivot table management

Configuration Options

Required Parameters

resourceClass: The Nova resource class for the related model
relationName: The name of the relationship method on your model
pivotTable: The name of the pivot table
foreignPivotKey: The foreign key of the parent model in the pivot table
relatedPivotKey: The foreign key of the related model in the pivot table

Optional Parameters

displayCallback: Customize how each option is displayed
withCreateButton: Enable the create button with an optional custom label

Security Vulnerabilities

If you discover any security vulnerabilities, please email metasyncsite@gmail.com

Credits

Metasync

metasync-site / nova-belongs-to-many

Maintainers

Details