11.

Assets: CSS, Imágenes, etc

|

Share this awesome video!

|

Vamos muy bien pero, Cielos! Nuestro sitio está muy feo. Es hora de arreglarlo.

Si descargas el código del curso en esta página, después de que lo descomprimas, encontrarás el directorio start/ con el directorio tutorial/ ahí dentro: el mismo directorio tutorial/ que ves aquí. Vamos a copiar algunos archivos de ahí en los próximos minutos.

Copiando el Layout Base y el Archivo CSS principal

El primero es base.html.twig. Lo voy a abrir, copiar el contenido, cerrarlo, y luego abriré nuestro templates/base.html.twig. Pega el nuevo contenido aquí.

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>{% block title %}Welcome!{% endblock %}</title>
{% block stylesheets %}
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Spartan&display=swap">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
<link rel="stylesheet" href="/css/app.css">
{% endblock %}
</head>
<body>
<nav class="navbar navbar-light bg-light" style="height: 100px;">
<a class="navbar-brand" href="#">
<i style="color: #444; font-size: 2rem;" class="pb-1 fad fa-cauldron"></i>
<p class="pl-2 d-inline font-weight-bold" style="color: #444;">Cauldron Overflow</p>
</a>
<button class="btn btn-dark">Sign up</button>
</nav>
{% block body %}{% endblock %}
<footer class="mt-5 p-3 text-center">
Made with <i style="color: red;" class="fa fa-heart"></i> by the guys and gals at <a style="color: #444; text-decoration: underline;" href="https://symfonycasts.com">SymfonyCasts</a>
</footer>
{% block javascripts %}{% endblock %}
</body>
</html>

Esto no fué un gran cambio: sólo agregó algunos archivos CSS - incluyendo Bootstrap - y un poco de HTML básico. Pero tenemos los mismos bloques que antes: {% block body %} en el medio, {% block javascripts %} , {% block title %}, etc.

Date cuenta que los link tags están dentro del bloque llamado stylesheets. Pero eso aun no es importante. Explicaré porque está hecho de esa forma dentro de poco.

29 lines | templates/base.html.twig
<!DOCTYPE html>
<html>
<head>
// ... lines 4 - 5
{% block stylesheets %}
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Spartan&display=swap">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
<link rel="stylesheet" href="/css/app.css">
{% endblock %}
</head>
// ... lines 13 - 27
</html>

Uno de los link tags está apuntando a /css/app.css. Ese es otro archivo que vive en el directorio tutorial/. De hecho, selecciona el directorio images/ y app.css y cópialos. Ahora, selecciona el directorio public/ y pégalos. Agrega otro directorio css/ y mueve app.css adentro.

Recuerda: el directorio public/ es nuestro documento raíz. Así que si necesitas que un archivo sea accesible por un usuario del navegador, entonces necesita vivir aquí. La ruta /css/app.css cargará el archivo public/css/app.css.

Vamos a ver como se ve! Muévete hacia tu navegador y refresca. Mucho mejor. El centro aun se ve terrible... pero eso es porque no hemos agregado ninguna etiqueta HTML al template para esta página.

A Symfony le Importan tus Assets

Así que hagamos una pregunta... y respondámosla: que funcionalidad nos ofrece Symfony cuando se trata de CSS y JavaScript? La respuesta es... ninguna... o muchas!

Symfony tiene dos niveles diferentes de integración con CSS y JavaScript. Por el momento estamos usando el nivel básico. De hecho, por ahora, Symfony no está haciendo nada por nosotros: creamos un archivo CSS, luego le agregamos un link tag muy tradicional con HTML. Symfony no está haciendo nada: todo depende de ti.

El otro tipo de integración de mayor nivel es utilizar algo llamado Webpack Encore: una fantástica librería que maneja minificación de archivos, soporte de Sass, soporte a React o VueJS y otras muchas cosas. Te voy a dar un curso rápido sobre Webpack Encore al final de este tutorial.

