Bogo Google Translate

=== Bogo Google Translate === Contributors: mgn Requires at least: 6.0 Tested up to: 7.0 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

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）による訳語固定