WordPressプラグイン ドキュメント
通貨コンバーターウィジェットのインストール、設定、カスタマイズ方法を学びましょう
目次
1 インストール
方法1：WordPressからインストール（推奨）
- WordPress管理ダッシュボードにアクセス
- プラグイン > 新規追加 へ移動
- 「Currency.Wiki Converter」と検索
- 「今すぐインストール」をクリックし、「有効化」
方法2：手動インストール
- 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のような16進コード） |
| 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 トラブルシューティング
ウィジェットが表示されない場合
プラグインが有効化されているか確認してください。キャッシュ系プラグインがあればクリアしてください。スクリプト埋め込みで動作しない場合はiframe埋め込みをお試しください。
ウィジェットの表示が崩れる・スタイルが競合する場合
一部のWordPressテーマはウィジェットスクリプトと競合する場合があります。ショートコードにembed="iframe"を追加してiframe埋め込みモードに切り替えてください。
通貨ドロップダウンが隠れる・切れる場合
コンテナ要素にoverflow:hiddenが設定されている場合に発生します。iframe埋め込みモードを使うか、ウィジェットコンテナのCSSでoverflowを許可してください。
ウィジェットが古いレートを表示する場合
為替レートは自動で更新されます。キャッシュプラグインを使用している場合は、ウィジェットスクリプトをキャッシュ対象外にするか、変更後にキャッシュをクリアしてください。
