ci: auto-regenerate files

.github/readme/partials/documentation/compatibility.md

@@ -29,13 +29,14 @@
     <th nowrap="nowrap" align="center" title="🙋 Introduction">🙋</th>
     <th nowrap="nowrap" align="center" title="💕 GitHub Sponsors">💕</th>
     <th nowrap="nowrap" align="center" title="💫 Starlists">💫</th>
+    <th nowrap="nowrap" align="center" title="📆 Calendar">📆</th>
     <th nowrap="nowrap" align="center" title="🌇 GitHub Skyline 3D calendar">🌇</th>
     <th nowrap="nowrap" align="center" title="⏱️ Website performances">⏱️</th>
-    <th nowrap="nowrap" align="center" title="🎼 Music plugin">🎼</th>
     <th nowrap="nowrap" align="center" title="🗨️ StackOverflow plugin">🗨️</th>
     <th nowrap="nowrap" align="center" title="🌸 Anilist watch list and reading list">🌸</th>
     <th nowrap="nowrap" align="center" title="🐤 Latest tweets">🐤</th>
     <th nowrap="nowrap" align="center" title="✒️ Recent posts">✒️</th>
+    <th nowrap="nowrap" align="center" title="🎼 Music plugin">🎼</th>
     <th nowrap="nowrap" align="center" title="🗼 Rss feed">🗼</th>
     <th nowrap="nowrap" align="center" title="⏰ WakaTime plugin">⏰</th>
   </tr>  
@@ -67,13 +68,14 @@
     <td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="starlists">✔️</td>
+    <td nowrap="nowrap" align="center" data-plugin="calendar">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="skyline">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
-    <td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="stackoverflow">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="anilist">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="tweets">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
+    <td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="wakatime">✔️</td>
   </tr>
@@ -105,13 +107,14 @@
     <td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="starlists">❌</td>
+    <td nowrap="nowrap" align="center" data-plugin="calendar">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="skyline">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
-    <td nowrap="nowrap" align="center" data-plugin="music">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="stackoverflow">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="anilist">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="tweets">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
+    <td nowrap="nowrap" align="center" data-plugin="music">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="wakatime">❌</td>
   </tr>
@@ -143,13 +146,14 @@
     <td nowrap="nowrap" align="center" data-plugin="introduction">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="sponsors">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="starlists">❌</td>
+    <td nowrap="nowrap" align="center" data-plugin="calendar">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="skyline">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
-    <td nowrap="nowrap" align="center" data-plugin="music">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="stackoverflow">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="anilist">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="tweets">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="posts">❌</td>
+    <td nowrap="nowrap" align="center" data-plugin="music">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="rss">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="wakatime">❌</td>
   </tr>
@@ -181,18 +185,19 @@
     <td nowrap="nowrap" align="center" data-plugin="introduction">✓</td>
     <td nowrap="nowrap" align="center" data-plugin="sponsors">✓</td>
     <td nowrap="nowrap" align="center" data-plugin="starlists">✓</td>
+    <td nowrap="nowrap" align="center" data-plugin="calendar">✓</td>
     <td nowrap="nowrap" align="center" data-plugin="skyline">✓</td>
     <td nowrap="nowrap" align="center" data-plugin="pagespeed">✓</td>
-    <td nowrap="nowrap" align="center" data-plugin="music">✓</td>
     <td nowrap="nowrap" align="center" data-plugin="stackoverflow">✓</td>
     <td nowrap="nowrap" align="center" data-plugin="anilist">✓</td>
     <td nowrap="nowrap" align="center" data-plugin="tweets">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
+    <td nowrap="nowrap" align="center" data-plugin="music">✓</td>
     <td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="wakatime">✓</td>
   </tr>
   <tr>
-    <td colspan="35"></td>
+    <td colspan="36"></td>
   </tr>
   <tr>
     <th nowrap="nowrap">Mode/Plugin</th>    
@@ -222,13 +227,14 @@
     <th nowrap="nowrap" align="center" title="🙋 Introduction">🙋</th>
     <th nowrap="nowrap" align="center" title="💕 GitHub Sponsors">💕</th>
     <th nowrap="nowrap" align="center" title="💫 Starlists">💫</th>
+    <th nowrap="nowrap" align="center" title="📆 Calendar">📆</th>
     <th nowrap="nowrap" align="center" title="🌇 GitHub Skyline 3D calendar">🌇</th>
     <th nowrap="nowrap" align="center" title="⏱️ Website performances">⏱️</th>
-    <th nowrap="nowrap" align="center" title="🎼 Music plugin">🎼</th>
     <th nowrap="nowrap" align="center" title="🗨️ StackOverflow plugin">🗨️</th>
     <th nowrap="nowrap" align="center" title="🌸 Anilist watch list and reading list">🌸</th>
     <th nowrap="nowrap" align="center" title="🐤 Latest tweets">🐤</th>
     <th nowrap="nowrap" align="center" title="✒️ Recent posts">✒️</th>