Pero por ahora, lo vamos a mantener simple: Crearás archivos CSS o de JavaScript, los pondrás dentro del directorio public/, y luego crearás un link o script tag que apunte a ellos.

La No Tán Importante Función asset()

Bueno, de hecho, incluso con esta integración "básica", hay una pequeña funcionalidad de Symfony que debes de utilizar.

Antes de mostrartelo, en PhpStorm abre preferencias... y busca de nuevo por " Symfony" para encontrar el plugin de Symfony. Ves esa option de directorio web? Cambiala a public/ - solía ser llamada web/ en versiones anteriores de Symfony. Esto nos ayudará a tener un mejor autocompletado próximamente. Presiona "Ok".

Así es como funciona: cada vez que hagas referencias a un archivo estático en tu sitio - como un archivo CSS, JavaScript o imagen, en vez de solo escribir /css/app.css, debes de usar la función de Twig llamada asset(). Entonces, {{ asset() }} y luego la misma ruta que antes, pero sin la / inicial: css/app.css.

29 lines | templates/base.html.twig
// ... line 1
<html>
<head>
// ... lines 4 - 5
{% block stylesheets %}
// ... lines 7 - 9
<link rel="stylesheet" href="{{ asset('css/app.css') }}">
{% endblock %}
</head>
// ... lines 13 - 27
</html>

Qué es lo que hace está increíble función asset()? Prácticamente.. nada. De hecho, esto va a retornar exactamente la misma ruta que antes: /css/app.css.

Entonces porque nos molestamos en utilizar una función que no hace nada? Bueno, en realidad hace dos cosas... las cuales pueden o no interesarte. Primero, si decides instalar tu aplicación en un subdirectorio de un dominio - como por ejemplo ILikeMagic.com/cauldron_overflow, la función asset() automáticamente agrega el prefijo /cauldron_overflow a todas las rutas. Grandioso! si es que te interesa.

La segunda cosa que hace es más útil: si decides instalar tus assets a un CDN, con agregar una linea a un archivo de configuración, repentinamente, Symfony agregará el prefijo en todas las rutas con la URL de tu CDN.

Asi que... en realidad no es tán importante, pero si utilizas asset() en todos lados, serás feliz en caso de que luego lo necesites.

Pero... si refrescamos... sorpresa! El sitio exploto!

Acaso olvidaste correr composer require symfony/asset? La función asset no existe.

Que tan genial es eso? Recuerda, Symfony empieza en pequeño: instalas las cosas sólo cuando las necesitas. En este caso, estamos tratando de utilizar una funcionalidad que no está instalada... por lo tanto Symfony nos da el comando exacto que tenemos que correr. Copialo, abre la terminal y ejecuta:

composer require symfony/asset

Cuando termine... regresa al navegador y... funciona. Si observas la fuente HTML y buscas app.css... Asi es! está imprimiendo la misma ruta que antes.

Mejorando la página "show"

Hagamos que el centro de nuestra página se vea un poco mejor. De vuelta en el directorio tutorial/, abre show.html.twig, copia el contenido, ciérralo, luego abre nuestra versión: templates/question/show.html.twig. Pega el nuevo código.

