← Back to plugins index

✨ Stargazers over last weeks

This plugin displays stargazers evolution across affiliated repositories over the last two weeks.

Supported features
→ Full specification		 📗 Classic template 📘 Repository template
👤 Users đŸ‘Ĩ Organizations 📓 Repositories
🔑 (scopeless) 🗝ī¸ plugin_stargazers_worldmap_token read:org (optional) read:user (optional) read:packages (optional) repo (optional)
Classic charts
Chartist charts
Worldmap
## 🗝ī¸ Obtaining a Google Maps API token Some features like `plugin_stagazers_worldmap` require a Google Geocoding API token. Follow instructions from their [documentation](https://developers.google.com/maps/documentation/geocoding/get-api-key) for more informations. > đŸ’ŗ A billing account is required to get a token. However a recurring [monthly credit](https://developers.google.com/maps/billing-credits#monthly) is offered which means you should not be charged if you don't exceed the free quota. > > It is advised to set the quota limit at 1200 requests per day > > Use at your own risk, *metrics* and its authors cannot be held responsible for anything charged. ## ➡ī¸ Available options
OptionDescription

plugin_stargazers

Enable stargazers plugin
type: boolean
default: no

plugin_stargazers_charts_type

Charts display type

  • classic: <div> based charts, simple and lightweight
  • chartist: <svg> based charts, smooth
🌐 Web instances must configure settings.json:
  • metrics.npm.optional.chartist
type: string
default: classic
allowed values:
  • classic
  • chartist

plugin_stargazers_worldmap

Stargazers worldmap
✨ On master/main
🌐 Web instances must configure settings.json:
  • metrics.api.google.maps
type: boolean
default: no

plugin_stargazers_worldmap_token

Stargazers worldmap token
🔐 Token
✨ On master/main
type: token

plugin_stargazers_worldmap_sample

Stargazers worldmap sample

Use this setting to randomly sample and limit your stargazers. Helps to avoid consuming too much Google Geocoding API requests while still being representative.
✨ On master/main
type: number (0 ≤ đ‘Ĩ)
zero behaviour: disable
default: 0
## ℹī¸ Examples workflows ```yaml name: Using classic charts uses: lowlighter/metrics@latest with: filename: metrics.plugin.stargazers.svg token: ${{ secrets.METRICS_TOKEN }} base: "" plugin_stargazers: yes ``` ```yaml name: Using chartist charts uses: lowlighter/metrics@latest with: filename: metrics.plugin.stargazers.chartist.svg token: ${{ secrets.METRICS_TOKEN }} base: "" plugin_stargazers: yes plugin_stargazers_charts_type: chartist ``` ```yaml name: With worldmap uses: lowlighter/metrics@latest with: filename: metrics.plugin.stargazers.worldmap.svg token: ${{ secrets.METRICS_TOKEN }} base: "" plugin_stargazers: yes plugin_stargazers_worldmap: yes plugin_stargazers_worldmap_token: ${{ secrets.GOOGLE_MAP_TOKEN }} plugin_stargazers_worldmap_sample: 200 ```