README

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

安装

composer require ofyalcin/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 !!}

感谢使用。