webdeveric/wordpress-muplugin-installer

Install WordPress must-use plugins with Composer

3.0.1 2024-03-01 13:55 UTC

Requires

• php: >=8
• composer-plugin-api: ^2.0
• composer/installers: ^2.2
• react/promise: ^2.8 || ^3

Requires (Dev)

• composer/composer: ^2.7.1
• phpmd/phpmd: ^2.15.0
• phpunit/phpunit: ^11.0.0
• squizlabs/php_codesniffer: ^3.9.0

MIT

• Eric King

• installer
• plugin
• composer
• wordpress
• must-use
• mustuse
• LonelyPlanet
• webdeveric

README

composer require webdeveric/wordpress-muplugin-installer

The Multi-Framework Composer Library Installer does not completely install WordPress must-use plugins. It does put the plugin in the mu-plugins folder, but that isn't enough to be recognized as a must-use plugin by WordPress.

This plugin addresses that by copying the plugin entry point file into the mu-plugins folder. Your plugin can indicate which file is the main entry point by specifying it in the extra section of your composer.json file.

{
  "name": "scope/mu-plugin",
  "description": "Just another must-use plugin",
  "type": "wordpress-muplugin",
  "extra": {
    "wordpress-muplugin-entry": "your-plugin-entry-point-file.php"
  },
  "require": {
    "webdeveric/wordpress-muplugin-installer": "^2.0"
  }
}

If you do not specify wordpress-muplugin-entry, this plugin will figure out which PHP files are WordPress plugins by looking for Plugin Name: in the first 8 kilobytes of each PHP file in the root of your plugin folder.

Git hooks

Run this to install a git hook that will run PHPCS, PHPMD, and PHPUnit before you commit.

composer setup-hooks