Welcome !! Now 2008.07.20 22:26 (JST)

Maxigallery - 0.5.2

[ スニペット ]

Maxigallery は、多機能な画像ギャラリーです。Webユーザに投稿・編集管理権限を持たせることも可能です。また、ログインユーザのみ閲覧可能なギャラリーも構築できます。

PHx をサポートしており、テンプレートも細かく指定できるので、多彩な表現が可能です。また画像の表示方法も何通りかあり、ウォーターマークを挿入することもできます。

親アルバムの下に子（サブ）アルバムを持たせるような構成も簡単に実現できます。

参照ページ：Maxigallery wiki／Maxigallery

テスト環境

  • サーバ：さくらインターネット 　
    • PHP 4.4.4
    • MYSQL 4.0.27
  • MODX：0.9.5
  • Maxigallery - 0.5.2

サポートするファイル形式

  • jpg/jpeg
  • png
  • gif…gif は png にコンバートされます
  • zip-archives…ZZIPlibがインストールされていれば、各画像をzip圧縮してアップロードすることにより、管理が楽になります

利用の流れ

サブアルバムを持つギャラリーの構築方法を示します

  1. 親アルバム用のドキュメントを作り、以下のようにスニペットコールを書きます
    [!MaxiGallery? &display=`childgalleries`!]
  2. １．のドキュメントの下にサブアルバムとなるドキュメントを作成し以下のようにスニペットコールを書きます（各パラメータは任意です）
    [!MaxiGallery? &display=`embedded` &embedtype=`slimbox` &pics_per_row=`3` &max_thumb_size=`110`!]
  3. ２．で作成したドキュメント上から画像を投稿します
  4. ２．のドキュメントに自動的にサムネイルが作成されます。また１．のドキュメントにもサムネイルが表示されます。

ドキュメント構成とアルバムの関係

親ドキュメント＝親アルバム
　└子ドキュメント＝子アルバム
　└子ドキュメント＝子アルバム

インストール

リソースのインストール方法についてを参照してください

基本的な書式

[[MaxiGallery]]

コンフィギュレーションファイルを使う

MaxiGallery でも、Ditto2.x や Wayfinder2.0 で採用されている config パラメータを使った簡潔なスニペットコールの記述が可能です。

  1. configuration ファイルを作る
    • <?php
// Use the following syntax $param = 'value';
$pics_per_row = '3';
$display = 'childgalleries';
$order_by = 'random';
?>
    • こんな感じに「$パラメータ = '値';」を並べます
    • 値を囲むクォーテーションはパラメータ指定の「``」ではなく、「''」または「""」なので注意。
  2. ファイルを作ったら「configs」以下に「sample.config.php」という名前で保存します。
  3. サーバー上の該当位置にアップロードします
  4. Maxigallery コールで configuration file を指定します
    • [!MaxiGallery? &config=`sample`!]

パラメータ - 目次

パラメータ（共通）
MaxiGallery 全体に渡る設定に関するパラメータ
パラメータ（アイテム取得）
アイテム（サムネイル）表示に関するパラメータ
パラメータ（親アルバム用=childgalleries_xxxx）
親アルバム用に特に用意されたパラメータ
パラメータ（画像表示）
ギャラリータイプ、画像表示に関するパラメータ
パラメータ（スムースギャラリー： embedtype=`smoothgallery`）
スムースギャラリー用に特に用意されたパラメータ
パラメータ（サムネイル作成用）
画像をアップロードする際に作成するサムネイル用のパラメータ
パラメータ（ノーマルサイズ用）
画像をアップロードする際に作成するノーマル画像用のパラメータ
バラメータ（ビッグサイズ用）
画像をアップロードする際に作成するビッグサイズ画像用のパラメータ
パラメータ（ftp）
ftp用に用意されたパラメータ
パラメータ（テンプレート）
テンプレート用に用意されたパラメータ
利用可能なプレイスホルダ
テンプレートで利用可能なプレイスホルダ

パラメータ（共通）

MaxiGallery 全体に渡る設定に関するパラメータです。

△目次に戻る

admin_webgroups

画像の管理（投稿、編集、削除などの）を許可するWebユーザグループを指定します。カンマで区切って複数指定可能です。

admin_webusers

画像の管理（投稿、編集、削除などの）を許可するWebユーザを指定します。カンマで区切って複数指定可能です。

manager_webgroups

自分自身がポストした画像の管理を許可するWeb ユーザグループを指定します。カンマで区切って複数指定可能です。

manager_webusers

自分自身がポストした画像の管理を許可するWeb ユーザを指定します。カンマで区切って複数指定可能です。

debug

デバッグに関する情報を表示するかどうかを指定します。デフォルト「しない（0）」。

disable_js_libs

MaxigalleryがJSライブラリ（MooTools, Prototype, Scriptaculous）を<head>～</head>に自動挿入することを無効にするかどうかを指定します。デフォルト「しない（0）＝ライブラリを自動挿入します」。

これを有効にすれば、ドキュメント用のテンプレートで既にそれらのライブラリを指定しているとき、２重に読み込んでしまうことを避けることができます。

disable_rightclick

ユーザの環境でJavaScriptが有効なとき、右クリックメニューの「画像の保存」ができないようにするかどうかを指定します

  • これを指定してもFFだと場合によってはできちゃったりします
  • またIE（6）では右クリックメニューそのものが表示されません

