YGZ Music Widget

外掛說明

YGZ Music Widget is a powerful WordPress music player widget based on the open-source projects APlayer and MetingJS.

Main Features

• Support for multiple music platforms: NetEase Cloud Music, QQ Music, Kugou Music, Xiami Music, Baidu Music
• Support for various types: single song, playlist, album, artist, search
• Rich player configuration options: volume, loop mode, play order, lyric display, etc.
• Beautiful interface design with customizable theme colors
• Support for fixed-bottom mode and mini mode
• Support for lyric display
• Responsive design, adapting to various devices
• Fully localized, no external CDN dependencies
• Compliant with WordPress coding standards

How to Use

1. Install and activate the plugin in the WordPress admin dashboard
2. Go to “Appearance” -> “Widgets”
3. Find the “YGZ Music Widget” widget
4. Drag it to the sidebar or other widget areas
5. Configure the player parameters:
   • Title: The display title of the widget
   • Music Platform: Select the music source (NetEase Cloud Music, QQ Music, etc.)
   • Type: Select the content type to play (single song, playlist, album, etc.)
   • ID: Enter the ID of the song/playlist/album (can be found in the URL of the music platform page)
   • Volume: Set the default volume (between 0-1)
   • Theme Color: Customize the player theme color
   • Loop Mode: Select all loop, single loop, or no loop
   • Play Order: Select list order or random play
   • Preload: Set the audio preload method
   • Lyric Type: Choose whether to display lyrics
   • List Max Height: Set the maximum height of the playlist
   • Autoplay: Check to autoplay when the page loads (may be blocked by browsers)
   • List Folded: Check to fold the playlist by default
   • Fixed Mode: Check to fix the player at the bottom of the page
   • Mini Mode: Check to display the mini player
   • Mutex: Check to pause other players when this player plays

How to Get Playlist ID

1. Open the playlist page in your browser
2. Check the URL, for example: https://music.163.com/#/discover/toplist?id=3778678
3. The number part in the URL (3778678) is the playlist ID

Credits

• APlayer – Clean, beautiful, and powerful HTML5 music player
• MetingJS – Extension for APlayer, supporting major music platforms

License

This plugin is open-source under the MIT License.

External Services

This plugin uses the following external service:

• Meting API – Used by MetingJS to fetch music data from various music platforms
• URL: https://api.i-meto.com/meting/api
• Purpose: Retrieves music information, including song details, playlists, and lyrics
• Data sent: Music platform, type of content, and ID when a player is initialized
• Terms of Service: https://github.com/metowolf/MetingJS
• Privacy Policy: https://api.i-meto.com/privacy