metrics/source/plugins/achievements/README.md

🏆 Achievements

The achievements plugin displays several highlights about what you achieved on GitHub.

Compact display Detailed display

Achievements are mostly related to features offered by GitHub, so by unlocking achivements ranks you'll be mastering GitHub in no time!

A few achievements contains actual real ranking (based on GitHub search results)!

About achievements ranks

Moving forward between ranks is voluntarily difficult, making it almost impossible to reach the latest rank except by hard work.

With this design, when a user reach upper ranks you can be sure that they really deserve it! It also lets you quickly see at a glance what this user primarly use GitHub for, just look for crimson and gold badges!

➡️ Available options

Type	Description
plugin_achievements	Display achievements
type: boolean default: no
plugin_achievements_threshold	Display rank minimal threshold
type: string default: C allowed values: S A B C X
plugin_achievements_secrets	Display unlocked secrets achievements
type: boolean default: yes
plugin_achievements_display	Achievements display style
type: string default: detailed allowed values: detailed compact
plugin_achievements_limit	Maximum number of achievements to display
type: number (0 ≤ 𝑥) default: 0
plugin_achievements_ignored	Unlocked achievements to hide
type: array (comma-separated)
plugin_achievements_only	Unlocked achievements to display
type: array (comma-separated)

→ Full specification

ℹ️ Examples workflows

name: Detailed display
uses: lowlighter/metrics@latest
with:
  filename: metrics.plugin.achievements.svg
  token: ${{ secrets.METRICS_TOKEN }}
  base: ''
  plugin_achievements: 'yes'
  plugin_achievements_only: sponsor, maintainer, octonaut

name: Compact display
uses: lowlighter/metrics@latest
with:
  filename: metrics.plugin.achievements.compact.svg
  token: ${{ secrets.METRICS_TOKEN }}
  base: ''
  plugin_achievements: 'yes'
  plugin_achievements_only: >-
    polyglot, stargazer, sponsor, deployer, member, maintainer, developer,
    scripter, packager, explorer, infographile, manager
  plugin_achievements_display: compact
  plugin_achievements_threshold: X