TGM Plugin Activation Library Publishes Roadmap for Version 3.0

photo credit: domino - (license)
photo credit: domino(license)

This week contributors on the TGM Plugin Activation (TGMPA) library published a roadmap for the future of the project. TGMPA is widely used by WordPress developers to require and recommend plugins for themes (and other plugins). The library is recommended by Themeforest, CodeCanyon, and the Theme Review Team as an alternative to bundling everything in one theme/plugin.

Gary Jones is leading the upcoming 2.5 release, expected in May, with help from fellow lead developer Juliette Reinders Folmer, to whom he credits most of the recent activity on the project. This release will add support for installing from a GitHub repo source, separate menu items out from under the Appearance menu, add Travis CI support, improve accessibility, and fix a number of bugs.

The Future of the TGM Plugin Activation Library

The project’s contributors are also planning ahead for this summer’s 3.0 release, which Folmer will lead. This release will be a major turning point for TGMPA and will essentially constitute a complete rewrite.

The roadmap for 3.0 includes several ambitious items that will likely affect the way developers integrate TGMPA into their projects:

  • Multisite compatibility
  • Fix conflicting UI messages for usage in themes / plugins
  • Improved UI by having the admin page always in the same location
  • Updatability of TGMPA independently of the plugin/theme which ships it
  • Show dependencies more clearly

This plan includes an architectural change that would allow for the integration of the Plugin Dependencies (PD) plugin to provide UI for dependency management and cascading deactivation if dependencies are not met.

According to Jones, the eventual goal is to turn TGMPA into a plugin that can be added to the repository for easier updating:

Some of the logic in the rewrite will be handled by the Plugin Dependencies plugin, and TGMPA itself will be turned into a plugin and added to the WPORG repo so that it can be updated automatically. The TGMPA library will then consist of a bootstrap file, the TGMPA plugin (as a zip) and the PD plugin (as a zip). The bootstrap file will then check if the TGMPA + PD plugins are installed, and if not, install them from the embedded zips.

TGMPA contributors are currently in discussion with representatives from about the possibility of allowing their planned plugin in the official directory. As the plugin has not yet been produced and submitted, it’s still too early to know the outcome of the decision.

“If we can’t go onto the repo, then we’ll be looking at simply hosting the plugin version on GitHub, and use some (if needed) of the GitHub Updater plugin (or similar) code within the bootstrap file to pull the latest tag from GitHub instead,” Jones said.

One of the main focuses for version 3.0 is to allow different plugins and themes to use TGMPA without the concern of compatibilities resulting from plugin A including 2.4.1, for example, and plugin B including 2.5.0.

“The v3 setup should also be able to handle instances of v2 gracefully, and the v2 branch may have a 2.6 release to make the logic for that easier,” Jones said.

After version 3.0 is released, the project will contain multiple repositories – one for the standard plugin, and one that uses Grunt to pull in files from the plugin repository and zips them up next to the bootstrap file. In anticipation of these changes, contributors have moved the current repository into a new GitHub organization at:

As TGMPA does not currently track its usage, it’s difficult to nail down exact numbers for how many theme/plugin developers these changes will impact.

“I have no idea what sort of numbers of products this entails,” Jones said. “But there is a non-trivial amount of usage that requires us to step up the game in order to provide the exceptional functionality other developers can rely on.”

TGMPA is a critical tool that many developers in the WordPress ecosystem depend on for managing plugin requirements and recommendations. As theme development continues to move in the direction of separating theme and plugin functionality, TGMPA will play an important role in serving developers who want to structure their projects according to WordPress best practices.

Getting the new TGMPA plugin included in the plugin directory would be a big win for the project, as it would allow users to update more easily in the future. You can follow TGMPA on Twitter for all the latest news as the team moves into development for version 3.0.

Would you like to write for WP Tavern? We are always accepting guest posts from the community and are looking for new contributors. Get in touch with us and let's discuss your ideas.


  1. *cough* Feature Plugin *cough*

    Seriously: get it Plugin-ready, and then propose it as a core addition as a Feature Plugin. Getting dependency management baked directly into core would be such a huge win.


    1. There are certainly aspects of it which may well be useful for WP Core, so we’ll keep half-an-eye on having it as a feature plugin project.


    2. Totally agree. With the modulized development, dependency management is a must-have in any framework/application. I think bundle this into WordPress core is a huge step forward and solve a big headache for developers.


    3. +1 for core. It should be part of core anyways. :)


    4. WordPress Core is not only for developers. I don’t think it should be part of WP Core, leave it as lightweight as possible. Make it as an installable plugin which add these such features would be much more WordPress way.


      1. A dependency system in core would help end users far more than it would help developers.


      2. Hey Chip! Sam from WordCampKC 2011. Your theme repository session talk was after mine if you remember me.

        I agree. And wholeheartedly support this being added to core. I have been suggesting a dependency system to WP for quite some time now. Because more and more we are seeing a rise in plugin extenders!


  2. I just want to give a shout to both Gary and Juliette for all of their hard work on the library in my absence of being able to actively contribute. They have done an incredible job and will continue to make TGMPA even more reliable and functional for dependency management in WordPress.

    Thanks to you both!


    1. That’s a useful figure to know, thanks for checking! I wonder if you looked again in 6 months, if we’d have gone up by any significant amount. TGMPA hasn’t really changed since March 2014, so it’s been dormant. I’d love to see the 2.50 release reach 7%, and the 3.0.0 release reach 10% of WPORG themes.
      Then there’s WPORG plugins, GitHub-only themes and plugins, Theme Forest, Code Canyon etc. :-)


  3. Some excellent improvements outlined, and I think it’s definitely something which should be integrated with core.


  4. Definitely one of the goals should be to make this into a feature plugin. How about aiming for WP 4.3 or 4.4 inclusion? :)


  5. Most of it works just fine but for some reason random plugins are being involved in the download phase when using bulk option on table. Ticket submitted on GitHub.

    However I would still like to see this in the core and would like the core to store a history of plugin activation/deactivation. Using this type of class we could rollback or bulk re-install easily during troubleshooting.


Comments are closed.