==== Lightbox & Videobox preload for XOOPS Cube Legacy 2.1 ===

XOOPS Cube Legacy 2.1 上で Lightbox による画像表示とビデオ版 Lightbox「Videobox」による動画表示を可能にする preload です。

theme.html を修正することなく、Lightbox 2.0、Litebox、Lightbox plus、Slimbox、Videobox を利用できるようにする preload を同梱しています。

解凍すると "html/preload/" というディレクトリが展開され、このディレクトリの中に 2種類の preload があります。

• Lightbox.class.php - Lightbox による画像表示用の preload
  
• Videobox.class.php - Videobox による動画表示用の preload

また、"html/preload/extras/" 内に、theme.html を修正することなく Lightbox 2.0、Litebox、Lightbox plus、Slimbox、Videobox を利用できるようにする preload があります。

１　Lightbox.class.php の使い方

特に難しい使い方を覚える必要はなく、サイトプリロードディレクトリに入れるだけです。

これだけで、BBCode で貼り付けた画像を Lightbox.js で表示させることができます。

なお、オプションでグループ名とタイトルを入力することも可能です。

【画像のグループ化をする場合の使い方】
　［ｕｒｌ＝画像ＵＲＬ ｌｂ＝グループ名］［ｉｍｇ ａｌｉｇｎ＝ｌｅｆｔ］サムネイルＵＲＬ［／ｉｍｇ］［／ｕｒｌ］
　［ｓｉｔｅｕｒｌ＝画像ＵＲＬ ｌｂ＝グループ名］［ｓｉｔｅｉｍｇ ａｌｉｇｎ＝ｌｅｆｔ］サムネイルＵＲＬ［／ｓｉｔｅｉｍｇ］［／ｓｉｔｅｕｒｌ］

または

　［ｕｒｌ＝画像ＵＲＬ ｌｂ＝グループ名 ｔｉｔｌｅ＝タイトル］［ｉｍｇ ａｌｉｇｎ＝ｌｅｆｔ］サムネイルＵＲＬ［／ｉｍｇ］［／ｕｒｌ］
　［ｓｉｔｅｕｒｌ＝画像ＵＲＬ ｌｂ＝グループ名 ｔｉｔｌｅ＝タイトル］［ｓｉｔｅｉｍｇ ａｌｉｇｎ＝ｌｅｆｔ］サムネイルＵＲＬ［／ｓｉｔｅｉｍｇ］［／ｓｉｔｅｕｒｌ］

※ グループ名とタイトルの入力は必須ではありませんが、入力すると同じグループ名の画像をグループ化することができます。
※ タイトルのみを入力することはできません。タイトルのみを入力したい場合は、別に公開している CustomImagtag preload をお試しください。

【テキストリンクの入力をする場合の使い方】
　［ｕｒｌ＝画像ＵＲＬ ｌｂ＝グループ名］テキスト［／ｕｒｌ］
　［ｓｉｔｅｕｒｌ＝画像ＵＲＬ ｌｂ＝グループ名］テキスト［／ｓｉｔｅｕｒｌ］

または

　［ｕｒｌ＝画像ＵＲＬ ｌｂ＝グループ名 ｔｉｔｌｅ＝タイトル］テキスト［／ｕｒｌ］
　［ｓｉｔｅｕｒｌ＝画像ＵＲＬ ｌｂ＝グループ名 ｔｉｔｌｅ＝タイトル］テキスト［／ｓｉｔｅｕｒｌ］

※ タイトルのみを入力することはできません。
※ [siteurl]を使用する場合 XOOPSサイトトップからの相対パスを入力します。
　　入力例　［ｓｉｔｅｕｒｌ＝ｕｐｌｏａｄｓ／ｐｈｏｔｏｓ／1．ｊｐｇ］テキスト［／ｓｉｔｅｕｒｌ］

【グループ名を自動的に挿入するには】
この preload では、グループ名を指定できるようにしていますが、記事を投稿する毎にグループ名を入力するのはちょっと面倒ですね。

Smarty の修正子を使ってモジュールのテンプレートを修正すると、グループ名を自動的に挿入することもできますので、こちらの方が便利かもしれません。

例えば、bulletin 2.0 の場合は、bulletin_item.htm の <{$story.text}> を


に修正

preload を導入済の場合は、これで bulletin の記事毎にグループ名を自動的に挿入することができます。

２　Videobox.class.php の使い方
Videobox は、Youtube、Metacafe、Google Video、iFilm などの動画を Lightbox風に観覧できるスクリプトです。



この preload を利用すると、Videobox で表示するのに必要なタグを BBCode で入力できるようになります。

【使い方】
(1) 基本的な使い方
　［ｖｉｄｅｏｂｏｘ＝動画ＵＲＬ］テキスト［／ｖｉｄｅｏｂｏｘ］・・・（テキストリンクにする場合）
　［ｖｉｄｅｏｂｏｘ＝動画ＵＲＬ］［ｉｍｇ＝サムネイルＵＲＬ［／ｉｍｇ］［／ｖｉｄｅｏｂｏｘ］・・・（サムネイル画像にリンクにする場合）

(2) タイトルを入力する場合
　［ｖｉｄｅｏｂｏｘ＝動画ＵＲＬ ｔｉｔｌｅ＝タイトル］テキスト［／ｖｉｄｅｏｂｏｘ］・・・（テキストリンクにする場合）
　［ｖｉｄｅｏｂｏｘ＝動画ＵＲＬ ｔｉｔｌｅ＝タイトル］［ｉｍｇ＝サムネイルＵＲＬ［／ｉｍｇ］［／ｖｉｄｅｏｂｏｘ］・・・（サムネイル画像にリンクにする場合）

