admin panel

Painel de Administração

Painel de administrador agnóstico da estrutura.

Meta

Tentando torná -lo o mais mínimo possível. Ele permite criar várias páginas com diferentes tipos (tabela, formulário). sem intervir muito com sua base de código.

PS: Você ainda precisa configurar suas rotas, a autenticação etc ...

Resposta

Permitimos vários tipos de respostas, como padrão, usamos visualizações de PHP, mas imaginamos que os usuários do Laravel, como exemplo, usariam blade , portanto, uma solução possível é criar um Renderer diferente.

Por enquanto, temos dois Renderers padrão:

• DefaultRenderer Isso apenas retorna uma matriz como saída
• JsonRenderer isso retorna a saída JSON

Para criar um renderizador, faça -o estender AecodesAdminPanelResponsesRenderer . Em seguida, adicione -o à configuração.

Layouts atualmente suportados

• Tabela (leva uma matriz de TD, todo TD pode ser renderizado personalizado)
• Formulário (leva uma variedade de campos)
• Div (o único caso de uso é ter invólucros personalizados)
• É possível criar seus próprios widgets.

PS: Widgets implementa a interface Widget .

Atualmente suportado campos

• Entrada (texto, senha, e -mail, número, ...)
• Rádio
• Selecione
• Textarea
• Caixa de seleção
• Imagem (carrega uma única imagem)

Como configurar

1. Instale com o compositor
2. Crie um arquivo de configuração usando config/panel.php como ponto de partida.
3. Create (Singleton) Instância da classe Dashboard , aproveite a configuração como uma matriz.

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

Como criar uma página de administração

1. Crie uma nova classe que estenda a classe Panel
2. Para conveniência, defina as propriedades para $name e $description do painel (visível na página).
3. Crie um método query que retorne a matriz de dados.

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

4. Crie um método render que retorne uma variedade de widgets.

• Para criar uma tabela

 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 ' ),
        ])
        // ...
    ];
}

• Para criar um formulário

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

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

5. Para terminar, no retorno de chamada da sua rota, basta retornar uma nova instância da classe que você criou.

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

Extendibilidade

Layouts

Ao estender a classe Panel , você pode especificar a propriedade $layout .

Visualizações

Isso não é enviado com uma camada de vista. Você pode usar os pacotes de visualizações padrão (em breve).

Config

A configuração padrão é:

 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 [];
	}

];