• 追加された行はこの色です。
  • 削除された行はこの色です。
&tag(PukiWiki);

//*gallery.inc.php
|RIGHT:100|LEFT:360|c
|~サマリ|複数画像のサムネイルをまとめて作成・表示|
|~リビジョン|0.1|
|~対応バージョン|PukiWiki Plus! I18N|
|~ライセンス|GPL v2|
|~投稿日|&new{&date};|
|~投稿日|&new{2011-3-6};|

#contents

*概要 [#b68bcaba]
添付画像のサムネイルを自動作成し表示します。
添付画像のサムネイルを自動作成し表示します。Plus!用 ExtendPlugin の [[resize.inc.php>http://pukiwiki.cafelounge.net/plus/?ExtendPlugin%2Fresize.inc.php]] をベースに、複数画像を同時に扱えるように改変したものです。

Plus!用 ExtendPlugin の [[resize.inc.php>http://pukiwiki.cafelounge.net/plus/?ExtendPlugin%2Fresize.inc.php]] をベースに、複数画像を同時に扱えるように改変したものです。

**resize.inc.php との比較 [#if65a6aa]
***継承した機能 [#h07593d0]
-直リンク防止機能 : 外部サイトからの直リンクではサムネイル画像が表示され、元画像は表示されません。
-携帯(モバイル) : スキンが mobile だと判断される場合、画像は自動的に JPG、
sqicf(128,96)サイズで表示されます。
***変更点 [#u15c3bbc]
-ファイル名を正規表現で指定することで、複数の画像をまとめて扱えます。
-サムネイル作成のための補間関数は指定できません。
-その他いくつかのオプションを削除しています。

*ダウンロード [#x17be501]
#attachref(./gallery.inc.php)

*書式 [#tb65476a]
ブロック型
 #gallery([オプション])

**オプション [#d2d55ecb]
|オプション|内容|例|デフォルト|h
|page|元画像の添付されているページ|p=FrontPage|（現在のページ）|
|p|~|~|~|
|file|元画像のファイル名（正規表現）|f=.*|.*（全て）|
|f|~|~|~|
||~|~|~|
|~オプション|~内容|~使用例|~デフォルト|h
|page / p|元画像の添付されているページ|page=FrontPage|（現在のページ）|
|file / f|元画像のファイル名（正規表現）|file=.*|.*（全て）|
|rel|Lightboxなどのアルバムスクリプト用属性|rel=photo|※下記設定参照|
|width|サムネイル画像の幅(px)|w=100|0|
|w|~|~|~|
|height|サムネイル画像の高さ(px)|h=100|0|
|h|~|~|~|
|percent|サムネイル画像の元画像に対する縮尺率(%)|per=50%|0|
|per|~|~|~|
|width / w|サムネイル画像の幅(px)|width=100|0|
|height / h|サムネイル画像の高さ(px)|height=100|0|
|percent / per|サムネイル画像の元画像に対する縮尺率(%)|percent=50%|0|
|type|サムネイル画像のサイズ指定|type=mini|small|
|t|~|~|~|
|trim|サムネイル画像を指定サイズに合わせるためにトリミングを行う|trim|※下記設定参照|
|notrim|↑トリミングを行わない|notrim|~|
|nolink|元画像にリンクしない|nolink|（リンクする）|
|info|Exif情報の表示|info|（表示しない）|
|erase|サムネイル画像を削除|erase|（削除しない）|
|e|~|~|~|
|nocache|サムネイル画像を保存しない（ページを表示する毎にサムネイルを作成）|nocache|保存する|
|temp|~|~|~|
|tmp|~|~|~|
|erase / e|サムネイル画像を削除|erase|（削除しない）|
|nocache / temp|サムネイル画像を保存しない（ページを表示する毎にサムネイルを作成）|nocache|保存する|

**画像サイズについて [#hcdf9ae4]
***type [#s6fd4b37]
|type|サイズ|備考|h
**画像サイズ指定について [#hcdf9ae4]
***type とサイズの関係 [#s6fd4b37]
|~type|~サイズ|~備考|h
|intro|76 x 57|マイミク、コミュニティ紹介画像|
|mini|96 x 72||
|body|120 x 90|本文写真|
|prof|180 x 135|プロフィール画像|
|small|256 x 192|従来からのサムネイル画像|
|vga|640 x 480|VGA|
|cif|352 x 288|以下、携帯電話向け|
|disp|400 x 240||
|qvga|320 x 240|携帯での全画面サイズ|
|qcif|176 x 144||
|sqicf|128 x 96||

**その他 [#pda3b931]
***その他 [#pda3b931]
-type で指定した場合、元画像に合わせて縦長・横長が切替わります。
-width と height の一方しか指定しない場合、トリミングする場合は指定したサイズの正方形となり、トリミングしない場合は指定したサイズに合わせた縮尺となります。

*準備 [#g9497622]
**サムネイル画像保存用ディレクトリの作成 [#thumbdir]
COLOR(RED):このプラグイン実行前にディレクトリ attach/thumbnail（上記「THUMBNAIL_DIR」）を作成して下さい。
パーミッションは 777。

**スタイルシート追加 [#y68c7376]
本プラグインで作成されるHTMLは以下のようになります。
 <div id="gallery">
   <div class="gallery_img"> 画像(& Exif) </div>
   <div ... 画像の数だけ繰り返し
 </div>
-そのままでは、1画像/1行表示となります。
-画像を横に並べたい場合は、スタイルシートに下記を追加して下さい。
 .gallery_img { display:inline; }
または、
 .gallery_img { float:left; }

*設定 [#f2f71393]
**デフォルトの設定 [#r5109210]
gallery.inc.php の18～25行目の下記定数を適宜変更して下さい。
// サムネイル保存場所
')	or define('THUMBNAIL_DIR', UPLOAD_DIR . 'thumbnail/');
// Lightboxなどのスクリプト用属性
defined('GALLERY_ATTRIBUTE')	or define('GALLERY_ATTRIBUTE', 'rel="lightbox[%s]"');
// サムネイル画像を指定サイズに合わせてトリミングするかどうか : 'trim' or 'notrim'
defined('GALLERY_THUMB_TRIM')	or define('GALLERY_THUMB_TRIM', 'trim');
// 自サイトからのリンク以外は、標準画像を表示しない : true or false
defined('GALLERY_SAFE_MODE')	or define('GALLERY_SAFE_MODE', true);

|~定数|~内容|~デフォルト値|h
|THUMBNAIL_DIR|サムネイル保存用ディレクトリ名|attach/thumbnail/|
|GALLERY_ATTRIBUTE|Lightboxなどのスクリプト用属性|rel="lightbox[%s]"|
|THUMBNAIL_DIR[[*>#thumbdir]]|サムネイル保存用ディレクトリ名|attach/thumbnail/|
|GALLERY_ATTRIBUTE[[*>#attribute]]|Lightboxなどのスクリプト用属性|rel="lightbox[%s]"|
|GALLERY_THUMB_TRIM|サムネイル画像を指定サイズに合わせるためにトリミングを行うかどうか|trim|
|GALLERY_SAFE_MODE|自サイトからのリンク以外は元画像を表示しない|true|
**GALLERY_ATTRIBUTE 補足 [#attribute]
「%s」は以下のように文字列に置換されます。
-オプションで何も指定しない場合 => ref="lightbox[ページ名]"
-オプションで指定 ref=hoge => ref="lightbox[hoge]"

*使い方 [#o1fe6a04]
  #gallery()
 #gallery()
-現在のページに添付されている全ての画像をサムネイル表示します。
-画像サイズは 256 x 192 (small)。

  #gallery(^photo,w=100,rel=photo)
 #gallery(^photo,w=100,rel=photo)
-「photo」で始まる名前の画像全て。
-画像サイズは 100x100px。
-属性は「rel="lightbox[photo]"」。

 #gallery(page=PalmTips/MiniBar,w=50,nolink)
このサイトのページ PalmTips/MiniBar の画像を表示しています。
#gallery(page=PalmTips/MiniBar,w=50,nolink)

*履歴 [#y80b6d5e]
-2011/3/6 ver.0.1
--公開