MultiLipi WordPressプラグイン：完全なセットアップ、翻訳、多言語SEOおよび設定ガイド

1.1 設定ページに移動する

WordPress管理画面で、 MultiLipi メニューを左サイドバーから開き、 設定をクリックします。ページ上部に MultiLipiに接続 セクション。

1.2 MultiLipi APIキーを入力する

プロジェクトのAPIキーを指定のフィールドに貼り付けてください。キーはMultiLipiアカウントダッシュボードのウェブサイトプロジェクト設定から取得できます。

1.3 設定の取得と適用

クリック 設定を取得して適用する。プラグインはMultiLipiに接続し、アカウントから以下の設定を同期します：

1.4 接続の確認

取得が成功すると、ページ上で構成が適用されたことが確認されます。以下の場合には必ず再同期を行ってください：

2.1 設定詳細の表示

接続後、以下をクリックします 設定詳細を表示 をクリックすると、検証済みのバックエンド設定テーブルが展開されます。ここには、MultiLipiアカウントから同期されたすべての値が表示されます。

2.2 設定フィールド

2.3 機能フラグ

2.4 ローカライゼーションモード

ローカライズモードはMultiLipiアカウントで設定され、翻訳されたページが訪問者にどのように配信されるかを決定します。

2.5 クエリ翻訳と除外設定

クエリ翻訳ルールは、どのURLパラメータが翻訳された検索動作をトリガーするかを定義します。最も一般的なものはWordPressの検索パラメータです：

除外ブロッククラスは、ページコンテンツを処理する際にスキップするCSSクラス名を翻訳レイヤーに指示します。例：

2.6 機能が利用できない場合は？

3.1 言語ディレクトリとは？

各対象言語は、ISO言語コードに基づいた独自のURLサブディレクトリから提供されます。ソース言語は、プレフィックスなしのルートドメインを使用します。

3.2 対象言語ディレクトリへの移動

MultiLipi → 設定で、以下までスクロールします。 対象言語ディレクトリ セクション。このテーブルには、有効化チェックボックス、言語コード、言語名、URLプレビュー、およびディレクトリルーティングのドロップダウンが含まれています。

3.3 優先言語の有効化

各言語の横にある 有効にする チェックボックスをオンにして、提供する言語を選択します。有効化された言語のみが、そのディレクトリURLを通じてアクセス可能になります。

3.4 ディレクトリルーティングオプション

3.5 競合の防止

MultiLipiは、ネストされた言語プレフィックスを自動的に防止します。例えば、 /en/ がソース言語ディレクトリである場合、次のようなターゲットは en-GB 競合する /en/en-gb/ パスを作成しません。各言語には一意のトップレベルプレフィックスが割り当てられます。

3.6 保存とテスト

4.1 多言語サイトマップとは？

多言語XMLサイトマップは、すべての言語ディレクトリにわたるすべてのURLをリスト化し、検索エンジンが翻訳されたページを効率的に発見およびインデックスできるようにします。

4.2 サイトマップ設定への移動

MultiLipi → 設定で、 SEOと検索 セクションを開き、 多言語XMLサイトマップ.

4.3 サイトマップの有効化

各言語の横にある 多言語XMLサイトマップを有効にする チェックボックスをオンにして保存します。サイトマップインデックスは以下から利用可能です：

4.4 Hreflangアノテーション

4.5 WordPress SEOプラグインとの互換性

MultiLipiのサイトマップは、既存のSEOプラグインのサイトマップと共存します。以下のプラグインで互換性がテストされています：

4.6 robots.txtの自動検出

MultiLipiは、サイトのrobots.txtファイルにサイトマップURLを自動的に追加します。以下にアクセスして存在を確認できます：

4.7 Google Search Consoleへの送信

5.1 ハイブリッドSEOシナリオの理解

言語ディレクトリでハイブリッドルーティングを使用する場合、一部のURLはネイティブのWordPressページであり、その他はMultiLipiによって翻訳されたページとなります。検索エンジンが完全な多言語構造を理解できるように、両方のタイプをhreflangアノテーションに含める必要があります。

5.2 ハイブリッドディレクトリSEOへの移動