デフォルト「しない（0）」。

random_filenames

アップロードの際、画像にランダムなファイルネイムを使用するかどうかを指定します。デフォルト「しない（0）= ローカルのファイル名をそのまま利用」

gtable

maxigallery 用のデータベーステーブル名（MODx テーブルプリフィクスは、自動的に追加されるでしょう）。デフォルト「maxigallery」

css

ギャラリに適用するCSSを指定します。以下の指定方法が可能です。

  • CSSファイルへのパス…例：assets/css/gallery.css
  • CSSを記述したチャンク名
  • インラインCSS…例：<style>.classname{}</style>

デフォルト「assets/snippets/maxigallery/css/default.css」

js

JavaScript を挿入できます。以下の様式を指定できます。

  • path …例：/assets/js/gallery.js
  • chunk name … 例：MaxigalleryJs
  • text … 例：<scripttype="text/javascript">alert(hello);</script>

keep_date

後から画像のタイトルや説明などの変更をくわえても、画像をアップロードした時の日時を保持するかどうかを指定します。デフォルト「保持する（1）」

max_pic_number

ギャラリにアップロードできる画像の最大数を指定します。「0」を指定すると無制限にアップロードできます。デフォルト「無制限（0）」

lang

言語ファイルを指定します。デフォルト「en」。現在のところ日本語はないので、必要であれば自作します。lang_ja.phpとして作成し「maxigallery/lang」下に置きます。そしてスニペットコールで「&lang=`ja`」と指定します。

「slidebox」「lightboxv2」「slimbox」は、それぞれの「js」フォルダ下のJsと「image」フォルダ下の画像をそれぞれのファイル名の規則に従って作成すれば、「Next」などが日本語化できます（はずです）。

もし「ja」のつくファイルが見つからない場合、自動的に「en」を読みに行くようです。

is_target

ドキュメントをブラウジングモードで表示するか、マネージャモードで表示するかを指定します。デフォルト「マネージャモード（0）」。「1」を指定するとGalleryの管理者権限を持つアカウントでログインしても「Manager Pictures」ボタンが表示されません。

manage_gallery

アイテム管理をしたいドキュメントのIDを指定します。他のドキュメントから、アイテムの管理ができます。「manager_target」と組み合わせて、ギャラリー用ドキュメントと管理用ドキュメント用分けたい場合に利用すると良いでしょう。

管理者としてログインしていない場合は、普通にアイテムを表示します。

manage_target

カレントドキュメントのアイテム管理をするためのドキュメントIDを指定します。「&is_target=`1`」と併用します。

利用イメージ：

ギャラリ側：ID229
[!MaxiGallery? &display=`embedded` &embedtype=`slidebox` &manage_target=`286` &is_target=`1`!]
管理側：ID286
[!MaxiGallery? &manage_gallery=`229` &admin_webgroups=`Site Admins` &limit=`2`!]

パラメータ（アイテム取得）

アイテム（サムネイル）表示に関するパラメータです。

△目次に戻る

gal_query_ids

画像を取得したいドキュメント（アルバム）のIDを指定します。カンマで区切って複数指定可能です。デフォルト「カレントドキュメント」

スニペットコールサンプル：
[!MaxiGallery? &gal_query_ids=`228`!]
指定したドキュメントが親アルバムの場合、「query_level_limit」で指定した階層の子アルバムすべてから取得します。また「all」を指定すると、（MODx内の）すべてのアルバムから画像を取得します。

query_level_limit

「gal_query_ids」で指定したドキュメントのどの階層までアイテムを回収するかどうかを指定します。デフォルト「1」（「gal_query_ids」で指定したドキュメントが親ドキュメントなら直下の子ドキュメント層まで）。

view_gallery

直接の親アルバム以外のドキュメントから、サブギャラリのアイテムを表示します。マネージャ権限でログインしている場合は、「Manage pictures」ボタンも表示されます。利用したいサブアルバム（maxigallery call）コールを含むサブアルバムのドキュメントIDを指定します。

limit

表示するアイテムの数の最大値を指定します。デフォルト「9999999」

offset

表示するアイテムのオフセット数を指定します。デフォルト「0」。

order_by

並べ替えの基準になるフィールド名を指定します。以下を指定できます。

  • date
  • pos … position
  • filename
  • title
  • id
  • random

デフォルト「pos,date」。

サブアルバムで「randam」を指定すると、画像をラムダムに表示します。親アルバムで「ramdom」を指定すると、サブアルバムのサムネイルをランダムに交換します。

※「randam」ランダムを指定しているとマネージャで画像を削除した後エラーになる（かも）。

order_direction

降順（DESC）か昇順（ASC）かを指定します。デフォルト「DESC」。

pics_per_page

１ページに表示したいアイテム（サムネイル）の数を指定します。デフォルト「無制限（0）」。

親アルバムでは無効です。

pics_per_row

１行に表示するアイテム（サムネイル）の数を指定します。デフォルト「4」。親アルバムでも有効です。

pic_query_ids

回収したいアイテムIDを指定します。カンマで区切って複数指定可能です。このパラメータを指定すると「manage pictures」ボタンを表示しません。

pictureview_start_id

「display=`pictureview`」が指定されているとき、このパラメータで、表示を開始するアイテム（ID）を指定できます。

pictureview_start_pos

