## Configuración para "extender" los templates

### Objetivo

Definir las condiciones de sustitución de cada template (plantilla) de la aplicación Piwigo, por templates personalizados ubicados en la carpeta template-extension.

El template original es el que está ubicado en ./themes/default/template (u otra carpeta correspondiente al tema implementado) y que va a ser reemplazado por el template personalizado; opcionalmente, sólo cuando la dirección URL contiene el literal especificado en "Si la URL contiene".

Los valores de la lista "Si la URL contiene" son literales adicionales que componen la URL y que se encuentran tras el nombre del módulo.

Por lo tanto, uno de los valores posibles de "Si la URL contiene" puede ser un enlace permanente activo (ver la documentación sobre enlaces permanetes para más información).

Lea las `advertencias` acerca de las condiciones de uso.

### ¿Qué son las extensiones de los templates?

Se trata de un instrumento de configuración que extiende la funcionalidad de la aplicación en la medida que usted desee, útil tanto para principiantes como para usuarios avanzados. Mediante un cliente FTP, el webmaster puede duplicar buena parte de los ficheros .tpl distribuidos (templates originales) con un nombre diferente (templates a personalizar). En la actualidad se encuentra habilitada la sustitución de los siguiente templates:

- index.tpl
- mainpage_categories.tpl y/o thumbnails.tpl
- menubar.tpl
- header.tpl y/o footer.tpl
- picture_content.tpl y/o picture.tpl
- profile.tpl y/o profile_content.tpl
- tags.tpl
- upload.tpl
- about.tpl
- popuphelp.tpl
- search.tpl y/o search_rules.tpl
- nbm.tpl y/o notification.tpl
- identification.tpl y/o register.tpl
- redirect.tpl

### ¿Dónde puedo encontrar los templates originales?

Los templates origilales distribuidos están en /themes/default/template/ (no los modifique directamente en este lugar en previsión de la evolución a futuro que pueda tener la aplicación). Todo webmaster podrá crear su templates personalizados por copia de estos templates originales.

### ¿Dónde debo ubicar los templates personalizados?

Los templates personalizados se ubican en la carpeta template-extensión o en carpetas de esta última. Pueden tener cualquier nombre con la extensión .tpl. Por ejemplo: template-extension/mi-extension/video.tpl.

### ¿Cómo puedo activar los templates personalizados?

Cada template original debe estar asociado a un template personalizado para que se active la sustitución correspondiente. Activar los templates personalizados es la función de la opción "Reemplazar templates", que encontrará en el menú de Configuración.

Si selecciona un valor en Si la URL contiene, las sustituciones serán realizadas sólo en aquellas páginas cuya URL contiene esa palabra clave. Por ejemplo: index.php?/most_visited

Los usuarios avanzados pueden utilizar los enlaces permanentes como valores de este campo.

Si selecciona unbound template, los templates personalizados operarán sólo en ese template.

### ¿Cómo puedo desactivar mis templates personalizados?

- Para desactivar un template personalizado, elimine la selección en "Sustituye al original".
- Si desea eliminarlo definitivamente, borre el template personalizado de la carpeta template-extension.

### Advertencias

- El template original debe ser el correspondiente al que lo sustituye, de otro modo podría obtener resultados imprevisibles
- Si varios templates personalizados referencian a un mismo template original con un mismo valor en "Si la URL contiene", sólo el último permanece activo.
- Si no selecciona un valor en "Si la URL contiene", el template personalizado sustituirá siempre al template original. De acuerdo a lo mencionado más arriba, el orden de definición podría implicar que se inhibieran los templates personalizados precedentes.
- Subcarpetas: las subcarpetas no se tienen en cuenta, pero son útiles para modificar el orden actual.
  Distributed-samples (ejemplos distibuidos): se facilitan únicamente para la realización de pruebas. No los modifique, implemente los suyos propios
- Al eliminar la entrada en la columna template original, el template original vuelve a activarse inmediatamente.