Title: SoundFiles Player
Author: soundfiles
Published: <strong>2026 年 9 月 22 日</strong>
Last modified: 2026 年 9 月 22 日

---

搜尋外掛

![](https://ps.w.org/soundfiles-player/assets/banner-772x250.png?rev=3708004)

![](https://ps.w.org/soundfiles-player/assets/icon-256x256.png?rev=3708004)

# SoundFiles Player

 由 [soundfiles](https://profiles.wordpress.org/soundfile/) 開發

[下載](https://downloads.wordpress.org/plugin/soundfiles-player.2.0.3.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/soundfiles-player/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/soundfiles-player/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/soundfiles-player/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/soundfiles-player/#developers)

 [技術支援](https://wordpress.org/support/plugin/soundfiles-player/)

## 外掛說明

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"]<h3>External services</h3>
    ```

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`.

## 螢幕擷圖

[⌊SoundFiles Player with waveform and playback controls.⌉⌊SoundFiles Player with
waveform and playback controls.⌉[

SoundFiles Player with waveform and playback controls.

[⌊Player appearance settings with live preview in the WordPress admin.⌉⌊Player appearance
settings with live preview in the WordPress admin.⌉[

Player appearance settings with live preview in the WordPress admin.

[⌊Shortcode examples for embedding SoundFiles audio.⌉⌊Shortcode examples for embedding
SoundFiles audio.⌉[

Shortcode examples for embedding SoundFiles audio.

[⌊Responsive SoundFiles Player on a mobile device.⌉⌊Responsive SoundFiles Player
on a mobile device.⌉[

Responsive SoundFiles Player on a mobile device.

## 安裝方式

 1. Upload the plugin ZIP in Plugins -> Add Plugin -> Upload Plugin.
 2. Activate SoundFiles Player.
 3. Open Settings -> SoundFiles Player.
 4. Customize the player colors and width if needed.
 5. Add a player with `[soundfiles id="FILE_HASH"]`.

## 常見問題集

### Does the plugin work with different WordPress themes?

Yes. Player styles are isolated with Shadow DOM to reduce conflicts with theme and
page-builder CSS.

### Can the plugin be translated?

Yes. The plugin uses the standard WordPress internationalization functions and is
ready for translations through translate.wordpress.org when hosted in the WordPress.
org Plugin Directory.

### Can I use more than one player on a page?

Yes. Multiple SoundFiles players can be embedded on the same page.

## 使用者評論

這個外掛目前沒有任何使用者評論。

## 參與者及開發者

以下人員參與了開源軟體〈SoundFiles Player〉的開發相關工作。

參與者

 *   [ soundfiles ](https://profiles.wordpress.org/soundfile/)

[將〈SoundFiles Player〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/soundfiles-player)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/soundfiles-player/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/soundfiles-player/)，或透過 
[RSS](https://plugins.trac.wordpress.org/log/soundfiles-player/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/soundfiles-player/)。

## 變更記錄

#### 2.0.3

 * Moved settings-page CSS and JavaScript to files loaded with WordPress enqueue
   functions.
 * Moved player styling to a separate human-readable source stylesheet.
 * Removed bundled translation files and the unnecessary `load_plugin_textdomain()`
   call for WordPress.org hosting.
 * Updated the WordPress.org contributor username.
 * Documented that all distributed JavaScript and CSS are source files and require
   no build step.

#### 2.0.2

 * Added WordPress internationalization support.
 * Localized player accessibility labels and waveform status text.
 * Updated plugin metadata and documentation for WordPress.org.

#### 2.0.1

 * Isolated player styles with Shadow DOM so WordPress themes do not override player
   controls.
 * Removed the external Font Awesome dependency; the spinner now uses local CSS.
 * Improved responsiveness, multiple-player playback, time display, and seeking.

#### 2.0.0

 * Initial release.

## 中繼資料

 *  版本 **2.0.3**
 *  最後更新 **2 週前**
 *  啟用安裝數 **少於 10 次**
 *  WordPress 版本需求 ** 5.8 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.1.2**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/soundfiles-player/)
 * 標籤:
 * [audio](https://tw.wordpress.org/plugins/tags/audio/)[player](https://tw.wordpress.org/plugins/tags/player/)
   [waveform](https://tw.wordpress.org/plugins/tags/waveform/)
 *  [進階檢視](https://tw.wordpress.org/plugins/soundfiles-player/advanced/)

## 評分

這個項目尚無任何評論記錄。

[撰寫評分](https://wordpress.org/support/plugin/soundfiles-player/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/soundfiles-player/reviews/)

## 參與者

 *   [ soundfiles ](https://profiles.wordpress.org/soundfile/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/soundfiles-player/)