Version: 1.5.3

Author: simdej

License: GPL-2.0+

Description

Media Library Folders is a powerful, lightweight WordPress plugin that helps you organize your messy Media Library into custom, manageable folders. Utilizing a native WordPress taxonomy, this plugin seamlessly integrates a folder tree sidebar directly into your Media Library interface.

It fully supports both the Grid View and List View, allowing you to drag and drop files, create nested subfolders, and easily filter your attachments. Because it uses native WordPress taxonomy, it is highly compatible with other themes and plugins.

Key Features

• Drag and Drop Interface: Visually drag media files directly into folders in the sidebar.
• Nested Subfolders: Create endless levels of subfolders for precise organization.
• Bulk Moving: Move multiple selected files into a folder all at once.
• Unorganized Tracking: Easily find files that haven’t been assigned to a folder yet via the “Unorganized” view.
• Folder Management: Rename, delete, empty, and manually reorder your folders.
• Export & Import: Backup your entire folder structure as a JSON file and restore it on another site.
• Performance Optimized: Accurate file counting that respects native WordPress filters without bogging down your database.

Installation

1. Download the plugin folder/zip.
2. Upload the media-library-folders directory to your /wp-content/plugins/ directory, or upload the .zip file directly via the WordPress Plugins > Add New screen.
3. Activate the plugin through the Plugins menu in WordPress.
4. Navigate to Media > Library to start organizing!

User Guide

1. Navigating the Interface

Once activated, you will see a new Folders sidebar on the left side of your Media Library.

• All files: Shows every media item in your library.
• Unorganized: Shows only media items that have not yet been placed into a custom folder.
• Use the Search box below the main folders to quickly find a specific folder by name.

2. Creating Folders

• Add a Main Folder: Click the Folder + icon at the top right of the sidebar. Enter your desired name.
• Add a Subfolder: First, click on an existing folder to select it (it will highlight in blue). Then, click the Subfolder + icon at the top right of the sidebar.

3. Moving Files into Folders

• Single File (Drag & Drop): Click and hold any media file in the grid or list, drag it over to your desired folder in the sidebar, and release.
• Multiple Files (Grid View): Click the Bulk select button at the top of the grid. Select all the files you want to move. Drag any of the selected files to the sidebar, or use the “Move to” dropdown next to the “Delete selected” button to move them all at once.
• Multiple Files (List View): Check the boxes next to the files you want to move, then drag any of the checked rows into a folder.

4. Managing Folders

Click on a folder in the sidebar to make it active, then use the toolbar icons above the tree:

• Move Up / Move Down (Arrows): Reorder how folders appear in your list.
• Refresh (Circle Arrows): Reload the media view.
• Edit (Pencil): Rename the currently selected folder.
• Empty (X): Remove all files from the selected folder (files are not deleted, they simply become “Unorganized”).

5. Settings, Export, and Import

Click the Settings (Gear) icon in the folder toolbar to open the advanced options panel:

• Expand/Collapse All: Quickly open or close all nested subfolders.
• Show item counts: Toggle the display of the numbers indicating how many files are in each folder.
• Delete Folder: Permanently delete the currently selected folder. (Note: The files inside are not deleted; they are moved to the Unorganized view).
• Export: Download a backup of your entire folder structure as a .json file.
• Import: Upload a previously exported .json file to instantly recreate your folder structure on this or another website.