Indicadores Económicos INNOVATE

1.Qué necesita

El módulo mod_indicators_cl funciona en cualquier Joomla 4.2 o superior con un token gratuito del Banco Central. La versión 2.0.4 está probada en Joomla 6.2.0.

Joomla 3 no está soportado; esos sitios deben seguir con la versión 1.0.

2.Obtener y probar el token del Banco Central

Cada sitio necesita su propio token. El límite de 5 consultas por segundo es por cuenta, no por servidor, así que un mismo token no se debe repartir entre varios sitios.

1. Regístrese en la Base de Datos Estadísticos del Banco Central y active las credenciales de la API. El procedimiento está en Acceso a la API.
2. Pruebe el token en el navegador, reemplazando TU_TOKEN y las fechas:

https://si3.bcentral.cl/SieteRestWS/SieteRestWS.ashx?token=TU_TOKEN&function=GetSeries&timeseries=F073.TCO.PRE.Z.D&firstdate=2026-11-01&lastdate=2026-11-05

3. Si la respuesta incluye "Codigo": 0 y una lista Obs con valores, el token funciona. Cualquier otro código indica un problema con el token o con el registro.

3.Instalar o actualizar

La instalación nueva y la actualización desde la v1.0 se hacen igual: se sube el zip y Joomla conserva la configuración de los módulos ya creados.

1. En el panel de Joomla, vaya a Sistema → Instalar → Extensiones y suba mod_indicators_cl_v2.0.4.zip.
2. Vaya a Contenido → Módulos del sitio → Nuevo y elija Indicadores Económicos INNOVATE. Si actualiza, abra el módulo que ya existía.
3. Pegue el token en la pestaña Banco Central, asigne una posición de la plantilla y las páginas donde se mostrará, y guarde.
4. Si actualizó, vaya a Sistema → Limpiar caché y borre todos los grupos. Después recargue el sitio con Ctrl+F5.

Al actualizar desde la v1.0, el instalador borra los archivos antiguos que ya no se usan (helper.php, tmpl/error.php, el CSS anterior y los archivos de idioma con el formato viejo). Los módulos configurados como tabla o marquesina conservan esa vista.

4.Configurar el módulo

Lo único obligatorio es el token; el resto viene con valores que funcionan.

La línea «Fuente: Banco Central de Chile» aparece siempre, porque los términos del Banco exigen indicar que es dueño de los datos.

5.Elegir el formato

Hay cuatro vistas, elegidas en Apariencia → Disposición. Tabla y Tarjetas admiten 1 o 2 columnas, y en espacios de menos de 230 px pasan solas a 1 columna.

6.Personalizar

Los colores del módulo se calculan a partir del color de texto de la plantilla, así que se ven bien sobre fondos claros, oscuros o de color sin configurar nada.

Para fijarlos, agregue variables al CSS de la plantilla:

.icl {
    --icl-value: #0b3b6f;     /* valores */
    --icl-muted: #4b5563;     /* nombres, fechas y pie */
    --icl-tile-bg: #eef6ff;   /* fondo de cada tarjeta */
}

Cambiar el HTML sin tocar el módulo

Copie los archivos de modules/mod_indicators_cl/tmpl/ a templates/SU_PLANTILLA/html/mod_indicators_cl/ y edítelos ahí. Cada vista tiene su archivo: default_table.php, default_cards.php, default_ticker.php y default_bar.php. Las clases textItem y valueItem de la v1.0 siguen presentes en la tabla y la marquesina, así que el CSS antiguo sigue funcionando.

7.Cómo funciona

El módulo guarda los datos y solo consulta al Banco Central cuando vencen, así que la mayoría de las visitas no hacen ninguna consulta.

De cada serie se toma el valor de hoy (hora de Chile) o, si no hay, el más reciente anterior. Así se ignoran los valores futuros de la UF, que el Banco publica por adelantado, y los días sin dólar de los fines de semana.

Los cinco códigos están confirmados en producción. El IPC se publica con un mes de desfase, por eso en noviembre muestra septiembre u octubre.

8.Solución de problemas

Dos lugares dicen exactamente qué falló; conviene mirarlos antes de cualquier otra cosa.

• Aviso para administradores. Inicie sesión como Super Usuario en el sitio público (no en /administrator). Bajo el módulo aparece un recuadro con cada indicador que no se pudo obtener y el motivo. Los visitantes no lo ven.
• Log. El archivo administrator/logs/mod_indicators_cl.php registra cada falla con fecha y código de serie. Nunca incluye el token.