File Manager利用ガイド

File Manager (ファイルマネージャー)は、アップロードしたファイルを管理するモジュールです。

管理画面専用のモジュールで、サイト管理者が利用することを目的としています。ヘルプをよく読んでお使い下さい。

ご利用条件

• XOOPS Cube Legacy 専用モジュールです。従来のXOOPS 2環境では動作しません。
• 当モジュールを使う事で利用者に損害が生じても作者は一切責任を負いません。

概要

• SWFアップローダーを利用して複数のファイルをまとめてアップロード可能です。
• フォルダの作成・削除に対応しています。
• 設置サーバーの利用環境により利用できない場合があります。

特徴

• XOOPS Cube Legacy に完全対応しています。
• 複数のファイルのアップロードに対応しています。
• ビューワーを組み込んでおり、画像を見たり、各種動画・音楽を再生して見ることが出来ます。
• SWFアップローダのディレクトリにアクセス制限を行う為のhtaccessのサンプルを組成します。

一般設定

モジュールを使い始める前に、初期設定を行う必要があります。

• アップロードするデフォルトのパス
  アップロードする標準のフォルダ名を指定します。指定するフォルダは、XOOPS設置バス/uploads/より下のディレクトリが指定可能です。指定がない場合は、XOOPS設置バス/uploads/ になります。
  XOOPS設置バス/uploads/以外の設定は無効です。XOOPS設置バス/myimage/等は指定出来ません。
• サムネイルサイズ
  ファイルをリスト表示した時のサムネイルサイズを指定します。
• システム画像の非表示
  イメージマネージャーやアバターなどシステムで使っている画像を表示しません。非表示を推奨します。デフォルトは「いいえ」です。
• アップローダーのデバックをオン
  SWFUploadのデバッグ画面を有効にします。アップロード時のエラー解析に役立ちます。デフォルトは「いいえ」です。
• フォルダの操作をサポート
  「はい」を選ぶとフォルダの操作を可能にします。デフォルトは「いいえ」です。
• アップロード可能なファイルの拡張子
  アップロードを許可するファイルの拡張子を '|' 区切りで指定します。拡張子は、全て小文字で入力して下さい。
  デフォルトは、gif|jpg|jpeg|png|avi|mov|wmv|mp3|mp4|flv|doc|xls|ods|odt|pdf です。
• 【ffmpeg用設定】ffmpegを利用する
  ffmpegを利用する場合は、はいを選択して下さい。ffmpegは、サーバー側が対応している必要があります。
  お使いのサーバーに対応したバイナリを設置するか、ビルドして下さい。
• 【ffmpeg用設定】コマンド検索パス
  ffmpegの実行ファイルへパスが通っていない場合は、設置パスを指定します。
  (例: /usr/local/bin:/usr/bin)
• 【ffmpeg用設定】スクリーンショットの時間
  動画ファイルからスクリーンショットを撮る時間を動画の先頭からの時間（秒）を指定します。
• 【ffmpeg用設定】FLV変換のファイル形式
  FLV変換可能な動画ファイルの拡張子を '|' 区切りで指定します。拡張子は、全て小文字で入力して下さい。
  お使いのffmpegによって変換出来るファイル形式が異なります。
  デフォルトは、flv|avi|mwv|mov|mpg|qt|mov|3gp|3gp2|mp4 です。

一般設定が終わったら、動作環境の確認を行って下さい。

動作環境の確認では、使用しているライブラリのファイルのチェックを行います。
SWFUpload(FLASH)を使ったアップロードは、外部からのアクセスが可能になります。
SWFUploadを設置しているフォルダへ、htaccessを設置してアクセス制限を行って下さい。
動作環境の確認画面では、管理者のIPアドレスのみ利用できるhtaccessを組成しています。お使いのサーバーに合わせて設置してください。
複数の管理者で利用したい場合は、管理者のIPアドレスを追加すると良いでしょう。

使い方

フォルダ名とファイル名について

ファイルマネージャーで利用できるフォルダ名とファイル名は、半角英数字のみ（半角英数字と-~_）をサポートしています。
日本語のファイル名の操作に関しては対応していません。

フォルダごとの設定

ファイルマネージャーで操作出来るフォルダの属性は0777に固定されています。モジュール側で画像を管理している場合は、フォルダを削除されない為に0755,0775に設定しておくと良いでしょう。