「display=`pictureview`」が指定されているとき、このパラメータで、表示を開始するアイテム（position）を指定できます。

パラメータ（親アルバム用=childgalleries_xxxx）

親アルバム用に特に用意されたパラメータです。

△目次に戻る

childgalleries_ids

リストアップするサブアルバムをdocidで指定します。カンマで区切って複数指定可能です。デフォルト「すべて（all）」

childgalleries_level_limit

どの階層まで、リストアップするかを指定します。デフォルト「無制限（0）」。

childgalleries_limit

何件リストアップするかを指定します。

childgalleries_order_by

サブアルバムのソートの基準となるフィールドを指定します。デフォルト「menuindex」。

childgalleries_order_direction

サブアルバムの並び順を指定します。以下を指定できます。

  • ASC
  • DESC

デフォルト「ASC」

パラメータ（画像表示）

ギャラリーのタイプや、画像を表示するときのモードを指定するパラメータです。

△目次に戻る

display

ギャラリーのタイプまたは各画像の表示形式を指定します。以下を指定できます。

normal
サムネイルをリストアップしクリックすると元の大きさで画像を表示
embedded
サムネイルをリストアップしクリックすると「embedtype」パラメータで指定した方法で画像を表示。「embedtype」を指定しなければ、「normal」で動作する
childgalleries
サブアルバムのサムネイルを取得。各サブアルバムのアイテムのうち、一番IDが大きいものを1つ取得（たぶん）。
pictureview
サムネイルをリストアップせず、最初のアイテムを表示する

デフォルト「normal」

embedtype

「display」パラメータで、「embedded」を指定したとき、このパラメータで画像の表示方法を指定します。以下を指定できます。

slidebox
  • 画面下に「next」「back」と表示。画面右上に「×」。画面左上にコピーライト。センターにタイトル。画面下センターに説明
  • Ajax ライブラリに「prototype.js」を使用する
lightboxv2
  • イメージ上に「next」「prev」ボタンを表示。画面右下に「close」。左にタイトル - 説明
  • Ajax ライブラリに「prototype.js」「scriptaculous.js」を使用する。
slimbox
  • 表示はslideboxと同じ（たぶん）。
  • Ajax ライブラリに「mootools」を使用する。
  • ※IEだと ウィンドウを下にスクロールしていても、ページトップから表示しようとしてあんばいが良くない。
smoothgallery
  •  「max_pic_size」で指定したサイズより画像が大きければそのサイズでクロップする。はずなんだけど。「max_pic_size」で「widhtxheith」と指定すると上手くいかない。もしかすると「正方形」にしか対応してないのかも。「max_pic_size=`200`」とかならうまくいく。
  • Ajax ライブラリに「mootools」を使用する。
popup
画像をポップアップ表示（htmlファイルとして表示する）
external
画像のみを新しいウィンドウで表示（JSで target="_blank" を表現）

「slidebox」の場合、アルバムディレクトリに「gallery.xml」が生成される。他のモードの場合は、生成されず、仮に「galleyr.xml」が存在すると削除される。

また他のモードから「slidebox」に変更したときは、マネージャ画面で「Resynch Gallery」をクリックすると「gallery.xml」が作成される。この「gallery.xml」が存在しないと、「back」「Next」などのナビが表示されない模様。

picture_target

ブラウジングするときのターゲットになるドキュメントをIDで指定します。デフォルト「カレントドキュメント」。ターゲットドキュメント（以下の例ならばID231）のmaxigallery コールには「&is_target=`1`」をくわえます（そうしないと画像表示できません）。

指定なし：ドメイン/gallery/withzenliner.html?pic=126
カレントドキュメント= 229 = withzenliner.html

「picture_target=`231`」：ドメイン/gallery/outdoor.html?gal_id=229&pic=126
カレントドキュメント= 229 / ID231 = outdoor.html

パラメータ（スムースギャラリー： embedtype=`smoothgallery`）

スムースギャラリー用に特に用意されたパラメータです。

△目次に戻る

smoothgallery_carouselMaximizedOpacity

カルーセル（画像上に表示されるサムネイルストリップ）の不透明度を指定します。「0（まったく見えない）」～「1.0（完全に不透明）」。デフォルト「0.7」

smoothgallery_carouselMinimizedHeight

カルーセルを最小化したときの高さを「px」指定します。デフォルト「20」

smoothgallery_carouselMinimizedOpacity

カルーセルを最小化したときの不透明度を指定します。「0（まったく見えない）」～「1.0（完全に不透明）」。デフォルト「0.4」

smoothgallery_fadeDuration

ディゾルブにかかる時間をミリセコンドで指定します。デフォルト「500」

smoothgallery_height

画像表示領域の高さを「px」で指定します。オーバーフローした部分はカットされます。デフォルト「max_pic_sizeで指定した値（高さ）」

smoothgallery_width

画像表示領域の幅を「px」で指定します。オーバーフローした部分はカットされます。デフォルト「max_pic_sizeで指定した値（幅）」

smoothgallery_id

ギャラーに対するユニークidをテキストで指定します。このパラメータを指定すると、１ページに複数のスムースギャラリーを置くことができます。デフォルト「Gallery id」

smoothgallery_preloader

画像をプレローディングするかどうかを指定します。デフォルト「する（true）」

smoothgallery_timed

スライドショーモードにするかどうかを指定します。デフォルト「しない（false）」

smoothgallery_delay

