- 追加された行はこの色です。
- 削除された行はこの色です。
// author:1
// author_ucd:d9G8ajWEStk6 nobunobu
**cubeUtils モジュール
***1.これは何?
CubeUtilsモジュールは、XOOPS Cube2.1に対するある程度実用的なサンプルです。~
&font(b){&font(Red){しかしながら、あくまでもXOOPS Cube2.1の柔軟性に対する実証用モジュールですので、まだまだ安定版ではありません。};};
CubeUtilsモジュールは、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)
-iGoogle Gadget Block (試験実装)
***2.どうやって使うの?
+AutoLoginを有効にする場合~
このモジュールが動く環境は、[[XOOPS Cube2.1.x:http://xoopscube.sourceforge.net/]] 以降が前提となります。
-cubeUtils 0.7 - &ref(XC21Module-cubeUtils_0.7.zip);
+Multi Languageを使用される場合~
+上記のファイルをダウンロードして、解凍して下さい。
+解凍されたフォルダーをそのままXOOPS Cubeのルートフォルダーにコピーして下さい。
+管理画面よりモジュールをインストールして下さい
****AutoLoginを有効にする場合
管理画面でcubeUtilsモジュールの一般設定にて、
++「Auto Login 機能を使用する」を「はい」に設定
++「Auto Login の持続時間」にて、どの程度の期間AutoLogin状態を保持するかを設定して下さい。
****Multi Languageを使用される場合
標準では、日本語と英語の切替ができるような設定になっていますが、これ以外の言語切替を行いたい場合には、/modules/cubeUtils/include/conf_ml.dist.php を conf_ml.phpにコピーを行って、カストマイズを行って下さい。
+Please download above file.
AutoLogin機能は、基本的には、Site.LoginのDelegate関数を実装する事によって実現されています。~
+Unzip files and then copy them into XOOPS Cube Root folder.
:Site.Login|セッションが継続していなくても、クッキーにログイン情報が格納してれば、自動ログインを試みる
+Install module with XOOPS Cube Administration menu
****Enbling AutoLogin Feature
In cubeUtils module preference screen
++ Set [Use Auto Login] to "Yes"
++ Maximum lifetime for AutoLogin into [Auto Login Lifetime] field in hours.
****Customizing Muti Language Feature
With default setting, You can switch language between "Japanese" and "English".~
If you want to customize it , you shold copy~
/modules/cubeUtils/include/conf_ml.dist.php to conf_ml.php,~
and then edit it as you want.~
After setting done, if you can write a multi language content like as follow.
>[ja]NIHONGO[/ja][en]English[/en]
And if you insert [ja]mlimg[/ja] in your content, you'll see national flags to switch language.
-2006-08-21 : Version 0.0.1リリース
-2006-09-02 : GIJOE氏からの不具合報告に対応した Version 0.0.2リリース
-2006-09-04 : plusangel氏からの不具合報告に対応した Version 0.0.3リリース
-2006-09-25 : XOOPS Cube 2.1 Alpha5以降で変更になったCacheシステムに対応したVersion 0.0.4リリース~
-2006-08-21 : Version 0.0.1 Release
-2006-09-02 : Version 0.0.2 Release (Bugs reported by GIJOE are fixed)
-2006-09-04 : Version 0.0.3 Release (Bugs reported by plusangel are fixed)
-2006-09-25 : Version 0.0.4 Release (This will be able work with XOOPS Cube2.1 Alpha5)~
****iGoogle Gadget Block (Experimental)
This feature enbles any guest visible blocks on Xoops Cube Legacy will be displayed in your iGoogle page as gadget. (Brief document is under constuction) ~
[/en]
***3.どのように作られているの
*****1) AutoLogin
AutoLogin機能は、基本的には、Legacy_Controller.SetupUserのDelegate関数を実装する事によって実現されています。~
実際には、ログインブロックでの入力内容をクッキーに記憶したり、破棄したりするためにそのほかにも幾つかのDelegate関数が実装されています。
:Legacy_Controller.SetupUser|セッションが継続していなくても、クッキーにログイン情報が格納してれば、自動ログインを試みる
: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.1リリース
-2006-09-02 : GIJOE氏からの不具合報告に対応した Version 0.2リリース
-2006-09-04 : plusangel氏からの不具合報告に対応した Version 0.3リリース
-2006-09-25 : XOOPS Cube 2.1 Alpha5以降で変更になったCacheシステムに対応したVersion 0.4リリース
-2006-10-22 : XOOPS Cube 2.1 Beta1に対応したVersion 0.5リリース
-2008-02-27 : Hodajuku Distribution同梱に対応して、XOOPS Cube 2.1 Beta時代の古いロジックを削除して、Version 0.6リリース
-2008-03-16 : iGoogle Gadgetブロック機能を追加、ログオン画面の表示方法を変更し、Version 0.7リリース~
