Descrição
KooKoa Folders adiciona uma barra lateral de pastas à Biblioteca de mídia do WordPress. Você pode criar pastas, aninhá-las em subpastas e mover arquivos com arrastar e soltar. Ele também inclui Smart Folders ilimitados que são preenchidos automaticamente a partir de regras que você define — tipo de arquivo, tamanho, data, dimensões, tags e muito mais — para manter a biblioteca organizada conforme ela cresce.
👉 TESTE A DEMO AO VIVO ☝️ — Acesso instantâneo, sem necessidade de conta
As pastas são virtuais. Elas são armazenadas como uma taxonomia privada do WordPress e vinculadas aos seus itens de mídia, então seus arquivos no disco nunca são movidos e URLs de imagens existentes continuam funcionando. Se você desativar o plugin, sua Biblioteca de mídia continua funcionando como se nada tivesse acontecido.
🗂️ Organização
- Pastas e subpastas ilimitadas na Biblioteca de mídia
- Arraste e solte anexos entre pastas
- Atribua automaticamente novos uploads à pasta em que você está no momento
- Contagem de itens por pasta
- Filtro de pastas na visualização em lista da Biblioteca de mídia
⚡ Smart Folders
- Smart Folders ilimitados (baseados em regras), preenchidos automaticamente conforme sua Biblioteca de mídia cresce
- Combine várias regras por pasta com lógica AND — tipo de arquivo, tamanho, dimensões, data, autor, status, busca, tags e muito mais
- Contagens em tempo real armazenadas em cache por pasta, atualizadas automaticamente quando os itens mudam
- Suporte a fixar, bloquear, cor e ícone — mesma UX das pastas comuns
🌈 Aparência
- Cores de pasta personalizadas
- Ícones de pasta personalizados com seletor de emojis
- Fixe pastas no topo da árvore
- Bloqueie pastas para evitar renomear, alterar cor, ícone ou excluir por acidente
🔍 Navegação
- Barra lateral de pastas redimensionável e fixa
- Pesquise e ordene a árvore de pastas
- Barra de breadcrumbs e cartões de subpastas
- Smart Startup Folder — abra a Biblioteca de mídia na última pasta usada ou em uma pasta fixa de sua escolha
- Atalhos de teclado para ações comuns
- Layout responsivo para dispositivos móveis
🔄 Operações em massa
- Modo Bulk Organize — selecione vários anexos e mova-os para uma pasta com um clique
- Baixe uma pasta (e todas as suas subpastas) como um único arquivo ZIP
- Baixe apenas os itens selecionados como ZIP, diretamente da barra de ferramentas Bulk Organize
- Envie uma estrutura de pastas do seu computador e recrie as subpastas automaticamente
- Exporte e importe a estrutura de pastas como JSON, com modos Merge ou Replace
📊 Informações
- Tooltip ao passar o mouse sobre itens de mídia mostrando nome do arquivo, tamanho e dimensões
- Campos EXIF opcionais no tooltip ao passar o mouse — câmera, abertura, obturador, ISO, distância focal
🛡️ Controle de acesso
- Acesso baseado em funções — escolha quais funções do WordPress podem usar a barra lateral de pastas
🔒 Privacidade
- Fonte auto-hospedada, sem chamada ao Google Fonts
- Sem scripts externos, sem trackers, sem analytics
- Nenhum asset de frontend é carregado para visitantes comuns; integrações com builders/editores carregam apenas quando um editor autorizado abre um construtor visual compatível
✅ Compatível com
A barra lateral de pastas está disponível dentro de:
- Visualizações em lista e grade da Biblioteca de mídia do WordPress
- Modal de mídia do editor de blocos (Gutenberg)
- Modal de mídia do Editor clássico
- Modais de mídia do Divi 4 e 5
- Modal de mídia do Elementor
- Modal de mídia da galeria de produtos do WooCommerce
🔁 Migrate from other folder plugins
Already using another folder plugin? Switch in one click. KooKoa Folders detects existing folder structures directly from your database and rebuilds the full tree inside the KooKoa sidebar — with file assignments intact, no JSON export, no rebuilding from scratch.
Supported sources:
- FileBird (Ninja Team)
- Folders (Premio)
- Real Media Library (devowl.io)
A subtle hint inside the Media Library surfaces the importer when one of these plugins is detected, so you find it without going hunting through Settings. After a successful import, the source plugin can be deactivated with one button — your KooKoa folder structure keeps living independently.
🚀🚀🚀 Complemento Pro
👉 TRY THE LIVE DEMO ☝️
🚀 Folders for Posts & Pages
🚀 Folders for Custom Post Types
🚀 AI Image Generator (text-to-image)
🚀 AI Image Editor (text-guided edits)
🚀 WebP / AVIF Converter
🚀 Replace Media (same name or rename)
🚀 Watermark Images (logo or text)
🚀 Clean Unused Media
🚀 Find Duplicate Media (byte-exact + perceptual hash)
🚀 Image Editor (crop, rotate, filters, resize)
🚀 Media Stats Dashboard
🚀 Priority Email Support
💻 Use cases
A few real-world setups where KooKoa Folders earns its keep:
- Bloggers and content writers — keep every blog image, post screenshot, hero photo, video clip and audio file inside dedicated media folders. Drag and drop assets between folders, filter the media library by folder, and find the right image for tomorrow’s article in seconds instead of scrolling past 2,000 thumbnails.
- WordPress photographers and photo studios — split your media library by shoot type (portraits, weddings, real estate, landscapes, nature, family), by client, by year, or by location. Pin your active project to the top, lock the archive against accidental edits, and let smart folders auto-collect images by date, file size or alt text.
- WooCommerce shop owners and e-commerce managers — organize product images into folders that mirror your catalog (apparel, footwear, accessories, electronics). Drag and drop new product photos straight from upload into the right SKU folder, and use smart folders to auto-group every PNG, JPEG or WebP above a certain size for quality audits.
- Web designers, web developers and freelance agencies — separate site assets per project, per page section or per client (logos, mockups, illustrations, icon sets, screenshots). Folder colors and custom icons turn the media library into a navigable workspace even when you sit on thousands of files.
- Online publishers, magazines and editors — file every image per issue, per article, per author or per topic. Smart folders auto-collect everything uploaded this week, this month, or by a specific contributor — no manual sorting needed.
- Real estate, hospitality and listings sites — one folder per property or per location, subfolders per room, view or photoshoot. Bulk upload an entire shoot, drag the keepers into the listing folder, and skip the rest. Color-code your busiest property folders so the right one stands out at a glance.
- Course creators and membership sites — split lesson screenshots, video thumbnails and downloadable PDFs into folders per course, per module or per lesson. Find the right cover image without scrolling past fifty unrelated lessons.
- Marketing agencies, design studios and creative teams — one WordPress Media Library, many clients. A folder per brand keeps work tidy, role-based access keeps clients out of each other’s assets, and the export/import tool ships a folder tree to a new project in a single JSON file.
Bibliotecas de código aberto
KooKoa Folders é construído sobre estes projetos de código aberto. Obrigado aos seus autores por compartilharem seu trabalho com a comunidade.
-
jsTree v3.3.16 by Ivan Bozhanov (vakata) — MIT License
Website: https://www.jstree.com/ -
Share Tech Mono por Carrois Apostrophe (Ralph du Carrois) — SIL Open Font License 1.1 — https://www.carrois.com/
Fonte monoespaçada auto-hospedada usada em toda a interface. Sem CDN do Google Fonts.
Para todo o resto, o KooKoa Folders usa as bibliotecas que já vêm com o núcleo do WordPress — jQuery, jQuery UI (Draggable, Droppable, Sortable) e Dashicons — em vez de incluir suas próprias cópias.
Créditos
KooKoa Folders foi projetado e desenvolvido por Adamo Lussana — https://www.kookoa.com
Capturas de tela








