Download the PHP package antoniosam/easypanelbundle without Composer

Easy Panel Bundle Symfony 5

Se elimino todo el soporte para symfony 4 y 3

#

Bundle de soporte para la creacion de administradores simplificando las tareas sencillas list, new, edit, show(detail)

Para empezar

El bundle solo proporciona ayuda y soporte para crear platillas para las acciones mas basicas de un panel de administracion, no crea nuevos componentes para el framework, utiliza los componentes de symfony

• Render (twig)
• Form Interface
• Route Las consultas para mostrar informacion no se incorporan dentro del bundle, dependen del usuario.

Instalacion

Y agregamos el bundle en el AppKernel

Comandos Crud

Para facilitar la creacon del panel se incluyen metodos que generar automaticamente los controladores y formularios con funciones preestablecidas, puede ser todas las Entidades o una por una

Opcionales

• folder: Carpeta que se creara dentro de las carpetas de la estructura del proyecto
• prefix:Sufijo opcional para la ruta de los controladores (default:empty) Los parametros no deben incluir la carpeta src, se integran por default

create:panel

Busca todas las entidades dentro de la carpeta indicada y crea todos los controladores y formularios

create:menu

Crea un archivo Twig que incluye todas las rutas de las entidades que se encontraron para poder importarla en la configuracion

create:modulo

Selecciona una entidad por su namespace y crea su controlador y su formulario

install:assets

Descomprime 1 archivos Zip que contienen los recursos css y js para el panel(En las configuraciones se cambia el tipo de panel)

Login

NOTA Se recomienda primero crear el admnistrador antes de establecer la seguridad

El bundle solo incluye las pantallas y los controladores, la confifuracion de seguridad se debe hacer en el archivo security.yml

El servicio app.custom_encoder esta incluido dentro del bundle

security.yml

En comando create:panel genera la clase EasyPanelLoginFormAuthenticator

Dentro de la carpeta src/Security/[dir]/EasyPanelLoginFormAuthenticator y se debe incluir en el firewall

dir es el nombre de la carpeta que se uso en el comando

ej.

Servicio

Permite configuracion la vista, incluir un menu personalizado, cambiar el layout general(Al que Extiende la vista ), incluir el nombre del proyecto, y mas configuracion.

Este servicio se utiliza para gestionar las vistas, hacer los renders si se usa el metodo render o parsear la respuesta si se usa json

NOTA Cuando se usa json solo funciona para EasyList y EasyShow y no se pueden agrupar 2 o mas vistas

Clases

EasyForm

Crea una vista que integra un formulario, El formulario debe ser creado anteriormente

Para agregar mas opciones al formulario

El servicio EasyPanel es el encargado de mandar la informacion a la platilla y twig se encarga del render

Para configurar el formulario es necesario ir al archivo Type y hacer las validaciones y configuraciones necesarias

EasyList

Este clase tiene dependencia directa de plugin EasyDoctrine y la clase EasyData

Esta clase permite generar una tabla(lista) de una consulta y mostrar los campos establecido. Agregar paginacion, busqueda, ordenamiento y seleccion de items

setLabelsTable solo tiene efecto en la vista html

Se puede cambiar entre una respuesta json y html mediante el servicio $easypanel

HTML

API

EasyShow

Permite generar una tabla con el detalle de un objeto(show)

setLabelsFields solo tiene efecto en la vista html

Al igual que EasyList se puede cambiar entre una respuesta json y html mediante el servicio $easypanel

HTML

API

Configuracion de Respuesta EasyShow y EasyList

Para poder dar flexibilidad a la creacion de vistas y respuestas json estas dos clases permiten el uso de multiples metodos

RENDER AS

Metodos que permiten modificar el valor un campo obtenido de la consulta y mostrarlo en un formato diferente

Valido en metodo json y render

renderAsImage y renderAsLink

El metodo renderAsImage y renderAsLink permite agregar una ruta para la correcta visualizacion de la imagen o el archivo.

Si en la ruta que se proporciona ya incluye el nombre del archivo se usa esa por defecto, si no lo incluye se contruye con el valor de path y el valor del archivo $path.'/'.$valor

Si se ignora solo se antepone '/' para marcar la raiz del sitio

Tomando en cuenta que el metodo fotoperfil devolviera un valor fotousuario.jpg el resultado html seria:

Para el metodo renderAslink se sugiere utilizar el metodo generateUrl de symfony

Tomando en cuenta que el metodo archivo devolviera un valor registro1.pdf y tomando un ejemplo de de ruta file_preview con la configuracion /vista/{archivo}/preview obtendriamos

Si no se incluye el nombre del archivo en la ruta generada solo se incluye al final

TRANSLATE

Para aplicar la traduccion este bundle se basa en la configuracion de knplabs/doctrine-behaviors

https://github.com/KnpLabs/DoctrineBehaviors

Para poder aplicarlo solo se debe configurar la columna

Por default la traduccion sera con el parametro locale de la clase Request de Symfony

Para poder ver varias traducciones al mismo tiempo se agregan los idiomas a la columna

renderAsTranslate

Y por ultimo para poder visulizar la traduccion se creo el metodo renderAsTranslate

RELACIONES

Si se tiene una consulta relacionada se puede elegir el metodo que desea visualizar el objeto relacionado

Los metodos userid y username imprimirian el valor correspondiente para usertask el metodo internamente comprueba que la relacion no devuelda un valorNull y despues hace el llamado. Internamente la ejecucion seria la siguiente:

En la version 3 se permite una relacion hasta 2 niveles

EasyList Configuracion

Para poder agregar usabilidad a la vista de Lista se tiene diferentes metodos

RUTAS

Se tiene que usar rutas registradas por symfony en el proyecto

ORDERNAMIENTO y BUSQUEDA

PAGINACION

CONTADOR DE FILA

NOTA solo funciona cuando la seccion se muestra como html

GLOBAL: Links el final de la vista

En los 3 tipos de clases se permite el ingreso de links al final de la seccion

La ruta tiene que ser una ruta definida en el proyecto por symfony

NOTA solo funciona cuando la seccion se muestra como html

Enconder Symfony

Se agrega la clase CustomEnconder como serivicio en el archio services.yml y ese servicio se vincula con la tabla destino usando el encoder del archivo security.yml

Clase BuildPassword

Si se necesita crear la contraseña y no se puede acceder al encoder la clase BuildPassword puede generar las contraseñas con el mismo resultado que el encoder