ファイルのアップロードは、0755,0775,0777の場合にアップロードが可能になります。

フォルダのパーミッションと機能の一覧

フォルダのパーミッションと機能は以下のようになっています。誤って削除しないようにFTP等で設定してください。

ffmpegについて

サーバーサイドで動画の変換や画像の切り出しが可能になるライブラリです。

• ffmpgを利用する場合は、サーバー側の設定が必要になります。
• ffmpgを使った場合の動作を保障するものではありません。
• ffmpgは、バイナリでの配布は許可されていないので、別途ご用意下さい。
• ffmpgを使った操作は、ffmpgのコンパイルやサーバの環境へ依存します。
• 動画変換を使うと共有のレンタルサーバなどではサーバへの負荷が高くなるので、専用のサーバでお使い下さい。

注意事項

• XOOPSおよびImpressには、対応していません。また今後も対応する予定はありません。
• ファイルのアップロードは、アップロード画面を開いて３０分以上過ぎるとアップロードが出来ません。
  再度画面をリロードして表示しなおしてください。

サイトの閉鎖・移動の際の注意事項

※レンタルサーバでご利用の場合は、必ずご確認下さい。

ファイルマネージャーでファイルのアップロードやフォルダを作成した場合、フォルダ・ファイルの所有権がシステム側になりFTPなどで削除出来なくなる場合があります。

一度、ファイルをアップロードして、FTPソフトで削除可能かどうかを確認しておくことをオススメします。FTPソフトで削除出来ない場合は、必ずファイルマネージャーから削除を行って下さい。

サポートについて

• サポートはメールで行います。サポート用のサイトは準備中です。
• 日本語・英語のみ受付可能ですが、簡単な英語であれば答えることが可能です。

使用ライブラリとライセンス

ファイルマネージャー本体のライセンスは、GPLの予定です。

ファイルマネージャーは、以下のライブラリを利用しています。各ライブラリによってライセンスが異なりますから、必ずご確認ください。ライセンス違反による不正利用に関する問題について作者は関知いたしません。

• SWFUpload
  SWFUploadをファイルのアップロードに使用
  ライセンス：MIT License
• jQuery
  prettyPhotoをファイルのビューワーに使用
  ライセンス：MIT と GPL
• prettyPhoto
  prettyPhotoをファイルのビューワーに使用
  ライセンス：Creative Commons Attribution 2.5
• Flowplayer
  FlowplayerをFLVファイルのビューワーに使用
  ライセンス：GPL 3
  

参考URL

モジュールを作成するにあたり以下のサイトを参考にしました。

• http://swfupload.org/
• http://code.google.com/p/swfupload/
• http://drupal.org/node/287776
• http://youmos.com/reference/swfupload_setup.html (日本語)

変更履歴

• 0.8
  ベータ版の完成
• 0.9
  ファイルへのアクセス権により、操作などの表示を切り替えるようにした。
  ffmpegによる操作を組み込んで、サーバサイドで動画の扱いが可能にした。
  
• 0.95
  フォルダ選択のUIを変更して分かりやすくした。
  ファイルアップロードのリンク方法を変更して、使いやすくした。
  タブメニューシステムを廃止した。
  
• 0.96
  SWFUploadとJW FLV Playerの設置をcommonへ設置したものを使うように変更した。
  
• 0.97
  JW FLV PlayerとlightviewをFlowplayerとprettyPhotoに変更して、ライセンスを合わせた。
  利用している画像を変更し、画面デザインを少し変更した。
  SWFUploadを使う場合に、アップロード画面が表示される都度、新しいセッションを発行する方式へ変更した。
  使用しているライブラリのファイルチェック機能を追加した。
  
• 0.98
  SWFUploadのパスへ設置するhtaccessのサンプルを作成するようにした。
  トークン用のデータベースを追加を追加した。0.98以下のバージョンの人はアップデートが必要です。
  アップロードのチェックに独自にSQL側にトークンを保存して、アップロード時の不正アクセスを防止するようにした。
  

連絡先

モジュールに関する連絡先

• メール
  hiro1173.seike@gmail.com
• ウェブサイト
  http://beabo.net
  http://beabo.dip.jp
  http://code.google.com/p/hiro1173/