Modificar la sección del head desde el código en Joomla
La sección head de toda página web es de suma importancia. En ella solemos insertar o enlazar el código CSS y de scripts típicos (como JavaScript). Además los datos que contenga pueden tener bastante relevancia en lo que a SEO se refiere. Modificar la sección del head desde el código de un componente no es tan fácil como puede parecer. Vamos a ver como hacerlo.
Normalmente insertamos la cabecera utilizando el siguiente código:
La anterior línea carga el fichero libraries/joomla/document/html/renderer/head.php que contiene los métodos que procesan la sección head y devuelven el código HTML generado.
Ese mismo código HTML lo podemos obtener con:
|
|
$doc = JFactory::getDocument(); $datosSeccionHead = $doc->getHeadData(); |
Pero si lo que queremos es modificar esa sección desde un componente, la cosa se complica un poco si no conocemos lo que Joomla pone a nuestra disposición para realizar esta tarea. Para toda modificación, el método de la clase estática JFactory::getDocument(), nos proveerá de todo lo necesario. Para los siguientes ejemplos, seguiremos usando el ejemplo del código anterior.
Cambiar el título de la página dependiendo de la lógica del componente
El método setTitle(“”) nos permitirá modificar el título:
|
|
$doc->setTitle("Nuevo título para esta página"); |
Añadir estilos CSS dependiendo de la lógica del componente
El enlace a un fichero de reglas de estilos CSS lo hacemos con:
|
|
$doc->addStyleSheet("$RUTA-FICHERO-CSS/FICHERO.CSS"); |
Si solamente queremos añadir unas reglas pero no un fichero completo:
|
|
$doc->addStyleDeclaration(".miClaseCSS{background-color:#0000ff;}"); |
Añadir código JavaScript dependiendo de la lógica del componente
Podemos enlazar un fichero:
|
|
$doc->addScript("$RUTA-FICHERO-JS/FICHERO.JS"); |
O bien simplemente añadir un poco de JavaScript:
|
|
$doc->addScriptDeclaration("alert('Conseguido')"); |
La insercción de ficheros CSS y de script, las podemos hacer también, usando el objeto JHTML:
|
|
JHTML::stylesheet('fichero.css', 'ruta-al-fichero'); JHTML::script('fichero.js', 'ruta-al-fichero'); |
Modificando los metatags dependiendo de la lógica del componente
Desde que los metatags o etiquetasno son tan relevantes en el posicionamiento SEO, su uso se ha quedado un tanto olvidado. Si miramos el código fuente de una web, es probable que nos encontremos con una etiqueta meta del tipo:
…
… donde se está indicando el software que ha generado el código de la página. Sin embargo sus usos pueden ser muchos y variados, desde redirecciones automáticas de la página, hasta usar las etiquetas meta sugeridas por Facebook que nos permiten compartir nuestros contenidos en su red social.
Joomla pone a nuestra disposición una funcionalidad mediante la cual podemos insertar etiquetas meta. Para ello nos vamos al área de administración y una vez dentro, vamos a:
[En Joomla 3.x] -> [Sitio -> Configuración global]
[En Joomla 2.5] -> [Sistema -> Configuración global]
Nos vamos al apartado donde dice [Configuración de los metadatos] y una vez allí, insertamos las metatags que estimemos oportuno.
En la práctica, lo cierto es que frecuentemente necesitamos una manera dinámica de establecer estos metatags.
Código para modificar los metadatos
Quitar el metatag “generator” puesto por defecto por Joomla:
|
|
$doc->setGenerator(); // Lo ponemos vacío, sin argumentos. |
Otros metatags también tienen su propio método para cambiarlos o establecerlos:
|
|
$doc->setDescription("Este el meta description de la página"); |
Pero si no dispone de método propio, usamos setMetaData():
|
|
$doc->setMetaData("author", "José Manuel Domínguez"); |
Los metas formados de esta manera son los típicos que contienen los atributos name y content. Si queremos que el resultado sea un meta con atributo http-equiv, tendremos que usar el mismo método pero con un argumento más:
|
|
$doc->setMetaData("content-type", "text/html; charset=UTF-8", true); // El tercer argumento indica si es un meta con el atributo http-equiv |
Finalmente, debemos tener en cuenta que existen metatags que no corresponden a los estándares, sino que deben ser añadidos para la correcta ejecución de lógica de terceros (como scripts de Facebook por ejemplo):
Eso es todo. Recordad que toda esta información y más, forma parte de los cursos que ofrecemos de Joomla.
Espero que este artículo os sea de utilidad y como reencuentro con la actividad del blog que no he podido atender por falta de tiempo, durante una temporada que ya se hacía larga.
Nada más. Un cordial saludo a todos y hasta otra.
Estoy suscrito a diferentes blogs y similares que me ayudan a mantenerme al día en este mundo tan cambiante del software libre y desarrollo en general.
