Bogo Google Translate

Bogo の翻訳グループに対し、ja 原文を Google Cloud Translation API (v2) で各言語へ翻訳し、タイトル・本文・抜粋を翻訳版へ保存します。用語辞書による訳語固定にも対応。

Description

Bogo で多言語化したサイト向けの補助プラグインです。 既定言語（ja）の投稿を原文として、同じ翻訳グループ内の各言語版（en_US / ko_KR など）へ、 Google Cloud Translation API (v2) を使ってタイトル・本文・抜粋を翻訳・上書き保存します。

主な機能

• 投稿／固定ページの編集画面サイドバーに「Google 翻訳」ボックスを追加
• 原文（既定ロケール）を元に、グループ内の全翻訳版へ一括翻訳・保存
• 翻訳対象: タイトル（post_title）・本文（post_content）・抜粋（post_excerpt）
• 本文は format=html で送信し HTML タグを保持
• 翻訳用語辞書（カスタム投稿タイプ）で固有名詞・専門用語の訳語を言語ごとに固定
• API キーは設定ページ、または wp-config.php の定数 BGT_API_KEY から参照

動作の仕組み

Bogo は _original_post メタを共有する投稿群を 1 つの翻訳グループとして扱います。 本プラグインは編集中の投稿からグループを辿り、既定ロケール（ja）の投稿を「原文」として特定、 他ロケールの投稿（翻訳版）へ翻訳結果を保存します。原文・翻訳版どちらの編集画面からでも実行可能です。

Installation

1. wp-content/plugins/bogo-google-translate/ にプラグイン一式を配置します。
2. WordPress 管理画面「プラグイン」で本プラグインを有効化します（Bogo が有効である必要があります）。
3. API キーを設定します（下記のいずれか）。
   • 管理画面 → 設定 → Bogo Google Translate に v2 API キー（AIza... 形式）を入力
   • もしくは wp-config.php に次を記述（こちらが優先されます）: define( 'BGT_API_KEY', 'AIza...' );

Frequently Asked Questions

API キーはどの種類が必要ですか？

Google Cloud Translation API v2 の API キー（「AIza」で始まる文字列）です。 Google Cloud Console で「Cloud Translation API」を有効化したプロジェクトのキーを使用してください。

翻訳を実行するには？

対象記事の編集画面を開き、サイドバーの「Google 翻訳」ボックスで翻訳先言語を確認し、 「翻訳して保存」ボタンを押します。原文（ja）の内容が各翻訳版へ翻訳・上書き保存されます。

特定の用語を決まった訳語にしたい

管理メニュー「翻訳辞書」から用語を追加します。タイトル欄に原語（日本語）、 メタボックスで各言語の訳語を入力してください。翻訳時、その語は指定した訳語に固定されます （空欄の言語は自動翻訳のままです）。 ※ v2 API には用語集機能が無いため、プラグイン側で「翻訳前に notranslate で保護 → 翻訳後に訳語へ置換」する方式で実現しています。

翻訳版に手入力した内容は残りますか？

残りません。「翻訳して保存」は翻訳版のタイトル・本文・抜粋を上書きします。

Gutenberg ブロックは崩れませんか？

本文は format=html で送信するためタグは保持されますが、まれにブロックコメント （ 等）の属性に影響が出る場合があります。最初は 1 記事で結果を確認してください。

Changelog

1.0.0

• 初回リリース
• 投稿編集画面からの一括翻訳・保存
• API キーの設定ページ／wp-config.php 定数（BGT_API_KEY）対応
• 翻訳用語辞書（カスタム投稿タイプ bgt_glossary）による訳語固定