Joomla! Documentation™

Estructura de directorios típica de una plantilla

Las plantillas del CMS Joomla usan una estructura de directorios y archivos que puede variar de una plantilla a otra

• Las plantillas del Sitio (plantillas que cambian la apariencia de su sitio web) pueden ser encontradas en el directorio /templates. Por ejemplo, si su plantilla se llama "miplantilla", estaría situada en la carpeta:

<ruta-a-Joomla!>/templates/miplantilla

• Las plantillas de Administrador (las que cambiarán la apariencia de la interfaz administrativa) pueden ser encontradas en el directorio /administrator/templates. por ejemplo, si su plantilla de administrador se llama "miplantillaadmin", se encontraría en la carpeta:

<ruta-a-Joomla!>/administrator/templates/miplantillaadmin

Directorios de la plantilla

Una plantilla típica para Joomla! incluirá las siguientes carpetas:

• css - contiene todos los archivos .css
• html - contiene los archivos de "reemplazo" (override) para la salida del núcleo y el chrome de módulo
• images - contiene todas las imágenes usadas por la plantilla
• language - contiene archivos de idioma adicionales usados por la plantilla

Dependiendo de la complejidad y el diseño de la plantilla también puede contener,

• javascript - contiene JavaScript de apoyo usado por la plantilla para funcionalidades adicionales

Estructura de ejemplo con archivos

La ruta típica de una plantilla es <root>/public_html/nombre-de-dominio/template/<nombre de su plantilla>, la cual contendrá los siguientes directorios y archivos, que pueden variar según su plantilla.

/css
/html
/images
/javascript
/language
component.php
error.php
favicon.ico
index.php
templateDetails.xml
template_preview.png
template_thumbnail.png 

Archivos de la plantilla

Lo más habitual es que una plantilla tenga al menos los siguientes archivos:

• index.php

Porporciona la lógica para la presentación y posicionamiento de los módulos y componentes

• component.php

Proporciona la lógica para la presentación de la página de impresión, "Enviar por E-mail a un amigo." etc.

• error.php

Proporciona un método para gestionar los errores como el 404, error de página no encontrada

• favicon.ico

Archivo del icono favicon

• template.css

Maneja los aspectos formales de presentación de la plantilla, incluyendo especificaciones para los márgenes, tipos de letra, títulos, bordes de imagen, formato de lista, etc. Los archivos .css también pueden estar localizados en el directorio /css.

• templateDetails.xml

Contiene meta información relacionada con la plantilla y que es usada por el Instalador y el Gestor de Plantillas.

• template_preview.ext - reemplazar .ext con la extensión del formato de la imagen (.jpg, .png, .gif)

Generalmente una imagen de 600x400 píxeles que se muestra cuando se hace clic en la miniatura de la imagen den Gestor de Plantillas:Plantilla, no en Gestor de Plantillas:Estilos. Esto da al administrador una ventana modal emergente de la plantilla antes de aplicarla al sitio.

• template_thumbnail.ext - replace .ext with the extension format of the image (.jpg, .png, .gif)

Generalmente una imagen en miniatura de 200x150 píxeles que se muestra cuando se visualiza la lista de plantillas en Gestor de Plantillas:Plantillas, no en Gestor de Plantillas:Estilos. Esto da al administrador una vista en miniatura de la plantilla antes de aplicarla al sitio.