MultiLipi → 設定 → に移動し、 SEOと検索を見つけます。 ハイブリッドディレクトリSEO サブセクション

5.3 ハイブリッド言語SEO公開の有効化

「 ハイブリッド言語SEO公開を有効にする 」にチェックを入れると、MultiLipiは、ネイティブのWordPressページとMultiLipiが提供する翻訳の両方を同じ言語ディレクトリ内で含むhreflangタグを公開できるようになります。

5.4 正規URL（Canonical URL）の検証

正規タグ（Canonical tag）は、検索エンジンに対してどのURLがページの権威あるバージョンであるかを伝えます。正しい正規設定が行われていない場合、フランス語のURLが誤って英語のソースを正規版として宣言したり、2つのURLが互いを正規版として主張し、競合が発生したりする可能性があります。

5.5 必須確認事項

ハイブリッドSEO公開を有効にする前に、ハイブリッドディレクトリ配下のネイティブWordPressページで正規URL（canonical URL）が検証済みであることを確認する必要があります。設定ページでは以下の操作が求められます。

確認チェックボックスと 設定を保存 ボタンの両方が必要です。チェックボックスをオンにしても保存を行わない場合、機能は有効になりません。

6.1 仕組み

ヒンディー語の訪問者がヒンディー語サイトで検索を行うと、MultiLipiはそのクエリを翻訳済み検索インデックス経由でルーティングします。このインデックスにはコンテンツの翻訳版が含まれており、訪問者が英語で検索しなくても正確な一致結果を得ることが可能です。以下のコンテンツタイプが検索対象となります。

6.2 多言語検索へ移動

MultiLipi → 設定 → に移動し、 SEOと検索を見つけます。 多言語WordPress検索 サブセクション

6.3 多言語検索を有効にする

「 多言語検索を有効にする をクリックして保存します。MultiLipiは、言語ディレクトリからの検索リクエストを翻訳済み検索インデックス経由でルーティングし始めます。

6.4 オンデマンド検索フォールバック

訪問者が翻訳済みインデックスにまだ存在しない用語を検索した場合、オンデマンドフォールバックが以下の手順で処理を行います：

6.5 訪問者主導の検索インデックス作成

訪問者主導のインデックス作成を有効にすると、各言語ディレクトリから送信された検索クエリを使用して、翻訳済み検索インデックスが時間の経過とともに構築および拡張されます。つまり、実際の訪問者がサイトを利用するにつれて、インデックスが有機的に改善されます。

6.6 言語固有の検索URL

言語ディレクトリからの検索リクエストには、URLに言語プレフィックスが含まれます。例えば、ヒンディー語で用語を検索すると、以下のようになります：

6.7 保存とテスト

7.1 設定への移動

MultiLipi → 設定で、以下を見つけます 自動翻訳とキャッシュ セクション。

7.2 バックグラウンド事前翻訳範囲

バックグラウンド事前翻訳はコンテンツをあらかじめ処理するため、初回リクエスト時に翻訳されるのではなく、キャッシュから翻訳済みページが読み込まれます。優先順位に合わせて範囲を選択してください：

7.4 翻訳キャッシュ

「 翻訳キャッシュを有効にする 翻訳されたレスポンスをサーバー上に保存します。キャッシュされた翻訳は、再翻訳することなく繰り返しリクエストに対して提供されるため、すべての訪問者のレスポンス時間が短縮されます。

7.5 サーバーキャッシュ期間

キャッシュされた翻訳を更新するまでの保持期間を設定します。コンテンツの更新頻度に基づいて選択してください：

一般的なビジネスウェブサイトの推奨値：

7.6 事前翻訳とキャッシュの連携

バックグラウンドでの事前翻訳は、訪問者からのリクエストがある前に翻訳を準備します。翻訳キャッシュは、各翻訳の結果を後続のリクエストのために保存します。両方が有効な場合、最初の訪問者がページにアクセスすると事前翻訳がトリガーされ、その結果がキャッシュされます。その後、すべての訪問者は待機することなく、キャッシュされた翻訳を即座に受け取ることができます。

7.7 重要な考慮事項