(3) タイトルと表示サイズを入力する場合
　［ｖｉｄｅｏｂｏｘ＝動画ＵＲＬ ｔｉｔｌｅ＝タイトル ｗ＝横幅（ピクセル） ｈ＝縦幅（ピクセル）］テキスト［／ｖｉｄｅｏｂｏｘ］・・・（テキストリンクにする場合）
　［ｖｉｄｅｏｂｏｘ＝動画ＵＲＬ ｔｉｔｌｅ＝タイトル ｗ＝横幅（ピクセル） ｈ＝縦幅（ピクセル）］［ｉｍｇ＝サムネイルＵＲＬ［／ｉｍｇ］［／ｖｉｄｅｏｂｏｘ］・・・（サムネイル画像にリンクにする場合）

※ 表示サイズのみの入力には対応していません。

３　"html/preload/extras/" 内の preload の使い方

"html/preload/extras/" 内の preload を利用すると、<{$xoops_module_header}> にアサインし、theme.html の ＜ｈｅａｄ＞ 内に ＜ｓｃｒｉｐｔ＞タグなどを挿入することができます。

これにより、theme.html を修正することなく、より簡単に Lightbox と Videobox を導入することができます。

"html/preload/extras/" には、次の 5種類の preload があります。

• Lightboxset.class.php - Lightbox 2.0 用
  
• Liteboxset.class.php - Litebox 用
  
• Lightbox_plusset.class.php - Lightbox plus 用
  
• Slimboxset.class.php - Slimbox 用
  
• Videoboxset.class.php - Videobox 用

この 5種類の preload は、次の所定のディレクトリに、スクリプトなどのファイルが配置されていることを前提に動作します。

(1) Lightboxset.class.php - Lightbox 2.0 用
　　html/javascript/lightbox/js 内にスクリプト
　　html/javascript/lightbox/css 内に lightbox.css
　　html/javascript/lightbox/images 内に 画像ファイル
　
(2) Liteboxset.class.php - Litebox 用
　　html/javascript/litebox/js 内に litebox-1.0.js、prototype.lite.js、moo.fx.js
　　html/javascript/litebox/css 内に lightbox.css
　　html/javascript/litebox/images 内に 画像ファイル
　　
(3) Lightbox_plusset.class.php - Lightbox plus 用
　　html/javascript/lightbox_plus/js 内にスクリプト
　　html/javascript/lightbox_plus/css 内に lightbox.css
　　html/javascript/lightbox_plus/images 内に 画像ファイル
　　
(4) Slimboxset.class.php - Slimbox 用
　　html/javascript/slimbox/js 内に slimbox.js、mootools.js
　　html/javascript/slimbox/css 内に slimbox.css と画像ファイル

(5) Videoboxset.class.php - Videobox 用
　　html/javascript/videobox/js 内にスクリプト
　　html/javascript/videobox/css 内に videobox.css と画像ファイル

別のディレクトリにスクリプトを置きたい場合は、preload の 20行目

$jspath = 'javascript/lightbox';

を修正してください。

　修正例　XOOPS_ROOT_PATH/sample/lightbox/ に置く場合、sample/lightbox と記入
　※ XOOPS_ROOT_PATH/ の部分と最後の / は記入しないでください。
　※ なお、ファイルの配置は変更しないでください。

【アサインを無効にするモジュールの設定】
preload の 24行目

$cancel_module = "";

で、アサインを無効にするモジュールを設定することができます。

アサインを無効にするモジュールを設定する場合は、"|"でモジュールのディレクトリを区切って記入してください。

　設定例　$cancel_module = "newbb|news";
　
【トップページへのアサインを無効にする場合の設定】
preload の 27行目

$cancel_top = "1";

とすると、トップページへのアサインを無効にすることができます。

※ 空欄ならトップページにアサイン。

４　使用上の注意事項
グループ名とタイトルの文中に空白を含めないでください。空白があるとうまく動作しません。

Lightboxset.class.php 、Lightbox_plusset.class.php 、Videoboxset.class.php は、theme.html に <{$xoops_module_header}> が記述されていることを前提に動作します。

たいていの theme.html には <{$xoops_module_header}> が記述されているかと思いますが、もし無ければ ＜head＞内に <{$xoops_module_header}> を記述したうえでお使いください。

この 3つの preload を使用しない場合は、lightbox.js などのスクリプトを適切に配置し、利用しているテーマの theme.html を修正したうえで、preload を導入してください。


【参考記事】
XOOPS サイトに Lightbox plus を導入しよう
http://www.photositelinks.com/modules/forum/index.php?top...

Videobox: Lightbox for videos
http://videobox-lb.sourceforge.net/

【Lightbox と Videobox の併用について】
Lightbox と Videobox を同時に使おうとすると、うまく動かない場合があるようです。

その場合は、$cancel_module を利用してモジュールによって使い分けるか、Slimbox をお試しください。
http://www.digitalia.be/software/slimbox

【更新履歴】
0.70 2009-1-15
- Lightboxset.class.php を修正し、lightbox2.04 に対応(thx moegiiro)

0.60 2008-1-27
- Liteboxset.class.php を同梱
- $cancel_module オプション、$cancel_top オプションを追加

0.50 2008-1-25
- テキストリンクが可能となるよう Lightbox.class.php の変換パターンを修正
- Lightboxset.class.php 、Lightbox_plusset.class.php 、Videoboxset.class.php を同梱

0.40 2008-1-19
- Videobox.class.php

0.30 2008-1-17
- タイトルの入力に対応

0.20 2008-1-8
- グループ名の入力に対応

0.10 2007-5-3
- this new file