← Back to plugins index

🗂ī¸ GitHub projects

This plugin displays progress of profile and repository projects.

ℹī¸ This plugin currently only supports GitHub projects boards and not GitHub projects (beta)

Supported features
→ Full specification		 📗 Classic template 📘 Repository template
👤 Users đŸ‘Ĩ Organizations 📓 Repositories
🔑 (scopeless) 🔑 public_repo read:org (optional) read:user (optional) read:packages (optional) repo (optional)
## ➡ī¸ Available options
OptionDescription

plugin_projects

Enable projects plugin
type: boolean
default: no

plugin_projects_limit

Display limit

Projects defined by plugin_projects_repositories are not affected by this option
type: number (0 ≤ đ‘Ĩ ≤ 100)
default: 4

plugin_projects_repositories

Featured repositories projects

Use the following syntax for each project :user/:repo/projects/:project_id
⏯ī¸ Cannot be preset
type: array (comma-separated)

plugin_projects_descriptions

Projects descriptions
type: boolean
default: no
## 🔄 Enabling progress tracking By default, projects have progress tracking disabled. To enable it, open the `≡ Menu` from the project page and opt-in to `Track project progress`. ![Enable "Track project progress"](/.github/readme/imgs/plugin_projects_track_progress.png) ## 👤 Use personal projects To create a personal project, select the `Projects` tab from your profile: ![Create a new project](/.github/readme/imgs/plugin_projects_create.png) Fill informations and set visibility to *public*: ![Configure project](/.github/readme/imgs/plugin_projects_setup.png) ## 📓 Use repositories projects Repositories projects are created from the `Projects` tab of a repository. To use it with this plugin, retrieve the last section of the project URL (it should match the format `:user/:repository/projects/:project_id`) and add it in the `plugin_projects_repositories`. Be sure to tick `Track project progress` in project settings to display a progress bar. ![Add a repository project](/.github/readme/imgs/plugin_projects_repositories.png) *Example: include a project repository* ```yml - uses: lowlighter/metrics@latest with: plugin_projects: yes plugin_projects_repositories: lowlighter/metrics/projects/1 ``` ## ℹī¸ Examples workflows ```yaml name: Project from a repository uses: lowlighter/metrics@latest with: filename: metrics.plugin.projects.svg token: ${{ secrets.METRICS_TOKEN_WITH_SCOPES }} base: "" plugin_projects: yes plugin_projects_repositories: lowlighter/metrics/projects/1 plugin_projects_descriptions: yes ```