Releases: RonDevHub/Mini-Badges
v1.2.0
Changelog
[1.2.0] – [2025-10-21]
Added Codeberg Integration
- [2025-10-03] New integration for badges from :codeberg: Codeberg
- [2025-10-03] Metrics added per repo:
stars,name,license,language,created-at,updated-at,forks,issues,issues-open,issues-closed,prs,prs-open,prs-closed,size,watchers,branch-default,release,releases,release-tagandrelease@ - [2025-10-03] Metrics added for all repos:
issues-all,issues-allopen,issues-allclosed,prs-all,prs-allopen,prs-allclosed - [2025-10-03] Metrics added for user info:
username,location,createdis no longer supported and has been renamed toregister,followers,following,stars-give - [2025-10-06] Metrics added for all repos:
stars-all,forks-all,watchers-all,size-all,releases-all,lastcommit,lastcommit-info,lastcommit-infos,milestones-all,milestones-allopen,milestones-allclosed - [2025-10-06] Metrics added per repo:
milestones,milestones-open,milestones-closed,milestonesinfo,milestonesinfo-open,milestonesinfo-closed - [2025-10-18] Metrics added per repo:
downloads,downloads-latest - [2025-10-18] Metrics added for all repo:
downloads-all,respos - [2025-10-21] Metrics added:
created-since,updated-since,register-since
Added generally
- [2025-10-20] Codeberg Badges added to Wiki page
- [2025-10-20] Languages updated (en,de,es,it,fr,uk)
- [2025-10-20] The code has been cleaned up and optimized a bit
Changed
- [2025-10-18] Unnecessary API queries
- [2025-10-21] Metric
createdin the user info has been renamed toregister
Fixed
- [2025-10-06] Functions have been adjusted so that the information is cached with fewer API calls
- [2025-10-21] Fixed a small bug in the calculation of the time elapsed since the account was created, in the Github badges
v1.1.0-stable
Changelog
[1.1.0-stable] – 2025-09-26
Added
- [2025-09-12] New styles added:
classic,social,minimalist&pill - [2025-09-12] New metrics to display open and closed issues of a repo
issues-open,issues-closed - [2025-09-15] New metric to display the number of sponsors
sponsors(Query only possible with API) - [2025-09-15] New metrics for discussions of a repo have been added
discussionsfor count in addition to-lastdate,-lastupdate,-lasttitle,-lastauthor(Query only possible with API) - [2025-09-16] New metrics for
commitsto output all commits of a repo, with examplecommits@branchnameonly all commits of the branch, further metrics-all,-last,-last-info - [2025-09-16] New metrics for
codesizewhich prints the code size of a repo, with-allall repos (only the default branch) - [2025-09-22] New metrics for profile date:
name,company,location,status,createdAt,createdAt-since,updatedAtanupdatedAt-since(Query only possible with API)
Changed
- [2025-09-08] The metrics for
followerandfollowinghave been reworked, and the-namefunction has been removed for both. Github's REST API doesn't allow listing the last name sorted by date. The number of followers and followings will still be displayed accurately.
Fixed
- [2025-09-15] The cache has been optimized
- [2025-09-15] The
allowedOwnersfunction in the configuration has been fixed and is now working again - [2025-09-16] Fixed an issue with calls via the API key when specified
v1.0.0-beta
Mini-Badges (beta)
🫵 Note:
This script is currently in Beta.
If you like, you can try theexperimentalbranch and test it out.
Please keep in mind that bugs may still occur here and there.
The Wiki is still under construction.
A small, standalone PHP Badge System – no Redis, Docker, or Node required.
It supports static and dynamic (GitHub) badges, multiple styles (similar to Shields),
colors, languages (de/en), and simple file caching.
🚀 Installation
- Upload the contents of this folder to your webspace (e.g.
/www/htdocs/.../badges/). - Make sure the
cache/directory is writable (e.g.0775or0777). - (Optional) Add a GitHub token in
helpers/config.php(for higher rate limits). - Open
examples.htmlin your browser.
🔹 Static
URL pattern:
static/{textLabel}-{bgColor}-{textColor}/{textMessage}-{bgColor}-{textColor}/{style}
Example:
static/RonDevHub❤️PHP-000000/Awesome-3a6e8f/flat
🔹 With Icon
URL pattern:
icon/{icon}-{iconColor}/{textMessage}-{bgColor}-{textColor}/{style}/{textLabel}-{bgColor}-{textColor}
Examples:
/icon/github-gray/Github-*-000000/flat
/icon/github/👍-teal/*/Github-6d6e70
🔹 GitHub
URL pattern:
/github/{owner}/{repo}/{metric}/{style}/{icon}-{iconColor}/{lang}/{backgroundColorMessage}-{textColorMessage}/{backgroundLabelColor}-{textColorLabel}
Examples:
-
Top language:
github/{owner}/{repo}/top_language/*/*/*/green -
With icon:
github/{owner}/{repo}/forks/round/codefork/*/green
🔧 GitHub-specific
{metric}- For examplestars,license,issues... more metrics are listed in the wiki{owner}– GitHub user/org{repo}– GitHub repository
🖼️ Icons
⚠️ Note:
This download contains no icons.
Place your SVGs (withfill="currentColor") in theicons/folder, e.g.icons/star.svg.
Then use/star/in the URL.