feat(plugin/music): add support for new top mode with top artists or tracks (#569)

source/plugins/music/metadata.yml

@@ -28,7 +28,7 @@ inputs:
   # Music provider token
   # This may be required depending on music provider used and plugin mode
   # - "apple"   : not required
-  # - "spotify" : required for "recent" mode, format is "client_id, client_secret, refresh_token"
+  # - "spotify" : required for "recent" or "top" mode, format is "client_id, client_secret, refresh_token"
   # - "lastfm"  : required, format is "api_key"
   plugin_music_token:
     description: Music provider personal token
@@ -43,6 +43,7 @@ inputs:
     values:
       - playlist # Display tracks from an embed playlist randomly
       - recent   # Display recently listened tracks
+      - top   # Display top listened artists/tracks
 
   # Embed playlist url (i.e. url used by music player iframes)
   plugin_music_playlist:
@@ -65,6 +66,25 @@ inputs:
     type: boolean
     default: no
 
+  # Time range for "top" mode
+  plugin_music_time_range:
+    description: Time period for top mode
+    type: string
+    default: short  # Defaults to "short" (4 weeks)
+    values:
+      - short # Top artists/tracks from past 4 weeks
+      - medium   # Top artists/tracks from past 6 months
+      - long   # Top artists/tracks from several years
+
+  # Option for "top" mode to select tracks or artists
+  plugin_music_top_type:
+    description: Whether to show tracks or artists in top mode
+    type: string
+    default: tracks
+    values:
+      - tracks
+      - artists
+
   # Username on music provider service
   plugin_music_user:
     description: Music provider username