admin panel

管理面板

框架不可知论管理面板。

目标

试图使其尽可能最小。它允许您创建具有不同类型的多个页面（表，表单）。不用太多的代码库。

PS：您仍然需要设置路线，身份验证等...

回复

我们允许多种类型的响应，因为默认情况下我们使用了PHP视图，但是我们认为Laravel用户将使用刀片，因此可以使用blade ，因此一种可能的解决方案是创建另一个Renderer 。

目前，我们有两个默认Renderers ：

• DefaultRenderer这只是返回一个数组作为输出
• JsonRenderer此返回JSON输出

为了创建渲染器，使其扩展了AecodesAdminPanelResponsesRenderer 。然后将其添加到配置。

当前支持的布局

• 表（占用TD的数组，每个TD都可以自定义）
• 形式（采用各种字段）
• DIV（唯一的用例是具有自定义包装器）
• 可以创建自己的小部件。

PS：小部件实现Widget界面。

当前支持的表单字段

• 输入（文本，密码，电子邮件，号码，...）
• 收音机
• 选择
• Textarea
• 复选框
• 图像（上传单图像）

如何设置

1. 与作曲家安装
2. 使用config/panel.php创建一个配置文件作为起点。
3. 创建Dashboard类实例（Singleton）实例，请确保将配置作为数组传递。

 $ config = require ' ./config/panel.php ' ;
Aecodes  AdminPanel Dashboard:: setup ( $ config );

如何创建管理页面

1. 创建一个扩展Panel类的新类
2. 为方便起见，将面板的$name和$description为属性（页面上可见）。
3. 创建一个返回数据数组的query方法。

 function query (): array {
    // get data from database.
    return Page:: all ()-> toArray ();
}

4. 创建一个render方法，该方法返回一个小部件数组。

• 创建一个表

 function render (): array {
    return [
        Table:: make ([
            // (label, name) both are optional
            TD :: make ( ' # ' , ' id ' ),
            // it's also possible to use Table::column
            Table:: column ( ' Title ' , ' title ' ),
        ])
        // ...
    ];
}

• 创建形式

 function render (): array {
    return [
        Form:: make ([
            Input:: make ( ' title ' )-> title ( ' Title ' ),

            // form submit
            Action:: button ( ' Save ' ),
        ])
        -> action ( ' # ' )
        -> method ( ' post ' ),
        // ...
    ];
}

5. 要完成，在您的路线回调中，只需返回您创建的类的新实例即可。

 // callback for some route
public function index () {
    // PagesTable extends Panel
    return ( new Response ( new PagesTable ))-> render ();
}

可扩展性

布局

扩展Panel类时，您可以指定$layout属性。

视图

这不会带有视图层。您可以使用默认值（很快）视图软件包。

config

默认配置是：

 return [
    // current renderer.
	' renderer ' => ' default ' ,

    // add new renderer here.
	' renderers ' => [
		' json '    => Aecodes  AdminPanel  Responses JsonRenderer::class,
		' default ' => Aecodes  AdminPanel  Responses DefaultRenderer::class,
	],

    // default classes for button and a tag.
	' classes ' => [
		' link '   => '' ,
		' button ' => '' ,
	],

    // global menus, can be and array or callback
	' menu ' => function () {
		return [];
	},

    // input old value.
	' old_value ' => function ( $ name , $ default ) {
		return $ default ;
	},

    // global errors (i.e: validation errors)
	' errors ' => function () {
		return [];
	}

];