phpList の国際化（日本語化）の仕組みと方法

各翻訳ファイルは、メールマガジンを簡単に発行できる phpList をインストールしてみた の設定例では、/var/www/ 配下に展開したので、
/var/www/phplist-3.0.5/public_html/lists/admin/locale/ja/phplist.po
の poファイル で翻訳します。（./ja/ : 日本語の場合 ）

もちろん日本語以外もそろってはいますが、翻訳率は日本はかなり低い(30%ぐらい)です。

通常は、何も気にせずログインすれば自動的に翻訳しれるはずです。

1. まず、phpListの管理画面へログインします。
   
   

   phpListをインストールしただけの状態であれば、最初に管理画面のログイン画面を表示すると以下のように英語表記されると思います。
   
   
   画面右のこの状態で日本語へ切り替えても何も翻訳されません。
   しかし、ログイン前にここを日本語に設定しておきます。
   
   
   ユーザ名 : admin (デフォルト)、パスワード : インストール時に設定したパスワード（初期化した場合は無し）
   を入力しContinueボタンをクリックし、ログインします。
   

   
   
2. ログイン後、日本語に自動的に翻訳されます。
   
   

   上記のように管理画面のホームへ遷移中に言語情報の初期化画面が表示され、 先に翻訳ファイルを読み込み各翻訳ワードをデータベースへ登録します。
   

   先の翻訳ファイルが更新されない限り、言語情報の初期化は実施されませんので、上記のような画面は各言語毎に１回だけです。
   もちろん、翻訳ファイルを更新した場合は、自動的にログイン もしくは 言語切替時に再読み込みが実施され、上記のような言語情報の初期化画面が表示されます。
   
   
   
   

   登録を終え、画面が表示されると片言ながら日本語に翻訳されていることがわかると思います。もちろん片言の翻訳は、先の翻訳ファイルでの翻訳が 30% 程度のできだからです。
   

   
   

非常に簡単です。
先にも書きましたが、翻訳ファイルが更新されれば、再度読み込み、データベースへの登録が実施されるので、 後でいくらでも翻訳をやり直すことはできます。

翻訳ファイルをアップロードして、管理者でログイン あるいは ログイン状態から言語切替を行うだけで自動的に再読み込みしてくれます。

...
msgid "Next"
msgstr "次へ"
...

ほとんどの場合は、テキストファイルの翻訳ファイル ( phplist.po )を編集し、アップロードすれば、翻訳してくれます。

ただ、どうしても翻訳情報を初期化したい場合があるかもしれません。その場合、データベースを直接変更すると良いでしょう。

# 各テーブル名のプレフィックスは、
# config.php で定義された $table_prefix = "phplist_"; になります。
#  何も指定していない場合は、"phplist_" がデフォルトとなります。
# ここでは、"phplist_" として以降解説します。
 
# 日本語 翻訳データを削除する。他の言語の場合は、lan='xx' を変更すればOK。
mysql> delete from phplist_i18n where lan='ja';
Query OK, 794 rows affected (0.00 sec)
 
# 日本語 翻訳データの最終更新日時を削除する。他の言語の場合は、item = 'lastlanguageupdate-xx' を変更すればOK。
# -- 以下の最終更新日時がpoファイルの更新日時より古い場合のみ再読み込みするようになっています。
mysql> delete from phplist_config where item='lastlanguageupdate-ja';
Query OK, 1 row affected (0.00 sec)

これでデータベースは、すべて初期化されます。
この状態で、ログインや言語切替を行えば、phpListがインストールされた状態と同じように 翻訳ファイル ( phplist.po )を読み込もうとします。

phpList は 一応 moファイルに対応しています。
ご存じの方も多いと思いますが、
そもそも、テキストファイルの翻訳ファイル ( phplist.po )を使っているので、 本来なら、poファイルからmoファイルを作成すれば、自動的に翻訳してくれてよさそうな感じです。

しかし、デフォルトの動作は、poファイルをデータベースへ登録し、翻訳情報をデータベースから常に読み込むようになっています。
データベースが存在しない場合、あるいは、データベースに翻訳した文言が存在しない場合は、moファイルから読み込む？みたいです。

それだけ回りくどいからか、うまく読み込めないこともしばしばで、特にパフォーマンスが不足気味の環境では、使い物になりませんでした。
どうしてか・・・正直、そこまで確認できていませんが、基本的に上記のようにデータベースで素直にやることをおすすめします。
どうしてもやりたい方、試してみたい方だけ、一応、以降に自分でやってみた環境について簡単に解説しておきます。

phpListは、デフォルト英語環境となっています。
日本語などの多言語（国際）化を図る場合、スクリプトが用意されています。
ここでの例では、
/var/www/phplist-3.0.5/scripts/generate-mo.sh
になります。

これを実行するだけですが、このスクリプトは、msgfmt コマンドを使用します。
まずは、msgfmt コマンドがインストールされているか確認し、インストールされていない場合は、gettext パッケージ をインストールします。
( msgfmt コマンドは、gettext パッケージ に含まれています。 )

# msgfmt コマンドがインストールされているか確認します。
$ which msgfmt

# msgfmt コマンドがインストールされていない場合は、インストールします。
# -- CentOS/Scientific Linuxの場合
$ yum install gettext
...

# -- Debian/Ubuntuの場合
$ aptitude install gettext
...

# phpListの国際化の環境設定を行います。
# phpListのルートディレクトリから実行しないといけません。
$ cd /var/www/phplist-3.0.5
# 国際化のスクリプトを実行します。
[phplist-3.0.5]$ ./scripts/generate-mo.sh
...

# 日本語の phplist.mo ファイルが作成できたか確認します。
$ ls /var/www/phplist-3.0.5/public_html/lists/admin/locale/ja/LC_MESSAGES/
LC_MESSAGES  language_info  pagetitles.php  phplist.mo  phplist.po

$ echo "ja_JP" > gettext_code

これで データベースの翻訳情報用のテーブル( phplist_i18n )は、削除してもOKのはずです。

mysql> drop table phplist_i18n;
Query OK, 794 rows affected (0.00 sec)

この状態で、管理者用のページを開いてみてください。

こんな感じで日本語が見えればOKです。