- 追加された行はこの色です。
- 削除された行はこの色です。
// author:1
// author_ucd:d9G8ajWEStk6 nobunobu
**cubeUtils モジュール
***1.これは何?
CubeUtilsモジュールは、XOOPS Cube2.1に対するある程度実用的なサンプルです。~
&font(b){&font(Red){しかしながら、あくまでもXOOPS Cube2.1の柔軟性に対する実証用モジュールですので、まだまだ安定版ではありません。};};
XOOPS 2.0.x JP用の[[SysUtilモジュール:http://www.kowa.org/modules/pukiwiki/359.html]]にて用意していたGIJOE氏開発の以下のHACKと同等機能を、~
XOOPS Cube2.1のPreload機能及びDelegate機構を使用して実装したモジュールです。
-AutoLogin
-EMLH(Easiest Multi Language Hack)
***2.どうやって使うの?
このモジュールが動く環境は、[[XOOPS Cube2.1 Alpha4-b:http://xoopscube.jp/modules/cubeNews/index.php?action=detail&id=64]] 以降が前提となります。
-cubeUtils 0.2 - &ref(XC21Module-cubeUtils_0.2.zip);
+上記のファイルをダウンロードして、解凍して下さい。
+解凍されたフォルダーをそのままXOOPS Cubeのルートフォルダーにコピーして下さい。
+管理画面よりモジュールをインストールして下さい~
+管理画面よりモジュールをインストールして下さい
+AutoLoginを有効にする場合~
管理画面でcubeUtilsモジュールの一般設定にて、
++「Auto Login 機能を使用する」を「はい」に設定
++「Auto Login の持続時間」にて、どの程度の期間AutoLogin状態を保持するかを設定して下さい。
+Multi Languageを使用される場合~
+Install module with XOOPS Cube Administration menu~
標準では、日本語と英語の切替ができるような設定になっていますが、これ以外の言語切替を行いたい場合には、/modules/cubeUtils/include/conf_ml.dist.php を conf_ml.phpにコピーを行って、カストマイズを行って下さい。
>[ja]日本語[/ja][en]English[/en]
の様に記述することによって、日英両対応のコンテンツが作成出来ます。
>[ja]mlimg[/ja]
を文書に挿入すると、言語切り替え用国旗イメージを表示する事ができます。
***3.どのように作られているの
*****1) AutoLogin
AutoLogin機能は、基本的には、Site.LoginのDelegate関数を実装する事によって実現されています。~
実際には、ログインブロックでの入力内容をクッキーに記憶したり、破棄したりするためにそのほかにも幾つかのDelegate関数が実装されています。
:Site.Login|セッションが継続していなくても、クッキーにログイン情報が格納してれば、自動ログインを試みる
:Site.CheckLogin.Success|ログイン画面にてログインが成功したときにログイン情報をもとにしてクッキーを生成する
:Site.Logout|ログアウト時に、保存したクッキーを破棄する
:Legacypage.User.Access|RemenberMe付きのログイン画面を表示させる
これらのDelegate関数の定義と実装については、モジュールPreload機能によって~
自動的に読み込まれるようになっています。~
(/modules/cubeUtils/preload/AutoLoginHack.class.php)
*****2)EMLH(Easiest Multi Language Hack)
Legacy_Controller.GetLanguageName Delegate関数の実装を行い、この関数内でGETパラメータ、クッキー、ブラウザの~
プリファレンスを元にして、表示言語を決定します。~
このDelegate関数の定義については、preFilter()の段階で行う必要があるため、~
モジュール内Preloadでは無く、/preloadにMultiLanguagePreLoad.class.php を配置しています。~
言語タグの扱いについては、EMLHと同様 ob_filteringにて実現しています。~
別途CacheSystemを標準のstdRenderCacheを継承したクラスに置き換えて、言語毎のCacheを保存する事を可能にしています。
***4.変更履歴
-2006-08-21 : Version 0.0.1リリース
-2006-09-02 : GIJOE氏からの不具合報告に対応した Version 0.0.2リリース~