WordPress.org

Plugin Directory

Test out the new Plugin Directory and let us know what you think.

GitHub Release Downloads

Get the download count, links and more information for releases of GitHub repositories.

GitHub Release Downloads allows you to get the download count, links and more information for releases of GitHub repositories.

Download count

The shortcode is [grd_count]. It returns a number corresponding to the sum of all download count values for the selected releases. For instance, you can get the number of total downloads for one GitHub repository.

Attributes

  • user: the GitHub username.
  • repo: the GitHub repository name.
  • latest: only gets information about the latest published release for the repository.
  • tag: only gets information about the release with the specified tag name.

Examples

  • All repository downloads: [grd_count user="IvanRF" repo="MassiveFileRenamer"]
  • Latest release downloads: [grd_count user="IvanRF" repo="MassiveFileRenamer" latest="true"]
  • Specific release downloads: [grd_count user="IvanRF" repo="MassiveFileRenamer" tag="v1.6.0"]

Note: user and/or repo can be omitted if default values are set.

Release downloads list

The shortcode is [grd_list]. It returns an HTML list for the selected releases including the release tag name and the list of files that can be downloaded. For styling, class selectors are provided (e.g.: release-downloads-header, release-name, etc.).

Attributes

  • user, repo, latest, tag: same as above.
  • hide_size: hides information about the file size.
  • hide_downloads: hides information about the download count.
  • downloads_suffix: use it for internationalization. Default value is " downloads".

Examples

  • All repository downloads: [grd_list user="IvanRF" repo="MassiveFileRenamer"]
  • Latest release downloads: [grd_list user="IvanRF" repo="MassiveFileRenamer" latest="true"]
  • Specific release downloads: [grd_list user="IvanRF" repo="MassiveFileRenamer" tag="v1.5.6"]
  • Hide file size: [grd_list user="IvanRF" repo="MassiveFileRenamer" hide_size="true"]
  • Hide downloads count: [grd_list user="IvanRF" repo="MassiveFileRenamer" hide_downloads="true"]
  • Downloads suffix change: [grd_list user="IvanRF" repo="MassiveFileRenamer" downloads_suffix="descargas"]

Boolean attributes can take any of this values: "1", "true", "on" and "yes"; or "0", "false", "off" and "no".

Latest version

The shortcode is [grd_latest_version]. It returns the tag name of the latest published full release. For tag names like "v1.6.0", it returns "1.6.0" as the version number.

Attributes

  • user, repo: same as above.

Settings

Under WordPress Settings menu you will find the GitHub Release Downloads options page. In this page you can set values for the GitHub username and the repository name to use by default in the shortcodes.

If both values are set, the shortcodes can be used without attributes (e.g.: [grd_count]) since default values for user and repo will be used. Attribute values take precedence over default values. For example, [grd_count repo="MyRepo"] will use the username default value and the repository specified in the shortcode.

Requires: 3.1 or higher
Compatible up to: 4.7.3
Last Updated: 2 months ago
Active Installs: 100+

Ratings

4.5 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,1,1
100,2,2 100,1,1
100,1,1
100,1,1
100,1,1