スライドショーのディレイをミリセコンドで指定します。デフォルト「9000」

smoothgallery_embedLinks

スライドショーで画像をクリックしたとき画像を表示するかどうかを指定します。デフォルト「する（true）」

※このパラメータを「false」に指定した場合、「galleryPictureTpl」からもリンクタグを取り去ってください。

smoothgallery_showArrows

「Back」「Next」矢印を表示するかどうかを指定します。デフォルト「する（true）」。

※「smoothgallery_showArrows=`false`」だけを指定すると、画像も表示されなくなる。「smoothgallery_showCarousel=`false`」と併用すればOK※

smoothgallery_showCarousel

カルーセルを表示するかどうかを指定します。デフォルト「する（true）」。

スライドショーのためのスニペットコールサンプル：
[!MaxiGallery? &display=`embedded` &embedtype=`smoothgallery` &smoothgallery_showArrows=`false` &smoothgallery_showCarousel=`false` &smoothgallery_timed=`true`!]

smoothgallery_showInfopane

インフォメーションペイン（タイトルや説明を表示する領域）を表示するかどうかを指定します。デフォルト「する（true）」

smoothgallery_slideInfoZoneOpacity

インフォメーションペインの不透明度を指定します。「0（まったく見えない）」～「1.0（完全に不透明）」。デフォルト「0.7」

smoothgallery_textShowCarousel

カルーセルを表示するためのテキストを指定します。デフォルト「言語ファイルから読み込み（pictures）」

smoothgallery_thumbHeight

カルーセルの中のサムネイルの高さを「px」で指定します。デフォルト「75」。

既に作成済みのサムネイルサイズより小さい値を指定するとその分カットされる。

※既に作成済みのサムネイルより大きい値を指定すると表示はされるが、動作が妙※

smoothgallery_thumbWidth

カルーセルの中のサムネイルの幅を「px」で指定します。デフォルト「100」。

既に作成済みのサムネイルサイズより小さい値を指定するとその分カットされる。大きい値を指定するとその分余白ができる

smoothgallery_thumbSpacing

カルーセルの中のサムネイル同士のスペースを「px」で指定します。デフォルト「10」

パラメータ（サムネイル作成用）

画像をアップロードする際に作成するサムネイル用のパラメータです。

△目次に戻る

quality_thumb

サムネイルのクォリティをパーセントで指定します。デフォルト「70」。

max_thumb_size

画像の最大サイズをピクセルで指定します。アップロードした画像のサイズがここで指定したサイズを超える場合は、この値にリサイズされます。「&max_thumb_size=120」または「&max_thumb_size=120x90（width x height）」のように指定します。デフォルト「130」。

thumb_use_imagemask

イメージマスクを適用するかどうかを指定します。デフォルト「しない「0」

thumb_mask_img

イメージマスクとして適用したい画像へのパスを指定します。デフォルト「assets/snippets/maxigallery/imagemask /demomask-frame1.png」。

thumb_mask_bgcolor

マスク部分の背景色をRGGヘキサで指定します。この色はページの背景色と同じ色にすべきでしょう。デフォルト「FFFFFF」。

thumb_mask_position

イメージマスクの位置を指定します。以下が指定できます。

  • top
  • topleft
  • topright
  • left
  • center
  • right
  • bottom
  • bottomleft
  • bottomright
  • resize

「resize」は、イメージマスクを画像のサイズに合わせます。デフォルト「resize」。

thumb_use_dropshadow

シャドウを適用するかどうかを指定します。デフォルト「しない（0）」。

thumb_shadow_bgcolor

シャドウの背景色をRGBヘキサで指定します。この色は、ページの背景色と同じにすべきでしょう。デフォルト「FFFFFF」。

thumb_shadow_path

シャドウ用の画像へのパスを指定します。デフォルト「assets/snippets/maxigallery/dropshadow/」。

thumb_use_watermark

ウォーターマークを適用するかどうかを指定します。デフォルト「しない（0）」

thumb_watermark_font

ウォーターマークのフォントサイズを指定します。以下を指定できます。

  • 1
  • 2
  • 3
  • 4
  • 5

デフォルト「1」。

thumb_watermark_halign

ウォーターマークの挿入位置（水平方向）を指定します。以下を指定できます。

  • left
  • center
  • right

デフォルト「right」

thumb_watermark_valign

ウォーターマークの挿入位置（垂直方向）を指定します。以下を指定できます。

  • top
  • center
  • bottom

デフォルト「bottom」

thumb_watermark_img

ウォーターマークとして利用する画像のパスを指定します。アルファチャンネルつきのPNG画像を利用できます。デフォルト「assets/snippets/maxigallery/watermark/watermark.png」

thumb_watermark_txt

ウォーターマークとして適用したいテキストを指定します。デフォルト「Copyright <YEAR>」

thumb_watermark_txt_color

ウォーターマークとして適用したいテキストのカラーをRGBヘキサで指定します。デフォルト「FFFFFF」

thumb_watermark_txt_hmargin

ウォーターマークテキストの水平方向のマージンを「px」で指定します。デフォルト「2」

thumb_watermark_txt_vmargin

ウォーターマークテキストの垂直方向のマージンを「px」で指定します。デフォルト「2」

thumb_watermark_type

ウォーターマークのタイプを指定します。以下を指定できます。

  • image
  • text

デフォルト「text」

