NHR Smart Media Manager – Media Library Folders & AI Alt Text
| 开发者 | nhrrob |
|---|---|
| 更新时间 | 2026年10月10日 16:28 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
NHR Smart Media Manager organizes your WordPress media library into folders and writes alt text with AI. It adds a Smart Library page under Media, puts a folder tree in the media modal used by the block editor and page builders, and adds a folder filter to the Media Library. Folders are virtual, so file URLs never change. Any folder can also be shown on your site as an image gallery that updates itself when the folder changes.
Key Features:
- Virtual Folder System — Create nested folders to organize your media. Folders are stored as a custom taxonomy and do not move files on disk. Give folders a color, drag them into your own order, and search the folder tree.
- Folders in the Media Library and Media Modal — The media modal used by the block editor, featured image picker, and page builders gets a folder tree, and Media → Library (grid and list view) gets a folder dropdown. Files uploaded there go into the selected folder.
- Folder Gallery Block — Turn any folder into an image gallery on your site. Add the Folder Gallery block, pick a folder, and the gallery follows it: add, remove, or reorder images in the folder and every gallery using it updates on its own. Also available as a shortcode.
- Import and Export — Import folders and file assignments from FileBird, Real Media Library, CatFolders, Folders, Enhanced Media Library, Wicked Folders, Media Library Organizer, Mediamatic, HappyFiles, and WP Media Folder. Export your folder structure as a JSON file and import it on another site.
- Modern Grid & List View — Grid or sortable list view with thumbnail size control. Sort by date added, date modified, name, size, uploader, or your own custom order.
- Light and Dark Theme — The Smart Library and its settings page follow your system's light or dark setting, with a toggle in the top bar to choose either one.
- File Details Panel — Slide-in panel with editable title, alt text, caption, and description. See where each file is used: post content, featured images, custom fields, page builder data, product galleries, and the site logo.
- Files in Several Folders — Keep one file in more than one folder without duplicating it.
- Bulk Operations — Select multiple files and move them, add them to a folder, edit their title, alt text, caption, and description together, download them as a ZIP, or move them to the trash.
- Trash and Restore — Deleted files go to a Trash view first, where they can be restored or deleted permanently.
- Replace File — Upload a new version of a file. The URL and every place the file is used stay the same.
- Download as ZIP — Download a selection or a whole folder with its subfolders as one ZIP file.
- Smart Search & Filters — Search by title, file name, alt text, and caption. Filter by file type, upload date, and your own uploads at the same time. Shareable URL state.
- Missing Alt Text View — See every image without alt text, with a live count.
- Unused Files View — Scan the library for files with no reference in post content, featured images, custom fields, page builder data, product galleries, or the site logo. Files used only in theme files or CSS are not detected, so review the list before deleting.
- AI Alt Text, Captions, Titles & Descriptions — Generate text for a file with one click, for a selection, or for every image missing alt text, using the WordPress AI connector you configure at Settings → Connectors. Optionally write alt text automatically on upload. Choose the language, preferred model, maximum length, extra instructions, and whether to use the page title and SEO focus keyphrase (Yoast SEO, Rank Math, SEOPress) as context.
- Upload Enhancements — Assign files to folders on upload, drag-and-drop files or whole folders from your desktop (subfolders are kept), per-file progress bars, and a default upload folder.
- Starred & Recent — Star files and reopen recent ones. Both lists are saved to your user account.
- WP-CLI —
wp nhrsmm alt --limit=200generates alt text for images that have none. - AI agent and MCP ready — The plugin registers six abilities with the WordPress Abilities API, so AI agents and MCP clients (through the WordPress MCP Adapter) can list folders and files, find images without alt text, see where a file is used, create a folder, move files and write alt text, titles and captions. Editors and above only. Nothing can be deleted through them.
- Multisite — Each site in a network has its own folders and settings.
- Keyboard Shortcuts — Full keyboard navigation (Escape, Delete, Ctrl+A, Shift+click range select, Arrow keys).
- Add the Folder Gallery block in the block editor and choose a folder.
- Choose the number of columns, the image size, how many images to show, and whether images link to the file, the attachment page, or nothing.
- Upload a new image into the folder, or drag one in, and it appears in the gallery on every page that uses that folder. Remove it from the folder and it leaves the gallery.
- Images follow the folder's custom order when you have set one (sort by Custom Order in Smart Library and drag the files), otherwise newest first.
- The gallery is a responsive grid built on the standard WordPress gallery markup: your chosen number of columns on larger screens, at most two on phones.
- In the classic editor, widgets, or page builders, use the shortcode:
[nhrsmm_gallery folder="12" columns="3" size="medium" link="file" limit="50"]. The folder ID is shown in the Smart Library address bar when the folder is open.
安装:
- Upload the
nhrrob-smart-media-managerfolder to the/wp-content/plugins/directory. - Activate the plugin through the 'Plugins' menu in WordPress.
- Go to Media → Smart Library to access the new media manager.
- Optionally, go to Settings → NHR Smart Media to configure display defaults and view AI connector status.
屏幕截图:
常见问题:
Does this add a new page or change the existing media library?
The plugin adds a new "Smart Library" submenu item under the Media menu. Your existing WordPress media library and the media modal keep working as before; the plugin adds a folder tree to the media modal and a folder dropdown to the Media Library so you can filter by folder and upload into a folder.
Do I need an AI provider to use this plugin?
No. All features (folders, grid view, bulk operations, search) work without any AI provider. AI features (alt text and caption generation) require a compatible AI connector plugin installed and configured at Settings → Connectors.
Where are my folders stored?
Folders are stored as WordPress taxonomy terms (custom taxonomy nhrsmm_media_folder). Files are not physically moved on disk — it is a virtual organization layer.
Does this work with popular plugins?
Yes. Folders are virtual, so file URLs never change. The folder tree appears in the standard WordPress media modal, which page builders and the block editor use.
What happens when I delete a file?
It is moved to the Trash view, where you can restore it or delete it permanently. WordPress empties trashed items after 30 days by default.
Can I show a folder as a gallery on my site?
Yes. Add the Folder Gallery block and pick a folder, or use the [nhrsmm_gallery folder="12"] shortcode. The gallery always shows what is in the folder, so you manage it from the media library instead of editing each page.
Can an AI agent or MCP client use this plugin?
Yes. The plugin registers six abilities with the WordPress Abilities API (they all start with nhrsmm/). Three only read: list folders, list files (with filters such as missing alt text) and where a file is used. Three make changes: create a folder, move files to a folder, and update a file's alt text, title, caption or description. They need the same permission as the Smart Library (Editor and above) and the right to edit each file. An agent cannot delete or replace a file, delete a folder or change settings. To use them over MCP, install the WordPress MCP Adapter plugin; this plugin does not bundle it. The abilities never call your AI provider.
Which PHP versions are supported?
PHP 7.4 and every later version. Each change is tested on PHP 7.4 through 8.5, and on the upcoming 8.6.
Can I move my folders from another plugin?
Yes. Open Smart Library and use the plug icon at the bottom of the folder sidebar. Folders and file assignments are copied; the other plugin's data is not changed.
更新日志:
1.3.0
- New: AI agent and MCP support. Six abilities registered with the WordPress Abilities API: list folders, list files, where a file is used, create a folder, move files, and update alt text, title, caption or description. Editors and above; nothing can be deleted through them.
- Compatibility: verified on PHP 7.4 through 8.5 and on PHP 8.6 release candidates.
- Developer: every pull request now runs the PHPCompatibilityWP ruleset plus a syntax check, the unit tests and a runtime smoke test on each supported PHP version. The security probe also covers abilities.
- New: Light and dark theme for the Smart Library and its settings page. Follows your system setting, with a toggle in the top bar.
- New: Preferred AI model setting.
- New: AI button next to the Alt Text and Caption fields in the details panel.
- Improved: Folder dropdowns, media lists, the ZIP file listing, and the unused files scan run fewer database queries.
- Improved: Larger folder names, and larger folder import and export buttons that stay visible at the bottom of the sidebar.
- Improved: Clearer message when no AI provider is connected.
- Fix: Sorting by size no longer hides files whose size was not calculated yet.
- New: Folder tree in the media modal and folder dropdown in Media → Library (grid and list), with upload into the selected folder.
- New: Import folders from FileBird, Real Media Library, CatFolders, Folders, Enhanced Media Library, Wicked Folders, Media Library Organizer, Mediamatic, HappyFiles, and WP Media Folder.
- New: Export and import the folder structure as JSON.
- New: Folder colors, manual folder order, folder search, collapsible and resizable sidebar, breadcrumb path.
- New: Startup folder and default upload folder settings.
- New: Trash view with restore; deleting a file now moves it to the trash first.
- New: Missing alt text view and Unused files view with a library scan.
- New: Bulk edit of title, alt text, caption, and description.
- New: Bulk AI alt text, AI titles and descriptions, optional alt text on upload, and AI options (language, length, page context, extra instructions).
- New:
wp nhrsmm altWP-CLI command. - New: Replace a file while keeping its URL.
- New: Download a selection or a folder as a ZIP.
- New: Keep a file in several folders; hold Shift while dropping files on a folder to add instead of move.
- New: Sort by date modified, uploader, or a custom drag-and-drop order; filter by upload date and your own uploads.
- New: Upload whole folders from your desktop and keep their structure.
- New: Folder Gallery block and
[nhrsmm_gallery]shortcode: show a folder as a gallery that updates when the folder changes. - New: Starred and Recent lists are saved per user account.
- Improved: Search now matches file names and alt text.
- Improved: "Used In" also checks custom fields, page builder data, product galleries, and the site logo.
- Improved: Uninstall cleans up every site in a multisite network.
- Fixed: Dragging a multi-file selection onto a folder now moves all selected files.
- Fixed: The bulk action bar could sit below the visible area on short windows.
- Fixed: AI was shown as connected, and AI buttons were offered, on sites with no AI connector configured.
- Fixed: Files that also had terms from another plugin's taxonomy were counted as Uncategorized.
- Security: All plugin routes now require Editor+ (manage_categories). Folders are shared taxonomy terms — restricting to upload_files allowed any uploader to modify the global folder structure.
- Security: Added per-attachment permission checks on AI alt text, AI caption, and media usage REST API endpoints.
- Minor bug fixes and improvements.
- Initial release