¿Cuál es la estructura de directorios típica de una plantilla?

From Joomla! Documentation

This page is a translated version of the page What is the typical template directory structure? and the translation is 100% complete.

Other languages:
català • ‎Deutsch • ‎English • ‎español • ‎فارسی • ‎français • ‎Nederlands • ‎português do Brasil

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.