+    <th nowrap="nowrap" align="center" title="🎼 Music plugin">🎼</th>
     <th nowrap="nowrap" align="center" title="🗼 Rss feed">🗼</th>
     <th nowrap="nowrap" align="center" title="⏰ WakaTime plugin">⏰</th>
   </tr>  
@@ -260,13 +266,14 @@
     <td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="starlists">✔️</td>
+    <td nowrap="nowrap" align="center" data-plugin="calendar">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="skyline">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
-    <td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="stackoverflow">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="anilist">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="tweets">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
+    <td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="wakatime">✔️</td>
   </tr>
@@ -298,13 +305,14 @@
     <td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="starlists">❌</td>
+    <td nowrap="nowrap" align="center" data-plugin="calendar">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="skyline">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
-    <td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="stackoverflow">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="anilist">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="tweets">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
+    <td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="wakatime">❌</td>
   </tr>
@@ -336,13 +344,14 @@
     <td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="starlists">❌</td>
+    <td nowrap="nowrap" align="center" data-plugin="calendar">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="skyline">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
-    <td nowrap="nowrap" align="center" data-plugin="music">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="stackoverflow">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="anilist">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="tweets">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
+    <td nowrap="nowrap" align="center" data-plugin="music">❌</td>
     <td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
     <td nowrap="nowrap" align="center" data-plugin="wakatime">❌</td>
   </tr>

.github/workflows/examples.yml

@@ -697,6 +697,31 @@ jobs:
           user: lowlighter
           plugins_errors_fatal: yes
         if: ${{ success() || failure() }}
+      - name: 📆 Calendar - Current year calendar
+        uses: lowlighter/metrics@master
+        with:
+          filename: metrics.plugin.calendar.svg
+          token: ${{ secrets.METRICS_TOKEN }}
+          base: ""
+          plugin_calendar: yes
+          output_action: none
+          delay: 120
+          user: lowlighter
+          plugins_errors_fatal: yes
+        if: ${{ success() || failure() }}
+      - name: 📆 Calendar - Full history calendar
+        uses: lowlighter/metrics@master
+        with:
+          filename: metrics.plugin.calendar.full.svg
+          token: ${{ secrets.METRICS_TOKEN }}
+          base: ""
+          plugin_calendar: yes
+          plugin_calendar_limit: 0
+          output_action: none
+          delay: 120
+          user: lowlighter
+          plugins_errors_fatal: yes
+        if: ${{ success() || failure() }}
       - name: 🌇 GitHub Skyline 3D calendar - GitHub Skyline
         uses: lowlighter/metrics@master
         with:
@@ -756,94 +781,6 @@ jobs:
           user: lowlighter
           plugins_errors_fatal: yes
         if: ${{ success() || failure() }}
-      - name: 🎼 Music plugin - Apple Music - Random track from playlist
-        uses: lowlighter/metrics@master
-        with:
-          filename: metrics.plugin.music.playlist.svg
-          token: NOT_NEEDED
-          base: ""
-          plugin_music: yes
-          plugin_music_playlist: https://embed.music.apple.com/fr/playlist/usr-share/pl.u-V9D7m8Etjmjd0D
-          plugin_music_limit: 2
-          output_action: none
-          delay: 120
-          user: lowlighter
-          plugins_errors_fatal: yes
-        if: ${{ success() || failure() }}
-      - name: 🎼 Music plugin - Spotify - Random track from playlist
-        uses: lowlighter/metrics@master
-        with:
-          filename: metrics.plugin.music.playlist.spotify.svg
-          token: NOT_NEEDED
-          base: ""
-          plugin_music: yes
-          plugin_music_playlist: https://open.spotify.com/embed/playlist/3nfA87oeJw4LFVcUDjRcqi
-          output_action: none
-          delay: 120
-          user: lowlighter
-          plugins_errors_fatal: yes
-        if: ${{ success() || failure() }}
-      - name: 🎼 Music plugin - Spotify - Recently listed
-        uses: lowlighter/metrics@master
-        with:
-          filename: metrics.plugin.music.recent.svg
-          token: NOT_NEEDED
-          base: ""
-          plugin_music: yes
-          plugin_music_provider: spotify
-          plugin_music_mode: recent
-          plugin_music_token: ${{ secrets.SPOTIFY_TOKENS }}
-          plugin_music_limit: 2
-          output_action: none
-          delay: 120
-          user: lowlighter
-          plugins_errors_fatal: yes
-        if: ${{ success() || failure() }}
-      - name: 🎼 Music plugin - Spotify - Top tracks
-        uses: lowlighter/metrics@master
-        with:
-          token: NOT_NEEDED
-          base: ""
-          plugin_music: yes
-          plugin_music_mode: top
-          plugin_music_provider: spotify
-          plugin_music_token: ${{ secrets.SPOTIFY_TOKENS }}
-          plugin_music_time_range: short
-          plugin_music_top_type: tracks
-          output_action: none
-          delay: 120
-          user: lowlighter
-          plugins_errors_fatal: yes
-        if: ${{ success() || failure() }}
-      - name: 🎼 Music plugin - Spotify - Top artists
-        uses: lowlighter/metrics@master
-        with:
-          token: NOT_NEEDED
-          base: ""
-          plugin_music: yes
-          plugin_music_mode: top
-          plugin_music_provider: spotify
-          plugin_music_token: ${{ secrets.SPOTIFY_TOKENS }}
-          plugin_music_time_range: long
-          plugin_music_top_type: artists
-          output_action: none
-          delay: 120
-          user: lowlighter
-          plugins_errors_fatal: yes
-        if: ${{ success() || failure() }}
-      - name: 🎼 Music plugin - Youtube Music - Random track from playlist
-        uses: lowlighter/metrics@master
-        with:
-          token: NOT_NEEDED
-          base: ""
-          plugin_music: yes
-          plugin_music_playlist: >-
-            https://music.youtube.com/playlist?list=OLAK5uy_kU_uxp9TUOl9zVdw77xith8o9AknVwz9U
-          output_action: none
-          delay: 120
-          user: lowlighter
-          plugins_errors_fatal: yes
-        if: ${{ success() || failure() }}
       - name: 🗨️ StackOverflow plugin - Top answers from stackoverflow
         uses: lowlighter/metrics@master
         with:
