WordPress

PolylangまたはWPMLを使ってWordPressの投稿や固定ページを翻訳し、公開に合わせて翻訳を最新の状態に保ちます。

WordPressでは、投稿の各言語版をそれぞれ独立した投稿として保存し、PolylangまたはWPMLで元の投稿に関連付けます。Lingo.dev連携は、原文の言語で公開されている投稿を読み取り、ローカライゼーションエンジンでタイトル、抜粋、ブロックの内容を翻訳して、各投稿に紐づく翻訳版に書き込みます。ブロックのマークアップ、ブロック設定、ショートコード、埋め込み先のアドレスはそのまま保持し、その中のテキストや、検索・ナビゲーションなどのブロックのラベルを翻訳します。

まずは投稿タイプを一つ選び、手動で同期しましょう。結果を確認したら、公開済みの投稿を保存すると自動で翻訳が始まるようにします。

WordPress連携の利用には、Enterpriseプランが必要です。現在の提供状況は料金をご覧ください。組織のプランで利用できない場合は、設定 → 連携のWordPressの横にご利用のプランでは利用できませんと表示されます。

サイトを準備する #

サイトは公開アドレスへのHTTPS経由のアクセスに応答でき、言語設定を済ませたPolylangまたはWPMLが稼働している必要があります。Lingo.devは、de-DEに対するde_DEのように、WordPressが各言語に割り当てるロケールを使って翻訳するため、言語の対応付けを設定する必要はありません。別の言語がすでに同じロケールを使っている場合は、de_DEと併存するde_DE_formalにdeを使うように、より短いロケールを代わりに使用します。

WordPressのプラグインディレクトリからLingo.devプラグインをインストールし、有効化します。次に、WordPressで設定 → Lingo.devを開き、キーを生成します。プラグインにはキーのハッシュのみが保存されるため、ページを離れる前にキーをコピーしてください。新しいキーを生成すると古いキーは置き換えられ、Lingo.devに新しいキーを入力するまで同期が停止します。

サイトを接続する #

Lingo.devで設定 → 連携を開き、WordPressの接続を選択します。Studioから連携を追加 → WordPressを選択しても、同じフォームが開きます。接続名、サイトのアドレス、キーを入力してください。接続を選択すると、Lingo.devが、プラグインがそのキーで応答すること、サイトが返すアドレスが入力したアドレスと一致すること、PolylangまたはWPMLが有効になっていることを確認します。その後、投稿が変更されたときの通知先アドレスをプラグインに渡します。サイトを同時に接続できる組織は1つだけです。

Studioから接続すると、そのままセットアップに進みます。設定から接続したサイトは、接続ページにStudioでセットアップが表示されます。Studioの接続済みからサイトを選び、セットアップを選択することもできます。ローカライゼーションエンジンと、翻訳する投稿タイプを選択してください。Lingo.devは、サイトの既定の言語から、サイト内の他の言語のうちWordPressのロケールが用意されているすべての言語に翻訳します。後からPolylangまたはWPMLで追加した言語も翻訳されます。

一つの投稿タイプを翻訳する #

同期を実行し、該当するワークフロー実行を開いて、WordPressで翻訳済みの投稿を確認します。文章、リンク、ブロック、公開状態を確認したら、サイト上でも実際に読んでみてください。

初回の同期では、サイトにある既存の翻訳を保持します。タイトルは翻訳済みでも抜粋は未翻訳といったように、一部のフィールドだけが翻訳されている場合は、翻訳済みのフィールドを保持し、残りを翻訳します。

元の投稿が公開されている場合は、翻訳版も公開されます。非公開または公開予約済みの翻訳版は、その状態を維持します。元の投稿の公開を取り消しても、翻訳版は変更されません。

原文の変更を翻訳に反映する #

翻訳対象の投稿タイプの投稿が原文の言語で公開または更新されると、プラグインがLingo.devに通知し、Lingo.devが投稿を読み直して変更箇所を翻訳します。下書きや翻訳版を保存しても、翻訳は始まりません。また、Lingo.devは前回の確認以降に変更された投稿を毎時確認するため、通知を取りこぼした場合も変更を反映できます。

変更された投稿や不足している翻訳には、同期を使います。手動で編集したものも含めて翻訳を置き換える場合は、再翻訳を使ってください。

同期中の編集 #

書き込みには毎回、読み取り時点の元の投稿と翻訳版について、サイトが生成したハッシュが含まれます。同期による翻訳中に編集者がどちらかを変更すると、プラグインは編集内容を上書きせず、書き込みを拒否します。その投稿は、実行結果でスキップされたと報告されます。次回の同期では、投稿を読み直します。

設定を変更する・接続を解除する #

エンジンと投稿タイプは Studio の連携の 設定 タブで、言語は Polylang または WPML で変更できます。接続名の変更、キーの置き換え、接続の切断は、設定 → 連携 で行います。WordPress で新しいキーを生成したら、キーを置き換える を選択し、新しいキーを入力してください。

サイトのアドレスを変更するには、新しく接続し直す必要があります。接続を解除すると、プラグインにLingo.devへの通知停止が要求され、接続履歴と同期状態が削除されます。翻訳済みの投稿はワードプレスに残ります。プラグインは現在のキーによる要求のみを受け付けるため、ワードプレスで新しいキーを生成した場合は、接続を解除する前にキーを置き換えるを選択してください。古いキーでサイトの接続を解除した場合、プラグインは通知を送信し続けますが、Lingo.devはその通知を無視します。ワードプレスでプラグインを削除すると、通知が停止します。