パラメータ（ノーマルサイズ用）

画像をアップロードする際に作成するノーマル画像用のパラメータです。

△目次に戻る

quality_pic

ノーマルサイズの画像のクォリティをパーセントで指定します。デフォルト「70」。

max_pic_size

画像の最大サイズをピクセルで指定します。アップロードした画像のサイズがここで指定したサイズを超える場合は、この値にリサイズされます。「0」を指定するとオリジナルのサイズままアップロードします。「&max_pic_size=450」または「&max_pic_size=400x300（width x height）」のように指定します。デフォルト「450」。

pic_use_imagemask

イメージマスクを適用するかどうかを指定します。デフォルト「しない「0」

pic_mask_img

イメージマスクとして適用したい画像へのパスを指定します。デフォルト「assets/snippets/maxigallery/imagemask/demomask-frame2.png」。

pic_mask_bgcolor

マスク部分の背景色をRGGヘキサで指定します。この色はページの背景色と同じ色にすべきでしょう。デフォルト「FFFFFF」。

pic_mask_position

イメージマスクの位置を指定します。以下が指定できます。

  • top
  • topleft
  • topright
  • left
  • center
  • right
  • bottom
  • bottomleft
  • bottomright
  • resize

「resize」は、イメージマスクを画像のサイズに合わせます。デフォルト「resize」。

pic_use_dropshadow

シャドウを適用するかどうかを指定します。デフォルト「しない（0）」。

pic_shadow_bgcolor

シャドウの背景色をRGBヘキサで指定します。この色は、ページの背景色と同じにすべきでしょう。デフォルト「FFFFFF」。

pic_shadow_path

シャドウ用の画像へのパスを指定します。デフォルト「assets/snippets/maxigallery/dropshadow/」。

pic_use_watermark

ウォーターマークを適用するかどうかを指定します。デフォルト「しない（0）」

pic_watermark_font

ウォーターマークのフォントサイズを指定します。以下を指定できます。

  • 1
  • 2
  • 3
  • 4
  • 5

デフォルト「3」。

pic_watermark_txt

ウォーターマークとして適用したいテキストを指定します。デフォルト「Copyright <YEAR> <SITENAME>」

pic_watermark_txt_color

ウォーターマークとして適用したいテキストのカラーをRGBヘキサで指定します。デフォルト「FFFFFF」

pic_watermark_txt_hmargin

ウォーターマークテキストの水平方向のマージンを「px」で指定します。デフォルト「10」

pic_watermark_txt_vmargin

ウォーターマークテキストの垂直方向のマージンを「px」で指定します。デフォルト「10」

pic_watermark_type

ウォーターマークのタイプを指定します。以下を指定できます。

  • image
  • text

デフォルト「text」

pic_watermark_halign

ウォーターマークの挿入位置（水平方向）を指定します。以下を指定できます。

  • left
  • center
  • right

デフォルト「right」

pic_watermark_valign

ウォーターマークの挿入位置（垂直方向）を指定します。以下を指定できます。

  • top
  • center
  • bottom

デフォルト「bottom」

pic_watermark_img

ウォーターマークとして利用する画像のパスを指定します。アルファチャンネルつきのPNG画像を利用できます。デフォルト「assets/snippets/maxigallery/watermark/watermark.png」

バラメータ（ビッグサイズ用）

画像をアップロードする際に作成するビッグサイズ画像用のパラメータです。

△目次に戻る

keep_bigimg

大きいサイズ、またはオリジナルサイズの画像を保存するかどうかを指定します。デフォルト「しない（0）」。ファイル名に「beg_」がつきます。

ただし「1」を指定してもオリジナル画像が「max_pic_size」で指定サイズを超えない場合、大きい画像としては特に保存されないません。

従って、「1」を指定した場合、「display=`normal`」で、ノーマルサイズの画像をクリックすると大きなサイズ（オリジナルサイズ）の画像を表示する仕様ですが、上記の場合は、大きいサイズの画像がないため、Not found になります。と思ったんだけど、マネージャ画面で「Resynch Gallery」をクリックすると同期するみたい？

「keep_bigimg」の指定を解除した後、「Resynch Gallery」をクリックすると大きいイメージの画像は削除される。

quality_big

大きい画像のクォリティをパーセントで指定します。デフォルト「100」。

max_big_size

画像の最大サイズをピクセルで指定します。アップロードした画像のサイズがここで指定したサイズを超える場合は、この値にリサイズされます。「0」を指定するとオリジナルのサイズを保持します。「&max_big_size=1240」または「&max_big_size=800x600（width x height）」のように指定します。デフォルト「1024」。

big_img_linkstyle

画像の表示方法を指定します。以下を指定できます。

  • slidebox
  • lightboxv2
  • popup
  • external

デフォルト「external」です

big_mask_bgcolor

マスク部分の背景色をRGGヘキサで指定します。この色はページの背景色と同じ色にすべきでしょう。デフォルト「FFFFFF」。

big_mask_img

イメージマスクとして適用したい画像へのパスを指定します。デフォルト「assets/snippets/maxigallery/imagemask/demomask-frame2.png」。

big_mask_position

イメージマスクの位置を指定します。以下が指定できます。

  • top
  • topleft
  • topright
  • left
  • center
  • right
  • bottom
  • bottomleft
  • bottomright
  • resize

「resize」は、イメージマスクを画像のサイズに合わせます。デフォルト「resize」。

