CMSモジュール用の言語依存JavaScriptファイルを作成する
bluetronix CMSは、あなたのウェブサイトの各有効化された言語用に自動的に最適化されたJavaScriptファイルを生成します。標準ファイル、個別のカスタマイズ、および言語依存のモジュールテキストがどのように統合され、CMSが適切なファイルを自動的にウェブサイトに組み込むかを学びます。
言語依存のJavaScriptファイル
bluetronix CMSは、ウェブサイトの各アクティブ言語に対して独自のJavaScriptファイルを生成できます。これにより、言語依存のテキストと機能がそれぞれのJavaScriptファイル内で直接利用可能になります。
必要なファイルは、モジュール設定を保存すると自動的に作成されます。この際、CMSは標準ファイルとあなたの個別のカスタマイズの両方を考慮します。
このチュートリアルは、「CMSモジュールを組み込んでカスタマイズする」というドキュメントに基づいています。すでに開発者フォルダーbx_Modと独自の_ownファイルの使用に慣れている必要があります。
1. JavaScriptファイルの自動生成
モジュール設定を保存すると、CMSは必要な言語依存のJavaScriptファイルを自動的に再生成します。
モジュールLangで有効にした言語バージョンのみを生成します。
有効な言語は、グローバルモジュール設定によって決定されます：
bx_Mod/config_own.phpたとえば、ドイツ語、英語、スペイン語を有効にした場合、CMSはこれら3つの言語の対応するJavaScriptファイルを生成します。
カラーパレットやレイアウトの変更は、もはやJavaScriptファイルに影響を与えません。自動再生成はモジュール設定を保存した際に行われます。
2. JavaScriptファイルを手動で生成する
自動生成に加えて、言語依存のJavaScriptファイルを手動で生成することもできます。
そのためには、管理者として次のアドレスにアクセスしてください。サンプルドメインをあなたのCMSのアドレスに置き換えてください：
https://xxxx.bxserver.net/bx_Mod/BxScript.phpこの呼び出しを使用すると、モジュール設定を保存せずにJavaScriptファイルを再生成できます。
3. グローバルモジュール設定
グローバルモジュール設定は以下の場所にあります：
bx_Mod/config_own.phpこのファイルには、プロジェクトの個別設定が含まれています。インストール後、ユーザーの要求に応じて設定されます。
ここでは、使用するモジュールや領域（たとえば、ショップやブログ）を設定します。また、有効な言語も考慮されます。
この設定は、言語依存のJavaScriptファイルを生成するための重要な基盤を形成します。
4. モジュール設定と言語ファイル
生成時にCMSは、各モジュールの設定ファイルを考慮します。これには、標準設定、個別のカスタマイズ、言語依存のテキストが含まれます。
ショップモジュールの例では、以下の通りです:
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.phpファイルは異なる役割を果たします:
config.php: ショップモジュールの標準設定を含んでいます。
config_own.php: あなたの個別の設定内容を含んでいます。
config_text_de.php: ショップモジュールの標準的なドイツ語テキストを含んでいます。
config_text_de_own.php: あなたの個別のドイツ語テキストのカスタマイズを含んでいます。
有効化された他の言語についても、対応する言語ファイルが考慮されます。
標準ファイルをできるだけ直接変更しないでください。個々のカスタマイズには指定された_ownファイルを使用し、通常のCMSアップデート時に変更が保持されるようにしてください。
5. 標準JavaScriptと独自のカスタマイズ
一般的なJavaScriptファイルは、開発者フォルダbx_script内にあります。
中央のJavaScript機能には、以下のファイルが考慮されます:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.jsはbluetronix CMSの標準ファイルです。システムアップデート時に上書きされる可能性があります。
ファイルBxScript_own.jsとBxScript_own_min.jsは、個別のカスタマイズ用に用意されています。
これらのファイルは、言語依存のJavaScriptファイルを生成する際に考慮することができます。
6. ヘッダーJavaScriptと独自のカスタマイズ
一般的なJavaScriptファイルに加え、あなたのウェブサイトのヘッダー用の別のファイルも存在します。
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.jsはCMSが提供するヘッダーJavaScript機能を含んでいます。この標準ファイルはシステムアップデート時に上書きされる可能性があります。
個別のカスタマイズにはBxHeadScript_own.jsとBxHeadScript_own_min.jsを使用できます。
これらのファイルからも対応する言語依存のバージョンが生成されます。
7. 生成されたJavaScriptファイル
既存の設定、言語、およびJavaScriptファイルから、CMSは有効化された言語ごとに別々のファイルを生成します。
例えば、以下の一般的なJavaScriptファイルが生成されます:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsさらに、対応するヘッダーJavaScriptファイルも作成されます:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.js言語の略称はそれぞれの言語を示します。例えば、deはドイツ語、enは英語、ruはロシア語、esはスペイン語を表します。
CMSは実際に有効化された言語のファイルのみを生成します。
8. 生成されたJavaScriptファイルの最適化
生成中に、JavaScriptファイルはさらに最適化されます。その結果、不要なコメントや余分な空白が削除されることがあります。
簡単な最適化には以下のステップが含まれます:
1. //で始まる行は削除されます.
2. 空白文字のみを含む行は削除されます.
3. 複数の空白は1つの空白に置き換えられます.
完全なミニファイは現在必須ではありません.
最適化は生成されたJavaScriptファイル内の不要な内容を削減します.
9. 言語依存のJavaScriptファイルを自動的に組み込む
bluetronix CMSはウェブサイトを生成する際、現在選択されている言語に対応するJavaScriptファイルが存在するかを確認します.
HTMLレイアウトでは、一般的なJavaScriptファイルが以下のCMSマークアップで埋め込まれている場合があります:
__FV_/bx_script/BxScript_own_min.js__訪問者があなたのウェブサイトのドイツ語版を呼び出し、対応する言語ファイルが存在する場合、CMSは自動的にマークアップを以下のように置き換えます:
__FV_/bx_script/BxScript_de.js__同じ原則がヘッダーJavaScriptファイルにも適用されます.
例えば：
__FV_/bx_script/BxHeadScript_own_min.js__次のように：
__FV_/bx_script/BxHeadScript_de.js__既存のHTML埋め込みは、各言語ごとに個別に調整する必要はありません.
適切な言語ファイルが存在しない場合は、一般的なJavaScriptファイルが埋め込まれたままになります.
10. ファイル変更日時でブラウザキャッシュを更新
ブラウザが変更後も古いJavaScriptファイルをキャッシュから読み込まないようにするために、CMSは追加で各ファイルの変更日を使用できます.
埋め込まれたJavaScriptファイルにはバージョンパラメータが付与されます.
例:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMファイルが変更されると、バージョンパラメータも変化する可能性があります。これにより、ブラウザは変更されたファイルバージョンを認識し、新たに読み込むことができます.
この手法は、一般的なJavaScriptファイルやヘッダーJavaScriptファイルの両方に使用できます.
11. 概要
bluetronix CMSは、あなたのウェブサイトの各有効言語に対して自動的に個別のJavaScriptファイルを作成します.
作成はモジュール設定を保存するたびに行われます。さらに、bx_Mod/BxScript.phpを介して手動で開始することもできます.
作成時には、グローバルモジュール設定、モジュールの設定ファイルと言語ファイル、標準及び独自のJavaScriptファイルが考慮されます.
レイアウトでは、CMSが自動的に適切な言語ファイルが存在するかを認識し、一般的なJavaScriptファイルの代わりにこれを埋め込みます.
個別のカスタマイズには基本的に指定された_ownファイルを使用してください。これにより、通常のシステムアップデート時に変更が保持されます.
FAQ
お客様からよくある質問
言語依存のJavaScriptファイルはいつ生成されますか?
bluetronix CMSは、モジュール設定を保存するたびに自動的にファイルを生成します。この際、すべての有効な言語のJavaScriptファイルが再作成されます.
JavaScriptファイルを手動で再生成するにはどうすればよいですか?
管理者としてアドレスhttps://xxxx.bxserver.net/bx_Mod/BxScript.phpにアクセスしてください。この際、サンプルドメインをあなたのCMSのアドレスに置き換えてください.
すべての利用可能な言語のためにJavaScriptファイルは生成されますか？
いいえ。CMSは、Langモジュールで有効にした言語バージョンのみを生成します。適切な設定はbx_Mod/config_own.phpで行います。
カラースキームやレイアウトを変更した場合、JavaScriptファイルは変更されますか？
いいえ。カラースキームやレイアウトによってJavaScriptファイルは変更されません。自動再生成はモジュール設定を保存する際に行われます。
どのファイルを個別にカスタマイズできますか？
個別のJavaScriptカスタマイズには、BxScript_own.js、BxScript_own_min.js、BxHeadScript_own.js、BxHeadScript_own_min.jsなどが利用可能です。また、モジュールには_ownというラベルの付いた独自の設定ファイルと翻訳ファイルもあります。
CMSアップデート時に標準JavaScriptファイルはどうなりますか？
標準ファイルBxScript.jsとBxHeadScript.jsはシステムアップデートで上書きされる可能性があります。そのため、独自の変更は必ず指定された_ownファイルに保存してください。
CMSはどのJavaScriptファイルを読み込む必要があるかどうやって認識しますか？
CMSはウェブサイトを生成する際、現在選択されている言語に対応するJavaScriptファイルが存在するかどうかをチェックします。例えばBxScript_de.jsが存在すれば、一般ファイルの代わりにドイツ語バージョン用としてこれを読み込みます。
訪問者が古いJavaScriptファイルをブラウザキャッシュから読み込まないようにするにはどうすればいいですか？
CMSはJavaScriptファイルを読み込む際、ファイルの変更日付をバージョンパラメータとして使用できます。これにより、ブラウザは変更後に新しいファイルバージョンを読み込むことができます。