Los archivos de configuración son utiles para diseñar y administrar variables globales para los templates a partir de un archivo. Un ejemplo son los colores del template. Normalmente si usted quiere cambiar el esquema de colores de una aplicación, usted debe ir a cada uno de los archivos del template y cambiar los colores. Con un archivo de configuración, los colores pueden estar mantenidos en un lugar y solo necesita actualizar este para cambiar los colores.

# global variables
pageTitle = "Main Menu"
bodyBgColor = #000000
tableBgColor = #000000
rowBgColor = #00ff00

[Customer]
pageTitle = "Customer Info"

[Login]
pageTitle = "Login"
focus = "username"
Intro = """This is a value that spans more
           than one line. you must enclose
           it in triple quotes."""

# hidden section
[.Database]
host=my.domain.com
db=ADDRESSBOOK
user=php-user
pass=foobar

  

Los valores de las variables pueden estar entre comillas, mas no es necesario. Usted puede usar comillas simples o dobles. Si usted tuviera un valor que ocupe mas de una linea, coloque todo el valor entre tres comillas ("""). Usted puede colocar comentarios en un archivo de configuración con cualquier sintaxis que no sea valida en un archivo de configuración. Nosotros recomendamos usar un # en el princio de cada linea.

Este archivo de configuración tiene dos secciones. Los nombres de secciones debe estar entre corchetes []. Los nombres de sección pueden ser cadenas arbitrarias que no contengan los simbolos [ or ]. Las cuatro variables en la cabecera son variables globales, o no son variables de sección. Estas variables son siempre cargadas del archivo de configuración. Si una sección en particular fuera cargada, entonces las variables globales y las variables de esta sección son cargadas. Si una variable existe como global y dentro de una sección, la variable de sección será utilizada. Si usted tuviera dos variables en la misma sección con el mismo nombre, la ultima será utilizada.

Los archivos de configuración son cargados en el template con una función incrustada {config_load}. (Ver También config_load() ).

Usted puede ocultar variables o secciones enteras colocando un punto antes del nombre de la variable. Esto es útil si su aplicación lee los archivos de configuración y los datos sensibles a partir de ellos que la herramienta del template no lo necesita. Si usted tiene a otras personas realizando la edición de templates, usted tendra la certesa que ellos no leeran datos sensibles del archivo de configuración cargando estos en el template.

Ver También {config_load}, $config_overwrite, get_config_vars(), clear_config() y config_load()