KooKoa Folders – Media Library Folders & File Organizer

1.1.2

• Compatibility: tested with WordPress 7.0 (released May 2026). The retro-dark sidebar, modals and bulk-organize toolbar now neutralize the WP 7.0 Modern admin theme overrides that were inflating our buttons to 40px, breaking dashicon rendering, and pulling icons out of alignment.
• Fix: Smart Startup Folder “Last opened folder” mode now reliably restores the last visited folder on page load. A latent regression in the Settings save path was persisting an empty post-types list, which then blocked the AJAX that records navigation. Both the save serializer and the AJAX validator have been hardened.
• Improvement: minor admin UI refinements.

1.1.1

• New: WooCommerce “Stock status” rule for Smart Folders — auto-group products by In stock, Out of stock, or On backorder. Visible only on the product custom post type when WooCommerce is active.
• Hardening: uninstall now sweeps every plugin-owned option and user meta key, including the post-1.0 additions (install timestamp, migration importer flags, the permanently-hide-migrate-section flag, per-user dismiss flags for dashboard notices and the Rate Us card). Deleting KooKoa Folders truly leaves zero traces behind.
• Hardening: Smart Startup Folder “Specific folder” preference now verifies that the saved folder still exists in the matching taxonomy before storing it, so a deleted folder no longer leaves a stale reference in user meta.
• Hardening: download Content-Disposition HTTP header now passes the filename through sanitize_file_name() as defense-in-depth against control-character injection.
• Improvement: minor admin UI refinements.

1.1.0

• New: Migration importer for FileBird (by Ninja Team), Folders (by Premio) and Real Media Library (by devowl.io). Detects existing folders straight from your database and rebuilds the full tree, with file assignments, inside KooKoa Folders in one click. No JSON export needed, no rebuilding from scratch. Optional one-click deactivation of the source plugin after a successful import. Data-driven: imports keep working even when the source plugin section has been partially disabled in its own settings.
• New: Sidebar hint in the Media Library that surfaces detected folder plugins and links straight to the importer.
• New: Architecture ready for more importers. HappyFiles, Enhanced Media Library, Wicked Folders and others can be added in a few lines each.
• Improvement: minor admin UI refinements.

1.0.4

• New: Dutch translation bundled (nl_NL).
• Improvement: minor admin UI refinements.

1.0.3

Translations + bug fix release.

• New: Polish translation bundled (pl_PL).
• New: Brazilian Portuguese translation bundled — also covers European Portuguese (pt_PT) and other Portuguese-speaking locales (pt_AO, pt_MZ and others) via automatic locale fallback.
• Fix: “Sidebar width” in Settings → General now applies immediately to the admin who saves it, and the field always reflects the width currently on screen (drag-resized value if any, else the site-wide default).
• Removed: “Sticky sidebar” toggle in Settings → General — the toggle had no effect since the folder sidebar was always pinned regardless of the setting. Sidebar behavior is unchanged for all users.

1.0.2

Translations release.

• New: Italian translation bundled.
• New: Spanish translation bundled — covers Spain plus all Latin American Spanish variants (es_MX, es_AR, es_CL, es_CO, es_VE, es_PE and others) via automatic locale fallback.
• New: French translation bundled — covers France, Belgium, Canada, Switzerland and other Francophone locales via automatic locale fallback.
• New: German translation bundled — covers Germany, Austria, Switzerland and other German-speaking locales via automatic locale fallback.
• New: Japanese translation bundled.
• Improvement: smart locale fallback — when a region-specific .mo is not present (e.g. es_MX) the plugin now loads the generic language file (es) instead of leaving strings untranslated.
• Improvement: the Force English toggle now appears for users on regional locale variants whenever a generic fallback translation is bundled.

1.0.1

Bug fix release.

• Fix: media modal “Load more” no longer resets the grid back to the first page.
• Fix: downloading a single selected file now reliably saves to disk instead of occasionally opening it inline in the browser.
• Fix: “Download ZIP” entry no longer appears in the folder context menu on Posts, Pages and Custom Post Types — Media Library only.
• Fix: smart folders with two file extension rules (e.g. avif + webp) now return the union of both, not just one extension.
• Improvement: smart folder rules split per post type — Media gets a clearer “Text contains (Title+Caption+Desc.)” label plus a new “Alt Text contains” rule; Posts/Pages/CPT get a “Title contains” rule that searches post titles only.
• Improvement: folder bulk toolbar now hides Pin/Lock buttons when the matching context-menu entries are disabled in Settings, so the actions stay reversible from a single place.
• Polish: replaced three book emojis in the Folders icon category with new icons that don’t duplicate the Documents category.

1.0.0

Initial release on WordPress.org.

• Unlimited folders and subfolders in the Media Library.
• Unlimited smart folders (rule-based, auto-populated, multiple rules with AND logic).
• Drag and drop attachments into folders.
• Auto-assign new uploads to the current folder.
• Custom folder colors and emoji icons.
• Pin and lock folders.
• Resizable, sticky sidebar with search, sort and keyboard shortcuts.
• Breadcrumb bar, subfolder cards, Smart Startup Folder.
• Mobile responsive layout.
• Bulk Organize mode.
• Download a folder (with all subfolders) or just selected items as a ZIP archive.
• Upload a folder structure from your computer.
• JSON export and import of the folder structure (Merge or Replace).
• Metadata and EXIF tooltip on hover over media items.
• Role-based access control.
• Self-hosted font, admin-only, no frontend footprint.
• Media modal integration with Gutenberg, Classic Editor, Divi 4/5, Elementor, and WooCommerce product galleries.