=== AWT Media Manager Suite ===
Contributors: astridtechnology, sahiljb
Donate link: https://razorpay.me/@astridwebtechnologyllp
Tags: media manager, media renamer, attachment slug, file rename
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Rename media files and attachment slugs from the media library. Auto-renames all thumbnail sizes and updates every URL reference site-wide - without breaking a single link.

== Description ==

**AWT Media Manager Suite** lets you rename any media file and change its URL slug right from the WordPress media library - no FTP, no manual database edits, no broken links.

Open any media item, type in a new name, hit **Save Changes**, and the plugin handles everything automatically:

* The file is renamed on the server using the WordPress Filesystem API.
* All image sizes (thumbnail, medium, large, etc.) are renamed to match.
* Every post, page, widget, page builder block, and option that references that file is updated instantly.
* The URL slug can be changed independently from the filename.

Your pages, posts, and widgets keep working exactly as before - nothing breaks.

= Key Features =

* **File Rename** - Give any media file a clean, meaningful name without touching FTP or your hosting panel.
* **Slug Edit** - Change the URL-friendly slug of any attachment independently from the filename.
* **Nothing Breaks** - Every link, image, and reference across posts, postmeta, and options is updated automatically.
* **Thumbnails Included** - All automatically generated image sizes are renamed together with the original.
* **Works Everywhere** - Rename from the media library grid popup, the media list edit page, or directly from the attachment edit screen.
* **Safe & Secure** - All actions are nonce-verified. Only users with the `upload_files` capability (Authors and above) can rename files.
* **Serialization-Safe** - References stored in serialized postmeta and option values (page builders, widgets, theme mods) are handled correctly.

== Installation ==

1. Upload the `awt-media-manager-suite` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Open any file in the Media Library - the **Rename & Slug** section appears in the attachment details panel.

== Frequently Asked Questions ==

= Where do I find the rename fields? =

Go to your Media Library. In **grid view**, click any media item to open its details panel - you will see a **Rename & Slug** section with a **Save Changes** button. In **list view**, click **Edit** on any item to open the attachment edit page, where the same section appears.

= Will renaming a file break my website? =

No. The plugin scans and updates every post, page, postmeta row, and site option that contains a reference to the old file URL - so nothing breaks.

= Does it rename the different image sizes too? =

Yes. WordPress creates several sizes of every uploaded image (thumbnail, medium, large, etc.). All of those files are renamed at the same time as the original.

= Who can rename files? =

Any user with the `upload_files` capability can rename files. By default this includes Authors, Editors, and Administrators.

= Does it work with page builders like Elementor or Divi? =

Yes. The plugin updates image references stored in serialized postmeta and option values used by page builders, widgets, and theme mods - not just standard post content.

= Can I change the filename and the URL slug to different values? =

Yes. The filename and slug fields are completely independent - you can change one, the other, or both at the same time.

= Does the plugin leave any data behind when uninstalled? =

No. The plugin stores no custom database tables or options of its own, so uninstalling it leaves your database exactly as it was.

== Screenshots ==

1. Attachment details popup showing the Rename & Slug fields with Save Changes button.

== Changelog ==

= 1.0.0 =
* Initial release.
* Rename media files directly from the media library details popup and attachment edit page.
* Edit the attachment URL slug independently from the filename.
* Automatic renaming of all generated image sizes via WordPress Filesystem API.
* Site-wide reference update across post content, postmeta, and options - serialization-safe.
* Nonce-verified AJAX with `upload_files` capability check.

== Upgrade Notice ==

= 1.0.0 =
Initial release - install and start renaming media files directly from the media library.
