Documentation

標準言語ファイルの上書き方法

Liferay DXP/Portalでは、言語ファイルを使用して、デフォルトロケールと他の多くのロケールの見出し、ラベル、およびメッセージを実装します。 モジュール内の新しい言語ファイル値を使用して、任意のロケールのこれらの翻訳をオーバーライドできます。

注釈

言語翻訳をオーバーライドするには、Language Override toolを使用することをお勧めします。 このツールは、Liferay DXP 7.4 U4 (Update 4)以上、またはLiferay Portal 7.4 GA8以上で使用できます。 以前の方法を続けて読んでください。

標準言語ファイルの検証

標準言語ファイルは、ソースコードとDXP/Portalバンドルに含まれています。

ソースの場合:

バンドルの場合:

  • portal-impl.jar#content/Language[_xx_XX].properties

  • Liferay Foundation - Liferay Portal Language - Impl.lpkgcom.liferay.portal.language.lang-[version].jar#content/Language[_xx_XX].properties

さまざまな言語とロケールの言語ファイルは、ファイル名の末尾で識別できます。 たとえば、Language_ja.propertiesは日本語用です。

これらの言語ファイルには、言語設定プロパティなど、オーバーライドできるプロパティが含まれています。

...
lang.user.name.field.names=prefix,first-name,middle-name,last-name,suffix
lang.user.name.prefix.values=Dr,Mr,Ms,Mrs
lang.user.name.required.field.names=last-name
lang.user.name.suffix.values=II,III,IV,Jr,Phd,Sr
...

メッセージやラベル用にオーバーライドできる単純な翻訳もたくさんあります。

category.admin=Admin
category.alfresco=Alfresco
category.christianity=Christianity
category.cms=Content Management
...

プログラムによる言語ファイルのオーバーライド

Liferay DXP/Portal 7.4+では、メタデータを使用してオーバーライドを宣言できます。 以前のバージョンでは、Javaクラスがオーバーライドを宣言します。

お使いのバージョンが7.4より前の場合は、 以前のバージョンでのオーバーライド に進んでください。 それ以外の場合は、読み進めてください。

サンプルをデプロイする(7.4以降の場合)

この例では、home言語ファイル設定を次のように変更します。

新しいLiferay インスタンスを起動し、以下を実行します。

docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.29-ga29。

http://localhost:8080でLiferayへのサインインします。 メールアドレス_test@liferay.com_とパスワード_test_を使用してください。 プロンプトが表示されたら、パスワードを _learn_に変更します。

次に、以下の手順でサンプルをデプロイします。

  1. Download and unzip the liferay-i2f4.zip example project.

    curl https://learn.liferay.com/dxp/latest/ja/liferay-internals/extending-liferay/liferay-i2f4.zip -O
    
    unzip liferay-i2f4.zip
    
  2. プロジェクトモジュールをビルドしてデプロイします。

    cd liferay-i2f4
    
    ./gradlew deploy -Ddeploy.docker.container.id=$(docker ps -lq)
    

    注釈

    このコマンドは、デプロイされたjarをDockerコンテナの/opt/liferay/osgi/modulesにコピーするのと同じです。

  3. Liferay Dockerコンテナコンソールでデプロイを確認します。

    STARTED com.acme.i2f4.impl_1.0.0 [3209]
    
  4. サンプルモジュールのカスタマイゼーションを確認します。 ブラウザでhttps://localhost:8080を開きます。

  5. メニューアイコン(Menu)をクリックします。 ホームアイコンラベルには、カスタム言語ファイル値が使用されています。

    ホームアイコンには、カスタム言語ファイル値が使用されています。

  6. この例には、複数のロケールのカスタム言語ファイル値が含まれています。 たとえば、言語セレクターでブラジルのポルトガル語または日本語を選択すると、そのロケールでのカスタマイゼーションが表示されます。 モジュールは、これらのロケールの言語ファイルもオーバーライドします。

    カスタム言語ファイルは、ブラジルポルトガル語と日本語にも使用されます。

例を見たところで、次にこれがどのように機能するかを確認していきます。

言語プロパティファイルを作成する

オーバーライドしたい翻訳ファイルを選択します。 サンプルモジュールは、home言語ファイルをオーバーライドします。

重要

宣言する言語ファイルの値は、それらの既存の言語ファイルの値をオーバーライドします。 他のすべての既存の言語ファイル設定は保持されます。

オーバーライドする言語ファイルを決定したら、モジュールのsrc/main/resources/contentフォルダに言語プロパティファイルを作成します。 ファイル名Language.propertiesを使用して、デフォルトのロケールの言語ファイルをオーバーライドします。 特定のロケールの言語ファイルをオーバーライドするには、言語プロパティのファイル命名規則を使用します。

Language[_xx_XX].properties

たとえば、日本語を上書きする場合は、Language_ja.propertiesを使用します。

Bndファイルでオーバーライドを宣言する

モジュールのbnd.bndファイルで、言語リソースプロバイダーの機能を指定します。 サンプルのProvide-Capabilityヘッダーは次のとおりです。

Provide-Capability:\
	liferay.language.resources;\
		resource.bundle.base.name="content.Language"

注釈

この例では、サービスのランキングを省略しており、OSGiのデフォルトのランキング 0を使用しています。これは、デフォルトのグローバルリソースバンドルサービスのランキング -1よりも高くなっています。

標準言語ファイルのオーバーライドは、同じモジュール内にあるほうが管理が簡単です。

複数のモジュールを使用して標準言語ファイルをオーバーライドすることはお勧めしませんが、複数のモジュールで同じ言語ファイルをオーバーライドすると、サービスランキングが最も高い言語リソースプロバイダーが優先されます。