Instalação
- No administrador do WordPress, acesse Plugins Adicionar novo.
- Pesquise por KooKoa Folders.
- Clique em Instalar agora e depois em Ativar.
- Abra a Biblioteca de mídia — a barra lateral de pastas aparecerá à esquerda.
- Clique em + Folder no cabeçalho da barra lateral para criar sua primeira pasta e depois arraste itens para ela.
Para configurar o plugin, acesse KooKoa Folders no menu de administração do WordPress. Você pode definir a largura padrão da barra lateral, alterar a paleta de cores e o conjunto de ícones, ativar atalhos de teclado, ajustar o menu de contexto, escolher quais funções podem usar o plugin e muito mais.
Instalação manual
- Baixe o zip do plugin.
- Acesse Plugins Adicionar novo Enviar plugin e envie o zip.
- Ative o plugin.
Perguntas frequentes
-
O KooKoa Folders move arquivos no disco?
-
Não. As pastas são virtuais. Elas são armazenadas como uma taxonomia privada do WordPress e vinculadas aos itens de mídia. Seus arquivos no servidor mantêm os caminhos originais, então URLs de imagens existentes no seu conteúdo nunca quebram.
-
Excluir uma pasta apaga meus arquivos?
-
Não. Excluir uma pasta remove apenas a pasta em si. Os itens de mídia dentro dela ficam sem categoria e permanecem na Biblioteca de mídia.
-
O que acontece se eu desativar o plugin?
-
Suas pastas permanecem no banco de dados. Quando você reativa o plugin, tudo volta para onde estava. Se, em vez disso, você usar Delete na tela de plugins, todos os dados do plugin (pastas, cores, ícones, estado de fixação e bloqueio, configurações) são removidos de forma limpa.
-
O plugin carrega algo da internet?
-
Não. A fonte usada pela interface do plugin é incluída no próprio plugin e servida pelo seu próprio site — sem CDN do Google Fonts, sem scripts externos, sem analytics.
-
Isso afeta o frontend ou o desempenho do meu site?
-
O plugin é carregado na Biblioteca de mídia, na própria página de configurações e dentro do modal de mídia — inclusive quando um editor autorizado abre um construtor visual compatível, como Divi ou Elementor. Visitantes comuns não recebem nada extra: nenhum CSS, nenhum JavaScript, nenhuma consulta ao banco de dados.
-
Quantos Smart Folders posso criar?
-
Quantas você precisar. KooKoa Folders vem com Smart Folders ilimitados. Cada pasta combina várias regras com lógica AND e é preenchida automaticamente quando novos itens correspondem.
Avaliações
Colaboradores e desenvolvedores
“KooKoa Folders – Pastas da Biblioteca de mídia & organizador de arquivos” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.
ColaboradoresKooKoa Folders – Pastas da Biblioteca de mídia & organizador de arquivos” foi traduzido para 8 localidades. Agradecemos aos tradutores por suas contribuições.
Interessado no desenvolvimento?
Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.
Registro de alterações
1.4.1
- Fix: in the Divi 5 builder, the folder media modal now shows the drag preview while dragging an image onto a folder, displays the action confirmation messages (move, copy/paste, etc.), and opens directly on the Media Library tab instead of Upload Files.
- Fix: attachments hidden by the PRO Cleanup trash no longer reappear in Smart Folder results or in the folder ZIP download — they now stay hidden everywhere, matching what the Media Library grid already showed.
1.4.0
- Performance: the folder sidebar loads faster on large media libraries. The “Uncategorized” counter and the per-folder item counts no longer load every attachment ID into memory on each sidebar refresh, and the per-folder counts now run as a single batched query instead of one query per folder.
- Performance: migrating from another folder plugin (FileBird, Folders by Premio, Real Media Library) is faster on large libraries — folder counts are recalculated once when the import finishes instead of after every individual file assignment.
- Hardening: the folder reorder action now validates every sibling folder ID against its taxonomy before saving the order, so a crafted request cannot write folder metadata onto unrelated terms.
- Hardening: uninstalling the plugin now also removes the temporary ZIP-download workspace (uploads/kookoawpf-tmp/), so deleting KooKoa Folders leaves nothing behind.
1.3.0
- New: WooCommerce “Category” and “Tag” rules for Smart Folders — auto-group products by their product category or product tag, alongside the existing Stock status rule. Visible only on the product custom post type when WooCommerce is active.
- Improvement: minor admin UI refinements.
1.2.0
- Fix: smart folders are now preserved across JSON export and import. The export used to ship structure + metadata but skip the rule payload entirely, so re-importing a backup or running a “Replace all” silently demoted every smart folder in the tree to a plain folder, wiping its automation rules. The export now serialises the
is_dynamicflag and the rules alongside the rest of the tree, and the import re-applies both on the new terms. - New: keyboard shortcut Alt + B toggles Bulk Organize mode from anywhere it’s available (Media Library grid + list, Posts, Pages and any folder-enabled custom post type). Press it again — or press Esc with the bulk toolbar open — to exit. Both shortcuts now appear in the Keyboard Shortcuts dialog (Alt + K) under “Bulk Organize” and “Close Modal / Exit Bulk Mode”.
- Improvement: minor admin UI refinements.
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
Versão de traduções.
- Novo: tradução italiana incluída.
- Novo: tradução espanhola incluída — cobre Espanha e todas as variantes do espanhol latino-americano (es_MX, es_AR, es_CL, es_CO, es_VE, es_PE e outras) via fallback automático de locale.
- Novo: tradução francesa incluída — cobre França, Bélgica, Canadá, Suíça e outros locales francófonos via fallback automático de locale.
- Novo: tradução alemã incluída — cobre Alemanha, Áustria, Suíça e outros locales de língua alemã via fallback automático de locale.
- Novo: tradução japonesa incluída.
- Melhoria: fallback inteligente de locale — quando um arquivo .mo específico da região não está presente (por exemplo, es_MX), o plugin agora carrega o arquivo de idioma genérico (es) em vez de deixar strings sem tradução.
- Melhoria: o seletor Force English agora aparece para usuários em variantes regionais de locale sempre que uma tradução genérica de fallback estiver incluída.
1.0.1
Versão de correção de bugs.
- Correção: “Load more” no modal de mídia não redefine mais a grade para a primeira página.
- Correção: baixar um único arquivo selecionado agora salva de forma confiável no disco em vez de ocasionalmente abri-lo inline no navegador.
- Correção: a entrada “Download ZIP” não aparece mais no menu de contexto de pastas em Posts, Pages e Custom Post Types — apenas na Media Library.
- Correção: Smart Folders com duas regras de extensão de arquivo (por exemplo, avif + webp) agora retornam a união de ambas, não apenas uma extensão.
- Melhoria: as regras de Smart Folder agora são separadas por tipo de post — Media recebe um rótulo mais claro “Text contains (Title+Caption+Desc.)” e uma nova regra “Alt Text contains”; Posts/Pages/CPT recebem uma regra “Title contains” que pesquisa apenas títulos de posts.
- Melhoria: a barra de ferramentas em massa de pastas agora oculta os botões Pin/Lock quando as entradas correspondentes do menu de contexto estão desativadas em Settings, para que as ações continuem reversíveis a partir de um único lugar.
- Polimento: substituídos três emojis de livro na categoria de ícones Folders por novos ícones que não duplicam a categoria Documents.
1.0.0
Lançamento inicial no WordPress.org.
- Pastas e subpastas ilimitadas na Biblioteca de mídia.
- Smart Folders ilimitados (baseados em regras, preenchidos automaticamente, várias regras com lógica AND).
- Arraste e solte anexos em pastas.
- Atribua automaticamente novos uploads à pasta atual.
- Cores de pasta personalizadas e ícones com emojis.
- Fixe e bloqueie pastas.
- Barra lateral redimensionável e fixa com busca, ordenação e atalhos de teclado.
- Barra de breadcrumbs, cartões de subpastas, Smart Startup Folder.
- Layout responsivo para dispositivos móveis.
- Modo Bulk Organize.
- Baixar uma pasta (com todas as subpastas) ou apenas os itens selecionados como um arquivo ZIP.
- Envie uma estrutura de pastas do seu computador.
- Exportação e importação JSON da estrutura de pastas (Merge ou Replace).
- Tooltip de metadados e EXIF ao passar o mouse sobre itens de mídia.
- Controle de acesso baseado em funções.
- Fonte auto-hospedada, apenas no admin, sem impacto no frontend.
- Integração com o modal de mídia para Gutenberg, Editor clássico, Divi 4/5, Elementor e galerias de produtos do WooCommerce.
