plugins:attach

NP_Attach

概要

アイテムにファイルを添付します。添付したファイルはアイテム/テンプレート変数<%Attach>の場所に、プラグインオプションで設定したテンプレートに従って表示されます。ファイルの添付フォームが新たにアイテム編集画面へ追加されます。

プラグイン内での処理の一部をNP_MediaUtilsNP_Thumbnailが担っているため、NP_MediaUtilsNP_Thumbnailを先にインストールしておく必要があります。

General Plugin info
作者: Mocchi
最新のバージョン: Ver.0.9.6 (RC2)
フォーラム参照先: 現トピック (旧トピック 旧々トピック)
依存関係: NP_MediaUtilsNP_Thumbnail
対応環境: Nucleus CMS 3.40以上、PHPのバージョン5以上

インストール方法

  1. ZIPファイルを展開して、中身をサーバーのプラグインディレクトリにアップロードします
  2. スクリプトのパーミションを変更し、実行権限を付与します
  3. 管理画面からプラグインをインストールして下さい

使い方

インストールすると、管理画面のアイテムの追加/編集フォームと、ブックマークレットのアイテムの追加/編集フォームに、ファイルを添付するためのフォームが表示されます。

添付したファイルは、タグ<%Attach(通し番号)%>で記事内に展開されます。タグは、アイテム内でも、テンプレート内でも、スキン内でも記述可能です。

タグのテンプレートは、後述のようにプラグインオプションで設定できます。

オプション

グローバルオプションとウェブログオプション、アイテムオプションを設けます。

グローバルオプション

  • 管理画面に表示するサムネイルの横幅の最大値
  • 管理画面に表示するサムネイルの縦幅の最大値
  • 管理画面に表示する縮小画像のテンプレート
    • テンプレートで使えるタグの種類に関しては後述します
  • 管理画面に表示する画像以外のテンプレート
    • テンプレートで使えるタグの種類に関しては後述します

ウェブログオプション

  • アイテムに添付できるファイルの数
    • アイテム編集画面に表示されるファイルアップロードフォームの数を指定します
  • ウェブログに表示する原寸画像のテンプレート
    • テンプレートで使えるタグの種類に関しては後述します
  • ウェブログに表示する画像以外のテンプレート
    • テンプレートで使えるタグの種類に関しては後述します

アイテムオプション

  • ファイルの情報
    • アイテムオプションに添付ファイルの情報が記録されます

テンプレートのタグの種類

使うことの出来るタグの種類は、原寸画像、縮小画像、画像以外でそれぞれ異なります。

タグ原寸画像縮小画像画像以外内容
<%link%>オリジナルファイルそのもののURLになります。
<%text%>ファイルの説明文(代替文)になります。
<%media%>オリジナルファイルへの完全なリンクになります。<%text%>を含む(X)HTMLのa要素になります。
<%width%>×オリジナル画像の幅になります。
<%height%>×オリジナル画像の高さになります。
<%image%>××オリジナル画像を表示する(X)HTMLのimg要素になります。<%link%>、<%width%>、<%height%>、<%text%>をすべて含みます。
<%thumb_width%>×サムネイル画像の横幅になります。
<%thumb_height%>×サムネイル画像の縦幅になります。
<%thumb_url%>×サムネイル画像のURLになります。
<%rawpopuplink%>××ポップアップ・リンクへのURLとなります。
<%popuptext%>××上の<%text%>と同じですが、JavaScriptで利用できるようにhtmlエンティティ変換されています。
<%popupcode%>××ポップアップウィンドウを開くためのJavaScriptコード(windowオブジェクトを使用)になります。
<%popuplink%>××

備忘録

このプラグインのキモは以下の3つの動作

  • アイテムの編集画面でちゃんとファイル投稿フォームおよび投稿されているファイル情報が出力できること
  • アイテムを投稿した時に、ファイルのアップロードおよび削除、ファイル情報の更新ができること
  • アイテム/テンプレート変数<%Attach(番号)%>から呼び出されたときに、指定されたファイルへのアンカーをちゃんと出力できること

開発履歴

  • 2011.04.04 Ver.0.9.6 (RC2)
    • [Mocchi] 仕様変更
    • [Mocchi] リリースキャンディデート2
  • 2011.12.26 Ver.0.9.5 (RC1) 非公開
    • [Mocchi] リリースキャンディデート1
  • 2010.12.15 Ver.0.9
    • Ver.1.0のベータ版としてリリース
 
plugins/attach.txt · 最終更新: 2011/04/04 14:18 (外部編集)