Folder Structure Uploader for WordPress

1. 概要

このプラグインは、WordPress 標準のメディアライブラリに登録せず、静的ファイル一式を FTP に近い感覚で安全に配置・管理するためのものです。

2. 今回の変更点

3. インストール

1. folder-structure-uploader フォルダを wp-content/plugins/ に配置します。
2. 管理画面の プラグイン から Folder Structure Uploader for WordPress を有効化します。
3. 左メニューの Folder Uploader を開きます。
4. 必要に応じて拒否拡張子を調整します。

有効化時に作られるもの

• wp-content/uploads/site-assets/ ディレクトリ
• {wp_prefix}fsuwp_manifest テーブル
• {wp_prefix}fsuwp_history テーブル
• {wp_prefix}fsuwp_virtual_folder_history テーブル
• fsuwp_settings オプション

4. 管理画面の見方

5. 仮想フォルダ

仮想フォルダは、site-assets 配下に作る任意の中間フォルダです。案件や顧客単位で保存領域を分けたいときに使います。

例: 仮想フォルダ
clients/acme/campaigns

保存先ルート名
lp_2026

実際の保存先
wp-content/uploads/site-assets/clients/acme/campaigns/lp_2026/...

入力例

• clients/acme
• projects/2026/spring
• landing-pages

6. アップロード手順

6-1. ZIP アップロード

1. 保存先仮想フォルダ を必要に応じて入力します。
2. 保存先ルート名 を必要に応じて入力します。
3. ZIP ファイル を選択します。
4. 既存ファイルがある場合 を選びます。
5. ZIP をアップロード を押します。

ZIP 内の構成
lp_2026/
  index.html
  css/
    style.css
  js/
    app.js

仮想フォルダ
clients/acme

保存先
wp-content/uploads/site-assets/clients/acme/lp_2026/index.html
wp-content/uploads/site-assets/clients/acme/lp_2026/css/style.css
wp-content/uploads/site-assets/clients/acme/lp_2026/js/app.js

6-2. フォルダ直接アップロード

1. 対応ブラウザで フォルダを選択 を使います。
2. ブラウザが相対パスを取得できると、検出ファイル数が表示されます。
3. ZIP と同じく、仮想フォルダ、保存先ルート名、競合時動作を指定してアップロードします。

6-3. 個別ファイルアップロード

1. 保存先仮想フォルダ を必要に応じて入力します。
2. 保存先ルート名 を入力します。空欄なら現在の仮想フォルダ直下へそのまま保存されます。
3. ファイルを選択 で 1 件または複数件を選びます。
4. 個別ファイルをアップロード を押します。

例: 選択ファイル
index.html
privacy.html
contact.css

仮想フォルダ
clients/acme

保存先ルート名
site-pages

保存先
wp-content/uploads/site-assets/clients/acme/site-pages/index.html
wp-content/uploads/site-assets/clients/acme/site-pages/privacy.html
wp-content/uploads/site-assets/clients/acme/site-pages/contact.css

保存先ルート名を空欄にした場合

仮想フォルダ
clients/acme

保存先
wp-content/uploads/site-assets/clients/acme/index.html
wp-content/uploads/site-assets/clients/acme/privacy.html
wp-content/uploads/site-assets/clients/acme/contact.css

6-4. 競合時動作

7. 保存パスと公開 URL

公開 URL は WordPress 標準の wp_upload_dir() で得た base URL を使い、実フォルダ階層をそのまま反映して生成します。

物理保存先
wp-content/uploads/site-assets/clients/acme/lp_2026/css/style.css

公開 URL
https://example.com/wp-content/uploads/site-assets/clients/acme/lp_2026/css/style.css

• メディアライブラリ用の attachment URL は使いません。
• 物理パスと URL パスが一致します。
• 管理画面から URL をワンクリックでコピーできます。
• HTML ファイルや単体 CSS / JS も通常ファイルとして同じ階層のまま公開されます。

8. 履歴

履歴は 2 種類あります。ひとつはアップロード履歴、もうひとつは仮想フォルダ作成履歴です。アップロード履歴にはバッチ単位の結果を、仮想フォルダ作成履歴には作成したパスと URL を保持します。

アップロード履歴テーブルの主なカラム

仮想フォルダ履歴テーブルの主なカラム

9. セキュリティ

• 実行可能なのは manage_options 権限ユーザーのみです。
• すべての操作で nonce 検証を行います。
• ../、絶対パス、NULL バイト、ドット始まりのパスを拒否します。
• ZIP 内の各エントリを個別検証してから保存します。
• 危険拡張子は管理画面設定で制御できます。
• 保存先が必ず site-assets 配下に収まるか確認します。

デフォルト拒否拡張子

php, phtml, php3, php4, php5, phar, cgi, pl, exe, sh, bat, cmd, com, msi, htaccess

10. トラブルシュート

ZIP がアップロードできない

• ZIP 形式かを確認する
• ZipArchive が有効か確認する
• PHP のアップロードサイズ上限と実行時間上限を確認する

仮想フォルダが作れない

• 入力パスに ../ や先頭ドットが含まれていないか確認する
• wp-content/uploads/site-assets/ への書き込み権限を確認する

URL にアクセスできない

• Web サーバーが wp-content/uploads/ を配信できるか確認する
• サーバー設定やセキュリティプラグインで対象拡張子が止められていないか確認する
• 保存されたファイルの権限を確認する

履歴が古いものから消える

• 仕様通りです。アップロード履歴は 5,000 件、仮想フォルダ作成履歴は 1,000 件です。
• 過去の履歴を確認したい場合は、管理画面の 次の 100 件 ボタンからページ送りで遡ってください。
• 仮想フォルダのパスを忘れた場合は、管理画面の仮想フォルダ作成履歴を確認してください。

11. 確認テスト

1. clients/acme の仮想フォルダを作成できるか確認する。
2. 仮想フォルダ作成後に履歴へ表示され、公開 URL を確認できるか確認する。
3. lp_2026/index.html を含む ZIP を仮想フォルダ付きでアップロードし、同じ階層で保存されるか確認する。
4. 個別ファイルを複数選択して、指定した保存先ルート直下へ保存されるか確認する。
5. 個別ファイルで保存先ルート名を空欄にしたとき、現在の仮想フォルダ直下にそのまま保存されるか確認する。
6. 公開 URL が仮想フォルダ込みで生成されるか確認する。
7. 競合設定の 上書き / スキップ / エラー が正しく動くか確認する。
8. アップロード履歴で batch を展開したとき、実際のフォルダ構造が維持されたまま確認できるか確認する。
9. ネストしたフォルダをさらにクリックして、下位フォルダやファイルが展開されるか確認する。
10. ツリー内の各ファイルにある個別削除ボタンが動作するか確認する。
11. アップロード履歴と仮想フォルダ履歴の両方で 次の 100 件 が機能するか確認する。
12. 5,000 件を超えたときに古い履歴が削除されるか確認する。
13. 仮想フォルダ削除時に確認ダイアログが出て、配下ファイルごと削除されるか確認する。
14. アップロード履歴からの削除が batch 単位で正しく動くか確認する。

12. 拡張ポイント

• 特定フォルダの公開停止
• Basic 認証相当のアクセス制御
• 有効期限付き URL
• CDN 連携
• 一括置換アップロード
• バージョン管理