big_shadow_bgcolor

シャドウの背景色をRGBヘキサで指定します。この色は、ページの背景色と同じにすべきでしょう。デフォルト「FFFFFF」。

big_shadow_path

シャドウ用の画像へのパスを指定します。デフォルト「assets/snippets/maxigallery/dropshadow/」。

big_use_dropshadow

シャドウを適用するかどうかを指定します。デフォルト「しない（0）」。

big_use_imagemask

イメージマスクを使用するかどうかを指定します。デフォルト「しない（0）」。

big_use_watermark

ウォーターマークを適用するかどうかを指定します。デフォルト「しない（0）」。

big_watermark_font

ウォーターマークのフォントサイズを指定します。以下が指定できます。

  • 1
  • 2
  • 3
  • 4
  • 5

デフォルト「5」。

big_watermark_halign

ウォーターマークの（水平）配置を指定します。以下を指定できます。

  • left
  • center
  • right
  • デフォルト「right」。

big_watermark_img

ウォーターマーク用の画像へのパスを指定します。画像は透過PNGを使用できます。

big_watermark_txt

ウォーターマーク用のテキストを指定します。デフォルト「Copyright <YEAR> <SITENAME>」

big_watermark_txt_color

ウォーターマーク用のテキストカラーをRGBヘキサで指定します。デフォルト「FFFFFF」。

big_watermark_txt_hmargin

テキストウォーターマークの左右マージンを「ピクセル」で指定します。デフォルト「15」。

big_watermark_txt_vmargin

テキストウォーターマークの上下マージンを「ピクセル」で指定します。デフォルト「15」。

big_watermark_type

ウォーターマークのタイプを指定します。以下を指定できます。

  • image
  • text

デフォルト「text」。

big_watermark_valign

ウォーターマークの（垂直）配置を指定します。以下を指定できます。

  • top
  • center
  • bottom

デフォルト「bottom」。

パラメータ（ftp）

ftp用に用意されたパラメータです

△目次に戻る

ftp_base_dir

ベースディレクトリを指定します。

例えば、「/home/ユーザ名/www/MODx/」にMODxをインストールしている場合、以下のように指定します。

&ftp_base_dir=`/www/MODx/`

ftp_user

ユーザー名を指定します。

ftp_pass

パスワードを指定します。

ftp_port

ポート番号を指定します。デフォルト「21」。

ftp_server

ホスト名（アドレス）を指定します。

use_ftp_commands

サーバー側がサポートしていれば、fileシステム構築の際、maxigallery がPHP FTP コマンドを利用するかどうかを指定します。デフォルト「利用しない（0）」。

利用の際は、サーバー側でサポートしているかどうか確認してください。

パラメータ（テンプレート）

テンプレート用に用意されたパラメータです。

テンプレートはデフォルトでそれぞれ「assets/snippets/maxigallery/templates/」から読み込まれます。

テンプレートの指定方法には以下があります。

  • Chunk name
  • @FILE:<path to a file>
  • @CODE:<template string>

テンプレートで利用可能なプレイスホルダは後述します。

△目次に戻る

galleryOuterTpl

ギャラリーの一番外側に来るテンプレートを指定します。デフォルト「galleryoutertpl.html」。

childgalleryTpl

親アルバムでリストアップしているサブアルバムアイテム（サムネイル）ブロック用テンプレートを指定します。デフォルト「childgallerytpl.html」。

galleryPictureTpl

各アルバムでの各アイテム（サムネイル）ブロック用のテンプレートを指定します。デフォルト「gallerypicturetpl.html」。

pictureTpl

各画像を表示するときのテンプレートを指定します。デフォルト「picturetpl.html」

pageNumberTpl

ページナンバーブロック用のテンプレートを指定します。デフォルト「pagenumbertpl.html」

manageButtonTpl

マネージャ画面へ移動するためのボタン用のテンプレートを指定します。デフォルト「managebuttontpl.html」

manageOuterTpl

マネージャ画面の一番外側に来るテンプレートを指定します。デフォルト「manageoutertpl.html」

managePictureTpl

マネージャ画面での各アイテムブロック用テンプレートを指定します。デフォルト「managepicturetpl.html」

manageUploadTpl

マネージャ画面でのアップロードブロック用テンプレートを指定します。デフォルト「manageuploadtpl.html」

テンプレートの配置イメージ

親アルバムの場合：
┌galleryOuterTpl start
│─ ( manageButtonTpl ) … マネージャ権限でアクセスした場合に表示
│─ childgalleryTpl
└galleryOuterTpl end
各アルバムの場合：
┌galleryOuterTplstart
│─ ( manageButtonTpl ) … マネージャ権限でアクセスした場合に表示
│─ ( pageNumberTpl ) …ページナビゲーションが有効な場合に表示
│─ galleryPictureTpl　→　pictureTpl
└galleryOuterTpl end
マネージャ画面：
┌galleryOuterTpl start
│─ managePictureTpl … 数分繰り返し
│─ manageUploadTpl … 数分繰り返し
└galleryOuterTpl end

clearerTpl

「pics_per_row」パラメータを使うときに行を明確に区切るために利用するテンプレート。デフォルト「clearertpl.html」

draggableTpl

ポップアップソート（ポップアップしたウィンドウ内でサムネイルをドラッグして並べ替えるられる機能）時に利用するテンプレート。デフォルト「draggabletpl.html」

