Skip to content

Latest commit

 

History

History
178 lines (173 loc) · 6.16 KB

README.md

File metadata and controls

178 lines (173 loc) · 6.16 KB
← Back to plugins index

📰 Recent activity

This plugin displays recent activity on GitHub.

⚠️ Disclaimer

This plugin is not affiliated, associated, authorized, endorsed by, or in any way officially connected with GitHub. All product and company names are trademarks™ or registered® trademarks of their respective holders.

Supported features
→ Full specification
📗 Classic template 📒 Markdown template 📘 Repository template
👤 Users 👥 Organizations 📓 Repositories
🔑 (scopeless) read:org (optional) read:user (optional) read:packages (optional) repo (optional)

➡️ Available options

OptionDescription

plugin_activity

Enable activity plugin

type: boolean
default: no

plugin_activity_limit

Display limit

type: number (1 ≤ 𝑥 ≤ 1000)
default: 5

plugin_activity_load

Events to load

type: number (100 ≤ 𝑥 ≤ 1000)
default: 300

plugin_activity_days

Events maximum age

type: number (0 ≤ 𝑥 ≤ 365)
zero behaviour: disable
default: 14

plugin_activity_visibility

Events visibility

Can be used to toggle private activity visibility when using a token with repo scope

type: string
default: all
allowed values:
  • public
  • all

plugin_activity_timestamps

Events timestamps

type: boolean
default: no

plugin_activity_skipped

Skipped repositories

⏩ Inherits repositories_skipped
type: array (comma-separated)

plugin_activity_ignored

Ignored users

Can be used to ignore bots activity

⏩ Inherits users_ignored
type: array (comma-separated)

plugin_activity_filter

Events types

These are fetched from GitHub events API and the following types are currently supported:

  • push: Push of commits
  • issue: Opening/Reopening/Closing of issues
  • pr: Opening/Closing of pull requests
  • ref/create: Creation of git tags or git branches
  • ref/delete: Deletion of git tags or git branches
  • release: Publication of new releases
  • review: Review of pull requests
  • comment: Comments on commits, issues and pull requests
  • wiki: Edition of wiki pages
  • fork: Forking of repositories
  • star: Starring of repositories
  • public: Repositories made public
  • member: Addition of new collaborator in repository
type: array (comma-separated)
default: all
allowed values:
  • all
  • comment
  • ref/create
  • ref/delete
  • release
  • push
  • issue
  • pr
  • review
  • wiki
  • fork
  • star
  • member
  • public

ℹ️ Examples workflows

name: Recent activity
uses: lowlighter/metrics@latest
with:
  filename: metrics.plugin.activity.svg
  token: ${{ secrets.METRICS_TOKEN }}
  base: ""
  plugin_activity: yes
  plugin_activity_limit: 5
  plugin_activity_days: 0
  plugin_activity_filter: issue, pr, release, fork, review, ref/create