自作プラグイン/attachlist

カテゴリ：プラグイン 自作 追加

添付ファイルの一覧表示と一括操作プラグイン

そのページに添付されたファイルの名前、ファイルサイズ、アップロード日時を表で一覧表示する。
キャッシュ機能付きのため2回目以降の表示は高速化される。
また、チェックボックスで添付されたファイルの一括削除・凍結・解凍が可能。

このプラグインでできること

• アップロード画面にそのページに添付されているファイルを一覧表示する
  • 名前、ファイルサイズ、アップロード日時を表にして表示
  • ファイルサイズの表記をKBかBかで選択可能
  • 2回目以降の表示はキャッシュを利用するため高速化する
    • キャッシュはアップロードフォルダ (attach) に変更があった場合に自動で更新される
• 添付ファイルをチェックボックスで選択して一括操作できる
  • 一括削除・凍結・解凍が可能
    • 凍結中のファイルは一括操作画面にマーク付きで表示される
  • 操作するファイルの一括選択/解除が可能
  • 一括操作には管理者パスワードが必要

ダウンロード

最新: GitHub

セットアップ

1. GitHubにある「attachlist.inc.php」をダウンロードしてpluginフォルダに入れる
2. 「添付」のリンクをattachからattachlistに変更するため、libフォルダ内にある「html.php」の以下の部分を変更する

-	$_LINK['upload']   = "$script?plugin=attach&pcmd=upload&page=$r_page";
+	$_LINK['upload']   = "$script?plugin=attachlist&pcmd=upload&page=$r_page";

プラグインの設定

ATTACHLIST_ALLOW_CACHE

キャッシュ機能を利用するかどうか。デフォルトはtrue。

ATTACHLIST_CACHE_DIR

キャッシュを保存するディレクトリ

ATTACHLIST_DISPLAY_BYTE

ファイルサイズをバイトで表示する。デフォルトはfalse (キロバイト表示)

使用方法

ページ上部の「添付」を押すとアップロード画面 + ファイル一覧が表示される。

添付ファイルの一括操作

添付ファイル一覧の左上に表示される「ファイルの一括操作」のリンクから操作画面に移ることができる。
この機能を利用する場合、ファイルの選択画面に行く前とファイル操作の最終確認画面で各1回ずつ、計2回管理者パスワードの入力が求められる。

選択画面では添付ファイルの一覧から任意のファイルをチェックボックスでマークする。
その後画面下の「削除」「凍結」「解凍」のいずれかを押すと確認画面が表示され、管理者パスワードを入力すると選択されたファイルの削除を行う。
凍結されているファイルがある場合、ファイル名の後ろにアスタリスク (*) がつく。

キャッシュのクリア

アクション型で以下のように入力して使うと、添付ファイル一覧のキャッシュを全て削除する。

?cmd=attchlist

削除を実行するには管理者パスワードが必要。

使用例

一覧表示に関してはこのページなどを参考に。

一括操作の画面に関しては自身で導入して確認を。

追加したい機能

• 添付ファイルの一覧作成にもattachのクラスが使えそう。
• 一括凍結・解凍
  • 自分自身ファイルの凍結・解凍は使ったことがないためニーズがあるのかどうか。
    一応機能を追加できるようには作ってある (と思う) ので気が向いたら取り掛かるつもり。
    v1.0で実装
• キャッシュの能動的削除
  何らかの理由でキャッシュを能動的に削除したい場合にプラグインの操作で消せたら楽かなと思う。
  v0.5で実装

備考

• v0.5以前はattachプラグインをいくらか改造する必要があったが、v1.0からはhtml.phpの1行を変更するのみで良くなった。v0.5からバージョンアップする際にattachプラグインを元の状態に戻すのを忘れずに。
• 表のソート機能などは別途それ用のプラグインを組み込んでおり、配布版にこの機能はないので注意。
• ついでに複数ファイルの一括アップロードを可能にしたい場合はこのページで解説しているので参考にどうぞ。

コメント