admin panel

Panel de administración

Panel de administración agnóstico marco.

Meta

tratando de hacerlo lo más mínimo posible. Le permite crear varias páginas con diferentes tipos (tabla, forma). sin intervenir mucho con su base de código.

PD: Todavía necesita configurar sus rutas, la autenticación, etc.

Respuesta

Permitimos múltiples tipos de respuestas, como un valor predeterminado, utilizamos vistas de PHP, pero pensamos que los usuarios de Laravel como ejemplo usarían blade , por lo que una posible solución es crear un Renderer diferente.

Por ahora tenemos dos Renderers predeterminados:

• DefaultRenderer esto solo devuelve una matriz como salida
• JsonRenderer esto devuelve la salida de JSON

Para crear un renderizador, se extiende AecodesAdminPanelResponsesRenderer . Luego agrégalo a la configuración.

Diseños compatibles actualmente

• Tabla (toma la matriz de TD, cada TD se puede representar a medida)
• Formulario (toma una matriz de campos)
• Div (el único caso de uso es tener envoltorios personalizados)
• Es posible crear sus propios widgets.

PD: Widgets implementa la interfaz Widget .

Campos de formulario actualmente compatibles

• Entrada (texto, contraseña, correo electrónico, número, ...)
• Radio
• Seleccionar
• Textea
• Caja
• Imagen (cargar una simple imagen)

Cómo configurar

1. Instalar con el compositor
2. Cree un archivo de configuración usando config/panel.php como punto de partida.
3. Crear instancia (singleton) de la clase Dashboard , asegúrese de pasar la configuración como una matriz.

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

Cómo crear una página de administrador

1. crear una nueva clase que extienda la clase Panel
2. Por conveniencia Establezca las propiedades para $name y $description del panel (visible en la página).
3. Cree un método query que devuelva la matriz de datos.

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

4. Cree un método render que devuelva una matriz de widgets.

• Para crear una mesa

 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 crear un formulario

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

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

5. Para terminar, en la devolución de llamada de su ruta, simplemente devuelva una nueva instancia de la clase que creó.

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

Extensibilidad

Diseños

Al extender la clase Panel , puede especificar la propiedad $layout .

Vistas

Esto no se envía con una capa de vista. Puede usar los paquetes predeterminados (pronto) de vista.

Configuración

La configuración predeterminada es:

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

];