@@ -966,6 +903,94 @@ jobs:
           user: lowlighter
           plugins_errors_fatal: yes
         if: ${{ success() || failure() }}
+      - name: 🎼 Music plugin - Apple Music - Random track from playlist
+        uses: lowlighter/metrics@master
+        with:
+          filename: metrics.plugin.music.playlist.svg
+          token: NOT_NEEDED
+          base: ""
+          plugin_music: yes
+          plugin_music_playlist: https://embed.music.apple.com/fr/playlist/usr-share/pl.u-V9D7m8Etjmjd0D
+          plugin_music_limit: 2
+          output_action: none
+          delay: 120
+          user: lowlighter
+          plugins_errors_fatal: yes
+        if: ${{ success() || failure() }}
+      - name: 🎼 Music plugin - Spotify - Random track from playlist
+        uses: lowlighter/metrics@master
+        with:
+          filename: metrics.plugin.music.playlist.spotify.svg
+          token: NOT_NEEDED
+          base: ""
+          plugin_music: yes
+          plugin_music_playlist: https://open.spotify.com/embed/playlist/3nfA87oeJw4LFVcUDjRcqi
+          output_action: none
+          delay: 120
+          user: lowlighter
+          plugins_errors_fatal: yes
+        if: ${{ success() || failure() }}
+      - name: 🎼 Music plugin - Spotify - Recently listed
+        uses: lowlighter/metrics@master
+        with:
+          filename: metrics.plugin.music.recent.svg
+          token: NOT_NEEDED
+          base: ""
+          plugin_music: yes
+          plugin_music_provider: spotify
+          plugin_music_mode: recent
+          plugin_music_token: ${{ secrets.SPOTIFY_TOKENS }}
+          plugin_music_limit: 2
+          output_action: none
+          delay: 120
+          user: lowlighter
+          plugins_errors_fatal: yes
+        if: ${{ success() || failure() }}
+      - name: 🎼 Music plugin - Spotify - Top tracks
+        uses: lowlighter/metrics@master
+        with:
+          token: NOT_NEEDED
+          base: ""
+          plugin_music: yes
+          plugin_music_mode: top
+          plugin_music_provider: spotify
+          plugin_music_token: ${{ secrets.SPOTIFY_TOKENS }}
+          plugin_music_time_range: short
+          plugin_music_top_type: tracks
+          output_action: none
+          delay: 120
+          user: lowlighter
+          plugins_errors_fatal: yes
+        if: ${{ success() || failure() }}
+      - name: 🎼 Music plugin - Spotify - Top artists
+        uses: lowlighter/metrics@master
+        with:
+          token: NOT_NEEDED
+          base: ""
+          plugin_music: yes
+          plugin_music_mode: top
+          plugin_music_provider: spotify
+          plugin_music_token: ${{ secrets.SPOTIFY_TOKENS }}
+          plugin_music_time_range: long
+          plugin_music_top_type: artists
+          output_action: none
+          delay: 120
+          user: lowlighter
+          plugins_errors_fatal: yes
+        if: ${{ success() || failure() }}
+      - name: 🎼 Music plugin - Youtube Music - Random track from playlist
+        uses: lowlighter/metrics@master
+        with:
+          token: NOT_NEEDED
+          base: ""
+          plugin_music: yes
+          plugin_music_playlist: >-
+            https://music.youtube.com/playlist?list=OLAK5uy_kU_uxp9TUOl9zVdw77xith8o9AknVwz9U
+          output_action: none
+          delay: 120
+          user: lowlighter
+          plugins_errors_fatal: yes
+        if: ${{ success() || failure() }}
       - name: 🗼 Rss feed - News from hackernews
         uses: lowlighter/metrics@master
         with:

