WPML

WPMLサイトキー – 仕組み、必要な場合、リセット方法

サイトキーは、サイトがどのアカウントに属しているかをWPMLに伝えます。ほとんどのクライアントはキーを直接操作する必要はありません。サイトを移動またはコピーすると、WPMLは自動的に再接続し、キーもそれに従います。キーを直接管理する必要があるいくつかのケースを以下に示します。

サイトキーの仕組み

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

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

  • WPML > Activate & Update. 登録バナーにはマスクされたサフィックス（例：******abcd）が表示されるため、完全なキーを公開することなく、サイトが使用しているキーを特定できます。
  • WPML.orgのアカウントページ。 登録したすべてのサイトとその完全なキーがリストされています。

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

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

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

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

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

  1. WPMLアカウントを開き、登録済みサイトのリストから該当するサイトを見つけます。
  2. タイプをDevelopmentからProductionに変更します。
  3. 保存します。
  4. サイト自体でWPML > Activate & 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スクリプトによってプロビジョニングされ、手動でのセットアップ手順がない。
  • 多数のサイトを管理しており、登録をクリックスルーではなく宣言的に行いたい。
  • 新しくデプロイされた環境で、統合移行通知によりキーが要求される。