PHPackages                             tgm/plugin-activation - 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 &amp; Helpers](/categories/utility)
4. /
5. tgm/plugin-activation

Abandoned → [tgmpa/tgm-plugin-activation](/?search=tgmpa%2Ftgm-plugin-activation)Library[Utility &amp; Helpers](/categories/utility)

tgm/plugin-activation
=====================

TGM Plugin Activation is a PHP library that allows you to easily require or recommend plugins for your WordPress themes (and plugins).

2.6.1(9y ago)1.8k2.4k427[96 issues](https://github.com/TGMPA/TGM-Plugin-Activation/issues)[20 PRs](https://github.com/TGMPA/TGM-Plugin-Activation/pulls)GPL-2.0+PHPPHP &gt;=5.2

Since Mar 17Pushed 2y ago84 watchersCompare

[ Source](https://github.com/TGMPA/TGM-Plugin-Activation)[ Packagist](https://packagist.org/packages/tgm/plugin-activation)[ Docs](http://tgmpluginactivation.com)[ RSS](/packages/tgm-plugin-activation/feed)WikiDiscussions develop Synced 2mo ago

READMEChangelog (10)DependenciesVersions (11)Used By (0)

TGM Plugin Activation
=====================

[](#tgm-plugin-activation)

[![GitHub license](https://camo.githubusercontent.com/99d280c5a1f6abf3596fc7a96de71d3ae1003f7e99ee55140aae35bb88ba705e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c76322d626c75652e737667)](https://raw.githubusercontent.com/TGMPA/TGM-Plugin-Activation/develop/LICENSE.md)[![Build Status](https://camo.githubusercontent.com/e22fe3ad62bf52fa80133ec7d5d2dd62594ef103080c25f3f512b98f2a21dd11/68747470733a2f2f7472617669732d63692e6f72672f54474d50412f54474d2d506c7567696e2d41637469766174696f6e2e7376673f6272616e63683d646576656c6f70)](https://travis-ci.org/TGMPA/TGM-Plugin-Activation)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/fb280d5a8896ffd0b5f94ade5fa51e8608922f7d126b21a7e7290eca989851ef/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f54474d50412f54474d2d506c7567696e2d41637469766174696f6e2f6261646765732f7175616c6974792d73636f72652e706e673f623d646576656c6f70)](https://scrutinizer-ci.com/g/TGMPA/TGM-Plugin-Activation/?branch=develop)

**Lead Developers:**[Thomas Griffin](https://github.com/thomasgriffin) ([@jthomasgriffin](https://twitter.com/jthomasgriffin)), [Gary Jones](https://github.com/GaryJones) ([@GaryJ](https://twitter.com/GaryJ)), [Juliette Reinders Folmer](https://github.com/jrfnl) ([@jrf\_nl](https://twitter.com/jrf_nl))
**Version:** 2.6.1 **Requires at least:** 3.7.0 **Tested up to:** 4.5.2

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

[](#description)

TGM Plugin Activation is a PHP library that allows you to easily require or recommend plugins for your WordPress themes (and plugins). It allows your users to install, update and even automatically activate plugins in singular or bulk fashion using native WordPress classes, functions and interfaces. You can reference bundled plugins, plugins from the WordPress Plugin Repository or even plugins hosted elsewhere on the internet.

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

[](#installation)

1. Generate a customized version of the latest version of TGMPA based on your intended use-case using the [Custom TGMPA Generator](http://tgmpluginactivation.com/download/).
2. Extract the class file and place it somewhere in your theme hierarchy.
3. Add a `require_once` call within `functions.php` (or other file) referencing the class file.
4. Create a function, hooked to `tgmpa_register`, that registers the plugin and configurations.

For steps 3 and 4, it is recommended you view, copy and paste the contents of `example.php`and amend to suit. The `example.php` file is a model for how you should include the class in your theme.

Detailed documentation on [how to configure TGMPA](http://tgmpluginactivation.com/configuration/) is available on the website.

***We strongly recommend the use of the [Custom TGMPA Generator](http://tgmpluginactivation.com/download/) if you intend to use TGMPA in a theme which is to be published via WordPress.org or Themeforest.***

The generated customized version of TGMPA will comply with the Theme Review guidelines and Theme Check.

### Composer

[](#composer)

TGM Plugin Activation is also available as a [package](https://packagist.org/packages/tgmpa/tgm-plugin-activation) installable via Composer:

```
composer create-project tgmpa/tgm-plugin-activation --no-dev
```

Frequently Asked Questions
--------------------------

[](#frequently-asked-questions)

See [the FAQ page](http://tgmpluginactivation.com/faq/).

Feedback
--------

[](#feedback)

See  for current issues and the [guidelines for reporting bugs and enhancements](https://github.com/TGMPA/TGM-Plugin-Activation/wiki/Guidelines-for-reporting-bugs).

**Note:** TGM Plugin Activation library authors are not responsible for the *end-user support* for any plugin or theme which uses the library.

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md).

Contributing to TGM Plugin Activation
-------------------------------------

[](#contributing-to-tgm-plugin-activation)

If you have a patch, or stumbled upon an issue with TGM Plugin Activation core, you can contribute this back to the code. Please read our [contributor guidelines](CONTRIBUTING.md) for more information how you can do this.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity45

Moderate usage in the ecosystem

Community36

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~113 days

Recently: every ~80 days

Total

8

Last Release

3642d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ba7751eebec0f74a4963e9a062f49e58222b97872bf193d95f0505f3df321d09?d=identicon)[GaryJones](/maintainers/GaryJones)

---

Top Contributors

[![jrfnl](https://avatars.githubusercontent.com/u/663378?v=4)](https://github.com/jrfnl "jrfnl (269 commits)")[![GaryJones](https://avatars.githubusercontent.com/u/88371?v=4)](https://github.com/GaryJones "GaryJones (218 commits)")[![thomasgriffin](https://avatars.githubusercontent.com/u/909318?v=4)](https://github.com/thomasgriffin "thomasgriffin (184 commits)")[![zackkatz](https://avatars.githubusercontent.com/u/870979?v=4)](https://github.com/zackkatz "zackkatz (6 commits)")[![ramiy](https://avatars.githubusercontent.com/u/576623?v=4)](https://github.com/ramiy "ramiy (5 commits)")[![pedro-mendonca](https://avatars.githubusercontent.com/u/7371591?v=4)](https://github.com/pedro-mendonca "pedro-mendonca (4 commits)")[![nilovelez](https://avatars.githubusercontent.com/u/1619760?v=4)](https://github.com/nilovelez "nilovelez (4 commits)")[![alex-georgiou](https://avatars.githubusercontent.com/u/2937881?v=4)](https://github.com/alex-georgiou "alex-georgiou (3 commits)")[![emreerkan](https://avatars.githubusercontent.com/u/529484?v=4)](https://github.com/emreerkan "emreerkan (3 commits)")[![jeffsebring](https://avatars.githubusercontent.com/u/687638?v=4)](https://github.com/jeffsebring "jeffsebring (3 commits)")[![mobby2561](https://avatars.githubusercontent.com/u/17024123?v=4)](https://github.com/mobby2561 "mobby2561 (3 commits)")[![Ninos](https://avatars.githubusercontent.com/u/1012403?v=4)](https://github.com/Ninos "Ninos (3 commits)")[![vburlak](https://avatars.githubusercontent.com/u/1781636?v=4)](https://github.com/vburlak "vburlak (3 commits)")[![mayukojpn](https://avatars.githubusercontent.com/u/1886443?v=4)](https://github.com/mayukojpn "mayukojpn (2 commits)")[![hedii](https://avatars.githubusercontent.com/u/5358048?v=4)](https://github.com/hedii "hedii (2 commits)")[![hugosaner](https://avatars.githubusercontent.com/u/1635707?v=4)](https://github.com/hugosaner "hugosaner (2 commits)")[![andrezrv](https://avatars.githubusercontent.com/u/4804515?v=4)](https://github.com/andrezrv "andrezrv (2 commits)")[![elvishp2006](https://avatars.githubusercontent.com/u/7463100?v=4)](https://github.com/elvishp2006 "elvishp2006 (2 commits)")[![geoclaps](https://avatars.githubusercontent.com/u/7847695?v=4)](https://github.com/geoclaps "geoclaps (1 commits)")[![wowu](https://avatars.githubusercontent.com/u/6865958?v=4)](https://github.com/wowu "wowu (1 commits)")

---

Tags

wordpresslibrarythemepluginsactivation

### Embed Badge

![Health badge](/badges/tgm-plugin-activation/health.svg)

```
[![Health](https://phpackages.com/badges/tgm-plugin-activation/health.svg)](https://phpackages.com/packages/tgm-plugin-activation)
```

###  Alternatives

[tgmpa/tgm-plugin-activation

TGM Plugin Activation is a PHP library that allows you to easily require or recommend plugins for your WordPress themes (and plugins).

1.8k222.5k13](/packages/tgmpa-tgm-plugin-activation)[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)[appsero/client

Appsero Client

25431.7k9](/packages/appsero-client)[balbuf/composer-wp

Manage WordPress core, plugins, and themes with composer.

173.6k](/packages/balbuf-composer-wp)

PHPackages © 2026

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