Plugins List

Description

This is a simple WordPress plugin aimed at giving credit where credit is due.

The plugin inserts an XHTML list into any post/page through a shortcode. If you’re into customization, you can specify a format argument and indicate the exact output you are after. There’s also an option to display inactive plugins as well.

Key features include…

  • A simple template system allows you to format how you’d like the plugin information to be shown
  • Template tags are available for automatically linked items as well as simple text
  • Choose from a number of pieces of plugin data to be output
  • Display inactive plugins as well as active plugins if you wish
  • Output is cached to provide a super-quick response
  • A separate shortcode allows you to display how many plugins you have!

Technical specification…

  • Licensed under GPLv2 (or later)
  • Designed for both single and multi-site installations
  • PHP7 compatible
  • Fully internationalized, ready for translations. If you would like to add a translation to this plugin then please head to our Translating WordPress page
  • WCAG 2.0 Compliant at AA level

Thanks to Matej Nastran‘s My plugins, from which Plugins list was initially derived.

Please visit the Github page for the latest code development, planned enhancements and known issues.

Instructions on use

To get a list of the plugins that are installed and activated in your website, insert the following into any post or page:

<ul>[plugins_list]</ul>

You can customise the output specifying the format argument and a number of pre-defined tags. Here’s an example:

[plugins_list format="#LinkedTitle# - #LinkedAuthor#</br>"]

The tags are: #Title#, #PluginURI#, #Author#" ,#AuthorURI#, #Version#, #Description#, #LinkedTitle#, #LinkedAuthor#.

If you want to list also the plug-ins you have installed but are not using, here’s the formula:

<ul>[plugins_list show_inactive=true]</ul>

The plugins list can be freely styled with css, just place any class or id attribute on the format string, or on the elements surrounding it.

By default links will be followed but you can make these “nofollow” by simply adding the parameter of nofollow=true. For example…

<ul>[plugins_list nofollow=true]</ul>

You can also specify the link target too. For example…

<ul>[plugins_list target="_blank"]</ul><h3>Using HTML</h3>

If you wish to put HTML in your format then you can. However, this can cause havoc in the Visual editor and even causes extra characters to be passed into the output (rogue paragraph tags, for instance). I therefore highly recommend that, if you wish to add HTML, use { and } instead of < and > around your HTML tags – this plugin will correct this before output but it means the visual editor doesn’t try and interpret the HTML.

For example…

<ul>[plugins_list format="{li}#LinkedTitle# - #LinkedAuthor#{/li}"]</ul>

The characters will be corrected upon output and you will get a lovely, bulleted, un-ordered list as output.

Cache

By default your plugin list will be cached for 1 hour, ensuring that performance is impacted as little as possible. Use the parameter cache to change the number of hours. Set this to false to switch off caching.

For example…

<ul>[plugins_list cache=24]</ul>

This will cache for 24 hours. The following will switch the cache off…

<ul>[plugins_list cache=false]</ul><h3>Plugin Count</h3>

A shortcode also exists to allow you to display the number of plugins that you have. Simply add [plugins_number] to your post or page and it will return the number of active plugins.

To display the number of active AND inactive plugins use [plugins_number inactive=true].

As with the other shortcode results will be cached by default. To change the number of hours simply use the cache parameter. Set it to false to switch off caching. For example…

[plugins_number inactive=true cache=2]<h3>Function Calls</h3>

If you wish to get the plugin data via a PHP function call (for example, to integrate it into your theme or add to your own plugin) then the following can be used..

<?php $list = get_plugins_list(  $format, $show_inactive, $cache, $nofollow, $target ); ?>

None of the parameters are required and are as per the shortcode.

For getting the plugin numbers you can use the function…

<?php $number = get_plugin_number( $inactive, $cache ); ?>

Both function calls will return the appropriate text but not output it.

Reviews & Mentions

A default WP credit page would be kind of neat

Screenshots

  • An example of the list in use

Installation

Plugins List can be found and installed via the Plugin menu within WordPress administration (Plugins -> Add New). Alternatively, it can be downloaded from WordPress.org and installed manually…

  1. Upload the entire plugins-list folder to your wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress administration.

Voila! It’s ready to go.

FAQ

Installation Instructions

Plugins List can be found and installed via the Plugin menu within WordPress administration (Plugins -> Add New). Alternatively, it can be downloaded from WordPress.org and installed manually…

  1. Upload the entire plugins-list folder to your wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress administration.

Voila! It’s ready to go.

Reviews

What plugins do you use on your site?

I think this is question, when you see a great website, you might want to get answered.

So here’s a handy dandy plugin that does it all for you.

The only thing you have to add to it, is to answer this question ~ which ones could you not live without and why?

Read all 6 reviews

Contributors & Developers

“Plugins List” is open source software. The following people have contributed to this plugin.

Contributors

“Plugins List” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Plugins List” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

Learn more about my version numbering methodology

2.3.2

  • Maintenance: Updates to README
  • Maintenance: Removed un-needed language folder and domain path
  • Maintenance: Removed donation links

2.3.1

  • Bug: A number of the tags had stopped working. I don’t know what I’d been drinking when I tested the last release but it can’t have been good. Now all fixed
  • Maintenance: Plugin now requires WP 4.6 to work as we need to move with the times
  • Maintenance: Updated the links to my site because I like to move around
  • Maintenance: Tweaked this README to reflect the changes above but also the new plugin directory layout

2.3

  • Enhancement: Improved the performance of the search/replace of tags
  • Enhancement: Added a method of adding HTML to the formatting without causing issues with the visual editor
  • Enhancement: After WP 4.6 you no longer need to include the plugin domain. So I don’t!
  • Maintenance: Merged all the included files together as the total amount of code wasn’t enough to justify having it split!

2.2.7

  • Maintenance: Updated branding, inc. adding donation links

2.2.6

  • Maintenance: Updated branding
  • Maintenance: Stopped the naughty behavior of hard-coding the plugin folder name in INCLUDES
  • Maintenance: Removed the apl- prefix from the file names

2.2.5

  • Maintenance: Added text domain and domain path

2.2.4

  • Enhancement: Added internationalization

2.2.3

  • Maintenance: Updated links and changed branding

2.2.2

  • Bug: Accidentally left some debug output in place. Sorry!

2.2.1

  • Bug: Fixed PHP error
  • Bug: Corrected caching
  • Enhancement: Added uninstaller – cache will be wiped upon uninstall

2.2

  • Maintenance: Added instructions for generating list via PHP function call
  • Enhancement: Improved caching so that data is not left behind on options table
  • Enhancement: Prevent plugin’s HTML comment from appearing around each entry
  • Enhancement: Add link target and nofollow option
  • Enhancement: Added shortcode to return number of plugins

2.1

  • Maintenance: Divided code into separate files all of which, except the main launch file, have been added into an ‘includes’ folder
  • Maintenance: Split main code into separate functions to make future enhancement easier. This and the previous change have been made in preparation for version 3.
  • Enhancement: Added caching
  • Enhancement: Comment added to HTML output with debug information on

2.0

  • Maintenance: Renamed plugin and functions within it
  • Maintenance: Improved code readability, including adding PHPDoc comments
  • Maintenance: Re-written README
  • Maintenance: Changed default format to not display plugin version, as this is a security risk
  • Enhancement: Added links to plugin meta