PixelVault — Media Library Folders

📁 PixelVault is the free way to organize your WordPress media library with unlimited, drag-and-drop media folders. Sort images, videos, PDFs, audio, and documents into nested, colour-coded folders — right inside the Media Library, exactly where you upload and choose files. Stop scrolling through hundreds of unsorted attachments. PixelVault lets you categorize media into folders and subfolders, filter instantly, and find any file in seconds — a proper file manager for your WordPress media. Folders are virtual — physical files never move, no URLs change, nothing breaks, and standard WordPress export/import keeps working without any special steps. ✨ Core Features

• 📂 Unlimited nested folders and subfolders — no depth limit, no folder count limit
• 🔗 Assign files to multiple folders — one file can appear in as many folders as you like
• 🎨 Folder colour coding — colour-label folders for instant visual orientation
• 🖱️ Drag-and-drop sidebar — reorder folders, move files, and create subfolders by dragging
• ⚡ Auto-assign uploads — new files go straight into whichever folder is selected
• 🔍 Search and sort — find folders instantly; sort manually, by name, or by file count
• ⌨️ Keyboard shortcut — press "n" to create a new folder
• 🖲️ Right-click context menu — Rename, Delete, Lock, Create subfolders, Copy gallery shortcode, Import ZIP to folder, Download all files
• 🌐 RTL language support — full right-to-left layout

🛠️ Organisation and Productivity Tools 📦 ZIP File Import Right-click any folder and choose "Import ZIP to folder". Upload a .zip archive and PixelVault extracts and assigns every image, video, audio file, and PDF directly into that folder. 🗺️ Media Usage Map Right-click any image and choose "Where is this used?" to see every post, page, or custom post type that references the file — useful before replacing or deleting files. ⬇️ Bulk Download as ZIP Right-click any folder to download all its files as a ZIP archive. 🔒 Folder Locking Lock any folder to prevent accidental renaming, deletion, moving, or file reassignment. Locked folders display a padlock badge. 📊 Storage Analytics Full storage overview with total size, average file size, file-type breakdown chart, top-10 largest files, and per-folder size distribution. Available under Settings → Analytics and as a WordPress Dashboard widget. ✏️ Bulk Alt Text Editor Batch-edit alt text on all images that are missing it — useful for accessibility and image SEO. Edit multiple files at once without opening each one individually. 🔄 Media Replace Swap any file in place, keeping the same URL and attachment ID. All existing references on posts and pages continue to work automatically. 🎯 Smart Filters Dynamic built-in views that update automatically: Missing Alt Text, Unused Files, Recent Uploads, and Large Files. 🗂️ Auto-Categorise Existing Media Bulk-organise your existing media library in one click via the import icon at the bottom of the folder panel. Choose a rule:

• 📅 By Year — creates a folder per year (e.g. 2023, 2024).
• 🗓️ By Month — creates a folder per month (e.g. January 2024, February 2024).
• 🏷️ By File Type — creates Images, Videos, Audio, PDFs, Documents, and Spreadsheets folders.

Choose Unassigned only to leave already-organised files untouched, or All files to reassign everything. PixelVault previews the result before making any changes. 🚚 Import from Other Plugins One-click migration from FileBird, Real Media Library, WP Media Folder, and Enhanced Media Library. Folder hierarchy and all file assignments are copied automatically. Go to Settings → Tools → Import from Another Plugin. The original plugin's data is never modified. 💾 Export and Import Back up your entire folder structure as a JSON file and restore it on any WordPress site — no SQL required. 🔐 Role Permissions Granular folder access per WordPress user role: control who can create, edit, and delete folders independently. 🧩 Gutenberg, Elementor, and Divi

• 🖼️ PixelVault Gallery block — insert a folder's contents as a responsive gallery with lightbox directly in the block editor
• 📝 [pixelvault_gallery] shortcode — classic editor, widgets, and theme template support
• 🎛️ Elementor — folder panel works inside the Elementor media modal
• 🏗️ Divi — folder panel works in the Divi backend builder and the Divi Front End Builder
• 🌍 Universal compatibility — PixelVault hooks into WordPress's native media modal, so it works with any theme or page builder

🏛️ Architecture: Virtual Taxonomy PixelVault stores folder assignments in WordPress's native taxonomy tables (wp_term_relationships). Physical files stay exactly where they are. Deleting a folder never deletes files. 👩‍💻 For Developers Full REST API and documented action/filter hooks. 🔌 REST API — Full CRUD at /wp-json/rayetun-medianest/v1/folders. Authenticate with X-WP-Nonce. ⚙️ Action hooks (selection):

• rayetun_medianest_folder_created( $term_id, $folder_id, $args )
• rayetun_medianest_folder_renamed( $term_id, $new_name )
• rayetun_medianest_folder_moved( $term_id, $new_parent, $old_parent )
• rayetun_medianest_folder_deleted( $term_id, $folder_object )
• rayetun_medianest_folders_reordered( $ordered_term_ids )
• rayetun_medianest_attachment_assigned( $attachment_id, $term_ids, $context )

🔧 Filter hooks (selection):

