Top > PukiWiki > Plugin > gallery.inc.php

gallery.inc.php

修正 @ Mar 06, 2011 03:38:49

Tag: PukiWiki

サマリ複数画像のサムネイルをまとめて作成・表示
リビジョン0.1
対応バージョンPukiWiki Plus! I18N
ライセンスGPL v2
投稿日2011-3-6

概要

添付画像のサムネイルを自動作成し表示します。Plus!用 ExtendPlugin の resize.inc.php をベースに、複数画像を同時に扱えるように改変したものです。

resize.inc.php との比較

継承した機能

  • 直リンク防止機能 : 外部サイトからの直リンクではサムネイル画像が表示され、元画像は表示されません。
  • 携帯(モバイル) : スキンが mobile だと判断される場合、画像は自動的に JPG、 sqicf(128,96)サイズで表示されます。

変更点

  • ファイル名を正規表現で指定することで、複数の画像をまとめて扱えます。
  • サムネイル作成のための補間関数は指定できません。
  • その他いくつかのオプションを削除しています。
▲ ▼

ダウンロード

filegallery.inc.php
▲ ▼

書式

ブロック型

#gallery([オプション])

オプション

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

画像サイズ指定について

type とサイズの関係

typeサイズ備考
intro76 x 57マイミク、コミュニティ紹介画像
mini96 x 72
body120 x 90本文写真
prof180 x 135プロフィール画像
small256 x 192従来からのサムネイル画像
vga640 x 480VGA
cif352 x 288以下、携帯電話向け
disp400 x 240
qvga320 x 240携帯での全画面サイズ
qcif176 x 144
sqicf128 x 96

その他

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

準備

サムネイル画像保存用ディレクトリの作成

このプラグイン実行前にディレクトリ attach/thumbnail（上記「THUMBNAIL_DIR」）を作成して下さい。 パーミッションは 777。

スタイルシート追加

本プラグインで作成されるHTMLは以下のようになります。

<div id="gallery">
  <div class="gallery_img"> 画像(& Exif) </div>
  <div ... 画像の数だけ繰り返し
</div>
  • そのままでは、1画像/1行表示となります。
  • 画像を横に並べたい場合は、スタイルシートに下記を追加して下さい。 
    .gallery_img { display:inline; }
    または、 
    .gallery_img { float:left; }
▲ ▼

設定

デフォルトの設定

gallery.inc.php の18～25行目の下記定数を適宜変更して下さい。

定数内容デフォルト値
THUMBNAIL_DIR*サムネイル保存用ディレクトリ名attach/thumbnail/
GALLERY_ATTRIBUTE*Lightboxなどのスクリプト用属性rel="lightbox[%s]"
GALLERY_THUMB_TRIMサムネイル画像を指定サイズに合わせるためにトリミングを行うかどうかtrim
GALLERY_SAFE_MODE自サイトからのリンク以外は元画像を表示しないtrue

GALLERY_ATTRIBUTE 補足

「%s」は以下のように文字列に置換されます。

  • オプションで何も指定しない場合 => ref="lightbox[ページ名]"
  • オプションで指定 ref=hoge => ref="lightbox[hoge]"
▲ ▼

使い方

#gallery()
  • 現在のページに添付されている全ての画像をサムネイル表示します。
  • 画像サイズは 256 x 192 (small)。
#gallery(^photo,w=100,rel=photo)
  • 「photo」で始まる名前の画像全て。
  • 画像サイズは 100x100px。
  • 属性は「rel="lightbox[photo]"」。
#gallery(page=PalmTips/MiniBar,w=50,nolink)

このサイトのページ PalmTips/MiniBar の画像を表示しています。

▲ ▼

履歴

  • 2011/3/6 ver.0.1
    • 公開