內容簡介
SoundFiles Player 是一款官方的 WordPress 外掛，讓使用者能夠輕鬆嵌入 SoundFiles.eu 的音訊檔案。透過簡單的短碼或支援的 SoundFiles URL，使用者可以在網站上播放音訊，並確保播放器在各種佈景主題中保持一致的外觀。
【主要功能】
• 音訊播放器具備波形顯示功能
• 使用 Shadow DOM 確保佈景主題安全的樣式
• 在 WordPress 設定畫面中提供即時預覽
• 可自訂播放按鈕、波形、背景及文字顏色
• 支援簡單及進階的短碼嵌入
• 無需第三方圖示或字型 CDN 依賴
外掛標籤
開發者團隊
原文外掛簡介
SoundFiles Player is the official WordPress integration for SoundFiles.eu.
The plugin lets you embed public SoundFiles audio using a shortcode or a supported SoundFiles URL. The player is isolated from theme CSS with Shadow DOM, so its layout and controls remain consistent across WordPress themes.
Features include:
Responsive audio player with waveform.
Theme-safe styling using Shadow DOM.
Live preview in the WordPress settings screen.
Custom PLAY, waveform, background, border, and text colors.
Adjustable player width.
Shortcodes for simple and advanced embeds.
Translation-ready interface that follows the WordPress locale.
No third-party icon or font CDN dependency.
Shortcodes
Basic player:
[soundfiles id="FILE_HASH"]
Use one color for PLAY and WAVE:
[soundfiles id="FILE_HASH" color="#105b81"]
Set PLAY and WAVE colors independently:
[soundfiles id="FILE_HASH" play="#105b81" wave="#3a6b84"]
Embed from a SoundFiles URL:
[soundfiles_player url="https://soundfiles.eu/FILE_HASH/file"]
External services
This plugin connects to SoundFiles.eu in order to play the audio file selected by the site owner. When a player is displayed, the visitor’s browser requests the audio stream from soundfiles.eu and the waveform image from storage.soundfiles.eu.
SoundFiles.eu service: https://soundfiles.eu/
Developer information: https://soundfiles.eu/developers
No SoundFiles account or API key is required by this WordPress plugin for public audio embeds.
Development
All JavaScript and CSS files distributed with this plugin are the original, human-readable source files. The plugin does not use npm, webpack, minification, transpilation, or any other build step, and it does not include generated bundles that require separate source files.
The player stylesheet is stored in assets/player.css and is loaded inside the player’s Shadow DOM by assets/embed_sf.js. The WordPress settings screen uses the separate source files assets/admin.css and assets/admin.js.
