Troubleshooting: Plugin won't activate - dotherightthing/wpdtrt-plugin-boilerplate GitHub Wiki

Status

  • Added @ 1.4.26
  • Needs further documentation: [reference needed]

Trigger

Navigate to the WordPress Plugins page.

Error message

If you have debugging enabled, a message similar to this will be output to debug.log:

PHP Fatal error: require_once(): Failed opening required '/path/to/pluginname/vendor/tgmpa/tgm-plugin-activation/class-tgm-plugin-activation.php' (include_path='.:/Applications/MAMP/bin/php/php5.6.30/lib/php') in /path/to/pluginname/vendor/dotherightthing/wpdtrt-plugin-boilerplate/src/Plugin.php on line 161

Explanation

This error indicates that the TGMPA plugin loader dependency is missing.

Common causes

  • Certain workflows [reference needed] remove TGMPA to prevent conflicts with documentation generators
  • You have manually edited composer.json prior to a commit, then run composer update

Solution

Reinstall the TGMPA dependency by running the following workflow:

yarn run build