たとえば、モジュールの言語ファイルがサービスランキング1のプロバイダーの言語ファイルよりも優先されるようにする場合は、ランキングを2以上に設定します。

Provide-Capability:\
    liferay.language.resources;\
        resource.bundle.base.name="content.Language";\
        service.ranking:Long="2"

モジュールをデプロイして、新しい言語ファイル値を確認します。

以前のバージョンでのオーバーライド

7.4より前のLiferay DXP/Portalバージョンでは、標準言語ファイルをオーバーライドするには、カスタマイズする翻訳ごとに 言語プロパティファイルjava.util.ResourceBundleが必要です。 次の例をデプロイしてそのコードを調べることにより、詳細を確認してください。

注釈

言語ファイルの多くは標準言語ファイルにありますが、特定のアプリケーションモジュールにある場合もあります。 overriding module language translation in earlier versionsのプロセスは、標準ファイルをオーバーライドするプロセスとは異なります。

以前のバージョンの例をデプロイする

この例では、publish言語ファイル設定を次のように変更します。

サンプルをデプロイする方法は次のとおりです。

  1. liferay-x8f3.zip サンプルプロジェクトをダウンロードし、解凍します。

    curl https://learn.liferay.com/dxp/latest/ja/liferay-internals/extending-liferay/liferay-x8f3.zip -O
    
    unzip liferay-x8f3.zip
    
  2. プロジェクトモジュールをビルドしてデプロイします。

    cd liferay-x8f3
    
    ./gradlew deploy -Ddeploy.docker.container.id=$(docker ps -lq)
    
  3. Liferay Dockerコンテナコンソールでデプロイを確認します。

    STARTED com.acme.x8f3.impl_1.0.0 [3209]
    
  4. ブラウザで https://localhost:8080 を開き、サインインしてください。

  5. サイトページに移動し、編集アイコンをクリックします(Edit)。 公開ボタンに、カスタム言語ファイルが表示されます。

    公開ボタンには、カスタム言語ファイルが使用されています。

  6. 言語セレクターを使用してブラジルのポルトガル語または日本語を選択すると、カスタム言語ファイルが表示されます。 モジュールは、モジュールに含める各ロケールの言語ファイルをオーバーライドします。

    カスタム言語ファイルは、ブラジルポルトガル語と日本語にも使用されます。

7.4以降の例と同様に、このモジュールは言語ファイルの変更値を指定します。 ただし、メタデータ(bnd.bndファイルヘッダー)を使用してオーバーライドを宣言する代わりに、モジュールはResourceBundleクラスを使用します。

リソースバンドルクラスを作成する

オーバーライドする各ロケールには、java.util.ResourceBundleを拡張するクラスが必要です。 en_USロケールのリソースバンドルクラスの例を次に示します。

@Component(property = "language.id=en_US", service = ResourceBundle.class)
public class X8F3EnglishResourceBundle extends ResourceBundle {

	@Override
	public Enumeration<String> getKeys() {
		return _resourceBundle.getKeys();
	}

	@Override
	protected Object handleGetObject(String key) {
		return _resourceBundle.getObject(key);
	}

	private final ResourceBundle _resourceBundle = ResourceBundle.getBundle(
		"content.Language_en_US", UTF8Control.INSTANCE);

}

クラスの_resourceBundleフィールドにはResourceBundleが割り当てられます。 ResourceBundle.getBundleの呼び出しには、2つのパラメーターが必要です。 content.Language_en_USパラメーターは、モジュールのsrc/main/resources/contentフォルダに対する言語ファイルの修飾名です。 2番目のパラメーターは、リソースバンドルの言語構文を設定するcontrolです。 Liferayの構文と同じ言語構文を使用するには、Liferayのcom.liferay.portal.kernel.language.UTF8Controlクラスをインポートし、2番目のパラメーターをUTF8Control.INSTANCEに設定します。

クラスの@Componentアノテーションは、それをOSGi ResourceBundle サービスコンポーネントとして宣言します。 そのlanguage.idプロパティは、en_USロケール用にそれを指定します。

@Component(property = "language.id=en_US", service = ResourceBundle.class)

クラスは次のメソッドをオーバーライドします。

handleGetObject モジュールのリソースバンドル(モジュールの言語プロパティファイルに基づく)で言語ファイルを検索し、キーの値をObjectとして返します。

getKeys リソースバンドルのキーのEnumerationを返します。

リソースバンドルサービスコンポーネントは、デフォルトの言語ファイルをモジュールの言語ファイルオーバーライドにリダイレクトします。

複数のロケールの標準言語ファイルをオーバーライドするには、ロケールごとに個別のリソースバンドルクラスが必要です。 たとえば、チュートリアルコードには、ブラジルのポルトガル語、英語、および日本語用のクラスがあります。 各リソースバンドルは、language.idコンポーネントのプロパティ定義と言語ファイルの修飾名パラメーターでロケールを指定する必要があります。 たとえば、日本語ロケールでは次のようになります。

コンポーネント定義:

@Component(property = "language.id=ja", service = ResourceBundle.class)

リソースバンドルの割り当て:

private final ResourceBundle _resourceBundle = ResourceBundle.getBundle(
	"content.Language_ja", UTF8Control.INSTANCE);

モジュールをデプロイして、新しい言語ファイル値を確認します。

注釈

DXP 7.4以降にアップグレードする準備ができたら、言語ファイルオーバーライドモジュールを引き続き使用できます。 オプションとして、 above で示すように、ResourceBundle クラスを削除し、Provide-Capability ヘッダーを bnd.bnd ファイルで指定することで、モジュールを簡素化することができます。