言語変数
最終更新
CS-Cart（通常版・マーケットプレイス版）やアドオンは、言語変数によって、国際化やローカライズが可能です。
あらゆる言語のテキストは、PHPコードやSmartyテンプレートファイルに直接記述されていません。言語の表示については、特別な関数が呼び出されます。言語変数のID（名前）が関数に渡され、ユーザーの環境に応じた言語でテキストが返されます。
CS-Cart（通常版・マーケットプレイス版）とそのアドオンの翻訳データは、POファイルに保存されます。各言語には、言語変数の値を格納する個別のPOファイルが必要です。
POファイルは一般的に広く使用されている形式です。 ローカライズに関連する多くのサービスは、POファイルをインポート・エクスポートできます。 たとえば、Crowdinを使用してCS-Cartを翻訳することが可能です。
POファイルは、CS-Cartをインストールしたディレクトリのvar/langs以下のディレクトリにあります。これらのファイルは専用のアプリケーション、または一般的なテキストエディターで編集することが可能です。
英語のPOファイル内の言語変数は次のようになります。
以下はフランス語のPOファイルです。同じ言語変数があります。
日本語では以下のようになります。
msgctxt - メッセージコンテキスト。CS-Cartやアドオンでは、このメッセージコンテキストを使用して、SmartyテンプレートとPHPコード（プレフィックスを除く）に表示される言語変数の名前を保存します。
POファイルには、文字列の翻訳、アドオンの名前と説明、さまざまな設定とセクションの名前が保存されます。そのため、異なるタイプのデータの翻訳には異なる接頭辞が付いています。PHPまたはTPLファイルに表示される言語変数の名前は「Languages::プレフィックス」で始まる必要があります。
msgid - 翻訳元の言語の言語変数の値です。ここには英語で値を指定することをお勧めします。
msgstr - 翻訳元のテキストからターゲット言語への翻訳です。翻訳元の言語のPOファイルでは、msgstrはmsgidと同じになります。
商品名や各種値など、変更可能なデータを言語変数に含める必要がある場合があります。この場合は、次のように角括弧で囲まれたプレースホルダーを使用します。
Smartyテンプレートでプレースホルダーがどのように使用されるかを確認してください。
多くの言語では、単数形と複数形が異なる場合があります。例えば、次の2つのフレーズを考えてみましょう。
(The delivery will take) 1 day.
(The delivery will take) 2 days.
異なるフォームで言語変数を作成する場合は、|記号を使用してmsgidおよびmsgstrの値を区切ります。また、番号に置き換えられる[n]プレースホルダーを追加します。2つの形式の言語変数の例を次に示します。
一部の言語（例えばロシア語など）には複数形が複数あります。 ターゲット言語に元の言語よりも複数形がある場合の例：
msgidは元の言語と同じままです。
msgstrには、ターゲット言語のすべての形式の説明があります。
以下はロシア語の言語変数です。一つの言語変数に2つの複数形があります。
複数の単語形式をリストにする場合、単数形が常に最初に記述されます。 さまざまな言語のフォームがリストされる順序は、言語の複数規則に準拠しています。
コア関数__は、言語変数の値を表示するためにPHPコード内で使用されます。
必須の引数は、言語変数の名前です。2番目の引数はプレースホルダーの値を渡します。3番目の引数ではターゲット言語を指定します。
📘
デフォルトでは、ターゲット言語はユーザーの（環境の）ロケールによって決定されます。
__関数の例:
__を使用して、言語変数をSmartyテンプレートに挿入できます。
文字列を中括弧で囲みます。以下のコードは、Smary内でhelloという言語変数を挿入する方法です。
このような文字列は、テンプレートのコンパイル中にSmartyラッパークラスの__メソッドが呼び出され、置き換えられます。次に、そのクラスは上記のコア関数を呼び出します。
以下は、テンプレート内で使用されたプレースホルダーを持つ言語変数の例です。
複数形の言語変数を使用する場合、__関数の2番目の[n]パラメーターでプレースホルダーの代わりに置換された数値を渡します。
渡された番号に応じて、適切なフォームが自動的に選択されます。 英語の場合の例：
0 days
1 day
3 days
POファイルを変更する以外にも言語変数を編集する方法があります。
[管理]パネルで、[一般設定] →[言語]→[`言語変数]**に移動します。
REST API経由でlangvarsエンティティを使用します。