WPML

サイトキーの仕組み

WPMLに登録された各サイトには、WPMLアカウントに紐付く固有のサイトキーが付与されます。このキーにより、サイトはアカウントの翻訳メモリ、用語集、単語の許容量を使用できるようになります。

現在のサイトのキーは、以下の2か所で確認できます。

  • WPMLActivate & Update。登録バナーにはマスクされた接尾辞(例:******abcd)が表示されるため、キー全体を公開することなく、サイトがどのキーを使用しているかを識別できます。
  • WPML.orgアカウントページ。登録したすべてのサイトとその完全なキーがリストされています。

手動で新しいサイトを登録するには、アカウントページでキーを生成し、プロンプトが表示されたときにWPML管理画面に貼り付けます。これは、オンボーディング中のセットアップウィザード、またはWPMLが要求した際の統合移行通知の埋め込みサイトキーフォームで行います。

サイトの登録を解除するには(サイトを廃止する場合など)、WPMLActivate & Updateの登録バナーにある「Unregister WPML from this site」をクリックします。同じ画面でWPMLはプラグインをインストールおよび更新します。そこにあるサイトキーは、それらのダウンロードがどのアカウントに属するかを管理します。

「This Site Is Registered as a Development Site」通知の削除

WPMLアカウントでは、1つの本番サイトにつき3つの開発サイトを登録できます。開発サイトの通知(「This site is registered on WPML.org as a development site」)は、開発クローンが本番環境として扱われるのを防ぐため、意図的に開発サイトのすべてのWPML管理ページに表示されます。

サイトを開発から本番に切り替える準備ができたら、以下の手順に従います。

  1. WPMLアカウントを開き、登録済みサイトのリストからサイトを見つけます。
  2. タイプを「Development」から「Production」に変更します。
  3. 保存します。
  4. サイト自体で、WPMLActivate & Updateを開き、「更新を確認」をクリックします。アカウント側の変更が同期されると、開発サイトの通知は消えます。

同期後も通知が消えない場合は、WPMLサポートシステムチェックRefresh license dataを実行します。これにより、ローカルのライセンスキャッシュがクリアされ、アカウントの状態が再取得されます。

PHP定数を使用したサイトの自動登録

自動化された開発/ステージング/本番ワークフロー(サイトがCIパイプラインによってデプロイされ、手動でキーを貼り付ける人がいない場合)では、PHP定数を使用してwp-config.phpにサイトキーをハードコーディングできます。WPMLは有効化の際にこれを読み取り、プロンプトを表示せずにサイトを登録します。

wp-config.phpの「That’s all, stop editing!」という行の前に:

define( 'OTGS_INSTALLER_SITE_KEY_WPML', 'your-site-key-here' );

WPMLは有効化の際に定数を取得し、登録プロンプトをスキップします。開発、ステージング、本番の各環境で同じキー値を設定できます。WPMLはドメインによってこれらを区別します。

これは、次のような環境に適したアプローチです。

  • サイトがDocker / Composer / WP-CLIスクリプトによってプロビジョニングされ、手動のセットアップ手順がない場合。
  • 多くのサイトを管理しており、クリックスルーではなく宣言的に登録を行いたい場合。
  • 新しくデプロイされた環境で、統合移行通知によりキーの入力が求められる場合。