Movable Type プラグインディレクトリ
EntryImages
エントリー内の画像(imgタグ)の情報を出力します。サイドバー等に「最近の画像」を表示する際などに利用します。
インストール方法
- ダウンロードした「EntryImages_1_02.zip」を解凍します。
- 解凍して生成された「EntryImages.pl」ファイルを、Movable Typeの「plugins」ディレクトリにアップロードします。ただし、Movable Typeの文字コードをUTF-8以外に設定している場合は、その文字コードに変換してアップロードします。
使い方
- 主なタグ
- MTEntriesHaveImages
- 画像(imgタグ)を含むエントリーを出力するコンテナタグです。このコンテナの中では、MTEntry系のタグを使うことができます。
以下のアトリビュートに対応しています。 - lastn="N"
- 画像を含むエントリーが最大でN件まで見つかるまで検索を続けます。
- img_lastn="N"
- 最大でN件の画像が見つかるまでエントリーを検索します。
- sort_order="descend|ascend"
- 最新のエントリーから検索するか(descend)、その逆にするか(ascend)を指定します。
- img_sort_order="descend|ascend"
- 検索されたエントリーを新しいものから出力するか(descend)、その逆にするか(ascend)を指定します。
- force="1"
- カテゴリー・アーカイブ・テンプレートと日付アーカイブ・テンプレートでも、全エントリーを検索対象にします。
- MTEntryImages
- エントリーに含まれる画像の情報を出力するコンテナタグです。
タグを入れる箇所によって、以下の3通りの動作をします。 - 単独で使う場合
- MTEntriesHaveImagesタグのコンテナの内部で使う場合
- 単独で使い、「this_entry="1"」のアトリビュートをつける場合
- MTEntryImageEntry
- 画像を含むエントリーを表すコンテナタグです。このコンテナの中では、MTEntry系のタグを使うことができます。
MTEntryImagesコンテナの中で、見つかった画像を含むエントリーの情報を表示したい場合に使います。 - MTEntryImageSrc
- 画像(imgタグ)のsrc属性の値を出力する変数タグです。以下のアトリビュートに対応しています。
- regex="正規表現"
- src属性の値を正規表現で置換します。
- 例えば、Movable Typeの機能で画像のサムネールを生成するようにしている場合、以下のようにすると、サムネールを表示し、そこがクリックされたときに元の画像が表示されます。
- MTEntryImageWidth / MTEntryImageHeight
- imgタグのwidth / height属性の値を出力する変数タグです。以下のアトリビュートに対応しています。
- default="x"
- imgタグにwidth / height属性の値が指定されていない場合には、xを出力するようにします。
- cell_size="x,y"
- 横xピクセル / 縦yピクセルに収まり、かつ元のwidth / heightの縦横比を維持するように、幅と高さを計算した値を出力します。
- MTEntryImageAlt
- imgタグのalt属性の値を出力する変数タグです。
- 利用例
- その他の機能
- 画像の情報
- 画像等の個数のカウント
- 条件判断
このプラグインをインストールすると、多数のテンプレートタグが追加されます。主なタグの使い方は以下の通りです。
すべてのエントリーを対象に画像を検索し、見つかった画像の情報を出力します。ただし、カテゴリー・アーカイブ・テンプレートと日付アーカイブ・テンプレートでは、そのアーカイブのエントリーのみが検索対象になります。
コンテナ内の個々のエントリーに含まれる画像の情報を出力します。
現在の操作対象になっているエントリーから画像を検索します。MTEntriesタグのコンテナの中や、エントリー・アーカイブ・テンプレートの中で、対象のエントリーの画像を取り出したいときにこのアトリビュートを使います。
また、MTEntriesHaveImagesタグと同じアトリビュートを指定することができます。
<a href="<$MTEntryImageSrc regex="s/(.*)-thumb?.(.*)/$1.$2/"$>"><img src="<$MTEntryImageSrc$>" /></a>
以下のリストは、Movable Typeの標準テンプレートで、エントリーに含まれる画像の中から最近の5件を取り出し、サイドバーに表示する例です。
<div class="module-images module">
<h2 class="module-header">最近の画像</h2>
<div class="module-content">
<MTEntryImages img_lastn="5">
<p><a href="<MTEntryImageEntry><$MTEntryPermalink$></MTEntryImageEntry>">
<img src="<$MTEntryImageSrc$>" width="140" height="105" alt="<$MTEntryImageAlt$>" /></a></p>
</MTEntryImages>
</div>
</div>
サイドバーに最近の画像を表示した例
上記で解説した以外に、以下のタグが追加されます。
MTEntryImageTitle / MTEntryImageClass / MTEntryImageID
MTEntriesHaveImagesCount / MTEntryImageTotalCount /
MTEntryImageCount
MTEntryImageHeader / MTEntryImageFooter / MTEntryImageRowHeader / MTEntryImageRowFooter / MTEntryImageIfEmptyCell / MTEntriesIfHaveImages / MTEntryIfHaveImages
また、画像を検索する際に、一部の画像を検索から除外することもできます。
これらの詳細については、作者のブログをご参照ください。
カスタマイズ情報
特になし
その他付加情報
特になし
利用規約
特になし
トラックバック
- トラックバック URL