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 | 默认源货币（三字母 ISO 代码） |
| to | EUR | 默认目标货币（三字母 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 允许小部件容器溢出。
小部件显示旧汇率？
汇率会自动更新。如使用缓存插件，请确保排除小部件脚本或更改后清理缓存。