{% extends 'base.html.twig' %}
{% block title %}Question: {{ question }}{% endblock %}
{% block body %}
<div class="container">
<div class="row">
<div class="col-12">
<h2 class="my-4">Question</h2>
<div style="box-shadow: 2px 3px 9px 4px rgba(0,0,0,0.04);">
<div class="q-container-show p-4">
<div class="row">
<div class="col-2 text-center">
<img src="/images/tisha.png" width="100" height="100">
</div>
<div class="col">
<h1 class="q-title-show">{{ question }}</h1>
<div class="q-display p-3">
<i class="fa fa-quote-left mr-3"></i>
<p class="d-inline">I've been turned into a cat, any thoughts on how to turn back? While I'm adorable, I don't really care for cat food.</p>
<p class="pt-4"><strong>--Tisha</strong></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="d-flex justify-content-between my-4">
<h2 class="">Answers <span style="font-size:1.2rem;">({{ answers|length }})</span></h2>
<button class="btn btn-sm btn-secondary">Submit an Answer</button>
</div>
<ul class="list-unstyled">
{% for answer in answers %}
<li class="mb-4">
<div class="d-flex justify-content-center">
<div class="mr-2 pt-2">
<img src="/images/tisha.png" width="50" height="50">
</div>
<div class="mr-3 pt-2">
{{ answer }}
<p>-- Mallory</p>
</div>
<div class="vote-arrows flex-fill pt-2" style="min-width: 90px;">
<a class="vote-up" href="#"><i class="far fa-arrow-alt-circle-up"></i></a>
<a class="vote-down" href="#"><i class="far fa-arrow-alt-circle-down"></i></a>
<span>+ 6</span>
</div>
</div>
</li>
{% endfor %}
</ul>
</div>
{% endblock %}

Recuerda, aquí no está pasando nada importante: seguimos sobreescribiendo el mismo bloque title y body. Estamos usando la misma variable question y seguimos haciendo el mismo ciclo sobre answers aquí abajo. Solo tenemos mucha más sintaxis HTML... lo cual... tu sabes... hace que luzca bien.

Al refrescar... mira! Hermoso! De vuelta en el template, nota que esta página tiene algunas tags img... pero no están usando la función asset(). Hay que arreglarlo. Utilizaré un atajo! Simplemente escribo "tisha", oprimo tab y... boom! el resto se agrega solo! Buscar por img... y reemplaza también esta con "tisha". Te preguntas quien es tisha? Oh, es solo una de los multiples gatos que tenemos aquí en el staff de SymfonyCasts. Esta controla a Vladimir.

59 lines | templates/question/show.html.twig
// ... lines 1 - 4
{% block body %}
<div class="container">
<div class="row">
<div class="col-12">
// ... line 9
<div style="box-shadow: 2px 3px 9px 4px rgba(0,0,0,0.04);">
<div class="q-container-show p-4">
<div class="row">
<div class="col-2 text-center">
<img src="{{ asset('images/tisha.png') }}" width="100" height="100">
</div>
// ... lines 16 - 23
</div>
</div>
</div>
</div>
</div>
// ... lines 29 - 36
<ul class="list-unstyled">
{% for answer in answers %}
<li class="mb-4">
<div class="d-flex justify-content-center">
<div class="mr-2 pt-2">
<img src="{{ asset('images/tisha.png') }}" width="50" height="50">
</div>
// ... lines 44 - 52
</div>
</li>
{% endfor %}
</ul>
</div>
{% endblock %}

Por cierto, en una aplicación real, en vez de que estas imágenes sean archivos estáticos en el proyecto, podrían ser archivos que los usuarios suben. No te preocupes: tenemos todo un tutorial sobre como manejar la subida de archivos.

Asegurate de que esto funciona y... si funciona.

Puliendo la Homepage

La última página que no hemos estilizado es el homepage... la cual en este momento... imprime un texto. Abre el controlador: src/Controller/QuestionController.php. Asi es! Solamente retorna un nuevo objeto Response() y texto. Podemos hacerlo mejor. Cambialo por return $this->render(). Llamemos al template question/homepage.html.twig. y... por ahora... No creo que necesitemos pasar alguna variable al template... Asi que dejaré vacío el segundo argumento.

36 lines | src/Controller/QuestionController.php
// ... lines 1 - 8
class QuestionController extends AbstractController
{
// ... lines 11 - 13
public function homepage()
{
return $this->render('question/homepage.html.twig');
}
// ... lines 18 - 34
}

Dentro de templates/question/, crea un nuevo archivo: homepage.html.twig.

