Skip to content

Composer Autoloader that supports the WordPress Coding Standards

Notifications You must be signed in to change notification settings

alleyinteractive/composer-wordpress-autoloader

Repository files navigation

Composer WordPress Autoloader

Latest Version on Packagist Tests

Autoload WordPress files configured via Composer that support the WordPress Coding Standards using alleyinteractive/wordpress-autoloader. Will load the autoloaded classes defined in your package and all autoloaded classes in your dependencies.

Installation

You can install the package via Composer:

composer require alleyinteractive/composer-wordpress-autoloader

Usage

{
  "extra": {
    "wordpress-autoloader": {
      "autoload": {
        "My_Plugin_Namespace\\": "src/",
      },
      "autoload-dev": {
        "My_Plugin_Namespace\\Tests\\": "tests/",
      }
    }
  }
}

Once added, you can load vendor/autoload.php as normal and the autoloader will handle the rest. If that doesn't work, see Automatically Injecting WordPress Autoloader.

Automatically Injecting WordPress Autoloader

By default Composer WordPress Autoloader will automatically load the WordPress autoloader. This is done by adding src/autoload.php as an autoloaded file to Composer. However, this may not always work under some circumstances including symlinks. When necessary, you can opt to inject the vendor/wordpress-autoload.php file into your vendor/autoload.php file. This is disabled by default and be enabled by setting inject to true in your composer.json.

{
  "extra": {
    "wordpress-autoloader": {
      "inject": true
    }
  }
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.