Crear archivos JavaScript dependientes del idioma para módulos de CMS
El CMS bluetronix genera automáticamente archivos JavaScript optimizados para cada idioma activado de tu página web. Aprenderás cómo se combinan los archivos estándar, los ajustes individuales y los textos de módulos dependientes del idioma, y cómo el CMS vincula automáticamente los archivos adecuados a tu página web.
Archivos JavaScript dependientes del idioma
El CMS de bluetronix puede generar archivos JavaScript propios para cada idioma activado en tu página web. De este modo, los textos y funciones dependientes del idioma están disponibles directamente dentro de cada archivo JavaScript.
Los archivos necesarios se crean automáticamente tan pronto como guardas una configuración de módulo. El CMS considera tanto los archivos estándar como tus adaptaciones individuales.
Este tutorial se basa en la documentación "Incluir y adaptar módulos del CMS". Debes estar familiarizado con la carpeta del desarrollador bx_Mod y el uso de archivos _own propios.
1. Generación automática de archivos JavaScript
Al guardar una configuración de módulo, el CMS genera automáticamente todos los archivos JavaScript dependientes del idioma necesarios.
Sólo se crean las versiones de idioma que has activado a través del módulo Lang.
Los idiomas activados se establecen a través de la configuración global del módulo:
bx_Mod/config_own.phpPor ejemplo, si has activado alemán, inglés y español, el CMS genera archivos JavaScript correspondientes a estos tres idiomas.
Un cambio en el conjunto de colores o en el diseño no afecta ya los archivos JavaScript. La regeneración automática ocurre al guardar una configuración de módulo.
2. Generar archivos JavaScript manualmente
Además de la generación automática, puedes hacer que se generen manualmente los archivos JavaScript dependientes del idioma.
Para ello, como administrador, accede a la siguiente dirección. Sustituye el dominio de ejemplo por la dirección de tu CMS:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpA través de esta llamada, puedes regenerar los archivos JavaScript independientemente de guardar una configuración de módulo.
3. Configuración global del módulo
La configuración global del módulo se encuentra en:
bx_Mod/config_own.phpEste archivo contiene la configuración individual de tu proyecto. Se ajusta después de la instalación según las necesidades del usuario.
Aquí se establece, entre otras cosas, qué módulos y áreas deben utilizarse, como la tienda o el blog. Además, se tienen en cuenta los idiomas activados.
La configuración forma una base importante para la generación de los archivos JavaScript dependientes del idioma.
4. Configuraciones del módulo y archivos de idioma
Al generar, el CMS considera los archivos de configuración de los módulos respectivos. Esto incluye la configuración estándar, ajustes individuales y textos dependientes del idioma.
Tomando como ejemplo el módulo de la tienda, estos son:
bx_Mod/Shop/config.php
bx_Mod/Shop/config_own.php
bx_Mod/Shop/config_text_de.php
bx_Mod/Shop/config_text_de_own.phpLos archivos cumplen diferentes funciones:
config.php: Contiene la configuración estándar del módulo de la tienda.
config_own.php: Contiene tus ajustes de configuración individuales.
config_text_de.php: Contiene los textos estándar en alemán del módulo de la tienda.
config_text_de_own.php: Contiene tus ajustes individuales de los textos en alemán.
Para otros idiomas activados, se tienen en cuenta los archivos de idioma correspondientes.
Intenta no modificar directamente los archivos estándar. Utiliza los archivos _own destinados para los ajustes individuales, de modo que tus cambios se mantengan durante las actualizaciones normales del CMS.
5. JavaScript estándar y adaptaciones propias
Los archivos JavaScript generales se encuentran en la carpeta del desarrollador bx_script.
Para las funciones JavaScript centrales, se consideran los siguientes archivos:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js es el archivo estándar del CMS bluetronix. Puede ser sobrescrito durante actualizaciones del sistema.
Los archivos BxScript_own.js y BxScript_own_min.js están destinados para ajustes individuales.
Estos archivos pueden ser considerados al generar los archivos JavaScript dependientes del idioma.
6. JavaScript de cabecera y adaptaciones propias
Además de los archivos JavaScript generales, hay archivos separados para el encabezado de tu página web.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js contiene las funciones de JavaScript del encabezado proporcionadas por el CMS. Este archivo estándar puede ser sobrescrito durante una actualización del sistema.
Para tus propios ajustes, tienes disponibles BxHeadScript_own.js y BxHeadScript_own_min.js.
También se generan las versiones dependientes del idioma a partir de estos archivos.
7. Archivos JavaScript generados
A partir de los archivos de configuración, idioma y JavaScript existentes, el CMS genera archivos separados para cada idioma activado.
Por ejemplo, se generan los siguientes archivos JavaScript generales:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsAdicionalmente, se crean los correspondientes archivos de JavaScript del encabezado:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsLos códigos de idioma indican el respectivo idioma. Por ejemplo, de significa alemán, en inglés, ru ruso y es español.
El CMS solo genera los archivos para los idiomas que están realmente activados.
8. Optimización de los archivos JavaScript generados
Durante la generación, los archivos JavaScript se optimizan adicionalmente. Así se pueden eliminar comentarios innecesarios y espacios en blanco superfluos.
La optimización simple incluye los siguientes pasos:
1. Las líneas que empiezan con // se eliminan.
2. Las líneas que contienen exclusivamente espacios en blanco se eliminan.
3. Varios espacios pueden ser reemplazados por un solo espacio.
No es estrictamente necesario realizar una minificación completa en este momento.
La optimización reduce contenidos innecesarios dentro de los archivos JavaScript generados.
9. Incluir automáticamente archivos JavaScript dependientes del idioma
El CMS bluetronix verifica al generar tu página web si existe un archivo JavaScript correspondiente para el idioma seleccionado actualmente.
En el layout HTML, por ejemplo, el archivo JavaScript general puede estar incluido a través de la siguiente etiqueta CMS:
__FV_/bx_script/BxScript_own_min.js__Si el visitante accede a la versión en alemán de tu página web y el archivo de idioma correspondiente está disponible, el CMS reemplaza automáticamente la etiqueta por:
__FV_/bx_script/BxScript_de.js__El mismo principio se aplica al archivo JavaScript del encabezado.
De:
__FV_/bx_script/BxHeadScript_own_min.js__se convierte, por ejemplo, en:
__FV_/bx_script/BxHeadScript_de.js__La inclusión HTML existente no necesita ser ajustada individualmente para cada idioma.
Si no hay un archivo de idioma adecuado, el archivo JavaScript general permanece incluido.
10. Actualizar cache del navegador mediante la fecha de modificación del archivo
Para que los navegadores no sigan cargando un archivo JavaScript obsoleto del caché tras un cambio, el CMS puede utilizar adicionalmente la fecha de modificación del archivo respectivo.
El archivo JavaScript incluido recibe un parámetro de versión.
Ejemplo:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMSi el archivo cambia, el parámetro de versión también puede cambiar. De esta manera, el navegador reconoce la versión del archivo modificada y puede recargarla.
Este procedimiento puede aplicarse tanto a los archivos JavaScript generales como a los archivos JavaScript del encabezado.
11. Resumen
El CMS bluetronix crea automáticamente archivos JavaScript separados para cada idioma activado de tu página web.
La generación ocurre al guardar cada configuración de módulo. Además, puedes iniciarla manualmente a través de bx_Mod/BxScript.php.
En la creación se tienen en cuenta la configuración de módulo global, los archivos de configuración y de idioma de los módulos, así como los archivos JavaScript estándar y propios.
En el layout, el CMS reconoce automáticamente si hay un archivo de idioma adecuado disponible y lo incluye en lugar del archivo JavaScript general.
Para personalizaciones individuales, utiliza siempre los archivos _own previstos, para que tus cambios se conserven durante las actualizaciones normales del sistema.
Preguntas Frecuentes
lo que los clientes nos preguntan con frecuencia
¿Cuándo se generan los archivos JavaScript dependientes del idioma?
El CMS bluetronix genera los archivos automáticamente tan pronto como guardas una configuración de módulo. Los archivos JavaScript se recrean para todos los idiomas activados.
¿Cómo puedo volver a generar los archivos JavaScript manualmente?
Accede como administrador a la dirección https://xxxx.bxserver.net/bx_Mod/BxScript.php. Reemplaza el dominio de ejemplo con la dirección de tu CMS.
¿Se generan archivos JavaScript para todos los idiomas disponibles?
No. El CMS crea exclusivamente las versiones de idioma que has activado a través del módulo Lang. Las configuraciones correspondientes se establecen en bx_Mod/config_own.php.
¿Se modifican los archivos JavaScript al cambiar el conjunto de colores o el diseño?
No. El conjunto de colores o el diseño ya no modifican los archivos JavaScript. La regeneración automática se produce al guardar una configuración del módulo.
¿Qué archivos puedo personalizar?
Para ajustes individuales de JavaScript, tienes disponibles entre otros BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js y BxHeadScript_own_min.js. También los módulos tienen sus propios archivos de configuración y de idioma marcados con _own.
¿Qué pasa con los archivos JavaScript estándar al actualizar el CMS?
Los archivos estándar BxScript.js y BxHeadScript.js pueden ser sobrescritos durante las actualizaciones del sistema. Por eso, debes guardar tus propios cambios únicamente en los archivos _own correspondientes.
¿Cómo reconoce el CMS qué archivo JavaScript debe incluirse?
El CMS verifica al generar la página web si existe un archivo JavaScript correspondiente para el idioma seleccionado actualmente. Si por ejemplo existe BxScript_de.js, se incluirá este para la versión en alemán en lugar del archivo general.
¿Cómo evito que los visitantes carguen archivos JavaScript obsoletos desde la caché del navegador?
El CMS puede utilizar la fecha de modificación del archivo como parámetro de versión al incluir los archivos JavaScript. De este modo, el navegador puede cargar la nueva versión del archivo después de un cambio.