Title: KDA Media Button Author: deniskey Published: July 21, 2026 Last modified: July 21, 2026 --- Search plugins ![](https://ps.w.org/kda-media-button/assets/icon.svg?rev=3617486) # KDA Media Button By [deniskey](https://profiles.wordpress.org/deniskey/) [Download](https://downloads.wordpress.org/plugin/kda-media-button.1.3.3.zip) * [Details](https://wordpress.org/plugins/kda-media-button/#description) * [Reviews](https://wordpress.org/plugins/kda-media-button/#reviews) * [Installation](https://wordpress.org/plugins/kda-media-button/#installation) * [Development](https://wordpress.org/plugins/kda-media-button/#developers) [Support](https://wordpress.org/support/plugin/kda-media-button/) ## Description KDA Media Button extends the classic WordPress editor with a new button. Clicking the button opens a popup window that gives access to the site structure so you can: * Browse folders relative to a configured base folder. * Upload new images directly into the current folder. * Select an existing image and insert it into the post. The plugin is fully configurable from its settings page: * **Accessible folder** — a path relative to the site root. The plugin can only browse and upload inside this folder, which keeps the rest of the filesystem protected. * **Allowed formats** — comma separated list of allowed extensions. Leaving it empty allows all common image formats (jpg, jpeg, png, gif, webp, svg, ico, bmp, tiff, tif, avif). * **Roles** — choose which roles (e.g. Administrator, Editor) can see the editor button. * **Lightbox link class** — set a custom CSS class for the image link, or leave empty to disable the class. * **Activity log** — optionally keep a log of uploads, deletions, folder creation and renames. #### Working with images When an image is selected you can fine-tune the insertion: * **Size** — insert the original (Full) or a generated Thumbnail / Medium / Large copy. * **Alignment** — None, Left, Center or Right (adds the matching WordPress align class). * **Alt text** — custom alternative text for the inserted image. * **Link to full image** — wrap the image in a link to the full-size file with a built-in lightbox. * **Metadata** — resolution (width×height) and file size are shown before insertion, with a live thumbnail preview. You can select multiple images (multi-select) and insert them as a gallery using the `[kda_media_button_gallery]` shortcode: ``` [kda_media_button_gallery urls="https://.../a.jpg,https://.../b.jpg" size="medium" columns="3" link="none"] ``` #### File management Inside the popup you can also manage the folder structure: * Create new subfolders. * Rename files and folders. * Delete files and folders (recursive). #### Security * Folder traversal outside the configured base folder is blocked. * Uploaded files are validated against the allowed formats list and handled through the WordPress upload API. * All AJAX requests are protected with nonces and role/capability checks. ## Installation 1. Upload the `kda-media-button` folder to the `/wp-content/plugins/` directory. 2. Activate the plugin through the “Plugins” menu in WordPress. 3. Go to **Settings → KDA Media Button** to configure the accessible folder, allowed formats and roles. 4. Open a post in the classic editor and use the new “Insert image from folder” button. ## FAQ ### Does it work with the block editor (Gutenberg)? No. Gutenberg support is currently disabled. The plugin works only with the classic editor. ### Can the plugin access any folder on the server? No. It is restricted to the folder configured on the settings page (relative to the site root). Path traversal is prevented. ### Which image formats are allowed by default? All common image formats are allowed. You can restrict them on the settings page. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “KDA Media Button” is open source software. The following people have contributed to this plugin. Contributors * [ deniskey ](https://profiles.wordpress.org/deniskey/) “KDA Media Button” has been translated into 1 locale. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/kda-media-button/contributors) for their contributions. [Translate “KDA Media Button” into your language.](https://translate.wordpress.org/projects/wp-plugins/kda-media-button) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/kda-media-button/), check out the [SVN repository](https://plugins.svn.wordpress.org/kda-media-button/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/kda-media-button/) by [RSS](https://plugins.trac.wordpress.org/log/kda-media-button/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.3.3 * Fixed plugin icon deployment to WordPress.org assets directory. * Improved lightbox reopening behavior. * Disabled columns control until multiple images are selected. * Added link-to-full-image option in insert modal. * Removed autofocus from modal close button. #### 1.3.2 * Improved plugin asset deployment to WordPress.org. * Fixed lightbox reopening behavior after close. * Disabled columns control until multiple images are selected. * Added link-to-full-image option in the insert modal. * Removed autofocus from the modal close button on open. #### 1.3.1 * Fixed lightbox reopening after close without page refresh. * Disabled columns control until multiple images are selected. * Added link-to-full-image checkbox in the insert modal. * Removed autofocus from the modal close button on open. * Improved modal option layout and validation. #### 1.3.0 * Improvements and bug fixes for the classic editor integration. * Refined base folder handling and settings validation. * General stability and usability improvements. #### 1.2.24 * Removed hardcoded default base folder path from code. * Saving an empty accessible folder is now rejected with an error. * Added centralized helper for base folder retrieval. * Improved uninstall routine to use shared helper. #### 1.2.23 * Fixed default base folder handling when the stored option is empty. * The folder field now always shows a valid default path in settings. #### 1.2.22 * Removed Gutenberg block support and block files from the plugin. * Public gallery CSS is now disabled by default. * Cleaned up block-related assets and metadata. #### 1.2.21 * Fixed default base folder fallback in settings. * Ensured default path is preserved when saving the settings form. #### 1.2.20 * Updated default base folder path to include leading and trailing slashes. * Normalized path formatting across all retrieval points. #### 1.2.19 * Added Russian readme translation. * Fixed language support metadata for WordPress.org. * Updated contributor name. #### 1.2.18 * Security: blocked symlink escapes in path resolution and required edit_posts/ edit_pages capability for REST access. * Fixed size AJAX handler reading an undefined variable. * Refactored legacy admin-ajax handlers to reuse shared core functions. * Cached image metadata to speed up browsing. * Added result limit to recursive search. * Unified image/shortcode rendering with responsive srcset. * SVG uploads/replacements are sanitized on save. * Temporarily disabled Gutenberg block support. * Registered the block via `register_block_type_from_metadata` (matches `block. json` `apiVersion: 2`); activity log is no longer autoloaded. #### 1.2.16 * Added Gutenberg block “Media from Folder” (`kda-media-button/media`). * Added REST API endpoints: `browse`, `size`, `srcset`, `tree`, `upload`, `mkdir`,` rename`, `delete`, `clear_log`, `duplicate`, `bulk_delete`, `bulk_move`, `replace_image`. * Added recursive folder search with subfolder checkbox. * Added bulk delete, bulk move, file duplicate, copy URL (single + bulk). * Added responsive `srcset`/`sizes` to gallery shortcode. * Added non-image file support (inserted as links). * Added WP-CLI commands: `wp kda-media-button clean-cache` and `wp kda-media-button rebuild-cache`. * Added replace-image overwrite endpoint. * Added settings page tabs: General, Permissions, Advanced, Activity log. * Added keyboard navigation (arrow keys + Enter) and skeleton loaders. * Added dark theme support (`prefers-color-scheme: dark`) and mobile breakpoint. #### 1.2.14 * Minor fixes and usability improvements. #### 1.0.0 * First version. * Classic editor button opening a folder browser popup. * Upload and select images with insertion into the post. * Settings page: base folder, allowed formats and role restriction. ## Meta * Version **1.3.3** * Last updated **10 hours ago** * Active installations **Fewer than 10** * WordPress version ** 5.0 or higher ** * Tested up to **7.0.2** * PHP version ** 7.2 or higher ** * Languages * [English (US)](https://wordpress.org/plugins/kda-media-button/) and [Russian](https://ru.wordpress.org/plugins/kda-media-button/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/kda-media-button) * Tags * [classic editor](https://wordpress.org/plugins/tags/classic-editor/)[folder](https://wordpress.org/plugins/tags/folder/) [images](https://wordpress.org/plugins/tags/images/)[media](https://wordpress.org/plugins/tags/media/) [upload](https://wordpress.org/plugins/tags/upload/) * [Advanced View](https://wordpress.org/plugins/kda-media-button/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/kda-media-button/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/kda-media-button/reviews/) ## Contributors * [ deniskey ](https://profiles.wordpress.org/deniskey/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/kda-media-button/)