WordPress 外掛說明文件
學習如何安裝、設定及自訂您的貨幣轉換小工具
目錄
1 安裝
方法一：從 WordPress 安裝（推薦）
- 進入您的 WordPress 管理後台
- 前往外掛 > 安裝外掛
- 搜尋「Currency.Wiki Converter」
- 點擊「立即安裝」後再點「啟用」
方法二：手動安裝
- 從 WordPress.org 下載外掛
- 前往外掛 > 安裝外掛 > 上傳外掛
- 選擇下載的 ZIP 檔並點擊「立即安裝」
- 安裝完成後啟用外掛
2 使用 Gutenberg 區塊
將貨幣轉換器加入頁面的最簡單方式：
- 使用 Gutenberg 編輯器編輯任一頁面或文章
- 點擊 + 按鈕新增區塊
- 搜尋「Currency Converter」或瀏覽小工具類別
- 於右側側邊欄設定小工具
小提示： 您可在區塊編輯器中調整設定時即時預覽小工具效果。
3 短代碼用法
您也可以在文章、頁面或佈景主題模板中使用短代碼加入小工具：
基本用法
[currencywiki_converter]
可用屬性
| 屬性 | 預設值 | 說明 |
|---|---|---|
| style | compact | 小工具樣式（compact、inline、tall、mini-chart 等） |
| theme | auto | 色彩主題（auto、light、dark） |
| from | USD | 預設來源貨幣（3 碼 ISO 代碼） |
| to | EUR | 預設目標貨幣（3 碼 ISO 代碼） |
| amount | 1 | 預設轉換金額 |
| accent | #3b82f6 | 強調色（如 #3b82f6 的十六進位碼） |
| embed | script | 嵌入方式（script 或 iframe） |
| width | auto | 自訂寬度（像素） |
| height | auto | 自訂高度（像素） |
範例
深色主題小工具：
[currencywiki_converter theme="dark"]
自訂貨幣與金額：
[currencywiki_converter from="GBP" to="JPY" amount="100"]
迷你圖表樣式：
[currencywiki_converter style="mini-chart"]
使用 iframe 嵌入（提升佈景主題相容性）：
[currencywiki_converter embed="iframe"]
4 小工具樣式
多種小工具樣式，輕鬆搭配您的網站設計：
mini
極簡轉換器，適合狹小空間（250x140px）
square
方形 1:1 比例轉換器（250x250px）
compact
小巧省空間轉換器（280x200px）
inline
橫向排列，適合頁首（450x120px）
tall
直式經典標籤（220x360px）
mini-chart
含歷史圖表的精簡轉換器（250x260px）
multi-expandable
可轉換多種貨幣，使用者可新增/移除（300x400px）
multi-fixed
固定多貨幣轉換清單（280x360px）
rates-compact
簡易匯率清單（260x260px）
rates-viewer
完整匯率檢視器含圖表（350x420px）
rates-viewer-compact
精簡匯率檢視器含圖表（300x340px）
小提示： 請於 WordPress 管理後台的小工具產生器預覽所有樣式，再加入您的網站。
5 設定選項
於 WordPress 管理後台的外掛設定頁可調整預設選項：
主題選項
- auto - 自動配合網站色彩主題
- light - 永遠使用淺色背景
- dark - 永遠使用深色背景
嵌入方式
- script - 預設。小工具以內嵌方式載入，功能完整。貨幣下拉選單會顯示於其他內容之上。
- iframe - 備用選項。小工具以獨立 iframe 載入。若遇到佈景主題樣式衝突可使用此方式。
注意： 若貨幣下拉選單被其他元素遮住或顯示不全，請嘗試切換為 iframe 嵌入模式。
6 疑難排解
小工具未顯示？
請確認外掛已啟用。檢查是否有快取外掛需清除。若 script 嵌入無效，請改用 iframe 嵌入方式。
小工具樣式異常或衝突？
部分 WordPress 佈景主題可能與小工具腳本衝突。請於短代碼加入 embed="iframe" 切換為 iframe 嵌入模式。
貨幣下拉選單被遮蔽或顯示不全？
當容器元素設有 overflow:hidden 時會發生此情形。請改用 iframe 嵌入，或調整佈景主題 CSS 允許小工具容器 overflow。
小工具顯示舊匯率？
匯率會自動更新。若您使用快取外掛，請排除小工具腳本的快取，或於變更後清除快取。
