タグ<%Thumbnail%>をテンプレート/スキン/アイテムに記述することで、サムネイル画像を表示することができます。また、プラグインオプションを有効にすることで、アイテム内のタグ<%popup%>でもサムネイル画像を表示することができます。表示するサムネイル画像は、プラグインオプションのテンプレートで設定できます。サムネイルの動的/静的出力のどちらも可能です。
プラグイン内での処理の大部分をNP_MediaUtilsが担っているため、NP_MediaUtilsを先にインストールしておく必要があります。
| General Plugin info | |
|---|---|
| 作者: | Mocchi nakahara21 jirochou |
| 最新のバージョン: | Ver.3.9.6 (RC2) |
| フォーラム参照先: | 現トピック (旧トピック) |
| 依存関係: | NP_MediaUtilsに依存しています |
| 対応環境: | Nucleus CMS 3.40以上、PHPのバージョン5以上 |
<%Thumbnail(ファイルへの相対パス | 横幅の最大値 | 縦幅の最大値 | 説明文)%>
ファイルへの相対パスは、Nucleus CMSのコア機能で埋め込まれる<%image%>や<%popup%>、<%media%>と同じ文字列を指定します。つまり、ユーザ専用ディレクトリを利用するのであればファイル名のみ、それ以外はメディア用ディレクトリからの相対パスとなります。例えば「20101205-sample.png」や「public/sample2.jpeg」となります。
説明文は(X)HTMLのimg要素におけるalt属性となります。
これらはどれも必須です。
また、オプションを有効にすることでNucleus CMSコア機能が使う<%popup%>を、ポップアップリンク付きサムネイルに置き換えることができます。その場合のテンプレートは、ウェブログオプションで個別に指定することができます。
プラグインのグローバルオプションでファイルシステムを選択にしている場合、サムネイルをサーバに保存するようになるため、サーバの負担を軽減し、表示速度を早めることができます。保存先はメディア用ディレクトリの「.thumb」です。サムネイル生成のタイミングは表示する際とアップロードする際となります。
グローバルオプションとウェブログオプションを設けます。
テンプレートでは、以下を使うことができます。
| 使用可能なテンプレート一覧 | |
|---|---|
| <%thumb_url%> | サムネイル画像のURLになります。 |
| <%thumb_width%> | サムネイル画像の横幅になります。 |
| <%thumb_height%> | サムネイル画像の縦幅になります。 |
| <%link%> | オリジナル画像のURLになります。 |
| <%width%> | オリジナル画像の横幅になります。 |
| <%height%> | オリジナル画像の縦幅になります。 |
| <%text%> | ファイルの説明文（代替文）になります。 |
| <%media%> | オリジナル画像への完全なリンクになります。<%text%>を含む(X)HTMLのa要素になります。 |
| <%rawpopuplink%> | ポップアップ・リンクへのURLとなります。 |
| <%popuptext%> | 上の<%text%>と同じですが、JavaScriptで利用できるようにhtmlエンティティ変換されています。 |
| <%popupcode%> | ポップアップウィンドウを開くためのJavaScriptコード（windowオブジェクトのopenメソッドを使用）になります。 |
| <%popuplink%> | 画像への完全なポップアップ・リンクになります。<%popuptext%>を含む(X)HTMLのa要素であり、<%rawpopuplink%>、<%popupcode%>を含みます。 |
サムネイル画像を保存するように設定した状態で、<%Thumbnail%>や<%popup%>に与える数値でサムネイルのサイズを任意の値に指定した場合、テンプレートの<%thumb_url%>の挙動が変わります。
プラグインのグローバルオプションで設定した横幅と縦幅、あるいはタグで指定した横幅と縦幅に従い、NP_MediaUtilsのルールでリサイズされます。
グローバルオプションでサムネイル画像を保存するように設定している場合、Nucleus CMS管理画面左のクイックメニューに、NP_Thumbnailの管理画面へのリンクが表示されます。この管理画面では、サムネイル画像の連続生成と削除を行うことができます。
ボタンsyncでサムネイル画像を連続生成します。一度に生成できるサムネイルは10枚に限定しています。これは、サムネイル生成のような重い処理を一度に実行しようとすると、サーバに負担がかかり、他のユーザにとって迷惑となることに対する配慮からです。
ボタンclearでサムネイル画像をすべてクリアします。特定のサムネイル画像だけ削除することはできません。
プラグインのグローバルオプションで標準のサイズを変更した際、sync機能とclear機能を組み合わせることで、サムネイルの再生成を行うことができます。
