BNS Theme Details
PHP CSS JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


=== BNS Theme Details ===
Contributors: cais
Donate link:
Tags: themes details, themes, plugin, widget, shortcode, details, download, author, update, rating, changelog, version
Requires at least: 3.6
Tested up to: 4.3
Stable tag: 0.4.1
License: GNU General Public License v2
License URI:

Displays theme specific details such as download count, last update, author, etc.

== Description ==

This plugin can be used to display the recent download count of a theme, as well as various other details such as the author and when it was last updated. It also includes a link to the WordPress Theme repository if it exists.

== Installation ==

1. Go to 'Plugins' menu under your Dashboard
2. Click on the 'Add New' link
3. Search for BNS Theme Details
4. Install.
5. Activate through the 'Plugins' menu.
6. Place the BNS Theme Details widget appropriately in the Appearance > Widgets section of the dashboard; or use the default `[ bns_theme_details ]` shortcode (without the spaces) in a page or post.

Reading this article for further assistance with plugin installation:

/** ---- */

Shortcode Usage:

* `[ bns_theme_details ]` - this is the default (less the spaces) which will display the current active theme on the site (provided it is hosted on the WordPress repository).

Shortcode parameters (and their defaults):

* `title => __return_null()` ... returns nothing
* `theme_slug => wp_get_theme()->get_template()` ... uses the current theme; the theme name can also be used in place of its slug provided they are similar
* `use_screenshot_link => true` ... displays main screenshot
* `show_name => true` ... displays the theme name
* `show_author => true` ... displays the author name
* `show_last_updated => true` ... displays when the theme was last updated
* `show_current_version => true` ... displays the current theme version
* `show_rating => true` ... displays the current "star" rating of the theme
* `show_number_of_ratings => true` ... displays the number of ratings the theme has received
* `show_description => true` ... displays theme description (this is false by default in the widget section)
* `show_downloaded_count => true` ... displays the total download count
* `use_download_link => true` ... displays a download link pointing to the current version of the theme in the WordPress Theme repository
* `show_changelog => true` ... displays the contents of the theme's `changelog.txt` file if it exists

== Frequently Asked Questions ==
Q: Why am I not seeing any Theme Details?

This plugin currently only handles those themes that can be found in the WordPress Theme repository.

== Screenshots ==
* To be developed

== Other Notes ==
* Copyright 2014-2015  Edward Caissie  (email :

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License version 2,
  as published by the Free Software Foundation.

  You may NOT assume that you can use any other version of the GPL.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

  The license for this software can also likely be found here:

== Upgrade Notice ==
* Please stay current with your WordPress installation, your active theme, and your active plugins.

== Changelog ==
= 0.4.1 =
* Released August 2015
* Updated to use PHP5 constructor objects

= 0.4 =
* Released December 2014
* Added "in plugin update message" functionality
* Added changelog to output (requires theme to use `changelog.txt` file)
* Added enqueue statement for scripts and styles
* Added CONSTANTS for "DRY" purposes and customization paths
* Added more specificity to the output for more finely tuned styles
* Added plugin "icon" assets
* Change sanity check to ensure `$theme_slug` is not empty versus not `null`
* Corrected shortcode filter reference to indicate `bns_theme_details`
* Corrected conditional statements (changed `===` to `==`)
* Modified `textdomain` to use full plugin slug `bns-theme-details`
* Spice things up by leveraging BNS Inline Asides to minimize the Changelog display
* Switched order of "Theme Name and Author" with the "Screenshot"
* Updated required version to 3.6 in reference to the shortcode filter option
* Updated `exit_message` if WordPress version is too low
* Wrapped `<img />` tag in a `<p />` tag for better display compatibility

= 0.3 =
* Released February 2014
* Correct shortcode parameters not recognizing boolean checks

= 0.2 =
* Released February 2014
* Added theme description to output

= 0.1 =
* Initial release - February 2014