La mayoría de los templates empiezan de la misma forma. Genial consistencia! En la parte de arriba, {% extends 'base.html.twig' %}, {% block body %} y {% endblock %}. En medio, agrega más HTML para ver si esto funciona.

{% extends 'base.html.twig' %}
{% block body %}
<h1>Voilà</h1>
{% endblock %}

Muy bien... refresca la página y... excelente! Excepto por la parte de que se ve horrible.

Robemos algo de código del directorio tutorial/ una última vez. Abre homepage.html.twig. Esto es solo un montón de HTML estático para hacer que se vea mejor. Copialo, cierra ese archivo... y luego pegalo en nuestro código homepage.html.twig

{% extends 'base.html.twig' %}
{% block body %}
<div class="jumbotron-img jumbotron jumbotron-fluid">
<div class="container">
<h1 class="display-4">Your Questions Answered</h1>
<p class="lead">And even answers for those questions you didn't think to ask!</p>
</div>
</div>
<div class="container">
<div class="row mb-3">
<div class="col">
<button class="btn btn-question">Ask a Question</button>
</div>
</div>
<div class="row">
<div class="col-12">
<div style="box-shadow: 2px 3px 9px 4px rgba(0,0,0,0.04);">
<div class="q-container p-4">
<div class="row">
<div class="col-2 text-center">
<img src="{{ asset('images/tisha.png') }}" width="100" height="100">
<div class="d-block mt-3 vote-arrows">
<a class="vote-up" href="#"><i class="far fa-arrow-alt-circle-up"></i></a>
<a class="vote-down" href="#"><i class="far fa-arrow-alt-circle-down"></i></a>
</div>
</div>
<div class="col">
<a class="q-title" href="#"><h2>Reversing a Spell</h2></a>
<div class="q-display p-3">
<i class="fa fa-quote-left mr-3"></i>
<p class="d-inline">I've been turned into a cat, any thoughts on how to turn back? While I'm adorable, I don't really care for cat food.</p>
<p class="pt-4"><strong>--Tisha</strong></p>
</div>
</div>
</div>
</div>
<a class="answer-link" href="#" style="color: #fff;">
<p class="q-display-response text-center p-3">
<i class="fa fa-magic magic-wand"></i> 6 answers
</p>
</a>
</div>
</div>
<div class="col-12 mt-3">
<div class="q-container p-4">
<div class="row">
<div class="col-2 text-center">
<img src="{{ asset('images/magic-photo.png') }}" width="100" height="100">
<div class="d-block mt-3 vote-arrows">
<a class="vote-up" href="#"><i class="far fa-arrow-alt-circle-up"></i></a>
<a class="vote-down" href="#"><i class="far fa-arrow-alt-circle-down"></i></a>
</div>
</div>
<div class="col">
<a class="q-title" href="#"><h2>Pausing a Spell</h2></a>
<div class="q-display p-3">
<i class="fa fa-quote-left mr-3"></i>
<p class="d-inline">I mastered the floating card, but now how do I get it back to the ground?</p>
<p class="pt-4"><strong>--Jerry</strong></p>
</div>
</div>
</div>
</div>
<a class="answer-link" href="#" style="color: #fff;">
<p class="q-display-response text-center p-3">
<i class="fa fa-magic magic-wand"></i> 15 answers
</p>
</a>
</div>
</div>
</div>
{% endblock %}

Y ahora... se ve mucho mejor.

Así que esta es la integración básica de CSS y Javascript dentro de Symfony: tu te encargas de manejarlo. Claro, debes de utilizar la función asset(), pero no hace nada muy impresionante.

Si quieres más, estás de suerte! En el último capítulo, llevaremos nuestros assets al siguiente nivel. Te va a fascinar.

A continuación: nuestro sitio tiene algunos links! Y todos te llevan a ninguna parte! Aprendamos como generar URLs con rutas.