=== Filorium – Media Library Folders & Organizer ===
Contributors: qevixlabs
Tags: media library, media folders, folders, file manager, digital asset management
Requires at least: 5.3
Tested up to: 7.1
Requires PHP: 7.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A smarter WordPress Media Library with unlimited virtual folders, drag-and-drop organization, and a powerful folder explorer.

== Description ==

Filorium adds folders to the WordPress Media Library without moving your files or changing their URLs.

Organize your media with folders, drag and drop, favorites, multiple views, file previews, and more. You can also see your folders directly in WordPress's Media Library and media picker.

Your files stay where WordPress stores them. Deactivate Filorium and WordPress works as normal.

= Organize your media =

* Create unlimited nested folders.
* Drag and drop files and folders.
* Cut, paste, duplicate and rename files.
* Choose a folder when uploading files.
* Drop folders from your computer and recreate their folder structure.
* Star files as Favorites for quick access.
* Switch between grid, list and column views.
* Edit title, caption, description and alt text from the details panel.
* Preview files and move through your selection.
* Work with other users in the same media library and see changes as they happen.

= Folders inside WordPress =

* Browse folders directly from the Media Library.
* Use folders inside WordPress's media picker.
* Works with the block editor, classic editor, Featured Image, Customizer and other areas that use WordPress's media picker.
* Enable both from Filorium → Settings → Media Library.

= Delete with confidence =

* See where a file is used before deleting it.
* Filorium tracks references in post and page content and featured images.
* Deleted files go to Trash first.
* Empty Trash does not permanently delete files that Filorium knows are still in use.

= Rename or replace files =

* Rename files while keeping their WordPress attachment and URL working.
* Replace a file without breaking pages that already use it.

= Import your existing folders =

Already using another media folder plugin? Filorium imports your existing folder structure from it.

* Filorium detects the media organizer plugins it supports on your site and lists them under Filorium → Settings → Import.
* It shows what will be imported before anything is written.
* The importer only reads the other plugin's data and never changes it, so you can keep that plugin active while you check the result.

= Safe by default =

* Filorium works in the WordPress admin and does not load on public pages.
* Folder access follows WordPress user roles and capabilities.
* Users only get access to the media actions allowed for their role.
* Deleting the plugin does not remove your folders by default.
* You can choose to remove Filorium's data when uninstalling.

= Filorium Pro =

Everything in the free plugin works without a licence. Nothing is locked.

Filorium Pro is a separate add-on that adds:

* Filorium Library inside media pickers and page builders.
* Collections for organizing files with labels.
* Multi-folder filing.
* Similar files and duplicate detection.
* Unused files and missing metadata detection.
* A Used-in panel showing where files are used.
* Studio for crop, resize, compression and watermarking.
* Bulk metadata editing.
* Folder colors.
* Copy folders.
* Download folders as ZIP files.
* Unpack ZIP files into folders.

Filorium Pro is sold separately from filorium.com.

= What Filorium adds to your site =

Filorium stores folder information and activity in your WordPress database. Your actual media files remain in WordPress's uploads folder.

Filorium uses:

* Attachment taxonomies for folders and collections.
* A small activity log.
* A file usage index.
* WordPress options for settings and user preferences.
* Scheduled maintenance tasks for the activity log and usage index.

Deactivating Filorium keeps your data. Deleting the plugin only removes Filorium's data if **Delete everything if the plugin is removed** is enabled in Settings → Data.

= Files on disk =

Creating and organizing folders does not move your files.

Only **Rename**, **Replace** and **Empty Trash** can change files in the uploads folder. These actions require confirmation.

Filorium does not modify files outside the WordPress uploads folder.

= Source code =

The Filorium workspace is a React application. The compiled bundle is `build/index.js`, and the human-readable source is included in `src/` together with `package.json` and `webpack.config.js`. Run `npm install && npm run build` (`@wordpress/scripts`) to rebuild it.

React itself is not bundled; the plugin uses the copy that ships with WordPress.

The files in `src/edition/` are small placeholder modules where the separate Pro add-on plugs in its own code. Nothing in this plugin is switched on by a licence.

== External services ==

Filorium does not connect to external services.

There is:

* No analytics.
* No telemetry.
* No licence check in the free plugin.
* No remote fonts, scripts, stylesheets or images.

Everything Filorium needs is included in the plugin and runs on your own WordPress site.

The only external links are the links you choose to open from Settings → Licence, which point to filorium.com.

Filorium Pro is a separate add-on and handles licence activation through the Qevix Labs licence service. See the Pro add-on's readme for details about the information it sends.

== Installation ==

