PHPackages                             bueltge/must-use-loader - 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. bueltge/must-use-loader

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

bueltge/must-use-loader
=======================

Load Must-Use Plugins inside subdirectories with caching. For delete the cache: if you view the Must Use plugin list in the network administration.

1.3.1(7y ago)6115.7k21[1 issues](https://github.com/bueltge/must-use-loader/issues)2MITPHPPHP >=5.6CI failing

Since Jan 6Pushed 4y ago2 watchersCompare

[ Source](https://github.com/bueltge/must-use-loader)[ Packagist](https://packagist.org/packages/bueltge/must-use-loader)[ Docs](https://github.com/bueltge/must-use-loader)[ RSS](/packages/bueltge-must-use-loader/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (1)Versions (7)Used By (2)

Must Use Loader
===============

[](#must-use-loader)

[![Latest Stable Version](https://camo.githubusercontent.com/4f431c01fc8096e8970ec0e29bef1dec8597b374897870be2d00a6bfae70c423/68747470733a2f2f706f7365722e707567782e6f72672f6275656c7467652f6d7573742d7573652d6c6f616465722f762f737461626c65)](https://packagist.org/packages/bueltge/must-use-loader) [![Maintainability](https://camo.githubusercontent.com/0438dabd46c3cb6722f54c60806d262217d0d51484c9506d1fa3423b05ce9f6d/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f61373365633738616632656134303236666662312f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/bueltge/must-use-loader/maintainability) [![License](https://camo.githubusercontent.com/acf66010f0b4b7dfc3289281040caba4a1fd04aa03eeeb236bc5729711636745/68747470733a2f2f706f7365722e707567782e6f72672f6275656c7467652f6d7573742d7573652d6c6f616465722f6c6963656e7365)](https://packagist.org/packages/bueltge/must-use-loader)

This small plugin scan and include all plugins in subdirectories from the Must Use plugin folder.

Description
-----------

[](#description)

The WordPress Must Use Plugins are acceptable to include without doings in the back end. But WordPress does not load plugins in subdirectories. They must be at the root of the Must Use plugin directory, on default `/wp-content/mu-plugins/`. This small plugin scan includes all plugins in subdirectories from the Must Use plugin folder.

The plugin has a simple cache, and you flush this cache if you go to the network plugin page; view is enough.

### Screenshots

[](#screenshots)

[![List of Must Use Plugins, include the automatically loads in subdirectories](./assets/screenshot-1.png "List of Must Use Plugins, include the automatically loads in subdirectories")](./assets/screenshot-1.png)

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

[](#installation)

### Manual

[](#manual)

1. Download the php file
2. Copy to your Must Use plugin folder, default `/wp-content/mu-plugins/`
3. Alternative define your Must Use folder in the `wp-config.php` and copy the plugin in this folder
4. Check in the network plugin page, if it works

### Alternative via Composer

[](#alternative-via-composer)

The plugin is available as [Composer](https://getcomposer.org/) package and can be installed via Composer.

```
composer require bueltge/must-use-loader
```

Or to create as a project in your environment.

```
composer create-project bueltge/must-use-loader --no-dev
```

The package is on [packagist](https://packagist.org/packages/bueltge/must-use-loader) and the package name is `bueltge/must-use-loader`.

### Alternative via Git

[](#alternative-via-git)

1. Go to your Must Use folder `cd path`
2. `git init .`
3. `git remote add origin https://github.com/bueltge/must-use-loader.git`
4. `git fetch origin`
5. `git checkout master`
6. Check in the network plugin page, if it works

Customization
-------------

[](#customization)

### Custom Must Use Plugin directory

[](#custom-must-use-plugin-directory)

Define it in the `wp-config.php` of your install, as the following source.

```
// Custom mu plugin directory
define( 'WPMU_PLUGIN_DIR', dirname( __FILE__ ) . '/wpmu-plugins' );
define( 'WPMU_PLUGIN_URL', 'http://' . $_SERVER['HTTP_HOST'] . '/wpmu-plugins' );
```

### Exclude plugins from loader

[](#exclude-plugins-from-loader)

On default, exclude the plugin all plugin files, there start with an underline `_`. But you can remove plugins detected by the "Must Use Loader" from the loading process by using the `must_use_loader.mu_plugins` filter. Example:

```
function prefix_unset_autoloading( $mu_plugins ) {

    unset( $mu_plugins['plugin-folder/plugin-file.php'] );
    return $mu_plugins;
}
add_filter( 'must_use_loader.mu_plugins', 'prefix_unset_autoloading' );
```

Other Notes
-----------

[](#other-notes)

### Bugs, technical hints or contribute

[](#bugs-technical-hints-or-contribute)

Please give me feedback, contribute and file technical bugs on this [GitHub Repo](https://github.com/bueltge/must-use-loader), use Issues.

### License

[](#license)

Good news, this plugin is free for everyone! Since it's released under the [MIT](./LICENSE), you can use it free of charge on your personal or commercial blog. But if you enjoy this plugin, you can thank me and leave a [small donation](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6069955 "Paypal Donate link")for the time I've spent writing and supporting this plugin. And I don't want to know how many hours of my life this plugin has already eaten ;)

### Contact & Feedback

[](#contact--feedback)

The plugin is designed and developed by me ([Frank Bültge](https://bueltge.de), [Twitter](https://twitter.com/bueltge))

Please let me know if you like the plugin or you hate it or whatever ... Please fork it, add an issue for ideas and bugs.

### Disclaimer

[](#disclaimer)

I'm German, and my English might be gruesome here and there. So please be patient with me and let me know of typos or grammatical farts. Thanks

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity38

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 85% 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 ~105 days

Recently: every ~120 days

Total

6

Last Release

2891d ago

PHP version history (2 changes)1.1.0PHP >5.6

1.1.1PHP >=5.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/0fa321f6c73e14c16d4aea0276673ce1e5d001e49062e32f3b8dc91f0ed10c1e?d=identicon)[bueltge](/maintainers/bueltge)

---

Top Contributors

[![bueltge](https://avatars.githubusercontent.com/u/133425?v=4)](https://github.com/bueltge "bueltge (85 commits)")[![DannyvanHolten](https://avatars.githubusercontent.com/u/6751652?v=4)](https://github.com/DannyvanHolten "DannyvanHolten (8 commits)")[![cfoellmann](https://avatars.githubusercontent.com/u/1256090?v=4)](https://github.com/cfoellmann "cfoellmann (3 commits)")[![JoranSchipper](https://avatars.githubusercontent.com/u/5363447?v=4)](https://github.com/JoranSchipper "JoranSchipper (2 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")[![nicolasmn](https://avatars.githubusercontent.com/u/855244?v=4)](https://github.com/nicolasmn "nicolasmn (1 commits)")

---

Tags

loadermultisitephppluginwordpresspluginwordpressloader

### Embed Badge

![Health badge](/badges/bueltge-must-use-loader/health.svg)

```
[![Health](https://phpackages.com/badges/bueltge-must-use-loader/health.svg)](https://phpackages.com/packages/bueltge-must-use-loader)
```

###  Alternatives

[afragen/git-updater

A plugin to automatically update GitHub, Bitbucket, GitLab, or Gitea hosted plugins, themes, and language packs.

3.3k1.6k](/packages/afragen-git-updater)[webdevstudios/cmb2-attached-posts

Custom field for CMB2 for creating post relationships.

13565.5k](/packages/webdevstudios-cmb2-attached-posts)[appsero/client

Appsero Client

25431.7k9](/packages/appsero-client)[boxybird/inertia-wordpress

The WordPress adapter for Inertia.js

1827.4k](/packages/boxybird-inertia-wordpress)[iceicetimmy/acf-post-type-selector

Post type selector for Advanced Custom Fields.

559.0k](/packages/iceicetimmy-acf-post-type-selector)

PHPackages © 2026

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