README.md

@@ -19,7 +19,7 @@ Generate metrics that can be embedded everywhere, including your GitHub profile
   </tr>
   <tr>
     <th colspan="2" align="center">
-      <h3><a href="/README.md#-plugins">🧩 Customizable with 39 plugins and 253 options!</a></h3>
+      <h3><a href="/README.md#-plugins">🧩 Customizable with 40 plugins and 255 options!</a></h3>
     </th>
   </tr>
   <tr>
@@ -208,7 +208,7 @@ Generate metrics that can be embedded everywhere, including your GitHub profile
   </tr>
   <tr>
     <th><a href="source/plugins/starlists/README.md">💫 Starlists</a></th>
-    <th><a href="source/plugins/skyline/README.md">🌇 GitHub Skyline 3D calendar</a></th>
+    <th><a href="source/plugins/calendar/README.md">📆 Calendar</a></th>
   </tr>
   <tr>
         <td  align="center">
@@ -217,26 +217,26 @@ Generate metrics that can be embedded everywhere, including your GitHub profile
         <img width="900" height="1" alt="">
       </td>
         <td  align="center">
-        <img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.skyline.svg" alt=""></img>
+        <details open><summary>Current year</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.calendar.svg" alt=""></img></details>
+        <details><summary>Full history</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.calendar.full.svg" alt=""></img></details>
         <img width="900" height="1" alt="">
       </td>
   </tr>
   <tr>
+    <th><a href="source/plugins/skyline/README.md">🌇 GitHub Skyline 3D calendar</a></th>
     <th><a href="source/plugins/pagespeed/README.md">⏱️ Website performances</a></th>
-    <th><a href="source/plugins/music/README.md">🎼 Music plugin</a></th>
   </tr>
   <tr>
+        <td  align="center">
+        <img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.skyline.svg" alt=""></img>
+        <img width="900" height="1" alt="">
+      </td>
         <td  align="center">
         <details open><summary>PageSpeed scores</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.pagespeed.svg" alt=""></img></details>
         <details><summary>PageSpeed scores with detailed report</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.pagespeed.detailed.svg" alt=""></img></details>
         <details><summary>PageSpeed scores with a website screenshot</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.pagespeed.screenshot.svg" alt=""></img></details>
         <img width="900" height="1" alt="">
       </td>
-        <td  align="center">
-        <details open><summary>Random tracks from a playlist</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.music.playlist.svg" alt=""></img></details>
-        <details open><summary>Recently listened</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.music.recent.svg" alt=""></img></details>
-        <img width="900" height="1" alt="">
-      </td>
   </tr>
   <tr>
     <th><a href="source/plugins/stackoverflow/README.md">🗨️ StackOverflow plugin</a></th>
@@ -271,18 +271,30 @@ Generate metrics that can be embedded everywhere, including your GitHub profile
       </td>
   </tr>
   <tr>
+    <th><a href="source/plugins/music/README.md">🎼 Music plugin</a></th>
     <th><a href="source/plugins/rss/README.md">🗼 Rss feed</a></th>
-    <th><a href="source/plugins/wakatime/README.md">⏰ WakaTime plugin</a></th>
   </tr>
   <tr>
+        <td  align="center">
+        <details open><summary>Random tracks from a playlist</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.music.playlist.svg" alt=""></img></details>
+        <details open><summary>Recently listened</summary><img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.music.recent.svg" alt=""></img></details>
+        <img width="900" height="1" alt="">
+      </td>
         <td  align="center">
         <img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.rss.svg" alt=""></img>
         <img width="900" height="1" alt="">
       </td>
+  </tr>
+  <tr>
+    <th><a href="source/plugins/wakatime/README.md">⏰ WakaTime plugin</a></th>
+    <th></th>
+  </tr>
+  <tr>
         <td  align="center">
         <img alt="" width="400" src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.wakatime.svg" alt=""></img>
         <img width="900" height="1" alt="">
       </td>
+    <td align="center"><img width="900" height="1" alt=""></td>
   </tr>
   <tr>
     <th colspan="2" align="center">
@@ -405,6 +417,7 @@ Plugins provide additional content and lets you customize rendered metrics.
 * **Github plugins**
   * [🏆 Achievements <sub>`achievements`</sub>](/source/plugins/achievements/README.md)
   * [📰 Recent activity <sub>`activity`</sub>](/source/plugins/activity/README.md)
