這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

GitHub Release Downloads

外掛說明

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.
  • prereleases: includes draft releases and prereleases. Default value is false.

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, the release description and the list of files that can be downloaded, like release assets or the source code.
For styling, class selectors are provided (e.g.: release-downloads-header, release-name, etc.).

Attributes

  • user, repo, latest, tag, prereleases: same as above.
  • hide_description: hides the release description.
  • 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".
  • hide_source_code: hides the download link for the source code.

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, prereleases: 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.

螢幕擷圖

  • Example of [grd_count]. Here is used to get the number for total downloads.
  • Example of [grd_list]. Here it lists all available releases and downloads for a repository.
  • GitHub Release Downloads options page.

安裝方式

  1. Upload the github-release-downloads folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress

常見問題集

You’ll find more information at ivanrf.com.

使用者評論

2016 年 9 月 3 日 4 則留言
Hi Ivan - It is great thought developing a plugin like this. But it didnt worked for me . Could you please help me ? 1. Installed activated 2. In settings page I didnt put any username and repo info 3. I used the shorcode directly showed in examples section like below - [grd_list user="IvanRF" repo="MassiveFileRenamer" latest="true"] it throws me an error says invalid repo. I want to display the repo info of other users. Is it possible ? <Jan21-2016> Latest version is working fine. Thank You
閱讀全部 4 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈GitHub Release Downloads〉的開發相關工作。

參與者

〈GitHub Release Downloads〉外掛目前已有 2 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈GitHub Release Downloads〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

2.3.1

  • Added Authorization HTTP header, since access_token query parameter is deprecated.
  • Minor fix for a PHP warning.

2.3.0

  • Added release description, with Markdown support.
  • Added download link for release source code.
  • Added attribute to include draft and prereleases.
  • Improved dismissible admin notices.

2.2.0

  • Ignore draft and prereleases for latest version. Thanks @john30 for reporting this.
  • Improved admin notices.

2.1.0

  • Improved downloads list.

2.0.1

  • Removed scopes for access token.
  • Added scopes notes.
  • Added admin notices.

2.0.0.1

  • Fixed some localized strings.

2.0.0

  • Added Access Token to deal with API rate limit.
  • Improved error handling. External errors are shown in order to identify root causes.
  • Added help notes.
  • Moved translations to translate.wordpress.org.

1.1.0

  • Added i18n support for strings and download count.
  • Added Spanish translation.
  • Added Settings link in the Plugins list.
  • Added Donate and Follow Me links.

1.0.1

  • Minor fix for a PHP warning.

1.0

  • Initial release.