توضیحات
Physical Media Folders is a WordPress media folder plugin that creates real directories inside /wp-content/uploads.
Use it to create physical media folders, browse existing upload directories, select a destination folder, and upload new files directly into that location.
The selected directory becomes part of the stored file path and public media URL.
For example, a file uploaded into a folder named press-kit can be stored at:
/wp-content/uploads/press-kit/company-profile.pdf
Its public URL will also include the physical folder path:
https://example.com/wp-content/uploads/press-kit/company-profile.pdf
Unlike virtual media folder plugins that primarily organize attachments using database records, taxonomies, or metadata, Physical Media Folders works with actual directories on the server.
The folder structure shown by the plugin reflects the physical structure available through FTP, hosting file managers, server backups, and other filesystem tools.
Uploaded files are also registered as standard WordPress Media Library attachments, allowing them to remain available through the regular WordPress media workflow.
Create physical folders in WordPress uploads
Physical Media Folders lets authorized WordPress users create meaningful directories inside the active uploads location.
Folders can be used to organize media by:
- Client
- Project
- Department
- Product
- Campaign
- Documentation type
- Press resource
- Course module
- Content category
Nested folder structures can also be created when more detailed organization is required.
Examples include:
/wp-content/uploads/clients/client-name/
/wp-content/uploads/products/product-name/
/wp-content/uploads/courses/module-1/
/wp-content/uploads/press-kit/brand-assets/
Upload media directly into a selected folder
The plugin provides a dedicated screen under:
Media > Physical Folders
From this screen, users can:
- Browse existing directories under the WordPress uploads folder.
- Create a new physical folder.
- Create a nested folder structure.
- Select an upload destination.
- Choose a file from their computer.
- Upload the file directly into the selected directory.
The uploaded file is then registered as a normal WordPress attachment.
For supported image files, WordPress can also generate its standard attachment metadata and image sizes.
Physical folders compared with virtual media folders
Many WordPress media organization plugins create virtual folders.
Virtual folders can be useful for organizing attachments inside the WordPress Dashboard, but they do not always change where the files are physically stored on the server.
Physical Media Folders uses real filesystem directories.
This means the folder structure visible through the plugin also exists inside /wp-content/uploads.
Physical folders may be useful when you need:
- Predictable upload paths
- Meaningful directory names
- Clean, path-based media URLs
- Filesystem organization visible through FTP
- Easier navigation through a hosting file manager
- Separation of files by client, project, product, or department
- A folder structure that remains visible outside WordPress
Clean file paths and predictable media URLs
Files uploaded through the plugin retain the selected folder as part of their path.
Instead of relying only on date-based upload directories, you can create paths that describe the purpose of the file.
For example:
/uploads/press-kit/logo.png
/uploads/client-a/contracts/agreement.pdf
/uploads/products/product-one/manual.pdf
/uploads/training/module-two/video.mp4
This can make file locations easier to understand for administrators, developers, content editors, and teams working with server files.
Key features
- Create real folders inside
/wp-content/uploads - Create nested physical folder structures
- Browse existing upload directories in a folder tree
- Select a destination folder before uploading
- Upload new media directly into the selected physical directory
- Include the folder path in the final media URL
- Register uploaded files in the WordPress Media Library
- Generate standard WordPress image attachment metadata
- Follow WordPress file-type restrictions
- Follow the configured WordPress upload-size limit
- Restrict folder operations to users with upload permissions
- Use nonce verification for administrative actions
- Validate paths to prevent directory traversal
- Prevent navigation through symbolic links
- Use prefixed plugin identifiers to reduce conflicts
- Provide a lightweight, focused administration interface
- Require no separate configuration screen
WordPress-native upload handling
Physical Media Folders uses WordPress upload and attachment APIs for file processing.
The plugin respects:
- WordPress user capabilities
- WordPress upload permissions
- Allowed MIME types
- Maximum upload sizes
- Attachment creation
- Image metadata generation
- Existing upload-directory settings
This helps uploaded files remain compatible with the standard Media Library workflow.
Current limitations
The current version focuses on creating folders and uploading new files into selected physical directories.
It does not currently:
- Automatically move existing Media Library files
- Move existing attachments between folders
- Rename existing folders
- Delete existing folders
- Filter the standard Media Library grid by physical folder
- Replace the default WordPress media modal
- Automatically register files uploaded through FTP
- Synchronize manually created filesystem files
- Provide confirmed WordPress Multisite support
- Guarantee compatibility with every CDN or media-offloading plugin
These limitations are stated clearly so administrators can evaluate whether the plugin matches their workflow.
عکسهای صفحه






