plugins:attach

差分

この文書の現在のバージョンと選択したバージョンの差分を表示します。

この比較画面にリンクする

plugins:attach [2011/04/04 14:18] (現在)
ライン 1: ライン 1:
 +====== NP_Attach ======
 +
 +===== 概要 =====
 +
 +アイテムにファイルを添付します。添付したファイルはアイテム/​テンプレート変数<​%Attach>​の場所に、プラグインオプションで設定したテンプレートに従って表示されます。ファイルの添付フォームが新たにアイテム編集画面へ追加されます。
 +
 +プラグイン内での処理の一部を[[plugins:​mediautils|NP_MediaUtils]]と[[plugins:​mediautils|NP_Thumbnail]]が担っているため、[[plugins:​mediautils|NP_MediaUtils]]と[[plugins:​mediautils|NP_Thumbnail]]を先にインストールしておく必要があります。
 +
 +^General Plugin info ^^
 +^作者: | [[plugins:​authors:​mocchi|Mocchi]] |
 +^最新のバージョン:​ | Ver.0.9.6 (RC2) |
 +^フォーラム参照先:​ | [[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​p=26805 | 現トピック]] ([[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​p=26045|旧トピック]] [[http://​japan.nucleuscms.org/​bb/​viewtopic.php?​t=4284&​|旧々トピック]])|
 +^依存関係:​ | [[plugins:​mediautils|NP_MediaUtils]]、[[plugins:​mediautils|NP_Thumbnail]] |
 +^対応環境:​ | Nucleus CMS 3.40以上、PHPのバージョン5以上 |
 +
 +
 +===== インストール方法 =====
 +
 +  - ZIPファイルを展開して、中身をサーバーのプラグインディレクトリにアップロードします
 +  - スクリプトのパーミションを変更し、実行権限を付与します
 +  - 管理画面からプラグインをインストールして下さい
 +
 +===== 使い方 =====
 +
 +インストールすると、管理画面のアイテムの追加/​編集フォームと、ブックマークレットのアイテムの追加/​編集フォームに、ファイルを添付するためのフォームが表示されます。
 +
 +添付したファイルは、タグ<​%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%>​|×|○|×|画像への完全なポップアップ・リンクになります。<​%popuptext%>​を含む(X)HTMLのa要素であり、<​%rawpopuplink%>​、<​%popupcode%>​を含みます。
 +
 +
 +
 +===== 備忘録 =====
 +このプラグインのキモは以下の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 (外部編集)