外掛說明
Audio Playlist is a modern, self-hosted HTML5 audio player for WordPress. It dynamically reads MP3 and WAV files from a folder on your server — no Spotify, no SoundCloud, no dependency on external music services.
Features
- Reads tracks automatically from your audio folder
- Displays track titles based on filenames (clean formatting with spaces and capitalization)
- Displays a cover image (cover.jpg or cover.png) for the playlist
- Renders an interactive waveform powered by WaveSurfer.js
- Full playback controls: Play, Pause, Previous, Next, Shuffle, Loop, Volume
- Auto-scrolling title for long track names
- Works in any shortcode-compatible field — no Gutenberg block required
- Compatible with Divi and other page builders
- Configurable background color for the player
Usage
Place your MP3 files in a folder named playlist under your audio base directory, add a cover.jpg, then use the shortcode:
[nuclaup_playlist label="My Playlist"]
Free version limitations
- Reads tracks from a single fixed folder named
playlist - Single cover image per playlist (cover.jpg) — no per-track covers
Pro version
Audio Playlist Pro adds:
- Multiple playlists with custom folder paths
- ID3 tag reading (title, artist) for accurate track metadata
- Per-track cover art via catalog code matching
- Companion Python script to extract and resize cover art from MP3 ID3 tags
- Advanced admin panel with catalog code configuration
螢幕擷圖
安裝方式
- Upload the
audio-playlistfolder to/wp-content/plugins/ - Activate the plugin from Plugins Installed Plugins
- Open Audio Playlist from the WordPress sidebar
- If your audio folder is named
audioand is located in the root of your site, no configuration is needed — the plugin works automatically.
Folder structure
Place your audio files like this:
/audio/playlist/track01.mp3
/audio/playlist/track02.mp3
/audio/playlist/cover.jpg
Then use the shortcode [nuclaup_playlist label="My Playlist"] anywhere.
常見問題集
-
Do I need to configure anything?
-
No. If your audio folder is named
audioand is in the root of your site, the plugin works out of the box. -
Why does the shortcode not have a folder parameter?
-
The free version reads from a single fixed folder (
playlist) by design. The Pro version allows custom folder paths and multiple independent playlists. -
What if I use multiple shortcodes on the same page?
-
They will all display the same playlist, since the free version uses a single fixed folder.
-
What image formats are supported for cover art?
-
JPG and PNG. Name the file
cover.jpgorcover.pngand place it in the playlist folder. -
Does it work with Divi?
-
Yes. A dedicated Divi Integration tab inside the plugin provides ready-to-paste CSS to fix any style conflicts.
-
Yes. The plugin uses WordPress native functions and does not require CLI access.
-
Can I change the player background color?
-
Yes, from the plugin’s Settings tab in the WordPress admin.
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
1.0.0
- Initial release.