PEAK XOOPS - D3モジュールと言語処理(1) 
XOOPS
XOOPS : D3モジュールと言語処理(1)
D3モジュールの言語処理ですが、基本的にはファイルベースのオーバーライドシステムを採用しています。
ただ、同じモジュールが複数読み込まれる可能性がある以上、言語定数の多重定義という問題が生じます。ここで大事なのは、言語定数ファイルには、複数回読み込まれる可能性があるものとそうでないものの２種類ある、ということです。
例えば、modinfo.php は、モジュールインストーラなどで、同じ型のモジュールインスタンスとして複数回呼ばれます。ですから、XOOPS_TRUST_PATH/modules/(trustdirname)/language/(lang)/modinfo.phpはこのような構造になります。
$constpref = '_MI_' . strtoupper( $mydirname ) ;
if( ! defined( $constpref.'_LOADED' ) ) {
// a flag for this language file has already been read or not.
define( $constpref.'_LOADED' , 1 ) ;
define($constpref."_NAME","(name of the module)");
define($constpref."_DESC","(desc of the module)");
}
利用する側（例えばxoops_version.php）も、このようになります。
$modversion['name'] = constant($constpref.'_NAME') ;
$modversion['description'] = constant($constpref.'_DESC') ;
これに対して、main.phpやadmin.phpは、基本的に１回しか呼ばれません。だから、上のような繁雑な処理は不要です。従来通り、
main.php
define('_MD_D3FORUM_ON','On');
admin.php
define('_MD_A_D3FORUM_LABEL_SELECTFORUM','Select Forum');
などとすればOKです。mainやadminは、たかだか１モジュールからしか呼ばれない、という仕様上の保証があるので、その仕様に違反するようなモジュールを使わない限り、二重定義問題は回避できます。もちろん、ユーザオーバーライドも可能です。
唯一複雑なのはブロックです。ブロックは、基本的に複数回呼ばれるのが仕様ですが、それは表示関係に限ります。ブロックオプションの編集フォームに利用される定数（１度しか利用されない）を、いちいち、constant($constpref."...") と書かなければならないのでは繁雑です。
というわけで、ブロック関連の定数に関しては２種類に分ける実装にしています。
XOOPS_TRUST_PATH/modules/(dirname)/language/(lang)/blocks_each.php
-- 従来通り、_MB_D3FORUM_* という定数を普通に定義する。ブロックオプションの編集関係のみ。
XOOPS_TRUST_PATH/modules/(dirname)/language/(lang)/blocks_common.php
-- $constpref で処理する。それらの定数は、Smartyにアサインする。
次回は、D3モジュールならではの、インスタンス毎の言語定数オーバーライドを説明します。
0 comments
Related articles
- D3モジュール言語定数のオーバーライド (2007-05-08 03:54:37)
- D3モジュールのテンプレート命名規則 (2006-10-04 03:48:11)
- D3モジュールとブロックテンプレート (2006-10-03 03:19:46)
- D3モジュールと言語処理(2) (2006-10-02 04:04:39)
- モジュールの多態性 (2006-05-15 03:24:00)
- Duplicatable V3 (2006-05-13 06:13:40)
Comments list
Login