🔌
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
動作環境| 項目 | 要件 |
|---|---|
| WordPress | 5.8 以上(7.1まで動作確認済み) |
| PHP | 7.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のみで判定します。 |