name: 📆 Commit calendar
category: github
description: |
  This plugin can display commit calendar across several years.
examples:
  current year: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.calendar.svg
  +full history: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.calendar.full.svg
index: 17
supports:
  - user
scopes:
  - public_access
inputs:

  plugin_calendar:
    description: |
      Enable calendar plugin
    type: boolean
    default: no

  plugin_calendar_limit:
    description: |
      Years to display

      This option has different behaviours depending on its value:
      - `n > 0` will display the last `n` years, relative to current year
      - `n == 0` will display all years starting from GitHub account registration date
      - `n < 0` will display all years plus `n` additional years, relative to GitHub account registration date
        - Use this when there are commits pushed before GitHub registration
    type: number
    default: 1
    zero: disable