Title: EG Repo Card
Author: emanuelegori
Published: <strong>October 4, 2026</strong>
Last modified: October 4, 2026

---

Search plugins

![](https://ps.w.org/eg-repo-card/assets/banner-772x250.png?rev=3727104)

![](https://ps.w.org/eg-repo-card/assets/icon-256x256.png?rev=3727104)

# EG Repo Card

 By [emanuelegori](https://profiles.wordpress.org/emanuelegori/)

[Download](https://downloads.wordpress.org/plugin/eg-repo-card.2.2.0.zip)

 * [Details](https://wordpress.org/plugins/eg-repo-card/#description)
 * [Reviews](https://wordpress.org/plugins/eg-repo-card/#reviews)
 *  [Installation](https://wordpress.org/plugins/eg-repo-card/#installation)
 * [Development](https://wordpress.org/plugins/eg-repo-card/#developers)

 [Support](https://wordpress.org/support/plugin/eg-repo-card/)

## Description

EG Repo Card shows a compact card for a code repository hosted on GitHub, Codeberg
or any Forgejo or Gitea instance. Add the shortcode with the repository address 
and the card shows:

 * repository name, platform logo and description
 * buttons for the project website, the source code and the latest release download
 * last update date (the time since the update appears on hover)
 * latest version, from the latest release or, when there are none, the latest git
   tag
 * main language, license and star count
 * an “Archived” label for read-only repositories

The same shortcode works with plugins from the WordPress.org directory. Their card
shows the plugin name, icon and description, the plugin page, the download of the
latest version, the WordPress version it is tested up to, the active installations
and the average rating. Closed plugins get a “Closed” label.

The card adapts to your theme: card and buttons can use a neutral preset, a transparent
background, a custom color, or follow the light or dark mode of the visitor browser.
Text and icons always stay readable on the chosen background.

Repository data is cached. If the platform does not answer, the card keeps showing
the last data it received; visitors never see an error message.

### Usage

Insert the shortcode in any post, page, or widget:

[eg-repo-card url=”https://github.com/WordPress/wordpress-develop”]
 [eg-repo-card
url=”https://codeberg.org/forgejo/forgejo”] [eg-repo-card url=”https://git.emanuelegori.
uno/emanuelegori/eg-repo-card”] [eg-repo-card url=”https://wordpress.org/plugins/
akismet/”]

The address is the one you see in the browser on the repository or plugin page. 
For Forgejo and Gitea, any instance works, self-hosted ones included.

### External services

To build a card, the plugin asks the platform that hosts the repository or the plugin
for its public data. It contacts only the hosts written in the shortcodes on your
site, from your server, and only when a page with a card is displayed and the cached
data has expired. No data about your visitors is sent.

#### GitHub

 * **What**: the GitHub REST API (host `api.github.com`), used to read the data 
   of a public GitHub repository.
 * **When**: when a page with a GitHub card is displayed and the cached data has
   expired.
 * **Requests**: `/repos/{owner}/{repo}`, `/repos/{owner}/{repo}/releases/latest`
   and, when there are no releases, `/repos/{owner}/{repo}/tags`.
 * **Data sent**: the owner and name of the repository, and the personal access 
   token if you saved one.
 * **Data received**: public repository data (description, website, stars, language,
   license, latest release and tag).
 * Terms of service: https://docs.github.com/en/site-policy/github-terms/github-
   terms-of-service
 * Privacy statement: https://docs.github.com/en/site-policy/privacy-policies/github-
   general-privacy-statement

#### Codeberg

 * **What**: the Codeberg API (host `codeberg.org`, path `/api/v1`), used to read
   the data of a public Codeberg repository.
 * **When**: when a page with a Codeberg card is displayed and the cached data has
   expired.
 * **Requests**: the same as for Forgejo and Gitea instances, below.
 * **Data sent**: the owner and name of the repository, and the Forgejo token if
   you saved one.
 * **Data received**: public repository data (description, website, stars, language,
   license, latest release and tag).
 * Terms of use: https://codeberg.org/codeberg/org/src/branch/main/TermsOfUse.md
 * Privacy policy: https://codeberg.org/codeberg/org/src/branch/main/PrivacyPolicy.
   md

#### Forgejo and Gitea instances

Forgejo and Gitea are free software that anyone can host; there is no central service.
The plugin contacts only the instance whose address the site owner writes in a shortcode(
for example `git.emanuelegori.uno` in `[eg-repo-card url="https://git.emanuelegori.
uno/emanuelegori/eg-repo-card"]`), through the instance’s own API.

 * **What**: the API of that instance, used to read the data of a public repository
   hosted there.
 * **When**: when a page with a card from that instance is displayed and the cached
   data has expired.
 * **Requests**: `/api/v1/repos/{owner}/{repo}`, `/api/v1/repos/{owner}/{repo}/releases`
   and, when there are no releases, `/api/v1/repos/{owner}/{repo}/tags`. Once a 
   week per instance, `/api/forgejo/v1/version`, only to tell Forgejo from Gitea
   and show the right logo.
 * **Data sent**: the owner and name of the repository, and the Forgejo or Gitea
   token if you saved one.
 * **Data received**: public repository data (description, website, stars, language,
   license, latest release and tag).
 * Terms of service and privacy policy are those of the chosen instance, published
   by whoever runs it.

#### WordPress.org

 * **What**: the WordPress.org plugin directory API (host `api.wordpress.org`, path`/
   plugins/info/1.2/`), used to read the data of a plugin listed in the directory.
 * **When**: when a page with a WordPress.org plugin card is displayed and the cached
   data has expired.
 * **Data sent**: the slug of the plugin. No token is used.
 * **Data received**: public plugin data (name, description, icon, version, last
   update, tested WordPress version, active installations, rating, download link).
 * Privacy policy: https://wordpress.org/about/privacy/

#### Owner avatar and plugin icon

The image is off by default. When you enable it, visitors’ browsers load the owner’s
avatar or the plugin icon directly from the platform that hosts it (GitHub, Codeberg,
the Forgejo or Gitea instance, or WordPress.org), which receives the visitor’s IP
address like for any image request.

## Screenshots

[⌊Repository cards from Forgejo, Codeberg, GitHub and Gitea.⌉⌊Repository cards from
Forgejo, Codeberg, GitHub and Gitea.⌉[

Repository cards from Forgejo, Codeberg, GitHub and Gitea.

[⌊WordPress.org plugin cards: rating, active installations, tested WordPress version,
and a closed plugin.⌉⌊WordPress.org plugin cards: rating, active installations, 
tested WordPress version, and a closed plugin.⌉[

WordPress.org plugin cards: rating, active installations, tested WordPress version,
and a closed plugin.

[⌊"Follow the visitor browser": the same cards in dark mode, with the optional shadow.⌉⌊"
Follow the visitor browser": the same cards in dark mode, with the optional shadow
.⌉[

“Follow the visitor browser”: the same cards in dark mode, with the optional shadow.

[⌊The settings page: API tokens, cache and appearance.⌉⌊The settings page: API tokens,
cache and appearance.⌉[

The settings page: API tokens, cache and appearance.

## Installation

 1. Upload the `eg-repo-card` folder to `/wp-content/plugins/`, or install the plugin
    from the **Plugins** screen.
 2. Activate the plugin.
 3. Optionally, go to **Settings > EG Repo Card** to add API tokens and choose the 
    appearance.

## FAQ

### Which platforms are supported?

GitHub, Codeberg, any self-hosted Forgejo or Gitea instance, and the WordPress.org
plugin directory. The plugin tells Forgejo and Gitea apart and shows the right logo.

### Is an API token required?

No. Without a token, GitHub allows 60 requests per hour from your server. A personal
access token raises the limit to 5,000. A Forgejo or Gitea token is only needed 
for private repositories or instances that require login.

### Where does the Download button point?

For a repository: to the `.zip` file attached to the latest release, when the release
has exactly one. Otherwise it opens the release page. Without releases the button
is not shown. For a WordPress.org plugin: to the official `.zip` of the latest version.

### How does the cache work?

Data for each repository is stored as a WordPress transient for the duration set
in the settings (default 6 hours, maximum 168). The settings page has a button to
flush the cache.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“EG Repo Card” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ emanuelegori ](https://profiles.wordpress.org/emanuelegori/)

[Translate “EG Repo Card” into your language.](https://translate.wordpress.org/projects/wp-plugins/eg-repo-card)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/eg-repo-card/), check
out the [SVN repository](https://plugins.svn.wordpress.org/eg-repo-card/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/eg-repo-card/) by
[RSS](https://plugins.trac.wordpress.org/log/eg-repo-card/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.2.0

 * Removed: the `[eg-ranking-repo]` shortcode, the `egr_platform_label` filter and
   the import of EG Ranking Repo settings.
 * Changed: real, working addresses in the usage examples.

#### 2.1.3

 * Fixed: the card follows the width of the post content.
 * Changed: WordPress.org plugins without ratings show 0, like repositories without
   stars.

#### 2.1.2

 * New: links to documentation, repository and donations at the bottom of the settings
   page.
 * Changed: the plugin version moved to the bottom right of the settings page.

#### 2.1.1

 * Changed: the update date follows the date format set in WordPress.
 * Fixed: language dots are easier to see on dark backgrounds.

#### 2.1.0

 * New: cards for plugins in the WordPress.org directory, with plugin page, download,
   tested WordPress version, active installations and rating.
 * New: the Avatar option also shows the plugin icon.

#### 2.0.1

 * Fixed: automatic updates.

#### 2.0.0

 * New name: EG Ranking Repo is now EG Repo Card, with the new `[eg-repo-card]` 
   shortcode. `[eg-ranking-repo]` still works but is deprecated.
 * New: settings, colors and tokens of EG Ranking Repo are imported on first activation.
 * New: card and button backgrounds offer a neutral preset, transparent, custom 
   color, or follow the visitor browser; text adapts to the background.
 * New: optional border, shadow and owner avatar.
 * New: platform logos for GitHub, Codeberg, Forgejo and Gitea; Gitea instances 
   are now recognized.
 * New: Download button for the latest release.
 * New: main language, license and “Archived” label.
 * New: the date tooltip shows the time since the last update.
 * Changed: when the platform does not answer, the card shows the last data received;
   error messages are visible only to editors.
 * Removed: the “?” badge on the card.
 * Removed: the text color settings, now chosen automatically.
 * Deprecated: the `egr_platform_label` filter, replaced by `eg_repo_card_platform_label`.

The changelog of EG Ranking Repo 1.x is in `changelog.txt`.

## Meta

 *  Version **2.2.0**
 *  Last updated **1 day ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 8.0 or higher **
 * Tags
 * [Github](https://wordpress.org/plugins/tags/github/)[repository](https://wordpress.org/plugins/tags/repository/)
 *  [Advanced View](https://wordpress.org/plugins/eg-repo-card/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/eg-repo-card/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/eg-repo-card/reviews/)

## Contributors

 *   [ emanuelegori ](https://profiles.wordpress.org/emanuelegori/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/eg-repo-card/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://emanuelegori.uno/en/donate/)