Athenian File Management
product details.
Athenian File Management upgrades the WordPress Media Library with folders, smart collections, AFM Explorer, media modal integration, role-based defaults, REST-accessible file operations, and WooCommerce product image workflows. It helps teams organize, find, and manage images, documents, and product assets faster while reducing media clutter and duplicate uploads. It is designed as a focused module within…
Athenian File Management is a WordPress and WooCommerce media operations plugin that upgrades the native Media Library from a flat attachment list into a structured workspace for organizing, auditing, routing, and maintaining site files.
The plugin adds hierarchical attachment folders, Media Library folder filters, bulk move tools, attachment edit fields, media modal navigation, upload-time role defaults, smart cleanup collections, and a dedicated AFM Explorer screen with grid/list views, search, sorting, drag-and-drop movement, and an inspector panel.
For WooCommerce teams, AFM can automatically organize product featured images and gallery images into folder paths based on product category hierarchy. This helps product media stay aligned with the store structure while preserving native WordPress attachment IDs, URLs, metadata, thumbnails, and existing media relationships.
Within the Athenian Platform, AFM fits as the file and media organization layer for content-heavy WordPress sites, WooCommerce catalogs, product image workflows, SEO cleanup, DevDocs, Print Forge, product builders, catalog tools, and broader administrative operations.
How Athenian File Management fits the Athenian Platform
Platform role: Athenian File Management is part of the platform foundation layer. Its Admin Governance and Media Library & File Operations responsibilities help establish shared conventions that other Athenian modules can use without duplicating lower-level infrastructure.
Connected scope: Athenian File Management is designed to work inside a WordPress and WooCommerce operating environment where storefront, customer, order, identity, payment, fulfillment, automation, and reporting context can remain connected across relevant modules instead of being trapped in isolated add-ons.
From module to operating platform: Athenian Brands organizes the ecosystem in four connected layers: Platform Kernel and Platform Core foundations; focused capability plugins; implementation and integration services; and operating brands such as PrintGhost.ai, Athenian Marketplace, Athenian Academy, and Athenian Unÿa that apply the same patterns to real business workflows.
Media Library Organization
Turn WordPress Attachments Into a Structured Folder-Based Media Workspace
Athenian File Management adds hierarchical folders to native WordPress
attachments, giving content, catalog, and operations teams a cleaner way
to browse, filter, assign, and maintain large media libraries without
replacing WordPress media storage.
| Media Layer | Operational Value |
|---|---|
| Hierarchical Folders | Creates nested folder structures for attachments using a dedicated WordPress taxonomy. |
| Media Library Filters | Adds folder filtering and folder display columns to the native Media Library list table. |
| Bulk Move Tools | Lets operators move selected media items into an AFM folder through a native bulk action workflow. |
| Attachment Edit Fields | Adds folder assignment directly to attachment edit forms so admins can organize files from the existing attachment workflow. |
- Registers the hierarchical attachment taxonomy
afm_folder. - Stores plugin settings in the
afm_settingsoption. - Uses native WordPress attachments, metadata, thumbnails, URLs, and attachment IDs instead of replacing the Media Library.
- Supports folder-path creation through
Plugin::ensure_folder_path().
Media Operations Workspace
Find, Inspect, Sort, Filter, and Move Media From a Dedicated Explorer
AFM adds a dedicated Media Explorer admin screen for high-volume cleanup
and organization, combining folder navigation, smart collections, search,
filters, grid/list views, multi-select, drag-and-drop movement, and a
detailed inspector panel.
Find unassigned, unattached, missing-alt, large, recent, and type-specific files
Use grid/list views, sorting, search, uploader filters, and attachment-state filters
Review filename, type, size, dimensions, folder path, uploader, parent post, and alt status
| Explorer Feature | How It Helps |
|---|---|
| Smart Collections | Provides built-in operational views such as All Files, Unassigned, Not Attached, Missing Alt, Large Files, Recent, Images, Documents, PDFs, Videos, and Audio. |
| Drag-and-Drop Movement | Allows selected media cards or rows to be moved into folders or unassigned through explorer interactions. |
| Media Modal Integration | Adds AFM folder and collection navigation to the WordPress media modal so organization is available while choosing media. |
| REST-Powered Queries | Uses REST endpoints to return media metadata, folder context, uploader information, size data, alt text, and pagination-ready results. |
- Defines filterable smart collections through
afm_explorer_collections. - Includes admin assets such as
afm-explorer.js,afm-media-sidebar.js,afm-media-modal.js, andafm-media.css. - Uses REST routes such as
/afm/v1/bootstrap,/afm/v1/folders,/afm/v1/collections,/afm/v1/query, and/afm/v1/assign. - Supports cleanup workflows for missing alt text, unattached files, unassigned files, oversized files, recent uploads, and file-type browsing.
Admin Automation & WooCommerce Media Routing
Route New Uploads and Product Images Into Organized Folder Paths
AFM supports role-based upload defaults and WooCommerce product-image
auto-organization, helping teams keep new files and product media aligned
with operational folder structures as content and catalog data change.
| Automation Layer | Operational Purpose |
|---|---|
| Role-Based Defaults | Assigns newly uploaded attachments to default folders based on the uploader’s primary WordPress role. |
| WooCommerce Product Routing | Automatically organizes featured images and gallery images into folder paths based on product category hierarchy. |
| Category-Based Paths | Creates nested folder paths such as Products / Powder Coatings / Metallics / Gold from catalog structure. |
| Native Admin Placement | Adds AFM Explorer, AFM Folders, and AFM Settings under the WordPress Media admin menu. |
Media operations without leaving WordPress:
AFM gives larger content and commerce teams a practical way to organize,
audit, and route media while preserving native WordPress attachment
behavior and WooCommerce product relationships.
- Uses settings such as
role_defaults,wc_auto_product_folders, andwc_root_folder. - Uses WooCommerce product data such as featured image IDs,
_product_image_gallery, andproduct_cathierarchy. - Hooks into
add_attachmentfor upload-time default assignment andsave_post_productfor product-image organization. - Current package does not create custom database tables and does not register public shortcodes, blocks, or WP-CLI commands.
- Builds toward audit logs, duplicate media detection, broken-file scans, folder import/export, WP-CLI tools, inline alt editing, variation image routing, product media completeness reports, and stronger Athenian SEO / Print Forge / DevDocs integration.