+  * [📆 Calendar <sub>`calendar`</sub>](/source/plugins/calendar/README.md)
   * [♐ Code snippet of the day <sub>`code`</sub>](/source/plugins/code/README.md)
   * [🏅 Repository contributors <sub>`contributors`</sub>](/source/plugins/contributors/README.md)
   * [💬 Discussions <sub>`discussions`</sub>](/source/plugins/discussions/README.md)

action.yml

@@ -796,6 +796,17 @@ inputs:
     description: Restrict display to specified star lists
     default: <default-value>
   
+  # ====================================================================================
+  # 📆 Calendar
+  
+  plugin_calendar:
+    description: Enable calendar plugin
+    default: <default-value>
+  
+  plugin_calendar_limit:
+    description: Years to display
+    default: <default-value>
+  
   # ====================================================================================
   # 🌇 GitHub Skyline 3D calendar
   
@@ -842,49 +853,6 @@ inputs:
     description: PageSpeed token
     default: <default-value>
   
-  # ====================================================================================
-  # 🎼 Music plugin
-  
-  plugin_music:
-    description: Enable music plugin
-    default: <default-value>
-  
-  plugin_music_provider:
-    description: Music provider
-    default: <default-value>
-  
-  plugin_music_token:
-    description: Music provider token
-    default: <default-value>
-  
-  plugin_music_mode:
-    description: Display mode
-    default: <default-value>
-  
-  plugin_music_playlist:
-    description: Playlist URL
-    default: <default-value>
-  
-  plugin_music_limit:
-    description: Display limit
-    default: <default-value>
-  
-  plugin_music_played_at:
-    description: Recently played - Toggle last played timestamp display
-    default: <default-value>
-  
-  plugin_music_time_range:
-    description: Top tracks - Time range for `top` mode
-    default: <default-value>
-  
-  plugin_music_top_type:
-    description: Top tracks - Display type
-    default: <default-value>
-  
-  plugin_music_user:
-    description: Music provider username
-    default: <default-value>
-  
   # ====================================================================================
   # 🗨️ StackOverflow plugin
   
@@ -993,6 +961,49 @@ inputs:
     description: External source username
     default: <default-value>
   
+  # ====================================================================================
+  # 🎼 Music plugin
+  
+  plugin_music:
+    description: Enable music plugin
+    default: <default-value>
+  
+  plugin_music_provider:
+    description: Music provider
+    default: <default-value>
+  
+  plugin_music_token:
+    description: Music provider token
+    default: <default-value>
+  
+  plugin_music_mode:
+    description: Display mode
+    default: <default-value>
+  
+  plugin_music_playlist:
+    description: Playlist URL
+    default: <default-value>
+  
+  plugin_music_limit:
+    description: Display limit
+    default: <default-value>
+  
+  plugin_music_played_at:
+    description: Recently played - Toggle last played timestamp display
+    default: <default-value>
+  
+  plugin_music_time_range:
+    description: Top tracks - Time range for `top` mode
+    default: <default-value>
+  
+  plugin_music_top_type:
+    description: Top tracks - Display type
+    default: <default-value>
+  
+  plugin_music_user:
+    description: Music provider username
+    default: <default-value>
+  
   # ====================================================================================
   # 🗼 Rss feed
   

settings.example.json

@@ -109,6 +109,9 @@
     "starlists":{
       "enabled": false,            "//": "Enable starlists plugin"
     },
+    "calendar":{
+      "enabled": false,            "//": "Enable calendar plugin"
+    },
     "skyline":{
       "enabled": false,            "//": "Enable skyline plugin"
     },
@@ -116,10 +119,6 @@
       "token": null,               "//":"PageSpeed token\n\nAlthough not mandatory, it strongly advised to create one to avoid triggering the rate limiter. See [PageSpeed documentation](https://developers.google.com/speed/docs/insights/v5/get-started) for more informations.\n",
       "enabled": false,            "//": "Enable pagespeed plugin"
     },
-    "music":{
-      "token": null,               "//":"Music provider token\n\nBelow is the expected token format for each provider:\n- `apple`: *(not supported)*\n- `spotify`: \"client_id, client_secret, refresh_token\"\n- `lastfm`: \"api_key\"\n- `youtube`: \"cookie\"\n",
-      "enabled": false,            "//": "Enable music plugin"
-    },
     "stackoverflow":{
       "enabled": false,            "//": "Enable stackoverflow plugin"
     },
@@ -133,6 +132,10 @@
     "posts":{
       "enabled": false,            "//": "Enable posts plugin"
     },
