Criar arquivos JavaScript dependentes de idioma para módulos CMS
O bluetronix CMS gera automaticamente arquivos JavaScript otimizados para cada idioma ativado do seu site. Você vai aprender como arquivos padrão, personalizações individuais e textos de módulos dependentes de idioma são combinados e como o CMS incorpora automaticamente os arquivos adequados ao seu site.
Arquivos JavaScript dependentes de idioma
O CMS bluetronix pode gerar arquivos JavaScript próprios para cada idioma ativado do seu site. Isso torna textos e funções dependentes de idioma diretamente disponíveis dentro do respectivo arquivo JavaScript.
Os arquivos necessários são gerados automaticamente assim que você salva uma configuração de módulo. O CMS leva em consideração tanto os arquivos padrão quanto suas personalizações individuais.
Este tutorial baseia-se na documentação "Integrar e Personalizar Módulos CMS". Você deve já estar familiarizado com a pasta do desenvolvedor bx_Mod e o uso de arquivos _own.
1. Geração automática dos arquivos JavaScript
Quando você salva uma configuração de módulo, o CMS gera automaticamente todos os arquivos JavaScript dependentes de idioma necessários novamente.
Somente as versões linguísticas que você ativou através do módulo Lang são criadas.
As línguas ativadas são definidas na configuração global do módulo:
bx_Mod/config_own.phpSe você ativou alemão, inglês e espanhol, o CMS gera arquivos JavaScript correspondentes para esses três idiomas.
Uma mudança no conjunto de cores ou layout não altera mais os arquivos JavaScript. A nova geração automática ocorre ao salvar uma configuração de módulo.
2. Gerar arquivos JavaScript manualmente
Além da geração automática, você pode optar por criar manualmente os arquivos JavaScript dependentes de idioma.
Para isso, como administrador, acesse o seguinte endereço. Substitua o domínio de exemplo pelo endereço do seu CMS:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpCom essa chamada, você pode gerar os arquivos JavaScript independentemente do salvamento de uma configuração de módulo.
3. Configuração global do módulo
A configuração global do módulo está localizada em:
bx_Mod/config_own.phpEste arquivo contém as configurações individuais do seu projeto. Ele é configurado após a instalação de acordo com os requisitos do usuário.
Aqui são definidas, entre outras coisas, quais módulos e áreas devem ser usados, como loja ou blog. Além disso, são consideradas as línguas ativadas.
A configuração, portanto, forma uma base importante para a geração dos arquivos JavaScript dependentes de idioma.
4. Configurações de módulo e arquivos de idioma
Na geração, o CMS leva em conta os arquivos de configuração dos respectivos módulos. Isso inclui a configuração padrão, personalizações individuais e textos dependentes de idioma.
Tomando como exemplo o módulo da loja, são estes:
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.phpOs arquivos atendem a diferentes funções:
config.php: Contém a configuração padrão do módulo da loja.
config_own.php: Contém suas configurações individuais.
config_text_de.php: Contém os textos padrão em alemão do módulo da loja.
config_text_de_own.php: Contém suas personalizações dos textos em alemão.
Para outras línguas ativadas, os arquivos de linguagem correspondentes são considerados.
Tente não alterar os arquivos padrão diretamente. Use os arquivos _own para personalizações individuais, para que suas alterações sejam mantidas nas atualizações normais do CMS.
5. JavaScript padrão e personalizações próprias
Os arquivos JavaScript gerais estão na pasta do desenvolvedor bx_script.
Os seguintes arquivos são considerados para as funções centrais do JavaScript:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js é o arquivo padrão do CMS bluetronix. Ele pode ser substituído em atualizações do sistema.
Os arquivos BxScript_own.js e BxScript_own_min.js são destinados a ajustes individuais.
Esses arquivos podem ser considerados na geração dos arquivos JavaScript dependentes do idioma.
6. JavaScript de cabeçalho e personalizações próprias
Além dos arquivos JavaScript gerais, existem arquivos separados para o cabeçalho do seu site.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js contém as funções JavaScript do cabeçalho fornecidas pelo CMS. Este arquivo padrão pode ser substituído em uma atualização do sistema.
Para ajustes pessoais, você tem disponível BxHeadScript_own.js e BxHeadScript_own_min.js.
Versões correspondentes dependentes do idioma também são geradas a partir desses arquivos.
7. Arquivos JavaScript gerados
O CMS gera arquivos separados para cada idioma ativado a partir dos arquivos de configuração, idioma e JavaScript disponíveis.
Por exemplo, os seguintes arquivos JavaScript gerais são criados:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsAlém disso, os arquivos JavaScript do cabeçalho correspondentes são gerados:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsOs códigos de idioma indicam o respectivo idioma. Por exemplo, de significa alemão, en significa inglês, ru significa russo e es significa espanhol.
O CMS gera apenas os arquivos para os idiomas que estão realmente ativados.
8. Otimização dos arquivos JavaScript gerados
Durante a geração, os arquivos JavaScript são também otimizados. Isso permite a remoção de comentários desnecessários e espaços em branco excessivos.
A otimização básica inclui os seguintes passos:
1. Linhas que começam com // são removidas.
2. Linhas que contêm apenas espaços em branco são removidas.
3. Vários espaços em branco podem ser substituídos por um único espaço.
Atualmente, uma minificação completa não é estritamente necessária.
A otimização reduz conteúdos desnecessários dentro dos arquivos JavaScript gerados.
9. Incorporar arquivos JavaScript dependentes de idioma automaticamente
O CMS bluetronix verifica ao gerar seu site se há um arquivo JavaScript correspondente para o idioma atualmente selecionado.
No layout HTML, por exemplo, o arquivo JavaScript geral pode estar incluído através da seguinte marcação do CMS:
__FV_/bx_script/BxScript_own_min.js__Se o visitante acessar a versão em alemão do seu site e o arquivo de idioma correspondente estiver disponível, o CMS substituirá automaticamente a marcação por:
__FV_/bx_script/BxScript_de.js__O mesmo princípio se aplica ao arquivo JavaScript do cabeçalho.
De:
__FV_/bx_script/BxHeadScript_own_min.js__torna-se por exemplo:
__FV_/bx_script/BxHeadScript_de.js__A inclusão HTML existente não precisa ser ajustada individualmente para cada idioma.
Se não houver um arquivo de idioma apropriado, o arquivo geral de JavaScript permanece vinculado.
10. Atualizar o cache do navegador pela data de modificação do arquivo
Para que os navegadores não carreguem um arquivo de JavaScript desatualizado do cache após uma alteração, o CMS pode usar a data de modificação do respectivo arquivo.
O arquivo de JavaScript vinculado recebe um parâmetro de versão.
Exemplo:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMSe o arquivo mudar, o parâmetro de versão pode também mudar. Assim, o navegador reconhece a nova versão do arquivo e pode recarregá-la.
Esse método pode ser usado tanto para os arquivos gerais de JavaScript quanto para os arquivos de JavaScript de cabeçalho.
11. Resumo
O CMS bluetronix cria automaticamente arquivos de JavaScript separados para cada idioma ativado do seu site.
A geração ocorre a cada vez que uma configuração de módulo é salva. Além disso, você pode iniciá-la manualmente através de bx_Mod/BxScript.php.
Na criação, são levadas em consideração as configurações globais do módulo, os arquivos de configuração e de idioma dos módulos, bem como os arquivos de JavaScript padrão e personalizados.
No layout, o CMS reconhece automaticamente se existe um arquivo de idioma apropriado e o vincula em vez do arquivo geral de JavaScript.
Use sempre os arquivos _own designados para adaptações individuais, para que suas alterações sejam mantidas em atualizações normais do sistema.
FAQ
o que os clientes nos perguntam frequentemente
Quando os arquivos de JavaScript dependentes do idioma são gerados?
O CMS bluetronix gera os arquivos automaticamente assim que você salva uma configuração de módulo. Os arquivos de JavaScript são recriados para todos os idiomas ativados.
Como posso regenerar manualmente os arquivos de JavaScript?
Como administrador, acesse o endereço https://xxxx.bxserver.net/bx_Mod/BxScript.php. Substitua o domínio de exemplo pelo endereço do seu CMS.
Os arquivos de JavaScript são gerados para todas as línguas disponíveis?
Não. O CMS cria apenas as versões de idioma que você ativou através do módulo Lang. As configurações correspondentes são definidas em bx_Mod/config_own.php.
Os arquivos de JavaScript são alterados ao mudar o conjunto de cores ou layout?
Não. O conjunto de cores ou layout não altera mais os arquivos de JavaScript. A regeneração automática ocorre ao salvar uma configuração de módulo.
Quais arquivos posso personalizar?
Para ajustes individuais de JavaScript, você pode utilizar entre outros BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js e BxHeadScript_own_min.js. Os módulos também possuem seus próprios arquivos de configuração e de idioma com a marcação _own.
O que acontece com os arquivos de JavaScript padrão durante uma atualização do CMS?
Os arquivos padrão BxScript.js e BxHeadScript.js podem ser sobrescritos durante atualizações do sistema. Portanto, você deve salvar suas próprias alterações exclusivamente nos arquivos _own designados.
Como o CMS reconhece qual arquivo de JavaScript deve ser vinculado?
O CMS verifica ao gerar a página se há um arquivo correspondente de JavaScript para o idioma atualmente selecionado. Por exemplo, se BxScript_de.js existir, este será vinculado para a versão em alemão em vez do arquivo geral.
Como evito que os visitantes carreguem arquivos de JavaScript desatualizados do cache do navegador?
O CMS pode usar a data de modificação do arquivo como parâmetro de versão ao incluir arquivos JavaScript. Isso permite que o navegador carregue a nova versão do arquivo após uma alteração.