開発者

Tranzly アビリティリファレンス

Tranzly は自身のアクションを WordPress Abilities API に登録します。同一のアビリティは、サイト自身のサーバー上の MCP ツールとして、また /wp-json/wp-abilities/v1 以下の REST ルートとして利用できます。このページはプラグイン自身のレジストリから生成されています。

ユーザーガイド: AI アプリを接続する

エンドポイント

アビリティ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つずつ返します。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/runedit_posts (公開する場合は publish_posts)languages 配列 (必須)
post_types 配列
scope 文字列: missing、stale、all
engine 文字列
publish 真偽値
tranzly/cancel-job
ジョブを停止します。すでに作成された翻訳は保持されます。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/runmanage_options (REST ルート固有のチェック)id 文字列 (必須)
tranzly/check-quality
AI を使って翻訳とオリジナルを比較・スコアリングし、そのレポートを翻訳データに保存します。Tranzly のワークフロー設定で指定された品質チェック用 AI モデルを使用します。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/runその翻訳に対する edit_postid 整数 (必須)
tranzly/connect-support
このサイトを Zinn Digital® サポートに接続します (名前、メール、同意)。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/runmanage_options (REST ルート固有のチェック)email 文字列 (必須)
name 文字列
consent 真偽値 (必須)
tranzly/correct-segments
翻訳の修正済みセグメントを保存します (segments: キーとテキストのペア)。修正されたテキストは再翻訳から保護されます。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/runedit_post (REST ルート固有のチェック)id 文字列 (必須)
segments オブジェクト
texts オブジェクト
tranzly/create-job
指定した投稿 (posts) または投稿タイプ全体を指定の言語 (langs) に翻訳するバックグラウンドジョブを開始します。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/runedit_posts (REST ルート固有のチェック)posts 配列
post_type 文字列
langs 配列 (必須)
engine 文字列
status 文字列: publish、draft
force 真偽値
tranzly/create-post-translation
エンジンを使わずに手動で翻訳を作成するため、指定の言語 (lang) で投稿の下書き翻訳を作成します。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/runREST ルート固有のアイテムごとの権限チェックid 文字列 (必須)
lang 文字列 (必須)
name 文字列
slug 文字列
description 文字列
tranzly/create-term-translation
指定した名前、スラッグ、説明を使用して、タームの翻訳を指定の言語で作成します。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/runREST ルート固有のアイテムごとの権限チェックid 文字列 (必須)
lang 文字列 (必須)
name 文字列
slug 文字列
description 文字列
tranzly/disconnect-support
このサイトのサポート接続を解除します。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/runmanage_options (REST ルート固有のチェック)なし
tranzly/estimate
費用をかける前に、エンジンを使用して投稿 (posts または post_type) を指定の言語 (langs) に翻訳する際の文字数と費用を見積もります。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/runedit_posts (REST ルート固有のチェック)posts 配列
post_type 文字列
langs 配列 (必須)
engine 文字列
tranzly/estimate-bulk
サイト全体の翻訳を開始する前に、指定の言語への翻訳 (post_types、scope、engine) を見積もります。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/runedit_posts (REST ルート固有のチェック)post_types 配列
scope 文字列: missing、stale、all
engine 文字列
lang 文字列 (必須)
after 整数
tranzly/export-translation-file
翻訳者や翻訳会社向けに、特定言語のオリジナルと翻訳データを含む XLIFF または CSV ファイル (テキスト形式) を返します。指定した投稿、または特定の状態 (missing、stale、translated、all。after で繰り返し取得) にある投稿タイプのオリジナル最大100件のページを取得します。翻訳完了後、同じファイルをインポートできます。
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/runedit_posts (ユーザーに編集権限がある投稿のみが含まれます)lang 文字列 (必須)
format 文字列: xliff、csv
posts 配列
post_type 文字列
state 文字列: all、missing、stale、translated
after 整数
tranzly/fix-status
指定した言語と投稿タイプ内で、未翻訳または期限切れのすべての項目を翻訳キューに追加する。
無料POST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/runedit_posts (REST ルート独自のチェック)post_type 文字列
lang 文字列 (必須)
state 文字列 (必須): missing、stale、quality
tranzly/get-comments-setting
コメントを言語間で共有するか、言語ごとに保持するかを返す。
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/runmoderate_comments (REST ルート独自のチェック)なし
tranzly/get-deepl-usage
保存されている DeepL キーの今月の使用文字数と上限を返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/runmanage_options (REST ルート独自のチェック)なし
tranzly/get-diagnostics
サポートチケットに必要な診断情報 (バージョン、有効なプラグイン、制限、最近のエラー) を返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/runmanage_options (REST ルート独自のチェック)なし
tranzly/get-display
言語スイッチャーとクレジットの表示設定を返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/runmanage_options (REST ルート独自のチェック)なし
tranzly/get-engine-settings
デフォルトおよびフォールバックのエンジン、言語ごとのエンジンと AI モデル、各エンジンの状態、接続された AI プロバイダーとモデル、今月の利用金額を返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/runmanage_options (REST ルート独自のチェック)なし
tranzly/get-glossary
翻訳対象外の単語、固定された用語の翻訳、言語ごとのトーンを返す。
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/runmanage_optionsなし
tranzly/get-integrations
Tranzly が対応している SEO、WooCommerce、ページビルダー、フォームプラグインの一覧と、現在有効化されているものを返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/runmanage_options (REST ルート独自のチェック)なし
tranzly/get-job
指定したジョブの進捗状況とカウントを返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/runmanage_options (REST ルート独自のチェック)id 文字列 (必須)
tranzly/get-job-failures
ジョブで失敗した項目とその理由を一覧表示する。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/runmanage_options (REST ルート独自のチェック)id 文字列 (必須)
tranzly/get-legacy-import
Tranzly 2.x からの翻訳インポートの状態とレポートを返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/runmanage_options (REST ルート独自のチェック)なし
tranzly/get-licence
このサイトの Tranzly プラン、ライセンスの状態、更新日、プランに含まれる内容を返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/runmanage_options (REST ルート独自のチェック)なし
tranzly/get-menus
メニューの位置ごとに各言語で表示されるメニューを返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/runedit_theme_options (REST ルート独自のチェック)なし
tranzly/get-post-group
投稿の翻訳グループ (各言語のメンバー、タイトル、ステータス、編集リンク) を一覧表示する。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/runedit_post および edit_term (REST ルート独自のチェック)id 文字列 (必須)
tranzly/get-quality-report
翻訳の AI 品質レポート (スコアとフラグが設定されたセグメント) を返す。
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/runedit_post (REST ルート独自のチェック)id 文字列 (必須)
tranzly/get-segments
確認や修正のために、翻訳のセグメントを原文と並べて返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/runedit_post (REST ルート独自のチェック)id 文字列 (必須)
tranzly/get-shared-strings
指定した言語のテーマやプラグインのテキスト (スコープ) とその翻訳を返す。
無料GET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/runedit_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/runmanage_options (REST ルート独自のチェック)lang 文字列 (必須)
tranzly/get-support-connection
このサイトが Zinn Digital® サポートに接続されているかどうか、およびどのアカウントとして接続されているかを表示します。
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/runmanage_options (REST ルート独自のチェック)refresh 真偽値 (boolean)
tranzly/get-term-group
カテゴリーやタグの翻訳グループを一覧表示します。
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/runedit_post および edit_term (REST ルート独自のチェック)id 文字列 (必須)
tranzly/get-urls
アドレス内での言語の表示形式 (フォルダー、サブドメイン、ドメイン)、翻訳されたスラッグとベース、未翻訳ページの noindex 設定を返します。
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/runmanage_options (REST ルート独自のチェック)なし
tranzly/get-workflow-settings
公開時および更新時の自動翻訳、公開前のレビュー、AI 品質チェックのしきい値、プロバイダー、モデルの設定を返します。
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/runmanage_options (REST ルート独自のチェック)なし
tranzly/import-from-source
他の多言語プラグインから翻訳の次のページをインポートします (mode: dry-run または run、cursor)。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/runmanage_options (REST ルート独自のチェック)source 文字列 (必須)
mode 文字列: dry-run, run, undo
cursor 文字列
tranzly/import-translation-file
アップロードされた翻訳ファイルから次のページの投稿を書き込みます (完了するまで after を指定して繰り返します)。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/runedit_posts (REST ルート独自のチェック)token 文字列 (必須)
after 整数
tranzly/link-post
既存の投稿 (target) を、この投稿の特定言語での翻訳として関連付けます。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/runedit_post および edit_term (REST ルート独自のチェック)id 文字列 (必須)
lang 文字列 (必須)
target 整数 (必須)
tranzly/link-term
既存のターム (target) を、このタームの特定言語での翻訳として関連付けます。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/runedit_post および edit_term (REST ルート独自のチェック)id 文字列 (必須)
lang 文字列 (必須)
target 整数 (必須)
tranzly/list-engines
翻訳エンジン、各エンジンの設定状況、および指定がない場合に使用される既定のエンジンを一覧表示します。
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/runedit_postsなし
tranzly/list-import-sources
このサイトで見つかった、インポート可能な WPML、Polylang、TranslatePress のデータを一覧表示します。
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/runmanage_options (REST ルート独自のチェック)なし
tranzly/list-jobs
バックグラウンドの翻訳ジョブを新しい順に進捗状況とともに一覧表示します。
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/runedit_posts (REST ルート独自のチェック)なし
tranzly/list-languages
サイトの言語を一覧表示します。最初の言語が元のコンテンツが書かれている言語です。
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/runedit_postsなし
tranzly/list-status-items
特定言語における翻訳ステータス (state: missing, stale, current) を持つオリジナルコンテンツをページごとに一覧表示します。
FreeGET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/runedit_posts (REST ルート独自のチェック)post_type 文字列
lang 文字列 (必須)
state 文字列: all, missing, stale, translated, human, machine, review, quality
after 整数
tranzly/list-theme-strings
翻訳対象としてテキストをスキャンできるテーマとプラグイン、およびそれぞれの文字列数を一覧表示します。
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/runmanage_options (REST ルート独自のチェック)なし
tranzly/open-support-ticket
管理者が同意した場合、このサイトの診断情報を含めてサポートチケット (subject, message, kind, email) を送信します。ログイン情報の作成や送信は行いません。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/runmanage_options (REST ルート独自のチェック)subject 文字列 (必須)
message 文字列 (必須)
kind 文字列: help, bug, feedback, feature_request
email 文字列
name 文字列
diagnostics 真偽値 (boolean)
tranzly/record-support-consent
サポートチケットで診断情報を送信することに対する管理者の同意を記録します。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/runmanage_options (REST ルート独自のチェック)consent 真偽値 (boolean) (必須)
tranzly/retry-job-item
失敗した項目を再試行する (action: retry、必要に応じて別のエンジンを指定可能)、または手動翻訳用としてマークする (action: by-hand)。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/runedit_post および manage_options (REST ルート独自のチェック)item 文字列 (必須)
action 文字列 (必須)
engine 文字列
tranzly/review-translation
翻訳を承認する (元の投稿が公開されている場合は公開も行う)、または差し戻す (decision, note)。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/runedit_post (REST ルート独自のチェック)id 文字列 (必須)
decision 文字列 (必須): approve, changes, pending
note 文字列
tranzly/run-legacy-import
2.x のインポートを実行する: dry-run (レポートのみ)、run、undo。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/runmanage_options (REST ルート独自のチェック)action 文字列 (必須)
tranzly/scan-theme-strings
コンポーネントの PHP ファイルの次のページをスキャンして翻訳可能なテキストを検出する (完了するまで after を指定して繰り返す)。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/runmanage_options (REST ルート独自のチェック)component 文字列 (必須)
after 整数
tranzly/schedule-quality-check
言語の翻訳の次のページ (または指定した投稿) に対する AI 品質チェックをスケジュールする。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/runedit_posts (REST ルート独自のチェック)lang 文字列 (必須)
post_type 文字列
posts 配列
after 整数
tranzly/seo-audit
言語ごとにページ単位で、不足している SEO タイトル、ディスクリプション、スラッグ、hreflang がないか翻訳をチェックする。
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/runmanage_options (REST ルート独自のチェック)lang 文字列 (必須)
after 整数
tranzly/set-comments-setting
投稿の翻訳間でコメントを共有する、または言語ごとに保持する (mode)。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/runmanage_options および moderate_comments (REST ルート独自のチェック)mode 文字列 (必須): off, show, translate
tranzly/set-engine-key
DeepL、Google、Microsoft の API キー (および Microsoft のリージョン) を保存する。空にすると削除される。キーは暗号化して保存され、返されることはない。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/runmanage_options (REST ルート独自のチェック)engine 文字列 (必須)
key 文字列 (必須)
region 文字列
tranzly/set-menus
位置と言語ごとにメニューを割り当てる (map)。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/runedit_theme_options (REST ルート独自のチェック)map オブジェクト (必須)
tranzly/set-protection
翻訳がエンジンによって上書きされないよう保護する (protected: true)、または保護を解除する。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/runedit_post (REST ルート独自のチェック)id 文字列 (必須)
protected 真偽値 (必須)
tranzly/set-shared-strings
テーマやプラグインのテキスト (strings) の修正済み翻訳を保存する。これらは保護状態になる。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/runedit_theme_options (REST ルート独自のチェック)lang 文字列 (必須)
scope 文字列: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
strings オブジェクト (必須)
tranzly/set-site-string
ある言語のサイトテキスト (key) を1つ保存する (サイトタイトルやキャッチフレーズなど)。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/runedit_theme_options および manage_options (REST ルート独自のチェック)lang 文字列 (必須)
key 文字列 (必須)
translation 文字列 (必須)
tranzly/set-urls
アドレスモード (mode)、言語ごとのドメイン、翻訳されたベースとセグメント、noindex_untranslated、スラッグ候補を設定する。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/runmanage_options (REST ルート独自のチェック)mode 文字列
segments オブジェクト
domains オブジェクト
bases オブジェクト
suggest 真偽値
noindex_untranslated 真偽値
tranzly/start-trial
このサイトで Tranzly Pro の14日間無料トライアルを開始する (支払いは不要)。
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/runmanage_options (REST ルート独自のチェック)なし
tranzly/translate-media-field
画像の代替テキスト、タイトル、またはキャプション (field) を指定の言語 (lang) で保存します。
無料POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/runedit_post (REST ルート独自のチェック)id 文字列 (必須)
lang 文字列 (必須)
field 文字列 (必須): alt、caption、title
translation 文字列 (必須)
tranzly/translate-post
1件の投稿または固定ページを翻訳エンジンを使ってサイトの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/runedit_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/runedit_postslanguages 文字列 (必須)
tranzly/translate-term
1件のターム (カテゴリー、タグ、または商品属性) をエンジンを使って指定の言語 (lang) に翻訳し、翻訳の新規作成または更新を行います。
無料POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/runREST ルート独自の項目別権限チェック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_postsid 整数
post_type 文字列
tranzly/unlink-post
投稿を翻訳グループから切り離します。言語設定は保持されます。
無料POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/runedit_post および edit_term (REST ルート独自のチェック)id 文字列 (必須)
tranzly/unlink-term
タームを翻訳グループから切り離します。
無料POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/runedit_post および edit_term (REST ルート独自のチェック)id 文字列 (必須)
tranzly/update-display
切り替えスイッチャー (スタイル、国旗、名称、配置) およびクレジット表記を変更します。
無料POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/runmanage_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/runmanage_options (REST ルート独自のチェック)default 文字列
per_lang オブジェクト
fallback 配列
caps オブジェクト
models オブジェクト
tranzly/update-glossary
送信された用語集の部分 (翻訳不可の単語、用語の対訳、トーン) を置き換えます。省略された部分は保持されます。次回の翻訳からすべてのエンジンで使用されます。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/runmanage_optionsdnt 配列
terms オブジェクト
tone オブジェクト
tranzly/update-settings
サイトの言語 (languages: コードと名前のリスト。先頭が元の言語)、フロントエンドのクラス接頭辞、AI エージェント (MCP) の許可設定を行います。
無料POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/runmanage_options (REST ルート独自のチェック)prefix 文字列
mcp 真偽値
languages 配列
tranzly/update-workflow-settings
on_update (off、stale、translate)、on_publish、review、quality_threshold、quality_provider、quality_model を設定。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/runmanage_options (REST ルート固有のチェック)on_update 文字列: off、stale、translate
on_publish 真偽値
review 真偽値
quality_threshold 整数
quality_provider 文字列
quality_model 文字列
tranzly/upload-translation-file
他で翻訳された Tranzly XLIFF または CSV ファイル (content、filename) をアップロード。インポート対象のアップロードを識別するトークンを返します。
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/runedit_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=admin
wp tranzly jobs status 12
wp tranzly jobs failures 12
wp tranzly jobs retry 345 --engine=deepl
wp tranzly jobs retry-failed 12
wp tranzly jobs run 12 # キューランナーを待たずにここでジョブを実行
バックグラウンド翻訳ジョブを処理します。無料版
wp tranzly legacy <action> [--format=<format>]
wp tranzly legacy dry-run
wp tranzly legacy run
wp tranzly legacy undo
旧バージョン (Tranzly 2.x) サイトの翻訳データのインポートを表示、テスト実行 (ドライラン)、実行、または取り消しを行います。無料版
wp tranzly link <source> <target> [--term]既存の投稿 (またはターム) を別のアイテムの翻訳としてリンクします。無料版
wp tranzly network <action> [--languages=<codes>]
wp tranzly network setup
wp 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=admin
wp 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 ): booltranzly_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 $bar
int $id
Free
tranzly_admin_dataフィルター管理アプリの起動時に読み込まれるデータをフィルター。プレミアムレイヤーはエディションのレポートに使用。ページ内に出力されるため機密情報は含めないでください。なしFree
tranzly_ai_modelフィルター特定の言語への翻訳に使用する AI プロバイダーとモデルをフィルター。Free 版: 全言語共通で `translate` タスクに選択されたプロバイダーとモデル。Tranzly Pro: 言語ごとの設定、または「他のすべての言語」の設定。string $targetFree
tranzly_ai_providers_in_useフィルター特定の言語に選択された AI プロバイダーをフィルター。無料プラグインでは該当なし (すべての言語で `translate` タスクに選択されたプロバイダーとモデルを使用)。Tranzly Pro では言語ごとのモデルのプロバイダーを一覧表示。なしFree
tranzly_content_before_rebuildフィルター翻訳済みセグメントが書き込まれる直前の元コンテンツを言語ごとにフィルター (Pro の言語ごとの画像差し替え機能で使用)。string $content
string $lang
Free
tranzly_copy_meta_keysフィルター投稿から新しい翻訳へコピーするメタキーをフィルター。それ以外はコピーされません。int $source_idFree
tranzly_deepl_hostフィルターDeepL API ホスト (プロキシまたはテストダブル) をフィルター。string $host
string $key
Free
tranzly_deepl_price_per_millionフィルターDeepL の100万文字あたりの料金 (米ドル) をフィルター。float $priceFree
tranzly_default_engineフィルター指定がない場合に使用されるエンジンの ID をフィルター。string $idFree
tranzly_engine_capフィルターエンジンの月額上限 (米ドル) をフィルター。無料プラグインでは設定なし。float|null $cap
string $engine
Free
tranzly_engine_chainフィルター言語ごとに試行するエンジンの順序をフィルター。Free 版: デフォルトのエンジン。プレミアムレイヤーでは、言語固有のエンジンとフォールバックリストを追加。string $lang
string $first
Free
tranzly_engine_optionsフィルターエンジンに渡すオプション (翻訳対象外リスト、用語集、表記の丁寧さ、指示) をフィルター。string $target
Engine $engine
Free
tranzly_engine_settings_saveフィルター言語ごとのエンジン、AI モデル、フォールバックリスト、月額上限を保存。プレミアムレイヤーのみが応答 (WordPress.org ガイドライン 5: 無料プラグイン内での Pro 動作禁止)。なしFree
tranzly_frontend_prefixフィルターフロントエンドのニュートラルなクラスプレフィックスをフィルター。string $prefixFree
tranzly_fs_loadedアクションライセンス SDK の読み込み完了時に実行 (メインファイル内、Tranzly のコード実行前)。`tranzly_fs()` と通信するフック先。なしFree
tranzly_glossary_optionsフィルター対象言語のエンジンオプション (翻訳対象外リスト、およびプレミアムレイヤー追加時の用語集とトーン) をフィルター。string $langFree
tranzly_glossary_saveフィルター言語ごとの優先翻訳とトーンを保存。プレミアムレイヤーのみが応答 (WordPress.org ガイドライン 5: 無料プラグイン内での Pro 動作禁止)。なしFree
tranzly_google_price_per_millionフィルターGoogle Cloud Translation の100万文字あたりの料金 (米ドル) をフィルター。float $pricePro
tranzly_install_language_packsフィルターサイトに追加された言語の WordPress、テーマ、プラグインの言語パックを Tranzly がインストールするかどうか (WordPress や WooCommerce 本体のテキストを翻訳して表示するため)。初期状態は有効。bool $installFree
tranzly_integration_availableフィルタープラグインが検出されない場合に連携を実行するかどうかをフィルター (ビルダー停止後に残ったコンテンツや、通常とは異なる方法で読み込まれたプラグインに対応)。bool $on
string $id
Free
tranzly_integrationsフィルターTranzly が実行する連携機能をフィルター。他のプラグインをサポートするには `Integration` のサブクラスを追加。なしFree
tranzly_is_proフィルタープレミアムレイヤーが実行中かどうかをフィルター。プレミアムレイヤーのみが応答。bool $proFree
tranzly_job_createdアクション翻訳ジョブの作成後に実行。int $job
int $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 $localize
string $lang
無料版
tranzly_memory_enabledフィルター翻訳メモリを使用するかどうかをフィルターします。bool $onPro 版
tranzly_microsoft_price_per_millionフィルターMicrosoft Translator の100万文字あたりの価格 (米ドル) をフィルターします。float $pricePro 版
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 $target
int $source_id
string $code
string $engine
無料版
tranzly_post_translation_createdアクションTranzly が投稿の翻訳を作成した後に実行します。int $new_id
int $source_id
string $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 $workers
int $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 $type
array<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 $scope
string $lang
無料
tranzly_source_changedアクション原文の翻訳対象コンテンツが変更され、既存の翻訳が古い状態になったときに実行します。int $post_id
string $now
string $before
無料
tranzly_source_meta_keysフィルター変更によってページの翻訳が古い状態になるメタキーをフィルターします。連携機能により、翻訳対象のキー (ビルダーのデータ、SEO フィールド、カスタムフィールド) が追加されます。int $post_id無料
tranzly_source_publishedアクション原文が最初に公開されたとき (メタデータ保存後) に一度だけ実行します。int $post_id無料
tranzly_style_rules_enabledフィルター各言語の WordPress.org 翻訳チームのスタイルルール (引用符、約物の前後のスペース、アポストロフィ、リーダー記号、日本語のスペース、二人称代名詞) を新規翻訳に適用するかどうか。初期状態では有効です。bool $enabled
string $locale
無料
tranzly_taxonomiesフィルターTranzly が翻訳するタクソノミーをフィルターします。なし無料
tranzly_term_segmentsフィルターエンジンに送信するタームのセグメント (`name`、`description`、および連携機能が追加する SEO タイトルやカスタムフィールドなど) をフィルターします。追加したセグメントは `tranzly_term_translated` で書き込みます。\WP_Term $term無料
tranzly_term_translatedアクションエンジンがタームを翻訳した後に、すべての翻訳済みセグメントとともに実行します (連携機能によって `tranzly_term_segments` で追加されたセグメントが書き込まれます)。int $target
int $term_id
string $code
無料
tranzly_term_translation_createdアクションTranzly がタームの翻訳を作成した後に実行します。int $new_id
int $term_id
string $code
無料
tranzly_translatable_attributesフィルターTranzly がブロックタイプ向けに翻訳する属性をフィルターします。string $block_name無料
tranzly_translate_stringフィルター1つの翻訳対象文字列を指定の言語向けにフィルターします。string $value
string $code
array $context
無料
tranzly_translated_post_fieldsフィルターエンジンの実行後、翻訳に書き込まれる投稿フィールドをフィルターします。独自セグメント (カスタムフィールド、ビルダーデータ) を追加した連携機能は、ここで書き込みを行います。\WP_Post $post
string $code
無料
tranzly_translation_memoryフィルター使用中の翻訳メモリをフィルターします。無料版プラグインには含まれません。有料版で利用可能です (docs/843、WordPress.org ガイドライン 5)。Translation_Memory|null $memory無料