PHPackages                             soderlind/vmfa - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. soderlind/vmfa

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

soderlind/vmfa
==============

Install and manage add-ons that extend Virtual Media Folders.

1.5.3(2w ago)30GPL-2.0-or-laterPHPPHP >=8.3CI passing

Since Feb 12Pushed 2w agoCompare

[ Source](https://github.com/soderlind/vmfa)[ Packagist](https://packagist.org/packages/soderlind/vmfa)[ Fund](https://paypal.me/PerSoderlind)[ RSS](/packages/soderlind-vmfa/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (7)Versions (31)Used By (0)

Virtual Media Folders - Add-On Manager
======================================

[](#virtual-media-folders---add-on-manager)

Install and manage add-ons that extend [Virtual Media Folders](https://wordpress.org/plugins/virtual-media-folders/). Provides a dedicated admin screen under **Media → Add-on Manager** for installing, activating, updating, deactivating, and deleting supported add-ons directly from GitHub releases.

[![Try in WordPress Playground](https://camo.githubusercontent.com/fea5e87d0191ae2926c8a449513ed0686cf239f31b0fd24b055cbb274cf61576/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2545322539362542365f5472795f696e5f576f726450726573735f506c617967726f756e642d626c75653f7374796c653d666f722d7468652d6261646765)](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/soderlind/vmfa/refs/heads/main/blueprint.json)

[![Screenshot 2026-05-07 at 19 50 27](https://private-user-images.githubusercontent.com/1649452/589071142-b33cbd23-a74a-4190-986c-beb28c9fdcf5.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODAxMjk3NTEsIm5iZiI6MTc4MDEyOTQ1MSwicGF0aCI6Ii8xNjQ5NDUyLzU4OTA3MTE0Mi1iMzNjYmQyMy1hNzRhLTQxOTAtOTg2Yy1iZWIyOGM5ZmRjZjUucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUzMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MzBUMDgyNDExWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MDJmNmVhNmYwZDllZjZhYTM5OWIyZTg0NjJjZjI1OWE5NzY4MjY4MzYwMDA0ZTQ5OWZkMmY1M2E3YWYzOGUxZSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.ZMGVrDpEqmJ9aqdF5k2k8wGx_b5imfQJ45dQThiWZl8)](https://private-user-images.githubusercontent.com/1649452/589071142-b33cbd23-a74a-4190-986c-beb28c9fdcf5.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODAxMjk3NTEsIm5iZiI6MTc4MDEyOTQ1MSwicGF0aCI6Ii8xNjQ5NDUyLzU4OTA3MTE0Mi1iMzNjYmQyMy1hNzRhLTQxOTAtOTg2Yy1iZWIyOGM5ZmRjZjUucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUzMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MzBUMDgyNDExWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MDJmNmVhNmYwZDllZjZhYTM5OWIyZTg0NjJjZjI1OWE5NzY4MjY4MzYwMDA0ZTQ5OWZkMmY1M2E3YWYzOGUxZSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.ZMGVrDpEqmJ9aqdF5k2k8wGx_b5imfQJ45dQThiWZl8)Supported Add-ons
-----------------

[](#supported-add-ons)

Add-onDescription[AI Ability](https://github.com/soderlind/vmfa-ai-ability)Exposes folder management, rules automation, media cleanup, ZIP export, and AI Organizer workflows as MCP-ready WordPress Abilities API tools for AI agents.[AI Organizer](https://github.com/soderlind/vmfa-ai-organizer)Uses vision-capable AI models to analyze image content and automatically organize your media library into virtual folders.[Rules Engine](https://github.com/soderlind/vmfa-rules-engine)Rule-based automatic folder assignment for media uploads, based on metadata, file type, EXIF or IPTC data.[Editorial Workflow](https://github.com/soderlind/vmfa-editorial-workflow)Role-based folder access, move restrictions, and Inbox workflow.[Media Cleanup](https://github.com/soderlind/vmfa-media-cleanup)Tools to identify and clean up unused or duplicate media files.[Folder Exporter](https://github.com/soderlind/vmfa-folder-exporter)Export folders (or subtrees) as ZIP archives with optional CSV manifests.[Migrate](https://github.com/soderlind/vmfa-migrate)Import folders and assignments from Enhanced Media Library, FileBird, Real Media Library, HappyFiles, WP Media Folder, Media Library Assistant, and CatFolders.Each add-on card includes direct links to **report a bug** or **request a feature** via GitHub issue templates.

Requirements
------------

[](#requirements)

- WordPress 6.8+
- PHP 8.3+
- [Virtual Media Folders](https://wordpress.org/plugins/virtual-media-folders/) (core plugin)

Installation
------------

[](#installation)

1. Download the latest [`vmfa.zip`](https://github.com/soderlind/vmfa/releases/latest/download/vmfa.zip).
2. In WordPress, go to **Plugins → Add New → Upload Plugin** and upload the zip.
3. Activate the plugin.

The plugin updates itself automatically via GitHub releases using [plugin-update-checker](https://github.com/YahnisElsts/plugin-update-checker).

Usage
-----

[](#usage)

1. Go to **Media → Add-on Manager**.
2. **Install** any add-on — downloads the latest release zip from GitHub.
3. **Activate** / **Deactivate** add-ons as needed.
4. **Update** when a newer release is available (version comparison shown on the card).
5. **Delete** to remove an add-on completely (with confirmation prompt).
6. Click **Check updates now** to refresh cached version data.

How It Works
------------

[](#how-it-works)

- Add-on metadata is defined in `src/AddonCatalog.php`.
- Each add-on's latest version is fetched from the GitHub Releases API and cached as a transient for 6 hours.
- Installs and updates use WordPress `Plugin_Upgrader` with `Automatic_Upgrader_Skin`.
- All actions require the `manage_options` capability and are protected by nonce verification.

Development
-----------

[](#development)

```
composer install
composer test    # Run tests (Pest)
composer lint    # Run PHPCS
```

GitHub Actions
--------------

[](#github-actions)

Two workflows ship with the plugin:

- **Manually Build release zip** — trigger manually with a tag to create and upload `vmfa.zip` to a release.
- **On Release, Build release zip** — runs automatically when a release is published.

Both verify that `plugin-update-checker` is included in the zip before uploading.

License
-------

[](#license)

GPL-2.0-or-later

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance96

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Recently: every ~12 days

Total

16

Last Release

19d ago

Major Versions

0.2.0 → 1.0.02026-02-13

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1649452?v=4)[Per Søderlind](/maintainers/soderlind)[@soderlind](https://github.com/soderlind)

---

Top Contributors

[![soderlind](https://avatars.githubusercontent.com/u/1649452?v=4)](https://github.com/soderlind "soderlind (43 commits)")

---

Tags

virtual-media-folderswordpress-media-librarywordpress-plugin

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/soderlind-vmfa/health.svg)

```
[![Health](https://phpackages.com/badges/soderlind-vmfa/health.svg)](https://phpackages.com/packages/soderlind-vmfa)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.3k10](/packages/helsingborg-stad-municipio)[mautic/core

Mautic Open Source Distribution

9.8k2.6k9](/packages/mautic-core)[roots/wp-stage-switcher

WordPress plugin that allows you to switch between different environments from the admin bar

382458.3k3](/packages/roots-wp-stage-switcher)[vinkla/wordplate

The WordPlate boilerplate

2.2k5.3k](/packages/vinkla-wordplate)[mediawiki/maps

Adds various mapping features to MediaWiki

79149.7k3](/packages/mediawiki-maps)[rainlab/blog-plugin

Blog plugin for October CMS

17158.6k](/packages/rainlab-blog-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)