サポート・機能ガイド/Module / Plugin/WordPressプラグインの使い方
⚡ HTMLページ翻訳タグ🧩 Module / Plugin
🔌
WordPressプラグインの使い方
「Transer 多言語ページ翻訳」プラグイン(スラッグ: transer-translate)を使えば、コードを書かずにWordPressサイトをサーバーサイドで多言語化できます。
1
機能概要

プラグインは、WordPressが生成したHTML全体をtranslate.serviceへ送信し、翻訳済みHTML(多言語SEOタグ・言語ボックス自動挿入済み)に差し替えて表示するだけの薄いブリッジです。

翻訳先言語は、まずURLの言語プレフィックス(例: /en/about)を最優先で確認し、無ければ訪問者のCookie(transer_lang)で判定します。原文言語(既定: 日本語)の場合は何もしません。

💡
管理画面の設定だけで完結:PHPコードを書く必要はありません。プラグイン有効化後、設定画面でAPIキー等を入力するだけで利用できます。
2
URLプレフィックス優先の判定について

検索エンジンのクローラーは、Cookieを送らずに/en/aboutのようなURLへ直接アクセスします。従来はCookieだけで判定していたため、こうしたアクセスには常に原文(日本語)が返ってしまい、hreflangタグの内容と実際の配信内容が食い違っていました。

現在のバージョンでは、WordPress自身のURL解決より前(initフック)にURLの言語プレフィックスを検出・除去する処理が入っているため、この問題は自動的に解消されています。特別な設定は不要です。パーマリンク構造を問わず動作し、.htaccessなどサーバーのリライト設定も必要ありません。

3
動作環境
項目要件
WordPress5.8 以上(7.1まで動作確認済み)
PHP7.4 以上
ℹ️
レンタルサーバーなど、WordPressが動いている環境であればほとんどの場合PHP・WordPressのバージョン要件は既に満たしています。心配な場合はサーバー会社の管理画面やWordPressの「サイトヘルス」(ツール > サイトヘルス)でPHPバージョンを確認できます。
4
インストール
1
WordPress管理画面でプラグインを検索
「プラグイン」→「新規追加」で「Transer 多言語ページ翻訳」を検索し、「今すぐインストール」をクリックします。公式ディレクトリにアクセスできない環境では、「APIキー管理」ページからzipをダウンロードし、「プラグインのアップロード」からインストールしてください。
2
プラグインを有効化
「Transer 多言語ページ翻訳」を有効化してください。
3
APIキーを入力して保存
「設定」→「Transer 多言語ページ翻訳」を開き、「APIキー管理」ページで発行したAPIキーを入力して保存します。
5
設定画面(設定 > Transer 多言語ページ翻訳)
設定項目内容
APIキー「APIキー管理」ページで発行したAPIキーを入力します。入力が必要な項目はこれだけです。
原文言語・契約言語手入力は不要です。APIキーを使ってtranser.ioのアカウントから自動的に取得されます。
base_url通常は変更不要です(既定: https://api.transer.io)。
💡
入力するのはAPIキーだけです。原文言語・契約言語はAPIキーから自動的に取得されるため、言語の設定作業は必要ありません。
6
動作確認

設定保存後、https://example.com/en/(登録した言語コードのプレフィックス付きURL)へCookie無しでアクセスし、翻訳済みページが表示されるか確認してください。これが検索エンジンのクローラーと同じアクセス方法です。

従来通り、サイトのCookieにtranser_lang=enをセットした状態でプレフィックス無しのURLを開いても、同じく翻訳済みページが表示されます(言語ボックスでの切り替え時に使われる方式です)。

ℹ️
言語切り替えUI(言語ボックス)は、翻訳済みページの<head>に自動挿入されるスクリプトが描画します。プラグイン側で個別に実装する必要はありません。
7
トラブルシューティング
症状対処
言語を切り替えても何も変わらない設定画面でAPIキーが入力されているか確認してください。未入力の場合、プラグインは何もせず原文をそのまま表示します。
サイトが真っ白・エラーになるこれは想定外の挙動です。通信失敗時は必ず原文のHTMLがそのまま表示される設計になっています。WP_DEBUG_LOGを有効にしてエラーログをご確認のうえお問い合わせください。
特定のページだけ翻訳されないプラグインはGETリクエスト・HTML応答にのみ動作します。管理画面・REST API・AJAX・cronリクエストは対象外です。
hreflangタグに一部の言語が出ないその言語が契約済み(登録済み)になっているか確認してください。
/en/aboutにCookie無しでアクセスしても日本語のままプラグインが最新版(v0.9.6)に更新されているか確認してください(プラグイン一覧のバージョン表示)。古いバージョンではURLプレフィックスを見ず、Cookieのみで判定します。