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. http://tgmpluginactivation.com/
Find a file
Gary Jones 2d34264f4f
Composer: update PHPCS Composer plugin dependency (#787)
Composer: update PHPCS Composer plugin dependency
2020-01-22 04:31:23 +00:00
languages Add fr_CA langages files (#734) 2018-03-12 22:05:37 +01:00
plugins Update the included example plugin to v 1.0.2 2017-08-03 15:37:19 +02:00
.editorconfig editorconfig: Be a little more specific 2017-06-30 12:54:21 +01:00
.gitattributes Gitattributes: add contributing.md file to the list 2018-01-15 01:11:14 +01:00
.gitignore Ensure composer.lock stays out of version control 2018-01-13 16:41:52 +00:00
.scrutinizer.yml More comprehensive scrutinizer config. 2016-05-03 15:47:06 +02:00
.travis.yml Build/Travis/Composer: various tweaks 2019-02-11 19:48:07 +01:00
CHANGELOG.md Releasing version 2.6.1. 2016-05-19 15:31:17 +02:00
class-tgm-plugin-activation.php CS: minor updates 2019-05-01 01:20:58 +02:00
composer.json Composer: update PHPCS Composer plugin dependency 2020-01-19 21:16:36 +01:00
CONTRIBUTING.md Various textual changes. 2015-06-04 00:09:55 +02:00
example.php Fix the Yoast SEO plugin name 2018-05-27 18:52:33 +04:00
LICENSE.md Create LICENSE.md 2015-04-24 23:14:49 +01:00
phpcs.xml.dist CS: minor updates 2019-05-01 01:20:58 +02:00
README.md Releasing version 2.6.1. 2016-05-19 15:31:17 +02:00

TGM Plugin Activation

GitHub license Build Status Scrutinizer Code Quality

Lead Developers: Thomas Griffin (@jthomasgriffin), Gary Jones (@GaryJ), Juliette Reinders Folmer (@jrf_nl)
Version: 2.6.1 Requires at least: 3.7.0 Tested up to: 4.5.2

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

  1. Generate a customized version of the latest version of TGMPA based on your intended use-case using the Custom TGMPA Generator.
  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 is available on the website.

We strongly recommend the use of the Custom TGMPA Generator 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

TGM Plugin Activation is also available as a package installable via Composer:

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

Frequently Asked Questions

See the FAQ page.

Feedback

See https://github.com/TGMPA/TGM-Plugin-Activation/issues for current issues and the guidelines for reporting bugs and enhancements.

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

Changelog

See CHANGELOG.md.

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 for more information how you can do this.