name: 🗂️ GitHub projects
category: github
description: |
  This plugin displays progress of profile and repository projects.
examples:
  default: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.projects.svg
index: 25
supports:
  - user
  - organization
  - repository
scopes:
  - public_access
  - public_repo
  - read:project
inputs:

  plugin_projects:
    description: |
      Enable projects plugin
    type: boolean
    default: no

  plugin_projects_limit:
    description: |
      Display limit

      Projects defined by [`plugin_projects_repositories`](/source/plugins/projects/README.md#plugin_projects_repositories) are not affected by this option
    type: number
    default: 4
    min: 0
    max: 100

  plugin_projects_repositories:
    description: |
      Featured repositories projects

      Use the following syntax for each project `:user/:repo/projects/:project_id`

      > ℹ️ [GitHub projects (beta)](https://docs.github.com/en/issues/trying-out-the-new-projects-experience/about-projects) needs to use the same syntax as above and repository must specified repository must be linked to given project.
    type: array
    example: username/repo/projects/1, username/repo/projects/2, ...
    format: comma-separated
    default: ""
    preset: no

  plugin_projects_descriptions:
    description: |
      Projects descriptions
    type: boolean
    default: no