نصب
- Upload the plugin files to
/wp-content/plugins/physical-media-folders, or install the plugin through the WordPress Plugins screen. - Activate Physical Media Folders through the Plugins screen.
- Open Media > Physical Folders.
- Create a new folder or select an existing upload directory.
- Choose a file and upload it into the selected physical folder.
- Confirm that the uploaded file appears in the WordPress Media Library.
Before enabling the plugin on an established production website, test it on a staging environment.
Your hosting environment must allow WordPress to create directories and upload files inside the active WordPress uploads location.
سوالات متداول
-
How do I create physical folders in WordPress uploads?
-
Open Media > Physical Folders in the WordPress Dashboard.
Select the uploads root or an existing directory, click the option to create a new folder, and enter the folder name.
The plugin creates an actual directory inside the active WordPress uploads location.
-
Can I upload WordPress media to a custom folder?
-
Yes.
Select a physical folder from the folder tree and upload a new file. The file will be stored directly inside the selected directory.
-
Does the selected folder appear in the media URL?
-
Yes.
Files uploaded through the plugin include the selected folder path in their stored location and public attachment URL.
For example:
/wp-content/uploads/press-kit/document.pdf -
Are uploaded files added to the WordPress Media Library?
-
Yes.
Files uploaded through the Physical Folders screen are registered as standard WordPress attachments and appear in the Media Library.
-
Does the plugin move existing Media Library files?
-
No.
The current version does not move existing attachments automatically or manually. It creates physical folders and uploads new files into the selected directory.
-
Can I move an existing attachment into another folder?
-
Not currently.
Moving existing Media Library attachments between physical folders is not included in this version.
-
Can I rename or delete folders?
-
Not currently.
The plugin supports browsing, creating, and selecting physical folders.
Folder renaming and deletion are not included in the current version.
-
What is the difference between physical and virtual media folders?
-
Virtual media folders usually organize attachments through database records, metadata, or taxonomies without changing the physical file location.
Physical Media Folders creates actual directories inside the WordPress uploads folder and stores uploaded files in those directories.
-
Will deactivating the plugin break existing file URLs?
-
Deactivating the plugin does not delete or relocate previously uploaded files.
Existing files remain in their physical directories, and their URLs should continue working as long as the files and server configuration remain unchanged.
The Physical Folders interface and folder-specific upload workflow will not be available while the plugin is inactive.
-
Does the plugin replace the standard WordPress Media Library?
-
No.
The plugin adds a separate Media > Physical Folders screen.
Files uploaded through this screen are still registered in the standard WordPress Media Library.
-
Can I upload files directly into the uploads root?
-
Yes.
You can select the uploads root or choose a directory below it before uploading.
-
Which file types can be uploaded?
-
The plugin follows the file types allowed by WordPress for the current user and website configuration.
Disallowed file types will be rejected.
-
Does the plugin allow executable PHP files to be uploaded?
-
No.
Uploads are validated using WordPress file-type rules.
The plugin also adds protective files to newly created or used directories where supported. Server-level upload security remains the responsibility of the hosting provider or website administrator.
-
Does the plugin follow the WordPress maximum upload size?
-
Yes.
The plugin applies the maximum upload size configured for the WordPress website and hosting environment.
-
Can files added through FTP be synchronized automatically?
-
No.
Files manually uploaded through FTP or a hosting file manager are not automatically registered as WordPress Media Library attachments.
-
Does the plugin support WordPress Multisite?
-
WordPress Multisite compatibility has not yet been formally tested.
Test the plugin on a staging multisite installation before enabling it across a production network.
-
Does it work with CDN or media-offloading plugins?
-
Compatibility depends on how the other plugin changes upload paths, attachment URLs, or file-storage behavior.
Test the plugin combination on a staging website before using it in production.
-
Does the plugin change existing WordPress upload settings?
-
No.
The plugin applies its custom directory only during uploads initiated through the Physical Folders screen.
نقد و بررسیها
نقد و بررسیای برای این افزونه یافت نشد.
توسعه دهندگان و همکاران
“Physical Media Folders” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کردهاند.
مشارکت کنندگانترجمه “Physical Media Folders” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
2.0
- Added an improved physical-folder interface.
- Added physical folder creation.
- Added nested folder creation.
- Added browsing of existing upload directories.
- Added folder selection before uploading.
- Added direct uploads into selected physical directories.
- Added WordPress Media Library attachment registration.
- Added WordPress image metadata generation.
- Added WordPress file-type validation.
- Added upload-size validation.
- Added user-capability verification.
- Added nonce verification for administrative actions.
- Added directory traversal protection.
- Added symbolic-link traversal protection.
- Added additional upload-directory protection where supported.
- Added uniquely prefixed classes, methods, actions, handles, and identifiers.
- Improved admin upload behavior.
- Improved plugin security.
- Improved WordPress coding-standard compatibility.
- Improved WordPress Plugin Check compatibility.
- Improved plugin documentation and screenshot descriptions.
1.0
- Initial release.
1.1.4
- Fix text domain to ‘physical-media-folders’ in headers and i18n calls.
- Align readme plugin name with header.