8.1 URLスラッグとは？

URLスラッグとは、特定のページを識別するWebアドレスの読み取り可能な部分です。スラッグ翻訳では、ソース言語のスラッグをターゲット言語ディレクトリ下の翻訳された同等のものに置き換えます。

8.2 スラッグ翻訳への移動

WordPress管理画面の左サイドバーで、以下を開きます。 MultiLipi → スラッグ翻訳.

スラッグ翻訳ダッシュボードでは、以下の操作が可能です：

8.3 フィルターコントロール

スラッグ翻訳テーブル上部のフィルターコントロールを使用して、リストを絞り込みます。

各フィルターは、スラッグテーブルの異なる側面を制御します：

8.4 タクソノミールートベース

個別のコンテンツスラッグに加えて、WordPressがタクソノミーアーカイブに使用するルートベースを翻訳できます。例えば、デフォルトのWordPressカテゴリーベースでは、以下のようなURLが生成されます。

構造は以下の通りです。 言語 / 翻訳されたベース / 翻訳されたターム。ベース（श्रेणी）とターム（खबरें）はそれぞれ独立して翻訳されます。

タクソノミールートベースを翻訳するには：

8.5 投稿、固定ページ、および製品の翻訳済みスラッグを編集する

メインのコンテンツスラッグテーブルには、すべての翻訳済みスラッグマッピングが表示されます。各行には、コンテンツタイトル、ソーススラッグ、翻訳済みスラッグ、翻訳モード、およびマッピングを保存または削除するためのコントロールが含まれています。

スラッグを手動で翻訳するには：

例：ヒンディー語の「About Us（会社概要）」ページ。

8.6 自動スラッグモードと手動スラッグモード

8.7 Unicode URLの取り扱い

ヒンディー語（デーヴァナーガリー文字）、パンジャーブ語（グルムキー文字）、およびその他の非ラテン文字のスラッグは、RFC 3987 IRI標準に基づき有効なURL文字です。ブラウザはそれらを本来の形式で表示しますが、サーバーや一部のツールはパーセントエンコーディングされたシーケンスとしてエンコードします。

例えば、ヒンディー語のスラッグ हमारे-बारे-में は、以下のようにパーセントエンコーディングされて表示される場合があります：

8.8 重複スラッグの防止

MultiLipiは、WordPress自体と同じ一意性ロジック（wp_unique_post_slug）を適用します。同じ言語ディレクトリ内の別のページで翻訳済みスラッグが既に存在する場合、数値のサフィックスが自動的に付加されます。例えば、 /hi/सेवाएं/ が既に使用されている場合、重複分は /hi/सेवाएं-2/.

8.9 自動リダイレクト

訪問者がターゲット言語ディレクトリ配下でソース言語のスラッグにアクセスした場合（例： /hi/about-us/ ）、MultiLipiは翻訳済みスラッグへの302リダイレクトを発行します。以下のリクエストタイプはリダイレクト処理から除外されます：HEADリクエスト、AJAXリクエスト、およびWooCommerceのカート追加アクション。

8.10 未翻訳スラッグの削除と保持

8.11 スラッグマッピングの保存方法

翻訳されたスラッグマッピングは、専用のWordPressデータベーステーブルに保存されます： ${wpdb->prefix}multilipi_slug_mappings。各行には、テナントID、ターゲット言語、オブジェクトタイプ、オブジェクトID、ソーススラッグ、翻訳済みスラッグ、翻訳モード（自動または手動）、および作成・更新タイムスタンプが記録されます。

8.12 推奨ワークフロー

9.1 リセットオプションへの移動

WordPress管理画面で、 MultiLipi → 設定 に移動し、ページの一番下までスクロールします。そこに 保存されたすべてのデータを削除 セクションがあります。

9.2 削除されるデータ

9.3 削除されないもの

9.4 プラグインデータの削除方法

このリセットは、WordPressのnonce（セキュリティトークン）、権限チェック（管理者のみが実行可能）、および必須の確認用チェックボックスによって保護されています。削除を実行するには、これら3つの安全策すべてを満たす必要があります。

9.5 リセット後の再設定