README

A Laravel package for managing product brands with full API support, authorization policies, and Filament integration.

Features

• ✅ Complete CRUD operations for brands
• ✅ RESTful API endpoints with resource transformers
• ✅ Authorization policies for granular access control
• ✅ Soft deletes support
• ✅ Category relationships
• ✅ SEO-friendly with meta fields
• ✅ Slug-based routing
• ✅ User tracking (created by/updated by)
• ✅ Filament plugin ready
• ✅ API Resources for simple and detailed responses

Installation

You can install the package via composer:

composer require mortezaa97/brands

Service Provider Registration

The package will automatically register its service provider. If you need to manually register it, add the following to your config/app.php:

'providers' => [
    // ...
    Mortezaa97\Brands\BrandsServiceProvider::class,
],

Publish Assets

Publish the configuration file:

php artisan vendor:publish --provider="Mortezaa97\Brands\BrandsServiceProvider" --tag="config"

Publish migrations (optional, migrations are loaded automatically):

php artisan vendor:publish --provider="Mortezaa97\Brands\BrandsServiceProvider" --tag="migrations"

Run Migrations

Run the migrations to create the brands table:

php artisan migrate

Database Schema

The brands table includes the following fields:

Configuration

The configuration file config/brands.php allows you to customize:

return [
    'table_name' => 'brands', // Customize table name if needed
];

Usage

API Endpoints

The package automatically registers the following API routes:

Get All Brands

GET /api/brands

Returns a collection of brands with simple resource transformation.

Response:

[
    {
        "name": "Nike",
        "slug": "nike",
        "logo": "https://example.com/storage/logos/nike.png",
        "color": "#000000"
    }
]

Get Single Brand

GET /api/brands/{slug}

Returns a detailed brand resource including category relationship.

Response:

{
    "name": "Nike",
    "slug": "nike",
    "logo": "https://example.com/storage/logos/nike.png",
    "desc": "Nike is a leading sportswear brand...",
    "meta_title": "Nike - Premium Sportswear",
    "meta_desc": "Discover Nike products...",
    "meta_keywords": "nike, sportswear, shoes",
    "page_title": "Nike Official Store",
    "color": "#000000",
    "category": {
        "id": 1,
        "name": "Sportswear",
        "slug": "sportswear"
    }
}

Using in Your Code

Create a Brand

use Mortezaa97\Brands\Models\Brand;

$brand = Brand::create([
    'name' => 'Adidas',
    'slug' => 'adidas',
    'logo' => 'path/to/logo.png',
    'status' => Status::ACTIVE,
    'category_id' => 1,
    'desc' => 'Premium sportswear brand',
    'meta_title' => 'Adidas Official',
    'color' => '#000000',
    'created_by' => auth()->id(),
]);

Query Brands

// Get all active brands
$brands = Brand::all();

// Get brand by slug
$brand = Brand::where('slug', 'nike')->first();

// Get brands with category
$brands = Brand::with('category')->get();

// Get brands created by specific user
$brands = Brand::whereHas('createdBy', function($query) {
    $query->where('id', 1);
})->get();

Update a Brand

$brand = Brand::find(1);
$brand->update([
    'name' => 'Updated Brand Name',
    'updated_by' => auth()->id(),
]);

Delete a Brand (Soft Delete)

$brand = Brand::find(1);
$brand->delete(); // Soft delete

// Restore
$brand->restore();

// Force delete
$brand->forceDelete();

Relationships

The Brand model includes the following relationships:

Category

$brand = Brand::with('category')->first();
$categoryName = $brand->category->name;

Created By User

$brand = Brand::with('createdBy')->first();
$creatorName = $brand->createdBy->name;

Updated By User

$brand = Brand::with('updatedBy')->first();
if ($brand->updatedBy) {
    $updaterName = $brand->updatedBy->name;
}

Authorization

The package includes a BrandPolicy for authorization. The following gates are available:

• viewAny - View list of brands
• view - View single brand
• create - Create new brand
• update - Update existing brand
• delete - Delete brand
• restore - Restore soft-deleted brand
• forceDelete - Permanently delete brand

Example usage in your controllers:

use Illuminate\Support\Facades\Gate;

// Check if user can view brands
if (Gate::allows('viewAny', Brand::class)) {
    // User can view brands
}

// Authorize specific brand action
Gate::authorize('update', $brand);

API Resources

The package provides two resource transformers:

BrandResource

Full details including relationships and SEO fields.

use Mortezaa97\Brands\Http\Resources\BrandResource;

return new BrandResource($brand);

BrandSimpleResource

Simplified response for list views.

use Mortezaa97\Brands\Http\Resources\BrandSimpleResource;

return BrandSimpleResource::collection($brands);

Filament Integration

To integrate with Filament, register the plugin in your panel provider:

use Mortezaa97\Brands\BrandsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            BrandsPlugin::make(),
        ]);
}

Facade

You can use the Brands facade for convenient access:

use Mortezaa97\Brands\BrandsFacade as Brands;

// Use the facade
Brands::someMethod();

Global Scope

The Brand model includes a global scope that orders all queries by created_at in descending order (newest first).

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email mortezajafari76@gmail.com instead of using the issue tracker.

Credits

• Morteza Jafari
• All Contributors

License

The MIT License (MIT). Please see License File for more information.