開発者
Tranzly アビリティリファレンス
Tranzly は自身のアクションを WordPress Abilities API に登録します。同一のアビリティは、サイト自身のサーバー上の MCP ツールとして、また /wp-json/wp-abilities/v1 以下の REST ルートとして利用できます。このページはプラグイン自身のレジストリから生成されています。
エンドポイント
| アビリティ | REST |
|---|---|
| HTTP 経由の MCP (ストリーミング可能) | /wp-json/tranzly/v1/mcp |
| WP-CLI 経由の MCP (標準入出力) | wp mcp-adapter serve --server=tranzly --user=<login> |
| REST: アビリティの一覧取得 | /wp-json/wp-abilities/v1/abilities?category=tranzly |
| REST: アビリティの実行 | /wp-json/wp-abilities/v1/abilities/<name>/run (読み取り専用アビリティは ?input= を付けた GET、それ以外は {"input": {...}} を付けた POST) |
認証と権限
HTTP リクエストは WordPress アプリケーションパスワード (HTTP Basic) で認証します。MCP サーバーへの接続には以下に示す権限が必要です。各アビリティはその後、オブジェクトごとに自身の権限をチェックします。読み取り専用アビリティは GET とクエリ文字列内の入力で実行され、それ以外は POST と JSON 本文 ‘{“input”: {…}}’ で実行されます。
WordPress アプリケーションパスワード(HTTP)または --user(WP-CLI)。ユーザーには各アビリティが指定する権限が必要です · 設定: AI エージェントを許可 (MCP)、デフォルトで有効
すべてのアビリティ
| アビリティ | エディション | REST | 権限 | パラメーター |
|---|---|---|---|---|
tranzly/bulk-translate指定した投稿タイプ (指定がない場合は翻訳対象のすべてのタイプ) の各オリジナルに対して、バックグラウンド翻訳ジョブを開始します (未翻訳のみ、期限切れのみ、またはすべて)。言語ごとに開始されたジョブを1つずつ返します。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/run | edit_posts (公開する場合は publish_posts) | languages 配列 (必須)post_types 配列scope 文字列: missing、stale、allengine 文字列publish 真偽値 |
tranzly/cancel-jobジョブを停止します。すでに作成された翻訳は保持されます。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/run | manage_options (REST ルート固有のチェック) | id 文字列 (必須) |
tranzly/check-qualityAI を使って翻訳とオリジナルを比較・スコアリングし、そのレポートを翻訳データに保存します。Tranzly のワークフロー設定で指定された品質チェック用 AI モデルを使用します。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/run | その翻訳に対する edit_post | id 整数 (必須) |
tranzly/connect-supportこのサイトを Zinn Digital® サポートに接続します (名前、メール、同意)。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run | manage_options (REST ルート固有のチェック) | email 文字列 (必須)name 文字列consent 真偽値 (必須) |
tranzly/correct-segments翻訳の修正済みセグメントを保存します (segments: キーとテキストのペア)。修正されたテキストは再翻訳から保護されます。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run | edit_post (REST ルート固有のチェック) | id 文字列 (必須)segments オブジェクトtexts オブジェクト |
tranzly/create-job指定した投稿 (posts) または投稿タイプ全体を指定の言語 (langs) に翻訳するバックグラウンドジョブを開始します。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/run | edit_posts (REST ルート固有のチェック) | posts 配列post_type 文字列langs 配列 (必須)engine 文字列status 文字列: publish、draftforce 真偽値 |
tranzly/create-post-translationエンジンを使わずに手動で翻訳を作成するため、指定の言語 (lang) で投稿の下書き翻訳を作成します。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run | REST ルート固有のアイテムごとの権限チェック | id 文字列 (必須)lang 文字列 (必須)name 文字列slug 文字列description 文字列 |
tranzly/create-term-translation指定した名前、スラッグ、説明を使用して、タームの翻訳を指定の言語で作成します。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run | REST ルート固有のアイテムごとの権限チェック | id 文字列 (必須)lang 文字列 (必須)name 文字列slug 文字列description 文字列 |
tranzly/disconnect-supportこのサイトのサポート接続を解除します。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run | manage_options (REST ルート固有のチェック) | なし |
tranzly/estimate費用をかける前に、エンジンを使用して投稿 (posts または post_type) を指定の言語 (langs) に翻訳する際の文字数と費用を見積もります。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/run | edit_posts (REST ルート固有のチェック) | posts 配列post_type 文字列langs 配列 (必須)engine 文字列 |
tranzly/estimate-bulkサイト全体の翻訳を開始する前に、指定の言語への翻訳 (post_types、scope、engine) を見積もります。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/run | edit_posts (REST ルート固有のチェック) | post_types 配列scope 文字列: missing、stale、allengine 文字列lang 文字列 (必須)after 整数 |
tranzly/export-translation-file翻訳者や翻訳会社向けに、特定言語のオリジナルと翻訳データを含む XLIFF または CSV ファイル (テキスト形式) を返します。指定した投稿、または特定の状態 (missing、stale、translated、all。after で繰り返し取得) にある投稿タイプのオリジナル最大100件のページを取得します。翻訳完了後、同じファイルをインポートできます。 | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/run | edit_posts (ユーザーに編集権限がある投稿のみが含まれます) | lang 文字列 (必須)format 文字列: xliff、csvposts 配列post_type 文字列state 文字列: all、missing、stale、translatedafter 整数 |
tranzly/fix-status指定した言語と投稿タイプ内で、未翻訳または期限切れのすべての項目を翻訳キューに追加する。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/run | edit_posts (REST ルート独自のチェック) | post_type 文字列lang 文字列 (必須)state 文字列 (必須): missing、stale、quality |
tranzly/get-comments-settingコメントを言語間で共有するか、言語ごとに保持するかを返す。 | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/run | moderate_comments (REST ルート独自のチェック) | なし |
tranzly/get-deepl-usage保存されている DeepL キーの今月の使用文字数と上限を返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/get-diagnosticsサポートチケットに必要な診断情報 (バージョン、有効なプラグイン、制限、最近のエラー) を返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/get-display言語スイッチャーとクレジットの表示設定を返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/get-engine-settingsデフォルトおよびフォールバックのエンジン、言語ごとのエンジンと AI モデル、各エンジンの状態、接続された AI プロバイダーとモデル、今月の利用金額を返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/get-glossary翻訳対象外の単語、固定された用語の翻訳、言語ごとのトーンを返す。 | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/run | manage_options | なし |
tranzly/get-integrationsTranzly が対応している SEO、WooCommerce、ページビルダー、フォームプラグインの一覧と、現在有効化されているものを返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/get-job指定したジョブの進捗状況とカウントを返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/run | manage_options (REST ルート独自のチェック) | id 文字列 (必須) |
tranzly/get-job-failuresジョブで失敗した項目とその理由を一覧表示する。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/run | manage_options (REST ルート独自のチェック) | id 文字列 (必須) |
tranzly/get-legacy-importTranzly 2.x からの翻訳インポートの状態とレポートを返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/get-licenceこのサイトの Tranzly プラン、ライセンスの状態、更新日、プランに含まれる内容を返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/get-menusメニューの位置ごとに各言語で表示されるメニューを返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/run | edit_theme_options (REST ルート独自のチェック) | なし |
tranzly/get-post-group投稿の翻訳グループ (各言語のメンバー、タイトル、ステータス、編集リンク) を一覧表示する。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/run | edit_post および edit_term (REST ルート独自のチェック) | id 文字列 (必須) |
tranzly/get-quality-report翻訳の AI 品質レポート (スコアとフラグが設定されたセグメント) を返す。 | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/run | edit_post (REST ルート独自のチェック) | id 文字列 (必須) |
tranzly/get-segments確認や修正のために、翻訳のセグメントを原文と並べて返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/run | edit_post (REST ルート独自のチェック) | id 文字列 (必須) |
tranzly/get-shared-strings指定した言語のテーマやプラグインのテキスト (スコープ) とその翻訳を返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/run | edit_theme_options (REST ルート独自のチェック) | lang 文字列 (必須)scope 文字列: menus、site、templates、gettext.plugin-<slug>、gettext.theme-<slug> |
tranzly/get-site-strings指定した言語のサイトタイトル、キャッチフレーズ、ウィジェットのテキストを返す。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/run | manage_options (REST ルート独自のチェック) | lang 文字列 (必須) |
tranzly/get-support-connectionこのサイトが Zinn Digital® サポートに接続されているかどうか、およびどのアカウントとして接続されているかを表示します。 | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/run | manage_options (REST ルート独自のチェック) | refresh 真偽値 (boolean) |
tranzly/get-term-groupカテゴリーやタグの翻訳グループを一覧表示します。 | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/run | edit_post および edit_term (REST ルート独自のチェック) | id 文字列 (必須) |
tranzly/get-urlsアドレス内での言語の表示形式 (フォルダー、サブドメイン、ドメイン)、翻訳されたスラッグとベース、未翻訳ページの noindex 設定を返します。 | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/get-workflow-settings公開時および更新時の自動翻訳、公開前のレビュー、AI 品質チェックのしきい値、プロバイダー、モデルの設定を返します。 | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/import-from-source他の多言語プラグインから翻訳の次のページをインポートします (mode: dry-run または run、cursor)。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/run | manage_options (REST ルート独自のチェック) | source 文字列 (必須)mode 文字列: dry-run, run, undocursor 文字列 |
tranzly/import-translation-fileアップロードされた翻訳ファイルから次のページの投稿を書き込みます (完了するまで after を指定して繰り返します)。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run | edit_posts (REST ルート独自のチェック) | token 文字列 (必須)after 整数 |
tranzly/link-post既存の投稿 (target) を、この投稿の特定言語での翻訳として関連付けます。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/run | edit_post および edit_term (REST ルート独自のチェック) | id 文字列 (必須)lang 文字列 (必須)target 整数 (必須) |
tranzly/link-term既存のターム (target) を、このタームの特定言語での翻訳として関連付けます。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/run | edit_post および edit_term (REST ルート独自のチェック) | id 文字列 (必須)lang 文字列 (必須)target 整数 (必須) |
tranzly/list-engines翻訳エンジン、各エンジンの設定状況、および指定がない場合に使用される既定のエンジンを一覧表示します。 | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run | edit_posts | なし |
tranzly/list-import-sourcesこのサイトで見つかった、インポート可能な WPML、Polylang、TranslatePress のデータを一覧表示します。 | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/list-jobsバックグラウンドの翻訳ジョブを新しい順に進捗状況とともに一覧表示します。 | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run | edit_posts (REST ルート独自のチェック) | なし |
tranzly/list-languagesサイトの言語を一覧表示します。最初の言語が元のコンテンツが書かれている言語です。 | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run | edit_posts | なし |
tranzly/list-status-items特定言語における翻訳ステータス (state: missing, stale, current) を持つオリジナルコンテンツをページごとに一覧表示します。 | Free | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/run | edit_posts (REST ルート独自のチェック) | post_type 文字列lang 文字列 (必須)state 文字列: all, missing, stale, translated, human, machine, review, qualityafter 整数 |
tranzly/list-theme-strings翻訳対象としてテキストをスキャンできるテーマとプラグイン、およびそれぞれの文字列数を一覧表示します。 | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/open-support-ticket管理者が同意した場合、このサイトの診断情報を含めてサポートチケット (subject, message, kind, email) を送信します。ログイン情報の作成や送信は行いません。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/run | manage_options (REST ルート独自のチェック) | subject 文字列 (必須)message 文字列 (必須)kind 文字列: help, bug, feedback, feature_requestemail 文字列name 文字列diagnostics 真偽値 (boolean) |
tranzly/record-support-consentサポートチケットで診断情報を送信することに対する管理者の同意を記録します。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run | manage_options (REST ルート独自のチェック) | consent 真偽値 (boolean) (必須) |
tranzly/retry-job-item失敗した項目を再試行する (action: retry、必要に応じて別のエンジンを指定可能)、または手動翻訳用としてマークする (action: by-hand)。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run | edit_post および manage_options (REST ルート独自のチェック) | item 文字列 (必須)action 文字列 (必須)engine 文字列 |
tranzly/review-translation翻訳を承認する (元の投稿が公開されている場合は公開も行う)、または差し戻す (decision, note)。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (REST ルート独自のチェック) | id 文字列 (必須)decision 文字列 (必須): approve, changes, pendingnote 文字列 |
tranzly/run-legacy-import2.x のインポートを実行する: dry-run (レポートのみ)、run、undo。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (REST ルート独自のチェック) | action 文字列 (必須) |
tranzly/scan-theme-stringsコンポーネントの PHP ファイルの次のページをスキャンして翻訳可能なテキストを検出する (完了するまで after を指定して繰り返す)。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (REST ルート独自のチェック) | component 文字列 (必須)after 整数 |
tranzly/schedule-quality-check言語の翻訳の次のページ (または指定した投稿) に対する AI 品質チェックをスケジュールする。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (REST ルート独自のチェック) | lang 文字列 (必須)post_type 文字列posts 配列after 整数 |
tranzly/seo-audit言語ごとにページ単位で、不足している SEO タイトル、ディスクリプション、スラッグ、hreflang がないか翻訳をチェックする。 | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (REST ルート独自のチェック) | lang 文字列 (必須)after 整数 |
tranzly/set-comments-setting投稿の翻訳間でコメントを共有する、または言語ごとに保持する (mode)。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options および moderate_comments (REST ルート独自のチェック) | mode 文字列 (必須): off, show, translate |
tranzly/set-engine-keyDeepL、Google、Microsoft の API キー (および Microsoft のリージョン) を保存する。空にすると削除される。キーは暗号化して保存され、返されることはない。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (REST ルート独自のチェック) | engine 文字列 (必須)key 文字列 (必須)region 文字列 |
tranzly/set-menus位置と言語ごとにメニューを割り当てる (map)。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (REST ルート独自のチェック) | map オブジェクト (必須) |
tranzly/set-protection翻訳がエンジンによって上書きされないよう保護する (protected: true)、または保護を解除する。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (REST ルート独自のチェック) | id 文字列 (必須)protected 真偽値 (必須) |
tranzly/set-shared-stringsテーマやプラグインのテキスト (strings) の修正済み翻訳を保存する。これらは保護状態になる。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run | edit_theme_options (REST ルート独自のチェック) | lang 文字列 (必須)scope 文字列: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>strings オブジェクト (必須) |
tranzly/set-site-stringある言語のサイトテキスト (key) を1つ保存する (サイトタイトルやキャッチフレーズなど)。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run | edit_theme_options および manage_options (REST ルート独自のチェック) | lang 文字列 (必須)key 文字列 (必須)translation 文字列 (必須) |
tranzly/set-urlsアドレスモード (mode)、言語ごとのドメイン、翻訳されたベースとセグメント、noindex_untranslated、スラッグ候補を設定する。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run | manage_options (REST ルート独自のチェック) | mode 文字列segments オブジェクトdomains オブジェクトbases オブジェクトsuggest 真偽値noindex_untranslated 真偽値 |
tranzly/start-trialこのサイトで Tranzly Pro の14日間無料トライアルを開始する (支払いは不要)。 | Free | POST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run | manage_options (REST ルート独自のチェック) | なし |
tranzly/translate-media-field画像の代替テキスト、タイトル、またはキャプション (field) を指定の言語 (lang) で保存します。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/run | edit_post (REST ルート独自のチェック) | id 文字列 (必須)lang 文字列 (必須)field 文字列 (必須): alt、caption、titletranslation 文字列 (必須) |
tranzly/translate-post1件の投稿または固定ページを翻訳エンジンを使ってサイトの1つ以上の言語に翻訳し、各翻訳の新規作成または更新を行います。publish が true でない限り、新しい翻訳は下書きになります。force が true でない限り、人が編集した翻訳はスキップされます。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/run | その投稿の翻訳権限 (対象の edit_post)、既存の翻訳の edit_post、公開する場合は該当タイプの publish 権限 | id 整数 (必須)languages 配列 (必須)engine 文字列publish 真偽値force 真偽値 |
tranzly/translate-shared-strings未翻訳のテーマおよびプラグインのテキストの次のページを、デフォルトのエンジンを使って指定の言語で翻訳します (完了するまで after で繰り返します)。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run | edit_theme_options (REST ルート独自のチェック) | lang 文字列 (必須)scope 文字列: menus、site、templates、gettext.plugin-<slug>、gettext.theme-<slug>after 整数 |
tranzly/translate-siteガイド付きワークフロー: エージェントが言語とエンジンを確認し、コストを見積もり、未翻訳の箇所を翻訳します。費用発生や公開の前には確認を求めます。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/run | edit_posts | languages 文字列 (必須) |
tranzly/translate-term1件のターム (カテゴリー、タグ、または商品属性) をエンジンを使って指定の言語 (lang) に翻訳し、翻訳の新規作成または更新を行います。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | REST ルート独自の項目別権限チェック | id 文字列 (必須)lang 文字列 (必須)engine 文字列force 真偽値status 文字列: publish、draft |
tranzly/translation-status投稿 ID を指定した場合: その投稿の言語別の翻訳状況、古い状態かどうか、および作成者を表示。ID なしの場合: サイト全体の言語別翻訳状況を表示。 | 無料 | GET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run | 対象の投稿の edit_post、サイト全体のサマリーには edit_posts | id 整数post_type 文字列 |
tranzly/unlink-post投稿を翻訳グループから切り離します。言語設定は保持されます。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run | edit_post および edit_term (REST ルート独自のチェック) | id 文字列 (必須) |
tranzly/unlink-termタームを翻訳グループから切り離します。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run | edit_post および edit_term (REST ルート独自のチェック) | id 文字列 (必須) |
tranzly/update-display切り替えスイッチャー (スタイル、国旗、名称、配置) およびクレジット表記を変更します。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/run | manage_options (REST ルート独自のチェック) | switcher オブジェクトcredit 真偽値 |
tranzly/update-engine-settingsデフォルトのエンジン、フォールバックエンジン、言語別エンジン、言語別 AI モデル (default、fallback、per_lang、models、caps) を設定します。デフォルトエンジン以外は Pro 版の機能です。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run | manage_options (REST ルート独自のチェック) | default 文字列per_lang オブジェクトfallback 配列caps オブジェクトmodels オブジェクト |
tranzly/update-glossary送信された用語集の部分 (翻訳不可の単語、用語の対訳、トーン) を置き換えます。省略された部分は保持されます。次回の翻訳からすべてのエンジンで使用されます。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run | manage_options | dnt 配列terms オブジェクトtone オブジェクト |
tranzly/update-settingsサイトの言語 (languages: コードと名前のリスト。先頭が元の言語)、フロントエンドのクラス接頭辞、AI エージェント (MCP) の許可設定を行います。 | 無料 | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (REST ルート独自のチェック) | prefix 文字列mcp 真偽値languages 配列 |
tranzly/update-workflow-settingson_update (off、stale、translate)、on_publish、review、quality_threshold、quality_provider、quality_model を設定。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/run | manage_options (REST ルート固有のチェック) | on_update 文字列: off、stale、translateon_publish 真偽値review 真偽値quality_threshold 整数quality_provider 文字列quality_model 文字列 |
tranzly/upload-translation-file他で翻訳された Tranzly XLIFF または CSV ファイル (content、filename) をアップロード。インポート対象のアップロードを識別するトークンを返します。 | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run | edit_posts (REST ルート固有のチェック) | content 文字列 (必須)filename 文字列 (必須) |
プラグインの abilities.json から生成されています。このファイル自体は稼働中のサイトから生成されたものであり、両者の内容が一致しない場合はテストが失敗します。
WP-CLI コマンド
サーバー上で WP-CLI を使用してこれらを実行します。各コマンドはプラグインの管理画面と同じ権限をチェックします。例はプラグイン自身のヘルプテキストから引用されています。
| コマンド | 動作 | エディション |
|---|---|---|
wp tranzly create <id> [--term]wp tranzly create 42 --lang=de_DE --user=admin | 投稿 (またはターム) にリンクされた翻訳の下書きを作成します。 | 無料版 |
wp tranzly engines | 翻訳エンジンを一覧表示します。 | 無料版 |
wp tranzly jobs <action> [<id>...] [--lang=<codes>] [--post-type=<type>] [--engine=<id>] [--publish] [--force] [--format=<format>]wp tranzly jobs create --lang=de,fr --post-type=page --user=adminwp tranzly jobs status 12wp tranzly jobs failures 12wp tranzly jobs retry 345 --engine=deeplwp tranzly jobs retry-failed 12wp tranzly jobs run 12 # キューランナーを待たずにここでジョブを実行 | バックグラウンド翻訳ジョブを処理します。 | 無料版 |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp tranzly legacy undo | 旧バージョン (Tranzly 2.x) サイトの翻訳データのインポートを表示、テスト実行 (ドライラン)、実行、または取り消しを行います。 | 無料版 |
wp tranzly link <source> <target> [--term] | 既存の投稿 (またはターム) を別のアイテムの翻訳としてリンクします。 | 無料版 |
wp tranzly network <action> [--languages=<codes>]wp tranzly network setupwp tranzly network languages --languages=en_US,de_DE,fr_FR | マルチサイト (Agency): ネットワーク内のすべてのサイトを設定するか、新しいサイトに初期設定される言語を指定します。 | 無料版 |
wp tranzly translate [<id>...] [--post-type=<type>] [--engine=<id>] [--force] [--publish] [--dry-run]wp tranzly translate --lang=de --post-type=page --user=adminwp tranzly translate 42 43 --lang=de_DE,fr_FR --engine=deepl --user=admin | 翻訳エンジンを使用して投稿を翻訳します。 | 無料版 |
wp tranzly translations <id> [--term] [--format=<format>] | 投稿 (またはターム) の翻訳一覧を表示します。 | 無料版 |
PHP 関数
テーマや他のプラグインから呼び出すことができる関数です。プラグインが無効化されている間もコードが動作し続けるよう、あらかじめ function_exists() で確認してください。
| 関数 | 機能 | エディション |
|---|---|---|
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null ) | WPML: オブジェクトの翻訳を取得する。 | Pro |
pll__( $text ) | Polylang: 登録済み文字列を翻訳する。Tranzly は WordPress 本体の gettext 経由でテーマ文字列を翻訳するため、文字列はそのまま返されます。 | Pro |
pll_current_language( $field = 'slug' ) | Polylang: 現在の言語を取得する。 | Pro |
pll_default_language( $field = 'slug' ) | Polylang: デフォルトの言語を取得する。 | Pro |
pll_e( $text ) | Polylang: 登録済み文字列をエスケープして出力する。 | Pro |
pll_get_post( $post_id, $lang = null ) | Polylang: 投稿の翻訳を取得する。 | Pro |
pll_get_post_language( $post_id, $field = 'slug' ) | Polylang: 投稿の言語を取得する。 | Pro |
pll_get_post_translations( $post_id ) | Polylang: 投稿のすべての翻訳を取得する (スラッグ => ID)。 | Pro |
pll_get_term( $term_id, $lang = null ) | Polylang: タームの翻訳を取得する。 | Pro |
pll_get_term_language( $term_id, $field = 'slug' ) | Polylang: タームの言語を取得する。 | Pro |
pll_get_term_translations( $term_id ) | Polylang: タームのすべての翻訳を取得する (スラッグ => ID)。 | Pro |
pll_home_url( $lang = '' ) | Polylang: 指定言語のホーム URL を取得する。 | Pro |
pll_is_translated_post_type( $post_type ) | Polylang: この投稿タイプが翻訳対象か判定する。 | Pro |
pll_is_translated_taxonomy( $taxonomy ) | Polylang: このタクソノミーが翻訳対象か判定する。 | Pro |
pll_languages_list( $args = array( ) | Polylang: 言語の一覧を取得する。 | Pro |
pll_register_string() | Polylang: 文字列を登録する (引数は受け付けられますが無視されます — pll__() を参照)。 | Pro |
pll_the_languages( $args = array( ) | Polylang: 言語スイッチャーを表示する。`raw` は Polylang の配列 (スラッグ => 詳細) を返します。それ以外の場合は Polylang のマークアップによる `<li>` リストを返します (`echo` が 0 でない限り出力)。`hide_current`、`hide_if_no_translation`、`display_names_as` (`name` または `slug`) に対応。`dropdown` はリストとしてレンダリングされます。ドロップダウンには Tranzly 独自のスイッチャーブロックまたはウィジェットを使用してください。 | Pro |
pll_translate_string( $text ) | Polylang: 指定言語の登録済み文字列を取得する。pll__() と同様に、文字列はそのまま返されます。 | Pro |
tranzly_compat_field( string $code, string $field ) | Polylang の仕様に基づく言語の特定フィールドを取得する。 | Pro |
tranzly_current_language(): string | 現在のリクエストの言語 (WordPress ロケールコード: `ja` や `fr_FR` など) を取得する。 | 無料版 |
tranzly_default_language(): string | デフォルトの言語 (先頭に登録された言語) を取得する。 | 無料版 |
tranzly_get_engines(): array | 利用可能なエンジン (ID => 名前) を取得する。 | 無料版 |
tranzly_get_post_language( int $post_id ): string | 投稿が記述されている言語を取得する。 | 無料版 |
tranzly_get_term_language( int $term_id ): string | タームが記述されている言語を取得する。 | 無料版 |
tranzly_get_term_translation( int $term_id, string $lang ): ?int | タームの指定言語への翻訳 ID または null を取得する。 | 無料版 |
tranzly_get_term_translations( int $term_id ): array | タームのすべてのバージョン (言語コード => ターム ID) を取得する。 | 無料版 |
tranzly_get_translation( int $post_id, string $lang ): ?int | 投稿の指定言語への翻訳 ID または null (存在しない場合) を取得する。投稿自体がすでにその言語で書かれている場合は、その投稿の ID を返します。 | 無料版 |
tranzly_get_translations( int $post_id ): array | 投稿自体を含むすべてのバージョン (言語コード => 投稿 ID) を取得する。翻訳のない投稿の場合は、その言語での自身のみを返します。 | 無料版 |
tranzly_language_switcher( array $args = array( ) | 任意のテーマ、ビルダー、プラグイン向けの言語スイッチャーの HTML (T5)。Page Builder Sandwich の要素でも呼び出されており、独自の実装でも利用可能です。言語が2つ未満の場合は空になります。 | 無料版 |
tranzly_language_url( string $lang, ?string $url = null ): string | 指定した言語を表示する URL を取得する。 | 無料版 |
tranzly_languages(): array | サイトの言語一覧 (デフォルトが先頭) を取得する。 | 無料版 |
tranzly_register_engine( Engine $engine ) | 翻訳エンジンを追加する。`tranzly_register_engines` フック内、またはリクエストの最初の翻訳が行われる前の任意のタイミングで呼び出します。 | 無料版 |
tranzly_restore_language(): bool | 直前の tranzly_switch_language() を元に戻す。 | 無料版 |
tranzly_switch_language( string $lang ): bool | tranzly_restore_language() が呼ばれるまで、別の言語でコードを実行する。現在の言語と WordPress 本体の翻訳の両方が切り替わります。switch_to_blog() のようにネスト可能です。 | 無料版 |
tranzly_translatable_attributes( string $block_name ): array | ブロックタイプに対して Tranzly が翻訳する属性名 (`block.json` の `role: content`、`tranzly_translatable_attributes` フィルターで調整可能) を取得する。 | 無料版 |
tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( ) | 現在のユーザーとして (その権限が適用されます)、エンジンを使用して投稿を指定した言語に翻訳します。 | 無料 |
アクションとフィルター
プラグインが提供するすべてのフックと、そのソースコードからの説明です。フィルターは値を変更し、アクションは特定のタイミングでコードを実行できるようにし、エントリーポイントはプラグインに処理を要求するためにトリガーするアクションです。
| フック | 種類 | 機能 | パラメーター | エディション |
|---|---|---|---|---|
tranzly_admin_bar | アクション | 翻訳管理バーメニューの構築後に実行 (Pro ビジュアルエディターはこのフックで「このページで翻訳」項目を追加)。 | \WP_Admin_Bar $barint $id | Free |
tranzly_admin_data | フィルター | 管理アプリの起動時に読み込まれるデータをフィルター。プレミアムレイヤーはエディションのレポートに使用。ページ内に出力されるため機密情報は含めないでください。 | なし | Free |
tranzly_ai_model | フィルター | 特定の言語への翻訳に使用する AI プロバイダーとモデルをフィルター。Free 版: 全言語共通で `translate` タスクに選択されたプロバイダーとモデル。Tranzly Pro: 言語ごとの設定、または「他のすべての言語」の設定。 | string $target | Free |
tranzly_ai_providers_in_use | フィルター | 特定の言語に選択された AI プロバイダーをフィルター。無料プラグインでは該当なし (すべての言語で `translate` タスクに選択されたプロバイダーとモデルを使用)。Tranzly Pro では言語ごとのモデルのプロバイダーを一覧表示。 | なし | Free |
tranzly_content_before_rebuild | フィルター | 翻訳済みセグメントが書き込まれる直前の元コンテンツを言語ごとにフィルター (Pro の言語ごとの画像差し替え機能で使用)。 | string $contentstring $lang | Free |
tranzly_copy_meta_keys | フィルター | 投稿から新しい翻訳へコピーするメタキーをフィルター。それ以外はコピーされません。 | int $source_id | Free |
tranzly_deepl_host | フィルター | DeepL API ホスト (プロキシまたはテストダブル) をフィルター。 | string $hoststring $key | Free |
tranzly_deepl_price_per_million | フィルター | DeepL の100万文字あたりの料金 (米ドル) をフィルター。 | float $price | Free |
tranzly_default_engine | フィルター | 指定がない場合に使用されるエンジンの ID をフィルター。 | string $id | Free |
tranzly_engine_cap | フィルター | エンジンの月額上限 (米ドル) をフィルター。無料プラグインでは設定なし。 | float|null $capstring $engine | Free |
tranzly_engine_chain | フィルター | 言語ごとに試行するエンジンの順序をフィルター。Free 版: デフォルトのエンジン。プレミアムレイヤーでは、言語固有のエンジンとフォールバックリストを追加。 | string $langstring $first | Free |
tranzly_engine_options | フィルター | エンジンに渡すオプション (翻訳対象外リスト、用語集、表記の丁寧さ、指示) をフィルター。 | string $targetEngine $engine | Free |
tranzly_engine_settings_save | フィルター | 言語ごとのエンジン、AI モデル、フォールバックリスト、月額上限を保存。プレミアムレイヤーのみが応答 (WordPress.org ガイドライン 5: 無料プラグイン内での Pro 動作禁止)。 | なし | Free |
tranzly_frontend_prefix | フィルター | フロントエンドのニュートラルなクラスプレフィックスをフィルター。 | string $prefix | Free |
tranzly_fs_loaded | アクション | ライセンス SDK の読み込み完了時に実行 (メインファイル内、Tranzly のコード実行前)。`tranzly_fs()` と通信するフック先。 | なし | Free |
tranzly_glossary_options | フィルター | 対象言語のエンジンオプション (翻訳対象外リスト、およびプレミアムレイヤー追加時の用語集とトーン) をフィルター。 | string $lang | Free |
tranzly_glossary_save | フィルター | 言語ごとの優先翻訳とトーンを保存。プレミアムレイヤーのみが応答 (WordPress.org ガイドライン 5: 無料プラグイン内での Pro 動作禁止)。 | なし | Free |
tranzly_google_price_per_million | フィルター | Google Cloud Translation の100万文字あたりの料金 (米ドル) をフィルター。 | float $price | Pro |
tranzly_install_language_packs | フィルター | サイトに追加された言語の WordPress、テーマ、プラグインの言語パックを Tranzly がインストールするかどうか (WordPress や WooCommerce 本体のテキストを翻訳して表示するため)。初期状態は有効。 | bool $install | Free |
tranzly_integration_available | フィルター | プラグインが検出されない場合に連携を実行するかどうかをフィルター (ビルダー停止後に残ったコンテンツや、通常とは異なる方法で読み込まれたプラグインに対応)。 | bool $onstring $id | Free |
tranzly_integrations | フィルター | Tranzly が実行する連携機能をフィルター。他のプラグインをサポートするには `Integration` のサブクラスを追加。 | なし | Free |
tranzly_is_pro | フィルター | プレミアムレイヤーが実行中かどうかをフィルター。プレミアムレイヤーのみが応答。 | bool $pro | Free |
tranzly_job_created | アクション | 翻訳ジョブの作成後に実行。 | int $jobint $items | Free |
tranzly_job_finished | アクション | 翻訳ジョブの残り作業がなくなったときに実行します。 | int $job_id | 無料版 |
tranzly_kit_api_base | フィルター | サポート画面が呼び出す Zinn Digital® API のベース URL をフィルターします。 | string $base | 無料版 |
tranzly_kit_diagnostics | フィルター | サイト所有者に表示される前の診断情報をフィルターします。プラグインは `extra` 配下に独自の情報を追加します。⛔ この処理はプレビューの前に実行され、プレビューと送信の間で実行されることはありません。 | なし | 無料版 |
tranzly_kit_footprint_free | フィルター | このサイトがフットプリントフリーである (Zinn® Ads が宣伝されない) かどうかをフィルターします。 | bool $footprint_free | 無料版 |
tranzly_kit_promotions | フィルター | 解決される前のプロモーションレジストリをフィルターします。別の製品を宣伝するには行を追加します: `id`、`kind` (hosting|marketplace|platform|plugin|bundle|ads)、`slot` (promo|cross-sell)、および `url` または (プラグインの場合) `name`、`site`、`main_files`。 | なし | 無料版 |
tranzly_kit_tier | フィルター | キットがこのプラグインに報告するプランティアをフィルターします (テストおよびステージング環境用。本番環境ではライセンスによって決まります)。 | string $tier | 無料版 |
tranzly_localize_links | フィルター | Tranzly がこのページの内部リンクを翻訳先に向けるかどうかをフィルターします。 | bool $localizestring $lang | 無料版 |
tranzly_memory_enabled | フィルター | 翻訳メモリを使用するかどうかをフィルターします。 | bool $on | Pro 版 |
tranzly_microsoft_price_per_million | フィルター | Microsoft Translator の100万文字あたりの価格 (米ドル) をフィルターします。 | float $price | Pro 版 |
tranzly_network_enabled | フィルター | マルチサイトネットワーク層が有効かどうかをフィルターします。 | bool $agency | 無料版 |
tranzly_pbs_internal_post_types | フィルター | Tranzly が処理対象外とする Page Builder Sandwich の投稿タイプをフィルターします。 | なし | 無料版 |
tranzly_post_segments | フィルター | エンジンに送信される投稿のセグメントをフィルターします。キー => `text` + `format` (`text` または `html`)。ブロック対応パーサーと連携機能がここでセグメントの追加、分割、置換を行い、`tranzly_translated_post_fields` に書き戻します。 | \WP_Post $post | 無料版 |
tranzly_post_translated | アクション | エンジンが投稿を翻訳した後 (または手動ファイルやインポートによって書き込まれた後) に実行します。 | int $targetint $source_idstring $codestring $engine | 無料版 |
tranzly_post_translation_created | アクション | Tranzly が投稿の翻訳を作成した後に実行します。 | int $new_idint $source_idstring $code | 無料版 |
tranzly_post_types | フィルター | Tranzly が翻訳する投稿タイプをフィルターします。 | なし | 無料版 |
tranzly_pre_current_language | フィルター | 現在の言語をショートサーキットします。言語コードを返すとその言語を使用します。これは tranzly_switch_language() の仕組みです。null を返すと Tranzly に判定を任せます。 | string|null $lang | 無料版 |
tranzly_query_var | フィルター | 言語を選択するクエリ変数をフィルターします。 | string $var | 無料版 |
tranzly_queue_lease_seconds | フィルター | 処理中のアイテムのリースタイムをフィルターします。この時間を過ぎると、アイテム処理中に停止したワーカーは他のワーカーにアイテムを返却します。最も遅い単一翻訳よりも長い時間を指定してください。 | int $seconds | 無料版 |
tranzly_queue_worker_seconds | フィルター | 1つのワーカーが引き継ぐまでに実行される秒数をフィルターします。 | int $seconds | 無料版 |
tranzly_queue_workers | フィルター | 1つのジョブが同時に実行するワーカー数をフィルターします。翻訳サービスに負荷をかけすぎないためのワーカー数の上限であり、処理されるアイテム数の上限ではありません。 | int $workersint $job_id | 無料版 |
tranzly_rate_source_ | フィルター | 別のソースからのレート (`tranzly_rate_sources` を参照)。 | なし | Pro 版 |
tranzly_rate_sources | フィルター | 為替レートの取得元をフィルターします。`[ code => rate against its reference ]` または WP_Error を返す `tranzly_rate_source_<id>` フィルターを使って追加します。 | なし | Pro 版 |
tranzly_register_engines | アクション | 翻訳エンジンを登録します。`$registry->add( new Your_Engine() )` を呼び出します。 | Registry $registry | 無料版 |
tranzly_relations_changed | アクション | オブジェクトの翻訳リンクが変更された後 (リンク、リンク解除、別言語への移動、削除) に実行します。影響を受けるグループごとに1回実行されるため、1つのリンク操作で2回実行される場合があります。 | string $typearray<int> $ids | 無料版 |
tranzly_robots_meta_keys | フィルター | robots 設定を保持する投稿メタキーをフィルターします。各設定はオリジナルからその翻訳へと引き継がれます。 | なし | 無料版 |
tranzly_shared_string_scopes | フィルター | 共有テキストのスコープをフィルターします (レーン L06、T6: 連携機能により `woocommerce`、`forms`、`theme` が追加され、そのテキストは `tranzly_shared_strings` で渡されます)。 | なし | 無料 |
tranzly_shared_strings | フィルター | Tranzly が文字列として翻訳する共有テキストをスコープごとにフィルターします。Pro 版では、ブロックテンプレート、テンプレートパーツ、パターンが `templates` に追加されます。 | string $scope | 無料 |
tranzly_shared_strings_covered | フィルター | 言語パックがある言語向けに翻訳する共有テキストスコープのテキストをフィルターします。Pro 版では、テーマおよびコアの登録済みパターンが `templates` 向けに通知されます。 | string $scopestring $lang | 無料 |
tranzly_source_changed | アクション | 原文の翻訳対象コンテンツが変更され、既存の翻訳が古い状態になったときに実行します。 | int $post_idstring $nowstring $before | 無料 |
tranzly_source_meta_keys | フィルター | 変更によってページの翻訳が古い状態になるメタキーをフィルターします。連携機能により、翻訳対象のキー (ビルダーのデータ、SEO フィールド、カスタムフィールド) が追加されます。 | int $post_id | 無料 |
tranzly_source_published | アクション | 原文が最初に公開されたとき (メタデータ保存後) に一度だけ実行します。 | int $post_id | 無料 |
tranzly_style_rules_enabled | フィルター | 各言語の WordPress.org 翻訳チームのスタイルルール (引用符、約物の前後のスペース、アポストロフィ、リーダー記号、日本語のスペース、二人称代名詞) を新規翻訳に適用するかどうか。初期状態では有効です。 | bool $enabledstring $locale | 無料 |
tranzly_taxonomies | フィルター | Tranzly が翻訳するタクソノミーをフィルターします。 | なし | 無料 |
tranzly_term_segments | フィルター | エンジンに送信するタームのセグメント (`name`、`description`、および連携機能が追加する SEO タイトルやカスタムフィールドなど) をフィルターします。追加したセグメントは `tranzly_term_translated` で書き込みます。 | \WP_Term $term | 無料 |
tranzly_term_translated | アクション | エンジンがタームを翻訳した後に、すべての翻訳済みセグメントとともに実行します (連携機能によって `tranzly_term_segments` で追加されたセグメントが書き込まれます)。 | int $targetint $term_idstring $code | 無料 |
tranzly_term_translation_created | アクション | Tranzly がタームの翻訳を作成した後に実行します。 | int $new_idint $term_idstring $code | 無料 |
tranzly_translatable_attributes | フィルター | Tranzly がブロックタイプ向けに翻訳する属性をフィルターします。 | string $block_name | 無料 |
tranzly_translate_string | フィルター | 1つの翻訳対象文字列を指定の言語向けにフィルターします。 | string $valuestring $codearray $context | 無料 |
tranzly_translated_post_fields | フィルター | エンジンの実行後、翻訳に書き込まれる投稿フィールドをフィルターします。独自セグメント (カスタムフィールド、ビルダーデータ) を追加した連携機能は、ここで書き込みを行います。 | \WP_Post $poststring $code | 無料 |
tranzly_translation_memory | フィルター | 使用中の翻訳メモリをフィルターします。無料版プラグインには含まれません。有料版で利用可能です (docs/843、WordPress.org ガイドライン 5)。 | Translation_Memory|null $memory | 無料 |