SymfonyCasts stands united with the people of Ukraine
gstreamer0.10-ffmpeg
gstreamer0.10-plugins-good packages.
Bien, veamos de qué se trata Layouts. En este capítulo, crearemos y utilizaremos, paso a paso, un "diseño", aprendiendo cómo funciona exactamente la magia de los Diseños.
Para comprobar la sección de administración de los Diseños, dirígete a /nglayouts/admin y encontrarás... ¡un formulario de acceso! El formulario de inicio de sesión no tiene nada que ver con los Layouts... es que el área de administración de los Layouts requiere que estés conectado... y ya he añadido un formulario de inicio de sesión a nuestro sitio. ¡Incluso hay un usuario en la base de datos! Inicia sesión condoggo@barkbite.com, contraseña woof.
Y cuando lo enviamos... ¡acceso denegado! No te preocupes: haz clic abajo en el icono de seguridad de la barra de herramientas de la web... y ve a "Decisión de acceso". Sí: nos han denegado el acceso porque buscaba un rol llamado ROLE_NGLAYOUTS_ADMIN. Para acceder al área de administración de los diseños, necesitamos tener este rol.
La forma más sencilla de añadirlo es ir a config/packages/security.yaml. El usuario con el que estamos conectados ahora mismo tiene ROLE_ADMIN. Por lo tanto, en role_hierarchy también le damos a nuestro usuario ROLE_NGLAYOUTS_ADMIN:
| security: | |
| ... lines 2 - 6 | |
| role_hierarchy: | |
| ROLE_ADMIN: [ROLE_USER, ROLE_NGLAYOUTS_ADMIN] | |
| ... lines 9 - 56 |
Y ahora si volvemos a hacer clic, ¡tachán! ¡Bienvenido a la sección de administración de layouts! Para entender lo que hace Layouts... lo mejor es verlo en acción. Empieza en esta sección de Diseños... y haz clic para crear un nuevo diseño. Esto nos muestra unos seis tipos de diseño diferentes entre los que podemos elegir. Como verás, son mucho menos importantes de lo que puede parecer al principio, porque, una vez que estás en una disposición, puedes hacer realmente lo que quieras, incluso hacer flotar cosas a izquierda y derecha. Yo suelo elegir la "Disposición 2". Llámalo "Diseño de la página de inicio" porque pienso utilizarlo en nuestra página de inicio.
Y... ¡bienvenido al editor de diseño! Recorrido rápido: estos elementos del lado izquierdo se llaman "bloques", y hay muchos tipos diferentes, desde simples bloques de título a mapas de Google... hasta cosas más complejas como listas y cuadrículas en las que puedes representar colecciones dinámicas de cosas, como recetas destacadas. Lo principal que "hacemos" en esta página es elegir un bloque de la izquierda... y arrastrarlo a una de las "zonas" del centro.
Coge un bloque "Título" y arrástralo a algún lugar de la página... luego dale algo de texto. ¡Genial!
Es un comienzo modesto, pero, ¡bastante bueno! En la parte superior derecha, pulsa "Publicar diseño".
Y ahora que tenemos este nuevo diseño, abre una segunda pestaña y ve a la página de inicio para descubrir que... ¡no ha cambiado absolutamente nada! Deja que reorganice mis pestañas.
De todos modos, nada ha cambiado porque, una vez que tienes una disposición, necesitas asignarla a una página o conjunto de páginas específicas. Ese es el trabajo de la sección de mapeo de diseños. Realmente son las dos únicas secciones importantes en el área de administración.
Aquí, añade un nuevo mapeo y luego ve a Detalles. Hay varias formas de asignar un diseño a una URL específica. Puedes utilizar, por ejemplo, la información de la ruta, que es un término elegante que significa "la URL, pero sin parámetros de consulta". O puedes usar un prefijo de información de la ruta, como usar esta disposición para todas las URL que empiecen por "/productos". O incluso puedes asignar un diseño a un nombre de ruta específico.
Vamos a probar eso. Pulsa "Añadir objetivo". Entonces... vamos a buscar el nombre de la ruta de nuestra página de inicio:src/Controller/MainController.php. Aquí está: app_homepage:
| ... lines 1 - 9 | |
| class MainController extends AbstractController | |
| { | |
| ('/', name: 'app_homepage') | |
| public function homepage(RecipeRepository $recipeRepository): Response | |
| { | |
| ... lines 15 - 22 | |
| } | |
| } |
Vuelve a desplazarte, pega y pulsa "Guardar objetivo".
Más adelante hablaremos de otras formas de mapear o "activar" un diseño para las páginas, pero la información de rutas y caminos es la más sencilla y flexible. Dicen:
Si la ruta o la URL actuales coinciden con lo que tenemos aquí, utiliza este diseño.
Pulsa guardar cambios. Para elegir qué maquetación va con este mapeo, pulsa "Maquetación de enlace" y selecciona la única: "Diseño de la página de inicio".
¡Genial! Ahora, cuando vayamos a la página de inicio, se utilizará el diseño de la página de inicio. Pero... ¿qué significa eso? ¡Vamos a averiguarlo! Actualiza y... ¡todavía no vemos ninguna diferencia! ¡Es la misma página estática de Symfony!
Ah, eso es porque nos hemos saltado un paso importante de la instalación. ¡Culpa mía! Ve a abrir la plantilla de esta página: templates/main/homepage.html.twig. Ahora mismo, estamos ampliando base.html.twig:
| {% extends 'base.html.twig' %} | |
| ... lines 3 - 60 |
Y esa plantilla, como es habitual, tiene un bloque llamado body en el centro:
| <html> | |
| ... lines 3 - 16 | |
| <body> | |
| ... lines 18 - 46 | |
| {% block body %}{% endblock %} | |
| ... lines 48 - 60 | |
| </body> | |
| </html> |
Así que es una configuración súper tradicional.
Ahora, cambia el extends por una variable dinámica llamada nglayouts.layoutTemplate:
| {% extends nglayouts.layoutTemplate %} | |
| ... lines 2 - 60 |
Prueba la página de nuevo. ¡Error! ¡Eso es un progreso! Dice:
Diseño base de la página, no especificado. Para renderizar la página con Layouts, especifica el diseño base de la página con esta configuración.
Todo esto tendrá más sentido dentro de un minuto. Lo que quiere que hagamos es abrirconfig/packages/ y crear un nuevo archivo -que puede llamarse como sea- pero llamémoslo netgen_layouts.yaml. Dentro, añade netgen_layouts y, debajo,pagelayout ajustado a nuestro base.html.twig:
| netgen_layouts: | |
| pagelayout: 'base.html.twig' |
Te explicaré todo esto en un minuto. Si refrescamos ahora... ¡eh, el mismo error! Es posible que Symfony no haya visto mi nuevo archivo de configuración... así que déjame borrar la caché para estar seguro:
php ./bin/console cache:clear
Y ahora... ¡sí! ¡Funciona! Excepto que... ¡sigue siendo la misma página estática! Pero, por primera vez, abajo en la barra de herramientas de depuración de la web, muestra que se está utilizando el "Diseño de la página de inicio". Así que se ha dado cuenta de que el diseño debe ser utilizado... sólo que no parece estar renderizándolo.
Para solucionarlo, tenemos que hacer una última cosa... y luego retrocederemos para explicar lo que está pasando y lo genial que es. En base.html.twig, alrededor de {% block body %}, añade {% block layout %}... luego después de {% endblock %}:
| <html> | |
| ... lines 3 - 16 | |
| <body> | |
| ... lines 18 - 46 | |
| {% block layout %} | |
| {% block body %}{% endblock %} | |
| {% endblock %} | |
| ... lines 50 - 62 | |
| </body> | |
| </html> |
Actualiza una vez más. Y... ¡guau! ¡Nuestra página ha desaparecido! Vale, todavía tenemos el nav y el pie de página... que vienen de arriba y de abajo de los bloques en base.html.twig, pero el contenido real de nuestra página ha desaparecido y ha sido sustituido por el bloque de título dinámico ¿Qué magia negra es ésta?
En primer lugar, antes de explicarlo, permíteme decir que hay formas mucho más rápidas de empezar con Netgen Layouts: tienen proyectos de inicio para aplicaciones normales de Symfony, aplicaciones de Sylius y aplicaciones de Ibexa CMS. Pero hemos hecho todo este trabajo de configuración manualmente a propósito... porque realmente quiero que entiendas cómo funcionan los Layouts: es sorprendentemente sencillo.
En primer lugar, nuestra página sigue llegando a nuestra ruta normal - app_homepage - y sigue ejecutando nuestro controlador normal y sigue renderizando nuestra plantilla normal. No hay nada de magia ahí.
Pero entonces, extendemos nglayouts.layoutTemplate. ¿A qué apunta eso? Si no hay ningún diseño asignado a una página concreta, nglayouts.layoutTemplate resolverá a base.html.twig. Eso es gracias a la configuración que hemos añadido aquí:
| netgen_layouts: | |
| pagelayout: 'base.html.twig' |
Pero si Layouts encuentra una asignación de diseño para esta página, entoncesnglayouts.layoutTemplate resuelve a una plantilla de Layouts del núcleo. En este caso, si pulsas Shift+Shift, se llamará layout2.html.twig... ya que hemos seleccionado "Layout 2".
Esto renderiza el diseño dinámico a través de estas etiquetas nglayouts_render_zone: cada una de ellas se refiere a una sección diferente -o "zona"- dentro de nuestro diseño.
En cualquier caso, lo realmente importante es que convierte el diseño en un bloque Twig llamado layout. A continuación, extiende ngLayouts.pageLayoutTemplate, que resuelve a nuestro base.html.twig.
El resultado final es que nuestra página se renderiza con total normalidad y sigue extendiendobase.html.twig... pero se ha añadido un bloque llamado layout que contiene el contenido del diseño dinámico.
Por eso no vimos ningún cambio en la página al principio. Hasta que no incluimos {% block layout %} en base.html.twig, el diseño se estaba cargando... sólo que no lo estábamos mostrando en ningún sitio.
La conclusión es la siguiente: si estás en una página que no está maquetada, todo es exactamente igual que siempre. Pero si estás en una página que se mapea a un diseño, simplemente significa que ahora tienes un bloque llamado layout cuyo contenido es igual a lo que tengas dentro de ese diseño.
Como he mencionado antes, no tenemos que añadir maquetas a todas las páginas de nuestro sitio: ¡podríamos añadirlas a la página de inicio y listo! Pero todas las páginas que queramos que admitan diseños tienen que ampliar nglayouts.layoutTemplate. Lo bueno es que, incluso si ampliamos esto, no ocurre nada a menos que asignemos un diseño a esta página. Así que no hay ningún inconveniente en utilizarla en todas partes. Actualizaré rápidamentelogin.html.twig para utilizarlo:
| {% extends nglayouts.layoutTemplate %} | |
| ... lines 2 - 39 |
luego list.html.twig y show.html.twig:
| {% extends nglayouts.layoutTemplate %} | |
| ... lines 2 - 33 |
| {% extends nglayouts.layoutTemplate %} | |
| ... lines 2 - 38 |
¡Realmente puedo moverme rápido cuando lo necesito!
De vuelta al navegador, las páginas de la lista de recetas y de la muestra de recetas siguen teniendo el mismo aspecto... porque no se ha resuelto el diseño. Pero ahora están preparadas para usar maquetas, si queremos.
Ahora, por muy interesante que sea controlar dinámicamente el contenido de la página de inicio, ¡hemos hecho demasiado! Todo nuestro antiguo contenido ha desaparecido. ¿Es posible mezclar el contenido dinámico con parte del contenido estático de nuestra plantilla Twig de la página de inicio? Por supuesto. Y eso es una gran parte de lo que hace que los diseños sean especiales. Eso a continuación.
Hey Richard,
Did you installed your assets and ran yarn watch?
How do you spin up your web server? The public directory must be the root directory in the browser
Cheers!
Yarn is installed and watching, the server is launched from the IDE (serve -d).
The url load the login page wich is styled with css, but the nglayouts/admin page is not styled.
I tried to launch the server from MAM Pro on mac and got the same issue.
Maybe I should load the finish source code to see if it works but I prefer understand where is my mistake.
Context: Mac OS 13.1, PHP 8.1.5, IDE : IntelliJ IDEA 2022.3
Hey Richart,
Could you try to run bin/console assets:install command? Then also restart your Webpack Encore and clear the Symfony cache just in case. Also, just to be extra sure, open the website in Chrome Incognito mode to avoid any browser's caching problem.
Let us know if it still does not help!
Cheers!
Bonjour Victor,
I followed scrupulously your answer.
I 're-run' the bin/console command on assets without error.
I could'nt clear the symfony cache : I had this error:Allowed memory size of 134217728 bytes exhausted (tried to allocate 40960 bytes) in /Users/[...]/start-layouts/vendor/twig/twig/src/Compiler.php on line 95
Last : I open the server on private navigation on Chrome and shazam!, the admin page appear correctly.
Could you tell me how to avoid this memory lack? I did encountered this problem previously.
Have a nice day, thanks for your help.
Cordialement, Richard.
Bonjour Richard!
Awesome, congrats on EA styles! I'm happy to hear you were able to see them now :) It seems some bundle's styles were not installed during the bundle's installation so you installed them manually.
About the cache - no problem, technically you can clear the cache by removing the var/cache/ folder, e.g.:
rm -rf var/cache/
But if you want to be able to clear the cache with the console command - you need to tweak your PHP CLI configuration setting the memory_limit = -1 - it will disable the memory limit and in theory, you won't see this error anymore.
Cheers!
you need to tweak your PHP CLI configuration setting the memory_limit = -1
That the point, I don't know where to set the "memory_limit=-1"
Thank you for being listening.
Hey Richard,
If you're using Symfony CLI, you can create a php.ini file at the root of your project and add that config line there. Otherwise, you'll need to find your local php.ini and modify it (the location of the file depends on your OS)
You can read more about Symfony CLI here https://symfony.com/doc/current/setup/symfony_server.html
Cheers!
// composer.json
{
"require": {
"php": ">=8.1.0",
"ext-ctype": "*",
"ext-iconv": "*",
"babdev/pagerfanta-bundle": "^3.7", // v3.7.0
"doctrine/doctrine-bundle": "^2.7", // 2.7.0
"doctrine/doctrine-migrations-bundle": "^3.2", // 3.2.2
"doctrine/orm": "^2.13", // 2.13.3
"easycorp/easyadmin-bundle": "^4.4", // v4.4.1
"netgen/layouts-contentful": "^1.3", // 1.3.2
"netgen/layouts-standard": "^1.3", // 1.3.1
"pagerfanta/doctrine-orm-adapter": "^3.6",
"sensio/framework-extra-bundle": "^6.2", // v6.2.8
"stof/doctrine-extensions-bundle": "^1.7", // v1.7.0
"symfony/console": "5.4.*", // v5.4.14
"symfony/dotenv": "5.4.*", // v5.4.5
"symfony/flex": "^1.17|^2", // v2.2.3
"symfony/framework-bundle": "5.4.*", // v5.4.14
"symfony/monolog-bundle": "^3.0", // v3.8.0
"symfony/proxy-manager-bridge": "5.4.*", // v5.4.6
"symfony/runtime": "5.4.*", // v5.4.11
"symfony/security-bundle": "5.4.*", // v5.4.11
"symfony/twig-bundle": "5.4.*", // v5.4.8
"symfony/ux-live-component": "^2.x-dev", // 2.x-dev
"symfony/ux-twig-component": "^2.x-dev", // 2.x-dev
"symfony/validator": "5.4.*", // v5.4.14
"symfony/webpack-encore-bundle": "^1.15", // v1.16.0
"symfony/yaml": "5.4.*", // v5.4.14
"twig/extra-bundle": "^2.12|^3.0", // v3.4.0
"twig/twig": "^2.12|^3.0" // v3.4.3
},
"require-dev": {
"doctrine/doctrine-fixtures-bundle": "^3.4", // 3.4.2
"symfony/debug-bundle": "5.4.*", // v5.4.11
"symfony/maker-bundle": "^1.47", // v1.47.0
"symfony/stopwatch": "5.4.*", // v5.4.13
"symfony/web-profiler-bundle": "5.4.*", // v5.4.14
"zenstruck/foundry": "^1.22" // v1.22.1
}
}
Hi
At this point (0:18), the url nglayouts/admin load a page without any css ?
I'm a bit lost with that public/build folder and don't know where is the 'call' to the existing css.
Thanks for attention, sincerly.