README

Introduction

This package extends Filament to include a field type called Grapesjs, leveraging the Grapesjs library to enable visual editing of HTML codes within the Filament components. It allows users to interactively design and incorporate HTML elements via drag-and-drop functionality.

• Features include:
  • Integration of the Grapesjs library into Filament components.
  • Drag-and-drop functionality for visually designing HTML elements.
  • Simplified HTML code editing within Filament.
• Latest versions of PHP and Filament
• Best practices applied:
  • README.md (badges included)
  • LICENSE
  • composer.json
  • .gitignore
  • pint.json

Installation

You can easily install the package via Composer:

composer require dotswan/filament-grapesjs-v3

Publish Configuration

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

Basic Usage

Resource file:

<?php
namespace App\Filament\Resources;
use Filament\Resources\Resource;
use Filament\Resources\Forms\Form;
use Dotswan\FilamentGrapesjs\Fields\GrapesJs;
...

class FilamentResource extends Resource
{
    ...
    public static function form(Form $form)
    {
        return $form->schema([
                GrapesJs::make( 'page_layout' )
                    ->tools([
                        // tools you want to include
                    ])
                    ->plugins([
                        'grapesjs-tailwind',
                        // other plugins you've included in your resources directory and referenced in filament-grapesjs.php
                        // e.g. 'gjs-blocks-basic, https://github.com/GrapesJS/blocks-basic'
                    ])
                    ->settings([
                        'storageManager' => [
                            'type' => 'local',
                            'options' => [
                                'local' => [
                                    'key' => 'gsproject-test',
                                ],
                            ],
                        ],
                        'styleManager' => [
                            'sectors' => [
                                [
                                    'name' => 'General',
                                    'open' => false,
                                    'buildProps' => [
                                        'background-color',
                                        // other properties you want to include
                                    ],
                                ],
                            ],
                        ]
                    ])
                    ->id( 'page_layout' )
           ]);
    }
    ...
}

License

MIT License © Dotswan

Security

We take security seriously. If you discover any bugs or security issues, please help us maintain a secure project by reporting them through our GitHub issue tracker. You can also contact us directly at tech@dotswan.com.

Contribution

We welcome contributions! contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request