README

演示GIF

安装

composer require customberg/customberg-php:"*"

将供应商文件添加到您的项目中（CSS、JS、配置、视图）

php artisan vendor:publish --provider="VanOns\Laraberg\LarabergServiceProvider"
php artisan vendor:publish --provider="Customberg\PHP\CustombergServiceProvider"

模型设置

您想使用此块编辑器的模型应该具有

use VanOns\Laraberg\Traits\RendersContent;

class Page extends Model
{
    use RendersContent;
}

在 backpack crud 控制器中，您必须创建如下所示的 crud 字段

CRUD::field('content')
    ->label('Page content')
    ->type('customberg')
    ->view_namespace('customberg::');

用法

使用 make:block 命令创建一个新的块

php artisan make:block AwesomeBlock

然后编辑 app/Blocks/AwesomeBlock.php 文件中的块字段定义，以及 resources/views/blocks/cb-awesome-block.blade.php 中的块视图。

查看 /example/app/Blocks/EverySingleField.php 以获取带有每种字段类型的完整示例。

更新

更新后，使用

php artisan vendor:publish --tag="customberg-assets" --force
php artisan vendor:publish --provider="VanOns\Laraberg\LarabergServiceProvider" --tag="public" --force

示例项目

git clone https://github.com/customberg/customberg-php
cd customberg-php/example
docker compose up -d
docker-compose exec php su app -c 'cd example; composer install'
docker-compose exec php su app -c 'cd example; cp .env.example .env; php artisan key:generate'
docker-compose exec nginx su app -c 'cd /app/example/public/; ln -s ../storage/app/public storage'

导航到 https://:8084 并点击登录。

享受！

路线图

变更日志

v0.15 - 2024-09-26

新字段类型：checkbox、textarea、number、email、url
为文本字段添加新属性 placeholder
为显示小帮助文本的所有字段添加新属性 hint 和 hint_html
查看 /example/app/Blocks/EverySingleField.php 以获取完整示例

v0.14 - 2024-08-07

错误修复：在渲染具有多语言的块时预览 API，当选择未保存翻译的新语言时。

v0.13 - 2024-07-08

允许安装 laravel 11

v0.12 - 2023-11-09

错误修复：无法重新声明 str_replace_limit

v0.11 - 2023-11-08

更新要求到 laravel 10

v0.10 - 2023-04-02

为 upload_image 添加文件扩展名验证。
使用 'allowed_types' => ['png', 'jpg', 'webp', 'svg'],
添加 upload_file 以无预览上传文件。
如果要在同一字段中上传多个文件，请使用 'multiple' => true,

v0.9 - 2023-01-01

多语言微调，可配置语言列表和错误修复
多语言仅支持字段 text 和 rich_text，并在可重复字段内部工作。

v0.8 - 2022-12-31

对可重复字段前端进行微调
添加了在可重复字段中移动和复制项的按钮
添加了可重复示例块

v0.7 - 2022-12-30

第一个版本发布到 packagist.org！🎉🥳
仅有的可用字段是：text, rich_text, color, upload_image
可重复存在但未测试。多语言存在但未测试且硬编码。

customberg / customberg-php

维护者

详细信息