• rayetun_medianest_get_folders( $folders, $post_type ) — modify the folder list
• rayetun_medianest_auto_assign_target( $term_id, $attachment_id ) — override the upload target folder
• rayetun_medianest_smart_folders( $defs ) — register custom dynamic folders

JavaScript hooks (via @wordpress/hooks) let you add items to the folder/image context menus and the bulk-action bar. A full list of PHP and JavaScript hooks with examples ships in HOOKS.md inside the plugin.

1. Upload the plugin folder to /wp-content/plugins/.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to Media → Library — the folder panel appears on the left.

No configuration is required to get started.

1.1.4

• Fix: pressing the "N" key while typing in the block (Gutenberg) editor, Elementor, or Divi no longer triggers the folder shortcut — the "New Folder" keyboard shortcut is now limited to the Media Library screen, where the folder sidebar lives. Previously the letter "n" could be swallowed while writing a post or page.

1.1.3

• New: create a folder right from the media popup while adding images to a post, page, Elementor, or Divi — no need to pre-create it in the Media Library first. New uploads go straight into the folder you just made.
• New: ZIP imports now run in batches, so large archives (hundreds or thousands of files) import reliably without timing out, with a live "Importing X of Y…" progress readout.
• New: added safety guards to ZIP import — a per-file-count limit and an uncompressed-size (zip-bomb) limit — and abandoned extractions are now cleaned up automatically.
• Fix: dropping a .zip onto the "Import ZIP to folder" window no longer uploads it to the Media Library by mistake — the drop is now captured by the import window and sent to the chosen folder.
• Fix: the "Done" button in the ZIP import window now closes the window as expected.

1.1.2

• Fix: the Media Library layout no longer pulls WordPress's own "Help" and "Screen Options" tabs (and the update/admin notices) into the folder sidebar row. They now stay in their normal position instead of forming an empty column and pushing the media grid off-screen.
• Fix: newly uploaded files now appear in the grid instantly — with WordPress's native upload progress bar — without needing to reload the page.
• Fix: the folder drag handle and the expand/collapse arrow no longer overlap in the sidebar.
• Fix: the "Media → PixelVault" admin menu item now shows with correct capitalisation.
• New: developer filter rayetun_medianest_load_admin_assets lets companion plugins load the PixelVault folder sidebar inside their own media modals.

1.1.1

• Fix: folder drag-to-reorder now starts from anywhere on the folder row — previously it required a pixel-perfect press on the tiny drag handle, so reordering often did nothing.
• Fix: drag-to-reorder now works for Editors (users with the "Edit Any Folder" capability), not only Administrators. Previously it silently failed to save for non-admins.
• Tweak: the drag handle is hidden for users who don't have permission to reorder, so there's no confusing non-working handle.

1.1.0

• New: ⭐ Starred Folders — mark favourite folders and pin them to the top of the media library sidebar (per user).
• New: 🗂️ Folder Templates — save your current folder structure as a reusable template and apply it in one click (Settings → Tools).
• New: Folder Structure Backup — export your folder structure to a JSON file and re-import it on any site.
• New: Developer hooks — added a full set of PHP actions/filters and JavaScript hooks so add-ons can extend PixelVault. See HOOKS.md.
• Tweak: Assets now use file-modification-time cache-busting, so updates always load without a hard refresh.
• Fix: Quick Action cards on the dashboard no longer overlap on some screen widths.

🎉 1.0.0

• Initial release.
• Unlimited nested virtual folders with colour coding and drag-and-drop sidebar.
• Right-click context menu: rename, delete, lock/unlock, subfolder creation, gallery shortcode copy, ZIP import, usage map, bulk download.
• Keyboard shortcut: press n to create a new folder.
• Auto-assign new uploads to the selected folder.
• Search and sort controls (manual, A-Z, Z-A, file count).
• Role-based folder visibility and granular role permissions panel.
• Folder Locking with padlock badge.
• Bulk Download as ZIP — download any folder's contents as a zip archive.
• ZIP File Import — upload a zip and extract media directly into a folder.
• Media Usage Map — see every post and page that references any image.
• Import from other plugins — one-click migration from FileBird (v5 and v6), Real Media Library, WP Media Folder, and Enhanced Media Library.
• Auto-Categorise Existing Media — bulk-assign unorganised files into folders by year, month, or file type.
• Storage Analytics — overview dashboard, file-type chart, and per-folder size breakdown.
• Bulk Alt Text Editor — batch-edit missing alt text.
• Media Replace — swap any file in place, preserving its URL and attachment ID.
• Smart Filters — Missing Alt Text, Unused Files, Recent Uploads, Large Files.
• PixelVault Gallery Gutenberg block with lightbox support.
• [pixelvault_gallery] shortcode for classic editor and theme templates.
• Elementor media modal integration.
• Divi backend and frontend builder integration.
• REST API — full CRUD at /wp-json/rayetun-medianest/v1/folders.
• AJAX fallback for environments where the REST API is restricted.
• JSON Export and Import for folder structure backup and restore.
• RTL language support.
• Documented action and filter hooks for developers.
• No external services, no data collection.