利用可能なプレイスホルダ

wiki を参考にしてします。

△目次に戻る

galleryOuterTpl

  • [+maxigallery.managebutton+] … マネージャ画面用ボタン
  • [+maxigallery.childgalleries+] …サブアルバム用テンプレート（childgalleryPictureTpl）を挿入
  • [+maxigallery.childgallerycount+] … サブアルバムの数
  • [+maxigallery.currentpage+] … 現在のページ番号
  • [+maxigallery.pagecount+] … トータルページ数
  • [+maxigallery.previous_page_url+] … 前ページへのリンクURL
  • [+maxigallery.next_page_url+] … 次ページへのリンクURL
  • [+maxigallery.pagenumbers+] … ページナンバーブロック用のテンプレート（pagenumbertpl.html）を挿入
  • [+maxigallery.pictures+] … 各アルバムでの各アイテムブロック用のテンプレー（galleryPictureTpl）を挿入
  • [+maxigallery.picscount+] … ギャラリーの画像の数
  • [+maxigallery.embedtype+] … 「embedtype」で指定された値
  • [+maxigallery.pageinfo.fieldname+] … ギャラリ用ドキュメントのドキュメントオブジェクト。「pagetitle」「longtitle」「pub_date」など
  • [+maxigallery.strings.keyname+] … 「click_to_zoom」や「previous」「next」など、言語ファイルから読み込まれるテキスト
  • [+maxigallery.config.parameter+] … スニペットパラメータの値

childgalleryTpl

  • [+maxigallery.picscount+] … ギャラリーの画像の数
  • [+maxigallery.pageinfo.fieldname+] … ギャラリ用ドキュメントのドキュメントオブジェクト。「pagetitle」「longtitle」「pub_date」など
  • [+maxigallery.strings.keyname+] … 「click_to_zoom」や「previous」「next」など、言語ファイルから読み込まれるテキスト
  • [+maxigallery.picture.fieldname+] … maxigallery テーブル（modx_maxigallery）のフィールド名。「id」「gal_id」「filename」「title」「date」「descr」「pos」「own_id」「hide」
  • [+maxigallery.childurl+] … サブアルバムへのリンクURL
  • [+maxigallery.path_to_gal+] … カレントギャラリへのパス（assets/galleries/120/　など）
  • [+maxigallery.big_pic_exists+] … ビッグサイズの画像が存在するかどうか（する=1 || しない=0）
  • [+maxigallery.picture_height_big+] … ビッグサイズの画像の高さ
  • [+maxigallery.picture_width_big+] … ビッグサイズの画像の幅
  • [+maxigallery.picture_height_normal+] … ノーマルサイズの画像の高さ
  • [+maxigallery.picture_width_normal+] … ノーマルサイズの画像の幅
  • [+maxigallery.picture_height_thumb+] … サムネイル画像の高さ
  • [+maxigallery.picture_width_thumb+] … サムネイル画像の幅
  • [+maxigallery.config.parameter+] … スニペットパラメータの値

galleryPictureTpl

  • [+maxigallery.embedtype+] … 「embedtype」で指定された値
  • [+maxigallery.picture.fieldname+] … maxigallery テーブル（modx_maxigallery）のフィールド名。「id」「gal_id」「filename」「title」「date」「descr」「pos」「own_id」「hide」
  • [+maxigallery.path_to_gal+] … カレントギャラリへのパス（assets/galleries/120/　など）
  • [+maxigallery.picture_link_url+] … 画像へのリンク
  • [+maxigallery.big_pic_exists+] … ビッグサイズの画像が存在するかどうか（する=1 || しない=0）
  • [+maxigallery.picture_height_big+] … ビッグサイズの画像の高さ
  • [+maxigallery.picture_width_big+] … ビッグサイズの画像の幅
  • [+maxigallery.picture_height_normal+] … ノーマルサイズの画像の高さ
  • [+maxigallery.picture_width_normal+] … ノーマルサイズの画像の幅
  • [+maxigallery.picture_height_thumb+] … サムネイル画像の高さ
  • [+maxigallery.picture_width_thumb+] … サムネイル画像の幅
  • [+maxigallery.pageinfo.fieldname+] … ギャラリ用ドキュメントのドキュメントオブジェクト。「pagetitle」「longtitle」「pub_date」など
  • [+maxigallery.strings.keyname+] … 「click_to_zoom」や「previous」「next」など、言語ファイルから読み込まれるテキスト
  • [+maxigallery.config.parameter+] … スニペットパラメータの値

