README

Block constructor for Filament.

Compatibility

Installation

You can install the package via composer:

composer require cube-agency/filament-constructor

You can publish the config file with:

php artisan vendor:publish --tag="filament-constructor-config"

Usage

Create your constructor block by using console command:

php artisan filament-constructor:create-block DoubleText

this will create a new class in Filament\Constructor\Blocks

namespace App\Filament\Constructor\Blocks;

use CubeAgency\FilamentConstructor\Constructor\Blocks\BlockRenderer;
use Filament\Forms\Components\Textarea;

class DoubleTextBlock extends BlockRenderer
{
    public function name(): string
    {
        return 'double_text';
    }

    public function title(): string
    {
        return __('DoubleText');
    }

    public function schema(): array
    {
        return [
            Textarea::make('first_text'),
            Textarea::make('second_text'),
        ];
    }
}

Add it to config

return [
    'blocks' => [
        'double_text' => \App\Filament\Constructor\Blocks\DoubleTextBlock::class,
    ],
];

Then add this field to your form

use CubeAgency\FilamentConstructor\Filament\Forms\Components\Constructor;
use Filament\Schemas\Schema;

public static function form(Schema $schema): Schema
{
    return $schema
        ->components([
            // ...
            Constructor::make('blocks'),
            // ...
        ]);
}

Or you can create multiple block groups and use different blocks in each resource

return [
    'blocks' => [
        'double_text' => \App\Filament\Constructor\Blocks\DoubleTextBlock::class,
    ],
    
    'image_blocks' => [
        'double_image' => \App\Filament\Constructor\Blocks\DoubleImageBlock::class,
    ],
];

use CubeAgency\FilamentConstructor\Filament\Forms\Components\Constructor;
use Filament\Schemas\Schema;

public static function form(Schema $schema): Schema
{
    return $schema
        ->components([
            // ...
            Constructor::make('blocks')->use(config('filament-constructor.image_blocks')),
            // ...
        ]);
}

Options

Constructor blocks has some of the options from Builder\Blocks.

1. To add label

    public function title(): string
    {
        return __('Text block');
    }

1. To add icon

  public function icon(): string
   {
       return 'heroicon-o-chat-bubble-left-right';
   }

1. To add maxItems

  public function maxItems(): int
   {
       return 1;
   }

1. To add columns

  public function columns(): int
   {
       return 6;
   }

To add Builder options to the constructor, add them when defining the constructor field in your page template. For example:

   Constructor::make('blocks')
    ->collapsible()
    ->collapsed()

Testing

composer test

Changelog

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

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Dmitrijs Mihailovs
• All Contributors

License

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