+    "music":{
+      "token": null,               "//":"Music provider token\n\nBelow is the expected token format for each provider:\n- `apple`: *(not supported)*\n- `spotify`: \"client_id, client_secret, refresh_token\"\n- `lastfm`: \"api_key\"\n- `youtube`: \"cookie\"\n",
+      "enabled": false,            "//": "Enable music plugin"
+    },
     "rss":{
       "enabled": false,            "//": "Enable rss plugin"
     },

source/plugins/README.md

@@ -10,6 +10,7 @@ Plugins provide additional content and lets you customize rendered metrics.
 * **Github plugins**
   * [🏆 Achievements <sub>`achievements`</sub>](/source/plugins/achievements/README.md)
   * [📰 Recent activity <sub>`activity`</sub>](/source/plugins/activity/README.md)
+  * [📆 Calendar <sub>`calendar`</sub>](/source/plugins/calendar/README.md)
   * [♐ Code snippet of the day <sub>`code`</sub>](/source/plugins/code/README.md)
   * [🏅 Repository contributors <sub>`contributors`</sub>](/source/plugins/contributors/README.md)
   * [💬 Discussions <sub>`discussions`</sub>](/source/plugins/discussions/README.md)

source/plugins/calendar/README.md

@@ -1,12 +1,83 @@
 <!--header-->
+<table>
+  <tr><th colspan="2"><h3>📆 Calendar</h3></th></tr>
+  <tr><td colspan="2" align="center"><p>This plugin displays your commit calendar across several years</p>
+</td></tr>
+  <tr>
+    <th rowspan="3">Supported features<br><sub><a href="metadata.yml">→ Full specification</a></sub></th>
+    <td><a href="/source/templates/classic/README.md"><code>📗 Classic template</code></a></td>
+  </tr>
+  <tr>
+    <td><code>👤 Users</code></td>
+  </tr>
+  <tr>
+    <td><code>🔑 (scopeless)</code> <code>read:org (optional)</code> <code>read:user (optional)</code> <code>read:packages (optional)</code> <code>repo (optional)</code></td>
+  </tr>
+  <tr>
+    <td colspan="2" align="center">
+      <details open><summary>Current year</summary><img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.calendar.svg" alt=""></img></details>
+      <details><summary>Full history</summary><img src="https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.calendar.full.svg" alt=""></img></details>
+      <img width="900" height="1" alt="">
+    </td>
+  </tr>
+</table>
 <!--/header-->
 
 ## ➡️ Available options
 
 <!--options-->
+<table>
+  <tr>
+    <td align="center" nowrap="nowrap">Type</i></td><td align="center" nowrap="nowrap">Description</td>
+  </tr>
+  <tr>
+    <td nowrap="nowrap"><h4><code>plugin_calendar</code></h4></td>
+    <td rowspan="2"><p>Enable calendar plugin</p>
+<img width="900" height="1" alt=""></td>
+  </tr>
+  <tr>
+    <td nowrap="nowrap">✨ On <code>master</code>/<code>main</code><br>
+<b>type:</b> <code>boolean</code>
+<br>
+<b>default:</b> no<br></td>
+  </tr>
+  <tr>
+    <td nowrap="nowrap"><h4><code>plugin_calendar_limit</code></h4></td>
+    <td rowspan="2"><p>Years to display</p>
+<img width="900" height="1" alt=""></td>
+  </tr>
+  <tr>
+    <td nowrap="nowrap">✨ On <code>master</code>/<code>main</code><br>
+<b>type:</b> <code>number</code>
+<br>
+<b>zero behaviour:</b> disable</br>
+<b>default:</b> 1<br></td>
+  </tr>
+</table>
 <!--/options-->
 
 ## ℹ️ Examples workflows
 
 <!--examples-->
+```yaml
+name: Current year calendar
+uses: lowlighter/metrics@latest
+with:
+  filename: metrics.plugin.calendar.svg
+  token: ${{ secrets.METRICS_TOKEN }}
+  base: ""
+  plugin_calendar: yes
+
+```
+```yaml
+name: Full history calendar
+uses: lowlighter/metrics@latest
+with:
+  filename: metrics.plugin.calendar.full.svg
+  token: ${{ secrets.METRICS_TOKEN }}
+  base: ""
+  plugin_calendar: yes
+  plugin_calendar_limit: 0
+
+```
 <!--/examples-->

source/plugins/calendar/metadata.yml

@@ -4,6 +4,7 @@ description: This plugin displays your 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: 25
 supports:
   - user
 scopes:

source/plugins/music/metadata.yml

@@ -7,7 +7,7 @@ description: |
 examples:
   +random tracks from a playlist: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.music.playlist.svg
   +recently listened: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.music.recent.svg
-index: 2
+index: 6.5
 supports:
   - user
   - organization

source/plugins/rss/metadata.yml

@@ -3,7 +3,7 @@ category: social
 description: This plugin displays news from a given RSS feed.
 examples:
   default: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.rss.svg
-index: 6.5
+index: 7
 supports:
   - user
   - organization

