Skip to content

Commit

Permalink
Merge branch 'dev'
Browse files Browse the repository at this point in the history
  • Loading branch information
thomasgriffin committed Jan 2, 2012
2 parents fc0843e + b16d552 commit d32e576
Show file tree
Hide file tree
Showing 3 changed files with 1,914 additions and 654 deletions.
34 changes: 21 additions & 13 deletions README
Original file line number Diff line number Diff line change
@@ -1,30 +1,21 @@
=== TGM Plugin Activation ===
Contributors: Thomas Griffin (@jthomasgriffin / thomasgriffinmedia.com)
Gary Jones (Github: @GaryJones / Twitter: GaryJ)
Version: 2.1.1
Version: 2.2.0
Requires at least: 3.0.0
Tested up to: 3.3-beta1
Tested up to: 3.3

== Description ==

This class will revolutionize how plugins can be handled for WordPress themes. By using classes that are
utilized within WordPress, the TGM_Plugin_Activation class can automatically install and activate multiple
plugins that are either packaged with a theme or downloaded from the WordPress Plugin Repository.

This class uses the WP_Filesystem Abstraction class to find the best way to install the plugin. WP_Filesystem
searches through a number of methods (Direct, FTP, FTP Sockets, SSH) and determines the best one for use based
on the user's server setup. If FTP is needed, a form will be displayed to prompt users to input their FTP
credentials. To do the installing, this class uses the Plugin_Upgrader and Plugin_Skin_Installer classes to
download, install and activate the plugins. This class also uses WP_Error to display any errors to users
during the plugin installation and activation process.
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 and even automatically activate plugins in singular or bulk fashion using native WordPress classes, functions and interfaces. You can reference pre-packaged plugins, plugins from the WordPress Plugin Repository or even plugins hosted elsewhere on the internet.

== Installation ==

1. Drop the class file somewhere in your theme hierarchy.
2. Add a require_once call within functions.php (or other theme file) referencing the class file.
3. Create a function, hooked to `tgmpa_register`, that registers the plugin and configurations.

For steps 2 and 3, it is recommended your view, copy and paste the contents of example.php
For steps 2 and 3, 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.

Some important things to note:
Expand All @@ -44,6 +35,23 @@ You can also follow project progress and updates on Twitter. Follow us here at h

== Changelog ==

= 2.2.0 =

* Fixed erroneous links for plugins linked to the WordPress Repo
* Improved UI of plugins by listing them in WordPress' default table layout
* Improved support for installing plugins if security credentials require FTP information
* Improved support for MultiSite
* Added 3 new classes (all extensions of existing WordPress classes): TGMPA_List_Table for outputting required/recommended plugins in a familiar table format, TGM_Bulk_Installer for bulk installing plugins and TGM_Bulk_Installer_Skin for skinning the bulk install process
* Added extra defensive measures to prevent duplication of classes
* Added ability to bulk install and bulk activate plugins
* Added new config options: 'parent_menu_slug', 'parent_menu_url', 'is_automatic', and 'message'
* Added new string: 'complete' (displayed when all plugins have been successfully installed and activated)
* Added support for singular/plural strings throughout the library
* Added permission checks to action links
* Added new filter tgmpa_default_screen_icon to set the default icon for the plugin table page
* Added new optional plugin parameters: 'version', 'force_activation', 'force_deactivation' and 'external_url'
* Removed 'button' string (deprecated with use of plugins table)

= 2.1.1 =

* Fixed nag not re-appearing if user switched themes and then re-activated the previous theme (UX improvement)
Expand Down
Loading

0 comments on commit d32e576

Please sign in to comment.