1. Install Filorium from the WordPress Plugins screen, or upload the plugin to `/wp-content/plugins/`.
2. Activate Filorium.
3. Open **Filorium** in the WordPress admin menu.
4. Start creating folders.
5. To show folders in the Media Library and media picker, enable **Folder explorer** under Filorium → Settings → Media Library.

== Frequently Asked Questions ==

= Does Filorium move my files or change their URLs? =

No. Filorium folders are virtual. Your files stay in WordPress's uploads folder and their URLs stay the same.

Only Rename, Replace and Empty Trash can change files, and each action asks for confirmation.

= Does it work with the block editor and classic editor? =

Yes. Enable **Folder explorer** in Filorium → Settings → Media Library.

Folders appear in WordPress's media picker, including the Image and Gallery blocks, Featured Image, classic editor, Customizer and widgets.

= Does it work with page builders? =

Any page builder that uses WordPress's standard media picker can use the folder column.

The full Filorium Library inside page builders such as Elementor, Beaver Builder, SiteOrigin, Brizy, Visual Composer, Zion and Themify is available in Filorium Pro.

= How does Filorium know if a file is being used? =

Filorium tracks references to files in post and page content and featured images.

The delete confirmation shows the number of known references. Files that Filorium knows are still in use are not permanently deleted when Trash is emptied.

References stored elsewhere, such as some theme, widget or plugin fields, may not be detected.

= Will Filorium slow down my website? =

Filorium runs in the WordPress admin and does not load on public pages.

The file usage index is updated when content is saved, with small maintenance tasks running once a day.

= Can I import folders from another plugin? =

Yes. Go to Filorium → Settings → Import.

Filorium detects supported plugins, shows what can be imported and reads their folder data without changing it.

= Do I need Filorium Pro? =

No. The free plugin is fully usable on its own and nothing is locked behind a licence.

Pro adds additional features such as the Filorium Library, collections, multi-folder filing, duplicate detection, unused-file detection, Studio, bulk metadata tools and ZIP tools.

= Do Filorium and Filorium Pro have to be on the same version? =

No. Pro plugs into a small, versioned set of Filorium extension points, and only that has to match — Filorium itself can be updated freely.

If a Filorium update ever changes those extension points, or a newer Pro needs ones your Filorium does not have yet, Pro pauses itself and a notice on Filorium's own screens says which of the two to update and where. Nothing is lost while it is paused; the free features keep running, and Pro switches back on by itself once the pair matches.

= What happens if I deactivate Filorium? =

Your folders, settings and data are kept.

WordPress's Media Library returns to its normal behavior while Filorium is inactive.

= What happens if I delete Filorium? =

By default, your Filorium data is kept.

If you want to remove it completely, enable **Delete everything if the plugin is removed** under Settings → Data before deleting the plugin.

= Is Filorium translation-ready? =

Yes. Filorium is translation-ready and includes its translation template.

Translations are provided through WordPress language packs from translate.wordpress.org.

= Is Filorium accessible? =

The workspace supports keyboard navigation.

The folder tree and views can be navigated with the keyboard, common actions have shortcuts, and resizable panels can be adjusted with the keyboard or mouse.

= Who made the icons? =

Qevix Labs.

The icons are custom inline SVG icons created for Filorium and are licensed under GPL-2.0-or-later like the rest of the plugin.

See `assets/ICONS.LICENSE.txt` for details.

== Screenshots ==

1. The workspace in use — folders on the left, files in the middle, details on the right.
2. All Files: the whole library at once, with folders, collections and Trash a click away.
3. The same folder in List view, where size, dimensions and date are all readable at a glance.
4. Column view, for walking a deep folder tree without losing your place.
5. Filing is a drag: drop files or whole folders onto a folder to move them.
6. Collections are labels, not places — one file can carry as many as you like. (Filorium Pro)
7. Studio: crop, rotate, resize and compress without leaving the library. (Filorium Pro)
8. Similar & duplicates finds the copies you forgot you had, grouped rather than listed. (Filorium Pro)
9. Choose the folder while you upload, so nothing lands unfiled.
10. Drag and drop straight into a folder from the desktop.
11. File health: what is missing alt text, what is oversized, and what nothing links to.
12. The WordPress media library on its own — every file in one long scroll.
13. The same screen with Filorium's folders added, inside the media modal you already use.

== Changelog ==

= 1.0.0 =
* First release.
* Folders and nested folders.
* Favorites.
* Media workspace.
* Media Library folder explorer.
* Media picker folder column.
* Desktop folder import.
* File usage tracking.
* Trash with usage confirmation.
* Rename and replace files.
* Folder importers.
* Optional uninstall cleanup.

== Upgrade Notice ==

= 1.0.0 =
First release.