source/plugins/skyline/metadata.yml

@@ -6,7 +6,7 @@ description: |
   > ⚠️ This plugin significantly increase file size, consider using it as standalone.
 examples:
   default: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.skyline.svg
-index: 25
+index: 26
 supports:
   - user
 scopes: []

source/plugins/sponsors/README.md

@@ -46,6 +46,7 @@
 <ul>
 <li><code>goal</code>: display GitHub active goal</li>
 <li><code>about</code>: display GitHub sponsors introduction</li>
+<li><code>list</code>: display GitHub sponsors list</li>
 </ul>
 <img width="900" height="1" alt=""></td>
   </tr>
@@ -53,7 +54,7 @@
     <td nowrap="nowrap"><b>type:</b> <code>array</code>
 <i>(comma-separated)</i>
 <br>
-<b>default:</b> goal, about<br>
+<b>default:</b> goal, list, about<br>
 <b>allowed values:</b><ul><li>goal</li><li>about</li><li>list</li></ul></td>
   </tr>
   <tr>

source/plugins/wakatime/metadata.yml

@@ -3,7 +3,7 @@ category: social
 description: This plugin displays statistics from your [WakaTime](https://wakatime.com) account.
 examples:
   default: https://github.com/lowlighter/metrics/blob/examples/metrics.plugin.wakatime.svg
-index: 7
+index: 8
 supports:
   - user
 scopes: []

source/templates/classic/README.md

@@ -6,7 +6,7 @@ This is also the default template.</p>
 </td></tr>
   <tr>
     <th rowspan="3">Supported features<br><sub><a href="metadata.yml">→ Full specification</a></sub></th>
-    <td><a href="/source/plugins/achievements/README.md" title="🏆 Achievements">🏆</a> <a href="/source/plugins/activity/README.md" title="📰 Recent activity">📰</a> <a href="/source/plugins/anilist/README.md" title="🌸 Anilist watch list and reading list">🌸</a> <a href="/source/plugins/code/README.md" title="♐ Code snippet of the day">♐</a> <a href="/source/plugins/fortune/README.md" title="🥠 Fortune">🥠</a> <a href="/source/plugins/nightscout/README.md" title="💉 Nightscout">💉</a> <a href="/source/plugins/poopmap/README.md" title="💩 PoopMap plugin">💩</a> <a href="/source/plugins/screenshot/README.md" title="📸 Website screenshot">📸</a> <a href="/source/plugins/stock/README.md" title="💹 Stock prices">💹</a> <a href="/source/plugins/discussions/README.md" title="💬 Discussions">💬</a> <a href="/source/plugins/followup/README.md" title="🎟️ Follow-up of issues and pull requests">🎟️</a> <a href="/source/plugins/gists/README.md" title="🎫 Gists">🎫</a> <a href="/source/plugins/habits/README.md" title="💡 Coding habits">💡</a> <a href="/source/plugins/introduction/README.md" title="🙋 Introduction">🙋</a> <a href="/source/plugins/isocalendar/README.md" title="📅 Isometric commit calendar">📅</a> <a href="/source/plugins/languages/README.md" title="🈷️ Most used languages">🈷️</a> <a href="/source/plugins/lines/README.md" title="👨‍💻 Lines of code changed">👨‍💻</a> <a href="/source/plugins/music/README.md" title="🎼 Music plugin">🎼</a> <a href="/source/plugins/notable/README.md" title="🎩 Notable contributions">🎩</a> <a href="/source/plugins/pagespeed/README.md" title="⏱️ Website performances">⏱️</a> <a href="/source/plugins/people/README.md" title="🧑‍🤝‍🧑 People plugin">🧑‍🤝‍🧑</a> <a href="/source/plugins/posts/README.md" title="✒️ Recent posts">✒️</a> <a href="/source/plugins/projects/README.md" title="🗂️ Active projects">🗂️</a> <a href="/source/plugins/reactions/README.md" title="🎭 Comment reactions">🎭</a> <a href="/source/plugins/repositories/README.md" title="📓 Repositories">📓</a> <a href="/source/plugins/rss/README.md" title="🗼 Rss feed">🗼</a> <a href="/source/plugins/skyline/README.md" title="🌇 GitHub Skyline 3D calendar">🌇</a> <a href="/source/plugins/sponsors/README.md" title="💕 GitHub Sponsors">💕</a> <a href="/source/plugins/stackoverflow/README.md" title="🗨️ StackOverflow plugin">🗨️</a> <a href="/source/plugins/stargazers/README.md" title="✨ Stargazers over last weeks">✨</a> <a href="/source/plugins/starlists/README.md" title="💫 Starlists">💫</a> <a href="/source/plugins/stars/README.md" title="🌟 Recently starred repositories">🌟</a> <a href="/source/plugins/support/README.md" title="💭 GitHub Community Support">💭</a> <a href="/source/plugins/topics/README.md" title="📌 Starred topics">📌</a> <a href="/source/plugins/traffic/README.md" title="🧮 Repositories traffic">🧮</a> <a href="/source/plugins/tweets/README.md" title="🐤 Latest tweets">🐤</a> <a href="/source/plugins/wakatime/README.md" title="⏰ WakaTime plugin">⏰</a></td>
+    <td><a href="/source/plugins/achievements/README.md" title="🏆 Achievements">🏆</a> <a href="/source/plugins/activity/README.md" title="📰 Recent activity">📰</a> <a href="/source/plugins/anilist/README.md" title="🌸 Anilist watch list and reading list">🌸</a> <a href="/source/plugins/calendar/README.md" title="📆 Calendar">📆</a> <a href="/source/plugins/code/README.md" title="♐ Code snippet of the day">♐</a> <a href="/source/plugins/fortune/README.md" title="🥠 Fortune">🥠</a> <a href="/source/plugins/nightscout/README.md" title="💉 Nightscout">💉</a> <a href="/source/plugins/poopmap/README.md" title="💩 PoopMap plugin">💩</a> <a href="/source/plugins/screenshot/README.md" title="📸 Website screenshot">📸</a> <a href="/source/plugins/stock/README.md" title="💹 Stock prices">💹</a> <a href="/source/plugins/discussions/README.md" title="💬 Discussions">💬</a> <a href="/source/plugins/followup/README.md" title="🎟️ Follow-up of issues and pull requests">🎟️</a> <a href="/source/plugins/gists/README.md" title="🎫 Gists">🎫</a> <a href="/source/plugins/habits/README.md" title="💡 Coding habits">💡</a> <a href="/source/plugins/introduction/README.md" title="🙋 Introduction">🙋</a> <a href="/source/plugins/isocalendar/README.md" title="📅 Isometric commit calendar">📅</a> <a href="/source/plugins/languages/README.md" title="🈷️ Most used languages">🈷️</a> <a href="/source/plugins/lines/README.md" title="👨‍💻 Lines of code changed">👨‍💻</a> <a href="/source/plugins/music/README.md" title="🎼 Music plugin">🎼</a> <a href="/source/plugins/notable/README.md" title="🎩 Notable contributions">🎩</a> <a href="/source/plugins/pagespeed/README.md" title="⏱️ Website performances">⏱️</a> <a href="/source/plugins/people/README.md" title="🧑‍🤝‍🧑 People plugin">🧑‍🤝‍🧑</a> <a href="/source/plugins/posts/README.md" title="✒️ Recent posts">✒️</a> <a href="/source/plugins/projects/README.md" title="🗂️ Active projects">🗂️</a> <a href="/source/plugins/reactions/README.md" title="🎭 Comment reactions">🎭</a> <a href="/source/plugins/repositories/README.md" title="📓 Repositories">📓</a> <a href="/source/plugins/rss/README.md" title="🗼 Rss feed">🗼</a> <a href="/source/plugins/skyline/README.md" title="🌇 GitHub Skyline 3D calendar">🌇</a> <a href="/source/plugins/sponsors/README.md" title="💕 GitHub Sponsors">💕</a> <a href="/source/plugins/stackoverflow/README.md" title="🗨️ StackOverflow plugin">🗨️</a> <a href="/source/plugins/stargazers/README.md" title="✨ Stargazers over last weeks">✨</a> <a href="/source/plugins/starlists/README.md" title="💫 Starlists">💫</a> <a href="/source/plugins/stars/README.md" title="🌟 Recently starred repositories">🌟</a> <a href="/source/plugins/support/README.md" title="💭 GitHub Community Support">💭</a> <a href="/source/plugins/topics/README.md" title="📌 Starred topics">📌</a> <a href="/source/plugins/traffic/README.md" title="🧮 Repositories traffic">🧮</a> <a href="/source/plugins/tweets/README.md" title="🐤 Latest tweets">🐤</a> <a href="/source/plugins/wakatime/README.md" title="⏰ WakaTime plugin">⏰</a></td>
   </tr>
   <tr>
     <td><code>👤 Users</code> <code>👥 Organizations</code></td>

tests/cases/calendar.plugin.yml

@@ -0,0 +1,15 @@
+- name: 📆 Calendar - Current year calendar
+  uses: lowlighter/metrics@latest
+  with:
+    token: MOCKED_TOKEN
+    plugin_calendar: 'yes'
+    use_mocked_data: 'yes'
+    verify: 'yes'
+- name: 📆 Calendar - Full history calendar
+  uses: lowlighter/metrics@latest
+  with:
+    token: MOCKED_TOKEN
+    plugin_calendar: 'yes'
+    plugin_calendar_limit: 0
+    use_mocked_data: 'yes'
+    verify: 'yes'