README

此软件包提供了一种简单的方法将 GrapesJS 集成到您的 Laravel 项目中。

安装

composer require jd-dotlogics/laravel-grapesjs

发布文件和迁移

php artisan vendor:publish --tag="laravel-grapesjs"

php artisan migrate

入门

1. 将 'gjs_data' 列添加到模型的数据表（例如 Page）中，您将使用该编辑器。

2. 实现 Editable 接口，并在模型类中使用 EditableTrait 特性

use Illuminate\Database\Eloquent\Model;
use Dotlogics\Grapesjs\App\Traits\EditableTrait;
use Dotlogics\Grapesjs\App\Contracts\Editable;

class Page extends Model implements Editable
{
    use EditableTrait;

    ...
}

1. 接下来创建编辑器的路由

Route::get('pages/{page}/editor', 'PageController@editor');

1. 在控制器中，使用 EditorTrait 并添加编辑器方法

<?php

namespace App\Http\Controllers;

use App\Models\Page;
use Illuminate\Http\Request;
use Dotlogics\Grapesjs\App\Traits\EditorTrait;

class PageController extends Controller
{
    use EditorTrait;

    ...


    public function editor(Request $request, Page $page)
    {
        return $this->show_gjs_editor($request, $page);
    }

    ...
}

1. 打开此路由 /pages/:page_id/editor（其中 :page_id 是您的模型 ID）

占位符

占位符类似于 WordPress 中的短代码。占位符的语法是

[[This-Is-Placeholder]]

在 "/resources/views/vendor/laravel-grapesjs/placeholders" 目录下创建一个名为 "this-is-placeholder.blade.php" 的文件。

然后占位符将被相对的 blade 文件 "this-is-placeholder.blade.php" 的内容替换。

模板

您可以在 "/resources/views/vendor/laravel-grapesjs/templates" 目录中创建全局模板（或块）。模板/块将在编辑器的块部分中可用。您也可以通过在模型中定义 getTemplatesPath/getGjsBlocksPath 来创建特定于模型的模板/块

public function getTemplatesPath(){ return 'pages_templates'; }

这将查找 "laravel-grapesj::pages_templates" 目录下的模板。

您也可以从这些方法返回 null 来隐藏任何模型的模板/块。

显示输出

"Editable" 模型（例如 Page）将有两个公共属性，css 和 html。在您的 blade 文件中，您可以使用这些属性来显示内容。

<style type="text/css">
	{!! $page->css !!}
</style>

{!! $page->html !!}

感谢您使用。