PHPackages                             soderlind/vmfa-rules-engine - 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-rules-engine

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

soderlind/vmfa-rules-engine
===========================

Rule-based automatic folder assignment for media uploads

1.6.0(2mo ago)1149↑50%[11 PRs](https://github.com/soderlind/vmfa-rules-engine/pulls)GPL-2.0-or-laterPHPPHP >=8.3CI passing

Since Jan 16Pushed 2mo agoCompare

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

READMEChangelog (10)Dependencies (14)Versions (52)Used By (0)

Virtual Media Folders Rules Engine
==================================

[](#virtual-media-folders-rules-engine)

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

Rule-based automatic folder assignment for media uploads. Add-on plugin for [Virtual Media Folders](https://wordpress.org/plugins/virtual-media-folders/).

    vmfa-rules-engine.mp4    Description
-----------

[](#description)

Turn "Default folder for uploads" into a powerful rule system. Automatically assign media to folders based on:

- **Filename patterns** — Match filenames using regular expressions (e.g., `^IMG_`, `^DSC`, `screenshot.*`)
- **MIME type** — Sort by file type (images, videos, PDFs, etc.)
- **Image dimensions** — Organize by resolution (HD, 4K, thumbnails)
- **File size** — Separate large files from small ones
- **EXIF camera model** — Group photos by device (iPhone, Canon, etc.)
- **EXIF date taken** — Organize by capture date
- **Upload author** — Assign based on who uploaded the file
- **IPTC keywords** — Match embedded metadata keywords

### Features

[](#features)

- **Multiple rules with priority** — Create as many rules as needed, drag to reorder
- **Stop after first match** — Control whether to continue evaluating rules
- **AND logic** — All conditions in a rule must match
- **Automatic on upload** — New uploads are processed instantly
- **Scan existing media** — Apply rules to your existing library with preview
- **WP-CLI compatible** — Rules apply to imports via `wp media import`
- **Modern React UI** — Consistent with WordPress admin design

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

[](#requirements)

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

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

[](#installation)

1. Download [`vmfa-rules-engine.zip`](https://github.com/soderlind/vmfa-rules-engine/releases/latest/download/vmfa-rules-engine.zip)
2. Upload via `Plugins → Add New → Upload Plugin`
3. Activate via `WordPress Admin → Plugins`

Plugin [updates are handled automatically](https://github.com/soderlind/wordpress-plugin-github-updater#readme) via GitHub. No need to manually download and install updates.

Usage
-----

[](#usage)

1. Go to **Media → Rules Engine** in the WordPress admin
2. Click **Add Rule** to create your first rule
3. Configure conditions and select a target folder
4. Enable the rule and save
5. New uploads will automatically be assigned to folders based on your rules

### Scanning Existing Media

[](#scanning-existing-media)

1. Click **Scan Existing Media** to preview what changes would be made
2. Review the preview and select items to process
3. Click **Apply Changes** to assign folders

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

[](#development)

See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md).

License
-------

[](#license)

GPL-2.0-or-later. See [LICENSE](LICENSE).

Copyright 2026 Per Soderlind

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance85

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity62

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 ~3 days

Total

20

Last Release

65d ago

Major Versions

0.4.1 → 1.0.02026-01-21

### 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 (81 commits)")

---

Tags

rules-enginewordpress-media-fileswordpress-plugin

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[10up/10up-experience

The 10up Experience plugin configures WordPress to better protect and inform clients, aligned to 10up's best practices

139477.6k](/packages/10up-10up-experience)

PHPackages © 2026

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