pictureTpl

  • [+maxigallery.managebutton+] … マネージャ画面用ボタン
  • [+maxigallery.big_img_linkstyle+] … 「big_img_linkstyle」で指定した値
  • [+maxigallery.keep_bigimg+] … 「keep_bigimg」で指定した値
  • [+maxigallery.path_to_gal+] … カレントギャラリへのパス（assets/galleries/120/　など）
  • [+maxigallery.picture.fieldname+] … maxigallery テーブル（modx_maxigallery）のフィールド名。「id」「gal_id」「filename」「title」「date」「descr」「pos」「own_id」「hide」
  • [+maxigallery.counter+] … 現在の画像番号
  • [+maxigallery.total_pics_count+] … このギャラリのトータル画像数
  • [+maxigallery.previous_pic_url+] … 前の画像へのリンク
  • [+maxigallery.next_pic_url+] … 次の画像へのリンク
  • [+maxigallery.index_url+] … ギャラリインデックスへのリンク
  • [+maxigallery.big_pic_exists+] … ビッグサイズの画像が存在するかどうか（する=1 || しない=0）
  • [+maxigallery.picture_height_big+] … ビッグサイズの画像の高さ
  • [+maxigallery.picture_width_big+] … ビッグサイズの画像の幅
  • [+maxigallery.picture_height_normal+] … ノーマルサイズの画像の高さ
  • [+maxigallery.picture_width_normal+] … ノーマルサイズの画像の幅
  • [+maxigallery.picture_height_thumb+] … サムネイル画像の高さ
  • [+maxigallery.picture_width_thumb+] … サムネイル画像の幅
  • [+maxigallery.pageinfo.fieldname+] … ギャラリ用ドキュメントのドキュメントオブジェクト。「pagetitle」「longtitle」「pub_date」など
  • [+maxigallery.strings.keyname+] … 「click_to_zoom」や「previous」「next」など、言語ファイルから読み込まれるテキスト
  • [+maxigallery.config.parameter+] … スニペットパラメータの値

pageNumberTpl

  • [+maxigallery.pageurl+] … ページURL
  • [+maxigallery.pagenumber+] … ページ番号
  • [+maxigallery.pagecount+] … トータルページ数
  • [+maxigallery.currentpage+] … カレントページ番号
  • [+maxigallery.config.parameter+] … スニペットパラメータの値

manageButtonTpl

  • [+maxigallery.urlaction+] … フォームアクションのためのURL
  • [+maxigallery.hiddenfields+] … フォームのための隠しフィールド
  • [+maxigallery.strings.keyname+] … 「click_to_zoom」や「previous」「next」など、言語ファイルから読み込まれるテキスト
  • [+maxigallery.config.parameter+] … スニペットパラメータの値

manageOuterTpl

  • [+maxigallery.messages+] … マネージャ画面でのエラーメッセージ。言語ファイルから読み込まれる
  • [+maxigallery.urlback+] … ギャラリーへ戻るためのリンクURL（デフォルトでは「back to normal view」ボタンとして表示されている）
  • [+maxigallery.urlaction+] … フォームアクションのためのURL
  • [+maxigallery.urldragsort+] … ポップアップソートへのリンクURL（デフォルトでは「Sort pictures」ボタンとして表示されている）
  • [+maxigallery.managepictures+] … 各アイテムブロック用テンプレート（managePictureTpl）を挿入
  • [+maxigallery.uploadpictures+] … アップロードブロック用テンプレート（manageUploadTpl）を挿入
  • [+maxigallery.hiddenfields+] … マネージャ画面で必要な隠しフィールド
  • [+maxigallery.pics_allowed_count+] … アップロードが許可されている画像の数
  • [+maxigallery.config.parameter+] … スニペットパラメータの値
  • [+maxigallery.pageinfo.fieldname+] … ギャラリ用ドキュメントのドキュメントオブジェクト。「pagetitle」「longtitle」「pub_date」など
  • [+maxigallery.strings.keyname+] … 「click_to_zoom」や「previous」「next」など、言語ファイルから読み込まれるテキスト

managePictureTpl

  • [+maxigallery.picture.fieldname+] … maxigallery テーブル（modx_maxigallery）のフィールド名。「id」「gal_id」「filename」「title」「date」「descr」「pos」「own_id」「hide」
  • [+maxigallery.path_to_gal+] … カレントギャラリへのパス（assets/galleries/120/　など）
  • [+maxigallery.fieldnames.field+] … input フィールドに与える名前（name）。「delete」や「position」など。テンプレートを参照してください。
  • [+maxigallery.strings.keyname+] …  「click_to_zoom」や「previous」「next」など、言語ファイルから読み込まれるテキスト
  • [+maxigallery.config.parameter+] … スニペットパラメータの値

manageUploadTpl

  • [+maxigallery.counter+] … アップロードフィールドの行番号
  • [+maxigallery.fieldnames.file+] …  input フィールドに与える名前。
  • [+maxigallery.config.parameter+] … スニペットパラメータの値

draggableTpl

  • [+maxigallery.path+] … maxigallery がインストールされているディレクトリパス
  • [+maxigallery.path_to_gal+] … カレントギャラリへのパス（assets/galleries/120/　など）
  • [+maxigallery.pageinfo.fieldname+] … ギャラリ用ドキュメントのドキュメントオブジェクト。「pagetitle」「longtitle」「pub_date」など
  • [+maxigallery.strings.keyname+] … 「click_to_zoom」や「previous」「next」など、言語ファイルから読み込まれるテキスト
  • [+maxigallery.config.parameter+]  … スニペットパラメータの値

ギャラリーサンプル

MaxiGallery で構築したギャラリーはこちらです（今作ってます…）。

問題点（うちのサイトでの）

maxigalleryが読み込む、default.cssのナニカと、このサイトで定義しているcss（prot_x.cssまたはcube-black_x.css）の相性が、IE的に良くないらしく、「manager pictures」ボタンが表示されている状態だと？、画像サムネイルが表示されない。FFでは問題なし。また、IEでも、「manager pictures」ボタンが表示されていない状態（ブラウジング状態）なら表示の問題なし（たぶん）。

△ページトップ