توسعه‌دهندگان
مرجع توانایی‌های Tranzly
ترنزلی (Tranzly) اقدامات خود را در API توانایی‌های وردپرس (Abilities API) ثبت می‌کند. همین توانایی‌ها ابزارهای MCP در سرور خود سایت و مسیرهای REST در /wp-json/wp-abilities/v1 هستند. این صفحه از رجیستری خود افزونه تولید شده است.
نقاط پایانی (Endpoints)
| توانایی | REST |
|---|---|
| MCP روی HTTP (قابل استریم) | /wp-json/tranzly/v1/mcp |
| MCP روی WP-CLI (ورودی و خروجی استاندارد) | 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 (GET با ?input= برای توانایی‌های فقط‌خواندنی، و POST با {"input": {...}} برای سایر موارد) |
احراز هویت و مجوزها
درخواست‌های HTTP با یک گذرواژه برنامه وردپرس (HTTP Basic) احراز هویت می‌شوند. اتصال به سرور MCP به قابلیتی که در زیر نشان داده شده است نیاز دارد؛ سپس هر توانایی، مجوز خود را به ازای هر شیء بررسی می‌کند. توانایی‌های فقط‌خواندنی با GET و ورودی‌شان در رشته پرسمان (query string) اجرا می‌شوند؛ سایر توانایی‌ها با POST و بدنه JSON با فرمت ‘{“input”: {…}}’ اجرا می‌شوند.
یک گذرواژه برنامه وردپرس (HTTP) یا --user (WP-CLI)؛ کاربر به قابلیتی که هر توانایی نام می‌برد نیاز دارد · تنظیمات: مجاز بودن عامل‌های هوش مصنوعی (MCP)، به طور پیش‌فرض فعال است
همه توانایی‌ها
| قابلیت | نسخه | REST | سطح دسترسی | پارامترها |
|---|---|---|---|---|
tranzly/bulk-translateکارهای ترجمه پس‌زمینه را برای تمام موارد اصلی انواع محتوای مشخص‌شده شروع می‌کند (در صورت مشخص نشدن، همه انواع ترجمه‌شده): ترجمه‌های ناموجود، قدیمی یا همه آن‌ها. کارهای شروع‌شده را، به ازای هر زبان یک مورد، بازمی‌گرداند. | حرفه‌ای | 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یک کار را متوقف می‌کند؛ ترجمه‌های انجام‌شده تا این لحظه حفظ می‌شوند. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/run | manage_options (بررسی اختصاصی خود مسیر REST) | id رشته (الزامی) |
tranzly/check-qualityاز هوش مصنوعی می‌خواهد یک ترجمه را با نسخه اصلی آن مقایسه کرده و به آن امتیاز دهد، و گزارش را روی ترجمه ذخیره می‌کند. از مدل هوش مصنوعی بررسی کیفیت که در تنظیمات گردش کار Tranzly تنظیم شده، استفاده می‌کند. | حرفه‌ای | POST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/run | edit_post روی آن ترجمه | id عدد صحیح (الزامی) |
tranzly/connect-supportاین سایت را به پشتیبانی ®Zinn Digital متصل می‌کند (نام، ایمیل، رضایت). | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run | manage_options (بررسی اختصاصی خود مسیر REST) | email رشته (الزامی)name رشتهconsent بولی (الزامی) |
tranzly/correct-segmentsبخش‌های اصلاح‌شده یک ترجمه را ذخیره می‌کند (بخش‌ها: کلید به متن)؛ متن اصلاح‌شده در برابر ترجمه مجدد محافظت می‌شود. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run | edit_post (بررسی اختصاصی خود مسیر REST) | id رشته (الزامی)segments شیءtexts شیء |
tranzly/create-jobیک کار پس‌زمینه را برای ترجمه نوشته‌های فهرست‌شده (posts) یا کل یک نوع نوشته به زبان‌های مشخص (langs) آغاز می‌کند. | رایگان | 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) ایجاد می‌کند تا به‌صورت دستی و بدون موتور ترجمه نوشته شود. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run | بررسی سطح دسترسی هر مورد توسط خود مسیر REST | id رشته (الزامی)lang رشته (الزامی)name رشتهslug رشتهdescription رشته |
tranzly/create-term-translationترجمه یک اصطلاح را در یک زبان با نام، نامک و توضیحات ارائه‌شده ایجاد می‌کند. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run | بررسی سطح دسترسی هر مورد توسط خود مسیر REST | id رشته (الزامی)lang رشته (الزامی)name رشتهslug رشتهdescription رشته |
tranzly/disconnect-supportاتصال این سایت را از پشتیبانی قطع می‌کند. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run | manage_options (بررسی اختصاصی خود مسیر REST) | هیچ‌کدام |
tranzly/estimateتعداد نویسه‌ها و هزینه ترجمه نوشته‌ها (posts یا post_type) به زبان‌ها (langs) را با یک موتور، پیش از پرداخت هرگونه هزینه برآورد می‌کند. | رایگان | 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) پیش از شروع آن برآورد می‌کند. | حرفه‌ای | 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 تکرار کنید). همین فایل پس از ترجمه قابل درون‌ریزی مجدد است. | حرفه‌ای | 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مشخص می‌کند که آیا دیدگاه‌ها بین زبان‌ها به اشتراک گذاشته شده‌اند یا برای هر زبان جداگانه نگهداری می‌شوند. | پرو | 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موتور پیش‌فرض و جایگزین، موتورها و مدل‌های هوش مصنوعی به تفکیک زبان، وضعیت هر موتور، ارائه‌دهندگان هوش مصنوعی متصل به همراه مدل‌هایشان و هزینه این ماه را برمی‌گرداند. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/run | manage_options (بررسی خود مسیر REST) | ندارد |
tranzly/get-glossaryکلماتی که هرگز نباید ترجمه شوند، ترجمه‌های اصطلاحات ثابت و لحن را برای هر زبان برمی‌گرداند. | پرو | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/run | manage_options | ندارد |
tranzly/get-integrationsافزونه‌های سئو، ووکامرس، صفحه‌ساز و فرم‌ساز که ترنزلی از آن‌ها پشتیبانی می‌کند و در اینجا فعال هستند را فهرست می‌کند. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run | manage_options (بررسی خود مسیر REST) | ندارد |
tranzly/get-jobپیشرفت و شمارنده‌های یک کار (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-importوضعیت و گزارش درون‌ریزی ترجمه‌ها از ترنزلی ۲.x را برمی‌گرداند. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run | manage_options (بررسی خود مسیر REST) | ندارد |
tranzly/get-licenceپلن ترنزلی این سایت، وضعیت لایسنس، تاریخ تمدید و مواردی که پلن شامل می‌شود را برمی‌گرداند. | رایگان | 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گزارش کیفیت هوش مصنوعی یک ترجمه را برمی‌گرداند: امتیاز و بخش‌هایی که علامت‌گذاری کرده است. | پرو | 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® متصل است یا خیر، و به عنوان چه کسی. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/run | manage_options (بررسی اختصاصی مسیر REST) | refresh دودویی |
tranzly/get-term-groupگروه ترجمه یک دسته یا برچسب را فهرست می‌کند. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/run | edit_post و edit_term (بررسی اختصاصی مسیر REST) | id رشته (الزامی) |
tranzly/get-urlsنحوه نمایش زبان‌ها در نشانی‌ها (پوشه، زیردامنه یا دامنه)، نامک‌ها و پایه‌های ترجمه‌شده، و noindex برای صفحات ترجمه‌نشده را برمی‌گرداند. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/run | manage_options (بررسی اختصاصی مسیر REST) | هیچ‌کدام |
tranzly/get-workflow-settingsترجمه خودکار هنگام انتشار و به‌روزرسانی، بررسی قبل از انتشار، و آستانه، ارائه‌دهنده و مدل بررسی کیفیت هوش مصنوعی را برمی‌گرداند. | پرو | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/run | manage_options (بررسی اختصاصی مسیر REST) | هیچ‌کدام |
tranzly/import-from-sourceصفحه بعدی ترجمه‌ها را از یک افزونه چندزبانه دیگر وارد می‌کند (حالت: dry-run یا run؛ مکان‌نما). | پرو | 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 تکرار کنید تا تمام شود). | پرو | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run | edit_posts (بررسی اختصاصی مسیر REST) | token رشته (الزامی)after عدد صحیح |
tranzly/link-postیک نوشته موجود (target) را به عنوان ترجمه این نوشته در یک زبان پیوند می‌دهد. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/run | edit_post و edit_term (بررسی اختصاصی مسیر REST) | id رشته (الزامی)lang رشته (الزامی)target عدد صحیح (الزامی) |
tranzly/link-termیک اصطلاح موجود (target) را به عنوان ترجمه این اصطلاح در یک زبان پیوند می‌دهد. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/run | edit_post و edit_term (بررسی اختصاصی مسیر REST) | id رشته (الزامی)lang رشته (الزامی)target عدد صحیح (الزامی) |
tranzly/list-enginesموتورهای ترجمه را فهرست می‌کند، همراه با وضعیت راه‌اندازی هر یک و اینکه کدام یک در صورت عدم تعیین نام استفاده می‌شود. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run | edit_posts | هیچ‌کدام |
tranzly/list-import-sourcesداده‌های WPML، Polylang و TranslatePress یافت‌شده در این سایت را که می‌توان وارد کرد، فهرست می‌کند. | پرو | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run | manage_options (بررسی اختصاصی مسیر REST) | هیچ‌کدام |
tranzly/list-jobsوظایف ترجمه در پس‌زمینه را از جدیدترین به قدیمی‌ترین، همراه با میزان پیشرفت فهرست می‌کند. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run | edit_posts (بررسی اختصاصی مسیر REST) | هیچ‌کدام |
tranzly/list-languagesزبان‌های سایت را فهرست می‌کند. زبان اول زبانی است که محتوای اصلی به آن نوشته شده است. | رایگان | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run | edit_posts | هیچ‌کدام |
tranzly/list-status-itemsمطالب اصلی را با وضعیت ترجمه‌شان در یک زبان (وضعیت: missing، stale، current) صفحه به صفحه فهرست می‌کند. | رایگان | 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پوسته‌ها و افزونه‌هایی را که متن‌های آن‌ها برای ترجمه قابل اسکن است، همراه با تعداد رشته‌های هر یک فهرست می‌کند. | پرو | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run | manage_options (بررسی اختصاصی مسیر REST) | هیچ‌کدام |
tranzly/open-support-ticketیک تیکت پشتیبانی (موضوع، پیام، نوع، ایمیل) ثبت می‌کند، در صورت موافقت مدیر به همراه داده‌های تشخیصی این سایت. هرگز اطلاعات ورود ایجاد نکرده و ارسال نمی‌کند. | رایگان | 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 دودویی |
tranzly/record-support-consentرضایت مدیر را برای ارسال اطلاعات تشخیصی همراه با تیکت‌های پشتیبانی ثبت می‌کند. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run | manage_options (بررسی اختصاصی مسیر REST) | consent دودویی (الزامی) |
tranzly/retry-job-itemیک مورد ناموفق را دوباره امتحان می‌کند (action: retry، اختیاری با یک موتور دیگر) یا آن را برای ترجمه دستی علامت‌گذاری می‌کند (action: by-hand). | رایگان | 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). | پرو | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (بررسی اختصاصی مسیر REST) | id رشته (الزامی)decision رشته (الزامی): approve، changes، pendingnote رشته |
tranzly/run-legacy-importدرون‌ریزی نسخه 2.x را اجرا می‌کند: dry-run (فقط گزارش)، run، یا undo. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (بررسی اختصاصی مسیر REST) | action رشته (الزامی) |
tranzly/scan-theme-stringsصفحه بعدی از فایل‌های PHP یک کامپوننت را برای متون قابل ترجمه اسکن می‌کند (با after تکرار کنید تا تمام شود). | پرو | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (بررسی اختصاصی مسیر REST) | component رشته (الزامی)after عدد صحیح |
tranzly/schedule-quality-checkبررسی کیفیت توسط هوش مصنوعی را برای صفحه بعدی ترجمه‌های یک زبان (یا نوشته‌های مشخص شده) زمان‌بندی می‌کند. | پرو | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (بررسی اختصاصی مسیر REST) | lang رشته (الزامی)post_type رشتهposts آرایهafter عدد صحیح |
tranzly/seo-auditترجمه‌ها را برای عناوین، توضیحات، نامک‌ها و hreflang سئو ناموجود در یک زبان، صفحه به صفحه بررسی می‌کند. | پرو | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (بررسی اختصاصی مسیر REST) | lang رشته (الزامی)after عدد صحیح |
tranzly/set-comments-settingدیدگاه‌ها را در میان ترجمه‌های یک نوشته به اشتراک می‌گذارد یا آن‌ها را به تفکیک زبان نگه می‌دارد (mode). | پرو | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options و moderate_comments (بررسی اختصاصی مسیر REST) | mode رشته (الزامی): off، show، translate |
tranzly/set-engine-keyکلید API (و منطقه برای مایکروسافت) مربوط به DeepL، Google یا Microsoft را ذخیره می‌کند؛ خالی بودن آن را حذف می‌کند. کلیدها به صورت رمزگذاری‌شده ذخیره می‌شوند و هرگز بازگردانده نمی‌شوند. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (بررسی اختصاصی مسیر REST) | engine رشته (الزامی)key رشته (الزامی)region رشته |
tranzly/set-menusبه ازای هر زبان و به ازای هر جایگاه یک فهرست اختصاص می‌دهد (map). | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (بررسی اختصاصی مسیر REST) | map شیء (الزامی) |
tranzly/set-protectionاز بازنویسی ترجمه توسط موتور جلوگیری می‌کند (protected: true)، یا قفل آن را باز می‌کند. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (بررسی اختصاصی مسیر REST) | id رشته (الزامی)protected بولین (الزامی) |
tranzly/set-shared-stringsترجمه‌های تصحیح‌شده متون قالب و افزونه را ذخیره می‌کند (strings)؛ آن‌ها محافظت‌شده می‌شوند. | رایگان | 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) در یک زبان ذخیره می‌کند، مانند عنوان سایت یا معرفی کوتاه. | رایگان | 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 و پیشنهادات نامک را تنظیم می‌کند. | رایگان | 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 را برای این سایت شروع می‌کند (بدون نیاز به پرداخت). | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run | manage_options (بررسی اختصاصی مسیر REST) | هیچ‌کدام |
tranzly/translate-media-fieldمتن جایگزین (alt)، عنوان یا توضیح (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-postیک نوشته یا برگه را با یک موتور ترجمه به یک یا چند زبان سایت ترجمه می‌کند و هر ترجمه را ایجاد کرده یا به‌روزرسانی می‌کند. ترجمه‌های جدید پیش‌نویس هستند مگر اینکه 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-termیک اصطلاح (دسته، برچسب یا ویژگی محصول) را با یک موتور به یک زبان (lang) ترجمه می‌کند و ترجمه آن را ایجاد یا به‌روزرسانی می‌کند. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | بررسی سطح دسترسی مختص هر مورد خود مسیر REST | id رشته (الزامی)lang رشته (الزامی)engine رشتهforce بولیstatus رشته: publish، draft |
tranzly/translation-statusبا شناسه نوشته: وضعیت ترجمه آن نوشته به هر زبان، اینکه آیا منسوخ شده است یا خیر، و چه کسی آن را نوشته است. بدون شناسه: چه مقداری از سایت ترجمه شده است، به تفکیک زبان. | رایگان | 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موتور پیش‌فرض، موتور پشتیبان، موتورهای هر زبان و مدل‌های هوش مصنوعی هر زبان را تنظیم می‌کند (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: فهرست کد و نام؛ اولی زبان اصلی است)، پیشوند کلاس فرانت‌اند، و مجاز بودن عامل‌های هوش مصنوعی (MCP) را تنظیم می‌کند. | رایگان | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (بررسی اختصاصی خود مسیر REST) | prefix رشتهmcp بولیlanguages آرایه |
tranzly/update-workflow-settingsموارد on_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یک پرونده XLIFF یا CSV مربوط به Tranzly (محتوا، نام پرونده) را که در جای دیگری ترجمه شده بارگذاری می‌کند؛ یک نشانک برمی‌گرداند که بارگذاری را برای درون‌ریزی شناسایی می‌کند. | 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 # work the job here instead of waiting for the queue runner | کارهای ترجمه در پس‌زمینه. | رایگان |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp tranzly legacy undo | نمایش، اجرای آزمایشی، اجرا یا لغو وارد کردن ترجمه‌های یک سایت قدیمی Tranzly (نسخه ۲.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 رشته‌های قالب را از طریق gettext خود وردپرس ترجمه می‌کند، بنابراین رشته همان‌طور که هست بازگردانده می‌شود. | پرو (Pro) |
pll_current_language( $field = 'slug' ) | Polylang: زبان فعلی. | پرو (Pro) |
pll_default_language( $field = 'slug' ) | Polylang: زبان پیش‌فرض. | پرو (Pro) |
pll_e( $text ) | Polylang: چاپ یک رشته ثبت‌شده، به صورت پاکسازی‌شده (escaped). | پرو (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: تمام ترجمه‌های یک نوشته، slug => ID. | پرو (Pro) |
pll_get_term( $term_id, $lang = null ) | Polylang: ترجمه یک اصطلاح (term). | پرو (Pro) |
pll_get_term_language( $term_id, $field = 'slug' ) | Polylang: زبان یک اصطلاح (term). | پرو (Pro) |
pll_get_term_translations( $term_id ) | Polylang: تمام ترجمه‌های یک اصطلاح، slug => ID. | پرو (Pro) |
pll_home_url( $lang = '' ) | Polylang: نشانی وب (URL) صفحه اصلی در یک زبان. | پرو (Pro) |
pll_is_translated_post_type( $post_type ) | Polylang: آیا این نوع نوشته (post type) ترجمه شده است؟ | پرو (Pro) |
pll_is_translated_taxonomy( $taxonomy ) | Polylang: آیا این طبقه‌بندی (taxonomy) ترجمه شده است؟ | پرو (Pro) |
pll_languages_list( $args = array( ) | Polylang: زبان‌ها. | پرو (Pro) |
pll_register_string() | Polylang: ثبت یک رشته (پذیرفته شده و نادیده گرفته می‌شود — pll__() را ببینید). | پرو (Pro) |
pll_the_languages( $args = array( ) | Polylang: سوئیچر زبان. مقدار `raw` آرایه Polylang را برمی‌گرداند (slug => details)؛ در غیر این صورت یک فهرست `<li>` در نشانه‌گذاری Polylang، که چاپ می‌شود مگر اینکه `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 | زبان درخواست فعلی (یک کد لوکال وردپرس مانند `fr_FR`). | رایگان |
tranzly_default_language(): string | زبان پیش‌فرض: زبانی که اول فهرست شده است. | رایگان |
tranzly_get_engines(): array | موتورهای موجود: id => name. | رایگان |
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 | ترجمه یک اصطلاح به یک زبان، یا null. | رایگان |
tranzly_get_term_translations( int $term_id ): array | تمام نسخه‌های یک اصطلاح: language code => term ID. | رایگان |
tranzly_get_translation( int $post_id, string $lang ): ?int | شناسه (ID) ترجمه یک نوشته به یک زبان، یا هنگامی که ترجمه‌ای وجود ندارد null. زمانی که نوشته خود به آن زبان نوشته شده باشد، شناسه خود نوشته را برمی‌گرداند. | رایگان |
tranzly_get_translations( int $post_id ): array | تمام نسخه‌های یک نوشته، شامل خود نوشته: language code => post ID. نوشته‌ای که هیچ ترجمه‌ای ندارد فقط خود را در زبانش برمی‌گرداند. | رایگان |
tranzly_language_switcher( array $args = array( ) | کد HTML سوئیچر زبان، برای هر قالب، صفحه‌ساز یا افزونه (T5). المان Page Builder Sandwich آن را فراخوانی می‌کند؛ المان شما هم می‌تواند آن را فراخوانی کند. وقتی کمتر از دو زبان وجود داشته باشد خالی است. | رایگان |
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(): زبان فعلی و ترجمه‌های خود وردپرس هر دو تغییر می‌کنند. مانند switch_to_blog() تو در تو می‌شود: | رایگان |
tranzly_translatable_attributes( string $block_name ): array | نام مشخصه‌هایی که Tranzly برای یک نوع بلوک ترجمه می‌کند: `role: content` در block.json آن، که با فیلتر `tranzly_translatable_attributes` تنظیم شده است. | رایگان |
tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( ) | ترجمه یک نوشته به یک زبان با یک موتور، به عنوان کاربر فعلی (دسترسی‌های او اعمال می‌شود). | رایگان |
اکشن‌ها و فیلترها
تمامی قلاب‌هایی که افزونه ارائه می‌دهد، به همراه توضیحات برگرفته از کد منبع آن. فیلترها مقداری را تغییر می‌دهند؛ اکشن‌ها به شما اجازه می‌دهند در یک لحظه خاص کدی را اجرا کنید؛ نقاط ورود اکشن‌هایی هستند که برای درخواست انجام کاری از افزونه اجرا می‌کنید.
| قلاب (Hook) | نوع | عملکرد | پارامترها | نسخه |
|---|---|---|---|---|
tranzly_admin_bar | Action | پس از ساخته شدن منوی نوار مدیریت «ترجمه‌ها» اجرا می‌شود (ویرایشگر بصری نسخه Pro مورد «ترجمه در این صفحه» را اینجا اضافه می‌کند). | \WP_Admin_Bar $barint $id | رایگان |
tranzly_admin_data | Filter | داده‌هایی را که برنامه مدیریت با آن‌ها راه‌اندازی می‌شود فیلتر می‌کند. لایه پرمیوم از آن برای گزارش نسخه خود استفاده می‌کند؛ هیچ اطلاعات حساسی نباید اینجا باشد، زیرا در صفحه چاپ می‌شود. | ندارد | رایگان |
tranzly_ai_model | Filter | ارائه‌دهنده هوش مصنوعی و مدلی را که به یک زبان ترجمه می‌کنند فیلتر می‌کند. رایگان: ارائه‌دهنده و مدل انتخاب‌شده برای تسک `translate` برای همه زبان‌ها. نسخه Tranzly Pro: انتخاب اختصاصی خود زبان، و در غیر این صورت انتخاب «سایر زبان‌ها». | string $target | رایگان |
tranzly_ai_providers_in_use | Filter | ارائه‌دهندگان هوش مصنوعی انتخاب‌شده برای زبان‌های خاص را فیلتر می‌کند. در افزونه رایگان هیچ موردی وجود ندارد: هر زبان از ارائه‌دهنده و مدل انتخاب‌شده برای تسک `translate` استفاده می‌کند. Tranzly Pro ارائه‌دهندگان مدل‌های اختصاصی به ازای هر زبان را فهرست می‌کند. | ندارد | رایگان |
tranzly_content_before_rebuild | Filter | محتوای منبع را درست قبل از اینکه بخش‌های ترجمه‌شده در آن نوشته شوند، برای هر زبان فیلتر می‌کند (قابلیت تعویض تصویر برای هر زبان در نسخه Pro از آن استفاده می‌کند). | string $contentstring $lang | رایگان |
tranzly_copy_meta_keys | Filter | کلیدهای متای کپی‌شده از یک نوشته به ترجمه جدید آن را فیلتر می‌کند. هیچ چیز دیگری کپی نمی‌شود. | int $source_id | رایگان |
tranzly_deepl_host | Filter | میزبان API سرویس DeepL را فیلتر می‌کند (یک پراکسی یا یک test double). | string $hoststring $key | رایگان |
tranzly_deepl_price_per_million | Filter | قیمت DeepL را به ازای هر یک میلیون نویسه به دلار آمریکا فیلتر می‌کند. | float $price | رایگان |
tranzly_default_engine | Filter | شناسه موتور استفاده‌شده در زمان مشخص نشدن موتور را فیلتر می‌کند. | string $id | رایگان |
tranzly_engine_cap | Filter | سقف ماهانه موتور را به دلار آمریکا فیلتر می‌کند: در افزونه رایگان وجود ندارد. | float|null $capstring $engine | رایگان |
tranzly_engine_chain | Filter | موتورهایی را که باید برای یک زبان امتحان شوند، به ترتیب فیلتر می‌کند. رایگان: موتور پیش‌فرض. لایه پرمیوم موتور اختصاصی زبان و فهرست پشتیبان را اضافه می‌کند. | string $langstring $first | رایگان |
tranzly_engine_options | Filter | گزینه‌های ارسال‌شده به موتور را فیلتر می‌کند (فهرست عدم ترجمه، واژه‌نامه، سطح رسمیت، دستورالعمل‌ها). | string $targetEngine $engine | رایگان |
tranzly_engine_settings_save | Filter | موتورها و مدل‌های هوش مصنوعی اختصاصی هر زبان، فهرست پشتیبان و سقف‌های ماهانه را ذخیره می‌کند. فقط لایه پرمیوم پاسخ می‌دهد (دستورالعمل ۵ سایت WordPress.org: بدون رفتار Pro در افزونه رایگان). | ندارد | رایگان |
tranzly_frontend_prefix | Filter | پیشوند کلاس‌های خنثای فرانت‌اند را فیلتر می‌کند. | string $prefix | رایگان |
tranzly_fs_loaded | Action | پس از بارگذاری SDK مجوزدهی اجرا می‌شود (در فایل اصلی، قبل از هر کد دیگر Tranzly). برای برقراری ارتباط با `tranzly_fs()` از این قلاب استفاده کنید. | ندارد | رایگان |
tranzly_glossary_options | Filter | گزینه‌های موتور را برای زبان مقصد فیلتر می‌کند: فهرست عدم ترجمه، به علاوه واژه‌نامه و لحن زمانی که لایه پرمیوم آن‌ها را اضافه کند. | string $lang | رایگان |
tranzly_glossary_save | Filter | ترجمه‌های ترجیحی و لحن را برای هر زبان ذخیره می‌کند. فقط لایه پرمیوم پاسخ می‌دهد (دستورالعمل ۵ سایت WordPress.org: بدون رفتار Pro در افزونه رایگان). | ندارد | رایگان |
tranzly_google_price_per_million | Filter | قیمت Google Cloud Translation را به ازای هر یک میلیون نویسه به دلار آمریکا فیلتر می‌کند. | float $price | حرفه‌ای (Pro) |
tranzly_install_language_packs | Filter | آیا Tranzly بسته‌های زبان وردپرس، قالب و افزونه را برای زبانی که به سایت اضافه شده نصب کند یا خیر (تا کلمات پیش‌فرض وردپرس و ووکامرس ترجمه شده نمایش داده شوند). به‌طور پیش‌فرض فعال است. | bool $install | رایگان |
tranzly_integration_available | Filter | فیلتر می‌کند که آیا ادغام در زمانی که افزونه مربوطه‌اش شناسایی نمی‌شود اجرا شود یا خیر — برای محتوایی که صفحه‌ساز پس از غیرفعال شدن بر جای گذاشته، یا افزونه‌ای که به روشی غیرمعمول بارگذاری شده است. | bool $onstring $id | رایگان |
tranzly_integrations | Filter | ادغام‌هایی را که Tranzly اجرا می‌کند فیلتر می‌کند. برای پشتیبانی از افزونه‌ای دیگر، یک زیرکلاس `Integration` اضافه کنید. | ندارد | رایگان |
tranzly_is_pro | Filter | فیلتر می‌کند که آیا لایه پرمیوم در حال اجرا است یا خیر. فقط لایه پرمیوم به آن پاسخ می‌دهد. | bool $pro | رایگان |
tranzly_job_created | Action | پس از ایجاد یک تسک ترجمه اجرا می‌شود. | int $jobint $items | رایگان |
tranzly_job_finished | Action | زمانی اجرا می‌شود که یک کار ترجمه دیگر هیچ کاری برای انجام نداشته باشد. | int $job_id | رایگان |
tranzly_kit_api_base | Filter | پایگاه API مربوط به Zinn Digital® را که صفحات پشتیبانی فراخوانی می‌کنند فیلتر می‌کند. | string $base | رایگان |
tranzly_kit_diagnostics | Filter | داده‌های عیب‌یابی را قبل از اینکه مدیر سایت ببیند فیلتر می‌کند. یک افزونه اطلاعات خود را در `extra` اضافه می‌کند. ⛔ این قبل از پیش‌نمایش اجرا می‌شود، نه بین پیش‌نمایش و ارسال. | ندارد | رایگان |
tranzly_kit_footprint_free | Filter | فیلتر می‌کند که آیا این سایت بدون ردپا (footprint-free) است یا خیر، تا Zinn® Ads هرگز روی آن تبلیغ نشود. | bool $footprint_free | رایگان |
tranzly_kit_promotions | Filter | فهرست تبلیغات را قبل از حل و فصل فیلتر می‌کند. یک ردیف برای تبلیغ محصول دیگری اضافه کنید: `id`، `kind` (hosting|marketplace|platform|plugin|bundle|ads)، `slot` (promo|cross-sell) و `url` یا (برای یک افزونه) `name`، `site`، `main_files`. | ندارد | رایگان |
tranzly_kit_tier | Filter | سطح پلنی را که کیت برای این افزونه گزارش می‌دهد فیلتر می‌کند (آزمایش و استیجینگ؛ مجوز در محیط پروداکشن تصمیم می‌گیرد). | string $tier | رایگان |
tranzly_localize_links | Filter | فیلتر می‌کند که آیا Tranzly لینک‌های داخلی این صفحه را به ترجمه‌های آن‌ها هدایت کند یا خیر. | bool $localizestring $lang | رایگان |
tranzly_memory_enabled | Filter | فیلتر می‌کند که آیا از حافظه ترجمه استفاده شود یا خیر. | bool $on | حرفه‌ای |
tranzly_microsoft_price_per_million | Filter | قیمت Microsoft Translator به ازای هر میلیون کاراکتر (به دلار آمریکا) را فیلتر می‌کند. | float $price | حرفه‌ای |
tranzly_network_enabled | Filter | فیلتر می‌کند که آیا لایه شبکه چندسایتی (multisite network layer) فعال است یا خیر. | bool $agency | رایگان |
tranzly_pbs_internal_post_types | Filter | انواع پست Page Builder Sandwich را که Tranzly دست‌نخورده باقی می‌گذارد، فیلتر می‌کند. | ندارد | رایگان |
tranzly_post_segments | Filter | بخش‌های (segments) یک پست ارسالی به موتور ترجمه را فیلتر می‌کند. کلید => `text` + `format` (`text` یا `html`). تجزیه‌کننده آگاه از بلوک و یکپارچه‌سازها بخش‌ها را در اینجا اضافه، تقسیم یا جایگزین می‌کنند و آن‌ها را در `tranzly_translated_post_fields` بازنویسی می‌کنند. | \WP_Post $post | رایگان |
tranzly_post_translated | Action | پس از اینکه یک موتور، یک پست را ترجمه کرد (یا فایل یک شخص یا یک ورودی آن را نوشت) اجرا می‌شود. | int $targetint $source_idstring $codestring $engine | رایگان |
tranzly_post_translation_created | Action | پس از ایجاد ترجمه یک پست توسط Tranzly اجرا می‌شود. | int $new_idint $source_idstring $code | رایگان |
tranzly_post_types | Filter | انواع پستی را که Tranzly ترجمه می‌کند فیلتر می‌کند. | ندارد | رایگان |
tranzly_pre_current_language | Filter | زبان فعلی را میانبر می‌زند: برای استفاده از آن یک کد زبان را برگردانید. تابع tranzly_switch_language() به این صورت عمل می‌کند؛ مقدار null برگردانید تا Tranzly تصمیم بگیرد. | string|null $lang | رایگان |
tranzly_query_var | Filter | متغیر کوئری را که زبان را انتخاب می‌کند فیلتر می‌کند. | string $var | رایگان |
tranzly_queue_lease_seconds | Filter | مدت زمان اجاره (lease) یک آیتم در صف را فیلتر می‌کند: پس از آن، کارگری که در اواسط انجام آیتم متوقف شده، آیتم را به بقیه واگذار می‌کند. طولانی‌تر از کُندترین تک‌ترجمه. | int $seconds | رایگان |
tranzly_queue_worker_seconds | Filter | مدت زمان اجرای یک کارگر قبل از تحویل کار را بر حسب ثانیه فیلتر می‌کند. | int $seconds | رایگان |
tranzly_queue_workers | Filter | تعداد کارگرانی را که یک کار به‌طور همزمان اجرا می‌کند فیلتر می‌کند. محدودیتی برای کارگران، جهت ملایمت با سرویس ترجمه؛ نه محدودیتی برای تعداد آیتم‌های انجام‌شده. | int $workersint $job_id | رایگان |
tranzly_rate_source_ | Filter | نرخ‌ها از منبعی دیگر (به `tranzly_rate_sources` مراجعه کنید). | ندارد | حرفه‌ای |
tranzly_rate_sources | Filter | منابع نرخ تبدیل ارز را فیلتر می‌کند. یک مورد را با فیلتر `tranzly_rate_source_<id>` اضافه کنید که `[ code => rate against its reference ]` یا یک WP_Error را برمی‌گرداند. | ندارد | حرفه‌ای |
tranzly_register_engines | Action | موتورهای ترجمه را ثبت کنید. `$registry->add( new Your_Engine() )` را فراخوانی کنید. | Registry $registry | رایگان |
tranzly_relations_changed | Action | پس از تغییر پیوندهای ترجمه اشیاء اجرا می‌شود: پیوند داده شده، پیوند برداشته شده، به زبان دیگری منتقل شده یا حذف شده. برای هر گروه دست‌خورده یک بار اجرا می‌شود، بنابراین یک پیوند واحد ممکن است آن را دو بار اجرا کند. | string $typearray<int> $ids | رایگان |
tranzly_robots_meta_keys | Filter | کلیدهای متای پستی را که تنظیمات ربات‌ها را نگهداری می‌کنند فیلتر می‌کند؛ هر کدام نسخه اصلی را روی ترجمه‌هایش دنبال می‌کند. | ندارد | رایگان |
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 | فیلتر | کلیدهای متایی را که تغییر آن‌ها ترجمه‌های یک برگه را منسوخ می‌کند، فیلتر می‌کند. ادغام‌ها کلیدهایی را که ترجمه می‌کنند اضافه می‌کنند (داده‌های صفحه‌ساز، فیلدهای سئو، زمینه‌های دلخواه). | int $post_id | رایگان |
tranzly_source_published | اکشن | یک بار هنگام اولین انتشار نسخه اصلی فعال می‌شود (پس از ذخیره متای آن). | int $post_id | رایگان |
tranzly_style_rules_enabled | فیلتر | آیا Tranzly قوانین نگارشی تیم ترجمه WordPress.org مربوط به زبان (علامت‌های نقل‌قول، فاصله‌گذاری علائم نگارشی، آپاستروف‌ها، نشانه‌های حذف، فاصله‌گذاری ژاپنی، ضمایر خطاب) را روی هر ترجمه جدید اعمال کند یا خیر. به‌طور پیش‌فرض فعال است. | bool $enabledstring $locale | رایگان |
tranzly_taxonomies | فیلتر | طبقه‌بندی‌هایی را که Tranzly ترجمه می‌کند فیلتر می‌کند. | ندارد | رایگان |
tranzly_term_segments | فیلتر | بخش‌های ارسالی یک اصطلاح به موتور را فیلتر می‌کند (`name`، `description`، به علاوه هر آنچه ادغام‌ها اضافه می‌کنند: عناوین سئو، زمینه‌های دلخواه). موارد اضافه شده را روی `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 | فیلتر | یک رشته قابل ترجمه را به یک زبان فیلتر می‌کند. | string $valuestring $codearray $context | رایگان |
tranzly_translated_post_fields | فیلتر | فیلدهای نوشته را که در یک ترجمه نوشته می‌شوند، پس از اجرای موتور فیلتر می‌کند. ادغام‌هایی که بخش‌های خود را اضافه کرده‌اند (زمینه‌های دلخواه، داده‌های صفحه‌ساز) آن‌ها را در اینجا می‌نویسند. | \WP_Post $poststring $code | رایگان |
tranzly_translation_memory | فیلتر | حافظه ترجمه در حال استفاده را فیلتر می‌کند: در افزونه رایگان وجود ندارد؛ لایه پریمیوم یکی را ارائه می‌دهد (docs/843، دستورالعمل ۵ در WordPress.org). | Translation_Memory|null $memory | رایگان |