Ontwikkelaars

Tranzly abilities-referentie

Tranzly registreert zijn acties bij de WordPress Abilities API. Dezelfde abilities zijn MCP-tools op de eigen server van de site en REST-routes onder /wp-json/wp-abilities/v1. Deze pagina wordt gegenereerd vanuit het eigen register van de plugin.

Gebruikershandleiding: verbind een AI-app

Endpoints

AbilityREST
MCP via HTTP (streambaar)/wp-json/tranzly/v1/mcp
MCP via WP-CLI (standaardinvoer en -uitvoer)wp mcp-adapter serve --server=tranzly --user=<login>
REST: lijst van de abilities/wp-json/wp-abilities/v1/abilities?category=tranzly
REST: voer een ability uit/wp-json/wp-abilities/v1/abilities/<name>/run (GET met ?input= voor alleen-lezen abilities, anders POST {"input": {...}})

Authenticatie en rechten

HTTP-verzoeken authenticeren met een WordPress-applicatiewachtwoord (HTTP Basic). Voor het verbinden met de MCP-server is de hieronder getoonde capability vereist; elke ability controleert vervolgens zijn eigen rechten, per object. Alleen-lezen abilities worden uitgevoerd met GET en hun invoer in de query-string; de overige met POST en een JSON-body ‘{“input”: {…}}’.

een WordPress-applicatiewachtwoord (HTTP) of --user (WP-CLI); de gebruiker heeft de capability nodig die door elke ability wordt genoemd · Instellingen: AI-agents toestaan (MCP), standaard ingeschakeld

Alle abilities

AbilityEditieRESTRechtenParameters
tranzly/bulk-translate
Start vertaaltaken op de achtergrond voor elk origineel van de opgegeven content types (alle vertaalde types als er geen zijn opgegeven): de ontbrekende vertalingen, de verouderde, of allemaal. Geeft de gestarte taken terug, één per taal.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/runedit_posts; publish_posts om te publicerenlanguages array (vereist)
post_types array
scope string: missing, stale, all
engine string
publish boolean
tranzly/cancel-job
Stopt een taak; reeds gemaakte vertalingen blijven behouden.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/runmanage_options (de eigen controle van de REST-route)id string (vereist)
tranzly/check-quality
Laat AI één vertaling vergelijken met het origineel en beoordelen, en slaat het rapport op bij de vertaling. Gebruikt het kwaliteitscontrole-AI-model dat is ingesteld in de workflow-instellingen van Tranzly.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/runedit_post op die vertalingid integer (vereist)
tranzly/connect-support
Verbindt deze site met Zinn Digital® support (naam, e-mail, toestemming).
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/runmanage_options (de eigen controle van de REST-route)email string (vereist)
name string
consent boolean (vereist)
tranzly/correct-segments
Slaat gecorrigeerde segmenten van een vertaling op (segmenten: sleutel naar tekst); gecorrigeerde tekst is beschermd tegen hervertaling.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/runedit_post (de eigen controle van de REST-route)id string (vereist)
segments object
texts object
tranzly/create-job
Start een achtergrondtaak voor het vertalen van opgegeven berichten (posts) of een heel berichttype naar talen (langs).
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/runedit_posts (de eigen controle van de REST-route)posts array
post_type string
langs array (vereist)
engine string
status string: publish, draft
force boolean
tranzly/create-post-translation
Maakt een conceptvertaling van een bericht in een taal (lang) om handmatig te schrijven, zonder vertaalmachine.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/runde eigen rechtencontrole per item van de REST-routeid string (vereist)
lang string (vereist)
name string
slug string
description string
tranzly/create-term-translation
Maakt een vertaling van een term aan in een taal met een door jou opgegeven naam, slug en beschrijving.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/runde eigen rechtencontrole per item van de REST-routeid string (vereist)
lang string (vereist)
name string
slug string
description string
tranzly/disconnect-support
Ontkoppelt deze site van support.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/runmanage_options (de eigen controle van de REST-route)geen
tranzly/estimate
Schat het aantal tekens en de kosten voor het vertalen van berichten (posts of post_type) naar talen (langs) met een vertaalmachine, voordat je iets uitgeeft.
FreePOST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/runedit_posts (de eigen controle van de REST-route)posts array
post_type string
langs array (vereist)
engine string
tranzly/estimate-bulk
Schat een vertaling van de hele site in een taal (post_types, scope, engine) voordat je ermee begint.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/runedit_posts (de eigen controle van de REST-route)post_types array
scope string: missing, stale, all
engine string
lang string (vereist)
after integer
tranzly/export-translation-file
Retourneert een XLIFF- of CSV-bestand (als tekst) met de originelen en hun vertalingen in één taal, voor een vertaler of een vertaalbureau: de opgegeven berichten, of een pagina van maximaal 100 originelen van een content type in een bepaalde status (missing, stale, translated of all; herhaal met after). Hetzelfde bestand kan na vertaling weer worden geïmporteerd.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/runedit_posts; elk bericht wordt alleen opgenomen als de gebruiker het mag bewerkenlang string (vereist)
format string: xliff, csv
posts array
post_type string
state string: all, missing, stale, translated
after integer
tranzly/fix-status
Zet de vertaling van elk ontbrekend (of verouderd) item in een taal en berrichttype in de wachtrij.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/runedit_posts (de eigen controle van de REST-route)post_type string
lang string (verplicht)
state string (verplicht): missing, stale, quality
tranzly/get-comments-setting
Geeft terug of reacties worden gedeeld over talen of per taal worden bewaard.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/runmoderate_comments (de eigen controle van de REST-route)geen
tranzly/get-deepl-usage
Geeft de gebruikte tekens en de limiet van de opgeslagen DeepL-sleutel van deze maand terug.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/runmanage_options (de eigen controle van de REST-route)geen
tranzly/get-diagnostics
Geeft de diagnostische gegevens terug die een supportticket zou bevatten: versies, actieve plugins, limieten en recente fouten.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/runmanage_options (de eigen controle van de REST-route)geen
tranzly/get-display
Geeft de taalwisselaar en weergaveopties voor credits terug.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/runmanage_options (de eigen controle van de REST-route)geen
tranzly/get-engine-settings
Geeft de standaard- en fallback-engine, engines en AI-modellen per taal, de status van elke engine, de verbonden AI-providers met hun modellen en de uitgaven van deze maand terug.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/runmanage_options (de eigen controle van de REST-route)geen
tranzly/get-glossary
Geeft de woorden die nooit vertaald worden, de vaste termvertalingen en de tone of voice per taal terug.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/runmanage_optionsgeen
tranzly/get-integrations
Toont de SEO-, WooCommerce-, pagebuilder- en formulierplugins die Tranzly ondersteunt en die hier actief zijn.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/runmanage_options (de eigen controle van de REST-route)geen
tranzly/get-job
Geeft de voortgang en tellingen van één taak terug.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/runmanage_options (de eigen controle van de REST-route)id string (verplicht)
tranzly/get-job-failures
Toont de mislukte items van een taak met de reden voor elk item.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/runmanage_options (de eigen controle van de REST-route)id string (verplicht)
tranzly/get-legacy-import
Geeft de status en het rapport terug van het importeren van vertalingen uit Tranzly 2.x.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/runmanage_options (de eigen controle van de REST-route)geen
tranzly/get-licence
Geeft het Tranzly-abonnement van deze site, de licentiestatus, de verlengingsdatum en wat het abonnement inhoudt terug.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/runmanage_options (de eigen controle van de REST-route)geen
tranzly/get-menus
Geeft terug welk menu elke taal toont op elke menulocatie.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/runedit_theme_options (de eigen controle van de REST-route)geen
tranzly/get-post-group
Toont de vertaalgroep van een bericht: elk lid van elke taal met titel, status en bewerkingslink.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/runedit_post en edit_term (de eigen controle van de REST-route)id string (verplicht)
tranzly/get-quality-report
Geeft het AI-kwaliteitsrapport van een vertaling terug: score en de gemarkeerde segmenten.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/runedit_post (de eigen controle van de REST-route)id string (verplicht)
tranzly/get-segments
Geeft de segmenten van een vertaling weer naast het origineel, voor beoordeling en correctie.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/runedit_post (de eigen controle van de REST-route)id string (verplicht)
tranzly/get-shared-strings
Geeft de thema- en pluginteksten (scope) in een taal met hun vertalingen terug.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/runedit_theme_options (de eigen controle van de REST-route)lang string (verplicht)
scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
tranzly/get-site-strings
Geeft de sitetitel, ondertitel en widgetteksten in een taal terug.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/runmanage_options (de eigen controle van de REST-route)lang string (verplicht)
tranzly/get-support-connection
Geeft aan of deze site is verbonden met Zinn Digital® support, en als wie.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/runmanage_options (de eigen controle van de REST-route)refresh boolean
tranzly/get-term-group
Toont de vertaalgroep van een categorie of tag.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/runedit_post en edit_term (de eigen controle van de REST-route)id string (vereist)
tranzly/get-urls
Geeft terug hoe talen in adressen verschijnen (map, subdomein of domein), vertaalde slugs en basissen, en noindex voor niet-vertaalde pagina’s.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/runmanage_options (de eigen controle van de REST-route)geen
tranzly/get-workflow-settings
Geeft automatisch vertalen bij publiceren en bijwerken terug, beoordeling vóór publicatie, en de drempelwaarde, provider en het model van de AI-kwaliteitscontrole.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/runmanage_options (de eigen controle van de REST-route)geen
tranzly/import-from-source
Importeert de volgende pagina met vertalingen uit een andere meertalige plugin (modus: dry-run of run; cursor).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/runmanage_options (de eigen controle van de REST-route)source string (vereist)
mode string: dry-run, run, undo
cursor string
tranzly/import-translation-file
Schrijft de volgende pagina met berichten vanuit een geüpload vertaalbestand (herhaal met after tot voltooid).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/runedit_posts (de eigen controle van de REST-route)token string (vereist)
after integer
tranzly/link-post
Maakt een bestaand bericht (target) de vertaling van dit bericht in een taal.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/runedit_post en edit_term (de eigen controle van de REST-route)id string (vereist)
lang string (vereist)
target integer (vereist)
tranzly/link-term
Maakt een bestaande term (target) de vertaling van deze term in een taal.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/runedit_post en edit_term (de eigen controle van de REST-route)id string (vereist)
lang string (vereist)
target integer (vereist)
tranzly/list-engines
Toont de vertaalmachines, of ze zijn ingesteld en welke wordt gebruikt als er geen is opgegeven.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/runedit_postsgeen
tranzly/list-import-sources
Toont gegevens van WPML, Polylang en TranslatePress op deze site die kunnen worden geïmporteerd.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/runmanage_options (de eigen controle van de REST-route)geen
tranzly/list-jobs
Toont vertaaltaken op de achtergrond, nieuwste eerst, met voortgang.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/runedit_posts (de eigen controle van de REST-route)geen
tranzly/list-languages
Toont de talen van de site. De eerste is de taal waarin de originele inhoud is geschreven.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/runedit_postsgeen
tranzly/list-status-items
Toont originelen met hun vertaalstatus in een taal (status: missing, stale, current), pagina voor pagina.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/runedit_posts (de eigen controle van de REST-route)post_type string
lang string (vereist)
state string: all, missing, stale, translated, human, machine, review, quality
after integer
tranzly/list-theme-strings
Toont de thema’s en plugins waarvan de teksten kunnen worden gescand voor vertaling, en hoeveel strings ze hebben.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/runmanage_options (de eigen controle van de REST-route)geen
tranzly/open-support-ticket
Dient een supportticket in (subject, message, kind, email), met de diagnostische gegevens van deze site als de beheerder akkoord ging. Maakt nooit een inlog aan en stuurt er geen.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/runmanage_options (de eigen controle van de REST-route)subject string (vereist)
message string (vereist)
kind string: help, bug, feedback, feature_request
email string
name string
diagnostics boolean
tranzly/record-support-consent
Legt de toestemming van de beheerder vast om diagnostische gegevens met supporttickets mee te sturen.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/runmanage_options (de eigen controle van de REST-route)consent boolean (vereist)
tranzly/retry-job-item
Probeert een mislukt item opnieuw (actie: retry, optioneel met een andere engine) of markeert het voor handmatige vertaling (actie: by-hand).
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/runedit_post en manage_options (de eigen controle van de REST-route)item string (verplicht)
action string (verplicht)
engine string
tranzly/review-translation
Keurt een vertaling goed (en publiceert deze wanneer het origineel is gepubliceerd) of stuurt deze terug (decision, note).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/runedit_post (de eigen controle van de REST-route)id string (verplicht)
decision string (verplicht): approve, changes, pending
note string
tranzly/run-legacy-import
Voert de 2.x-import uit: dry-run (alleen rapport), run, of undo.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/runmanage_options (de eigen controle van de REST-route)action string (verplicht)
tranzly/scan-theme-strings
Scant de volgende pagina van de PHP-bestanden van een component op vertaalbare teksten (herhaal met after tot voltooid).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/runmanage_options (de eigen controle van de REST-route)component string (verplicht)
after integer
tranzly/schedule-quality-check
Plant de AI-kwaliteitscontrole van de volgende pagina met vertalingen van een taal (of de opgegeven berichten).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/runedit_posts (de eigen controle van de REST-route)lang string (verplicht)
post_type string
posts array
after integer
tranzly/seo-audit
Controleert vertalingen pagina voor pagina op ontbrekende SEO-titels, beschrijvingen, slugs en hreflang in een taal.
ProGET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/runmanage_options (de eigen controle van de REST-route)lang string (verplicht)
after integer
tranzly/set-comments-setting
Deelt reacties tussen de vertalingen van een bericht of behoudt ze per taal (mode).
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/runmanage_options en moderate_comments (de eigen controle van de REST-route)mode string (verplicht): off, show, translate
tranzly/set-engine-key
Slaat de API-sleutel (en regio voor Microsoft) op van DeepL, Google of Microsoft; leeg verwijdert deze. Sleutels worden versleuteld opgeslagen en nooit geretourneerd.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/runmanage_options (de eigen controle van de REST-route)engine string (verplicht)
key string (verplicht)
region string
tranzly/set-menus
Wijst een menu toe per taal per locatie (map).
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/runedit_theme_options (de eigen controle van de REST-route)map object (verplicht)
tranzly/set-protection
Beschermt een vertaling tegen overschrijven door de engine (protected: true), of ontgrendelt deze.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/runedit_post (de eigen controle van de REST-route)id string (verplicht)
protected boolean (verplicht)
tranzly/set-shared-strings
Slaat gecorrigeerde vertalingen van thema- en pluginteksten op (strings); ze worden beschermd.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/runedit_theme_options (de eigen controle van de REST-route)lang string (verplicht)
scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
strings object (verplicht)
tranzly/set-site-string
Slaat één sitetekst (key) op in een taal, bijv. de sitetitel of ondertitel.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/runedit_theme_options en manage_options (de eigen controle van de REST-route)lang string (verplicht)
key string (verplicht)
translation string (verplicht)
tranzly/set-urls
Stelt de adresmodus in (mode), domeinen per taal, vertaalde bases en segmenten, noindex_untranslated en slug-suggesties.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/runmanage_options (de eigen controle van de REST-route)mode string
segments object
domains object
bases object
suggest boolean
noindex_untranslated boolean
tranzly/start-trial
Start de 14-daagse Tranzly Pro-proefperiode voor deze site (geen betaling nodig).
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/runmanage_options (de eigen controle van de REST-route)geen
tranzly/translate-media-field
Slaat de alt-tekst, titel of het bijschrift (field) van een afbeelding op in een taal (lang).
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/runedit_post (de eigen controle van de REST-route)id string (verplicht)
lang string (verplicht)
field string (verplicht): alt, caption, title
translation string (verplicht)
tranzly/translate-post
Vertaalt één bericht of pagina naar een of meer van de talen van de site met een vertaalmachine, waarbij elke vertaling wordt aangemaakt of bijgewerkt. Nieuwe vertalingen zijn concepten, tenzij publish waar is. Een vertaling die door een persoon is bewerkt, wordt overgeslagen tenzij force waar is.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/runmag dat bericht vertalen (edit_post erop); edit_post op een bestaande vertaling; de publish-capability van het type om te publicerenid integer (verplicht)
languages array (verplicht)
engine string
publish boolean
force boolean
tranzly/translate-shared-strings
Vertaalt de volgende pagina met onvertaalde thema- en pluginteksten in een taal met de standaardmachine (herhaal met after tot het klaar is).
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/runedit_theme_options (de eigen controle van de REST-route)lang string (verplicht)
scope string: menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>
after integer
tranzly/translate-site
Een begeleide workflow: de agent controleert de talen en de machine, schat de kosten in en vertaalt wat er ontbreekt, waarbij eerst om toestemming wordt gevraagd voordat er kosten worden gemaakt of wordt gepubliceerd.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/runedit_postslanguages string (verplicht)
tranzly/translate-term
Vertaalt één term (categorie, tag of productattribuut) naar een taal (lang) met een machine, waarbij de vertaling wordt aangemaakt of bijgewerkt.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/runde eigen rechtencontrole per item van de REST-routeid string (verplicht)
lang string (verplicht)
engine string
force boolean
status string: publish, draft
tranzly/translation-status
Met een bericht-ID: de vertaling van dat bericht in elke taal, of deze verouderd is en wie deze heeft geschreven. Zonder ID: hoeveel van de site vertaald is, per taal.
GratisGET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/runedit_post op dat bericht; edit_posts voor het siteoverzichtid integer
post_type string
tranzly/unlink-post
Haalt een bericht uit zijn vertaalgroep; het behoudt zijn taal.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/runedit_post en edit_term (de eigen controle van de REST-route)id string (verplicht)
tranzly/unlink-term
Haalt een term uit zijn vertaalgroep.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/runedit_post en edit_term (de eigen controle van de REST-route)id string (verplicht)
tranzly/update-display
Wijzigt de taalschakelaar (stijl, vlaggen, namen, plaatsing) en de naamsvermelding.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/runmanage_options (de eigen controle van de REST-route)switcher object
credit boolean
tranzly/update-engine-settings
Stelt de standaardmachine, een fallback-machine, machines per taal en AI-modellen per taal in (default, fallback, per_lang, models, caps). Alles behalve de standaardmachine is Pro.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/runmanage_options (de eigen controle van de REST-route)default string
per_lang object
fallback array
caps object
models object
tranzly/update-glossary
Vervangt de delen van de woordenlijst die je meestuurt (woorden die nooit vertaald worden, termvertalingen, tone-of-voice); delen die je weglaat, blijven behouden. Vanaf de volgende vertaling door elke machine gebruikt.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/runmanage_optionsdnt array
terms object
tone object
tranzly/update-settings
Stelt de talen van de site in (languages: lijst met code en naam; de eerste is de brontaal), het class-voorvoegsel van de front-end en of AI-agents (MCP) zijn toegestaan.
GratisPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/runmanage_options (de eigen controle van de REST-route)prefix string
mcp boolean
languages array
tranzly/update-workflow-settings
Stelt on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider en quality_model in.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/runmanage_options (de eigen controle van de REST-route)on_update string: off, stale, translate
on_publish boolean
review boolean
quality_threshold integer
quality_provider string
quality_model string
tranzly/upload-translation-file
Uploadt een elders vertaald Tranzly XLIFF- of CSV-bestand (content, filename); retourneert een token dat de upload identificeert voor de import.
ProPOST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/runedit_posts (de eigen controle van de REST-route)content string (vereist)
filename string (vereist)

Gegenereerd vanuit de abilities.json van de plug-in, die zelf weer wordt gegenereerd vanaf een actieve site; een test mislukt wanneer de twee niet overeenkomen.

WP-CLI-commando’s

Voer deze uit op de server met WP-CLI. Elk commando controleert dezelfde permissies als de schermen van de plug-in; de voorbeelden zijn overgenomen uit de eigen helptekst van de plug-in.

CommandoWat het doetEditie
wp tranzly create <id> [--term]
wp tranzly create 42 --lang=de_DE --user=admin
Maak een conceptvertaling van een bericht (of term), daaraan gekoppeld.Gratis
wp tranzly enginesToon de lijst met vertaalmachines.Gratis
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 # work the job here instead of waiting for the queue runner
Achtergrondvertaaltaken.Gratis
wp tranzly legacy <action> [--format=<format>]
wp tranzly legacy dry-run
wp tranzly legacy run
wp tranzly legacy undo
Bekijk, test (dry-run), voer uit of maak het importeren van vertalingen van een verouderde Tranzly (2.x)-site ongedaan.Gratis
wp tranzly link <source> <target> [--term]Koppel een bestaand bericht (of term) als vertaling van een ander.Gratis
wp tranzly network <action> [--languages=<codes>]
wp tranzly network setup
wp tranzly network languages --languages=en_US,de_DE,fr_FR
Multisite (Agency): configureer elke site van het netwerk, of stel de talen in waarmee nieuwe sites starten.Gratis
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
Vertaal berichten met een machine.Gratis
wp tranzly translations <id> [--term] [--format=<format>]Toon de vertalingen van een bericht (of term).Gratis

PHP-functies

Functies die thema’s en andere plug-ins kunnen aanroepen. Controleer eerst function_exists(), zodat je code blijft werken wanneer de plug-in inactief is.

FunctieWat het doetEditie
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null )WPML: de vertaling van een object.Pro
pll__( $text )Polylang: een geregistreerde tekenreeks, vertaald. Tranzly vertaalt thematekenreeksen via de eigen gettext van WordPress, dus de tekenreeks wordt ongewijzigd geretourneerd.Pro
pll_current_language( $field = 'slug' )Polylang: de huidige taal.Pro
pll_default_language( $field = 'slug' )Polylang: de standaardtaal.Pro
pll_e( $text )Polylang: een geregistreerde tekenreeks weergeven (echo), ge-escaped.Pro
pll_get_post( $post_id, $lang = null )Polylang: de vertaling van een bericht.Pro
pll_get_post_language( $post_id, $field = 'slug' )Polylang: de taal van een bericht.Pro
pll_get_post_translations( $post_id )Polylang: alle vertalingen van een bericht, slug => ID.Pro
pll_get_term( $term_id, $lang = null )Polylang: de vertaling van een term.Pro
pll_get_term_language( $term_id, $field = 'slug' )Polylang: de taal van een term.Pro
pll_get_term_translations( $term_id )Polylang: alle vertalingen van een term, slug => ID.Pro
pll_home_url( $lang = '' )Polylang: de home-URL in een taal.Pro
pll_is_translated_post_type( $post_type )Polylang: is dit berichttype vertaald?Pro
pll_is_translated_taxonomy( $taxonomy )Polylang: is deze taxonomie vertaald?Pro
pll_languages_list( $args = array( )Polylang: de talen.Pro
pll_register_string()Polylang: registreer een tekenreeks (geaccepteerd en genegeerd — zie pll__()).Pro
pll_the_languages( $args = array( )Polylang: de taalkiezer. `raw` retourneert de array van Polylang (slug => details); anders een `<li>`-lijst in de opmaak van Polylang, weergegeven tenzij `echo` 0 is. Houdt rekening met `hide_current`, `hide_if_no_translation` en `display_names_as` (`name` of `slug`). Een `dropdown` wordt weergegeven als de lijst: Tranzly’s eigen taalkiezer-blok/widget is de plek voor een dropdown.Pro
pll_translate_string( $text )Polylang: een geregistreerde tekenreeks in een taal. Net als bij pll__() wordt de tekenreeks ongewijzigd geretourneerd.Pro
tranzly_compat_field( string $code, string $field )Eén veld van een taal, in de terminologie van Polylang.Pro
tranzly_current_language(): stringDe taal van het huidige verzoek (een WordPress-localecode zoals `fr_FR`).Free
tranzly_default_language(): stringDe standaardtaal: de eerste in de lijst.Free
tranzly_get_engines(): arrayDe beschikbare engines: id => naam.Free
tranzly_get_post_language( int $post_id ): stringDe taal waarin een bericht is geschreven.Free
tranzly_get_term_language( int $term_id ): stringDe taal waarin een term is geschreven.Free
tranzly_get_term_translation( int $term_id, string $lang ): ?intDe vertaling van een term naar een taal, of null.Free
tranzly_get_term_translations( int $term_id ): arrayElke versie van een term: taalcode => term-ID.Free
tranzly_get_translation( int $post_id, string $lang ): ?intDe ID van de vertaling van een bericht naar een taal, of null wanneer er geen is. Retourneert de eigen ID van het bericht wanneer het al in die taal is geschreven.Free
tranzly_get_translations( int $post_id ): arrayElke versie van een bericht, inclusief het bericht zelf: taalcode => bericht-ID. Een bericht zonder vertalingen retourneert alleen zichzelf in zijn eigen taal.Free
tranzly_language_switcher( array $args = array( )De HTML van een taalkiezer, voor elk thema, builder of plugin (T5). Het element van Page Builder Sandwich roept deze aan; dat kan die van jou ook doen. Leeg wanneer er minder dan twee talen zijn.Free
tranzly_language_url( string $lang, ?string $url = null ): stringEen URL die de opgegeven taal toont.Free
tranzly_languages(): arrayDe talen van de site, standaardtaal eerst.Free
tranzly_register_engine( Engine $engine )Voeg een vertaalengine toe. Roep deze aan op `tranzly_register_engines`, of op elk moment vóór de eerste vertaling van het verzoek.Free
tranzly_restore_language(): boolMaak de laatste tranzly_switch_language() ongedaan.Free
tranzly_switch_language( string $lang ): boolLaat code in een andere taal draaien tot tranzly_restore_language(): zowel de huidige taal als de eigen vertalingen van WordPress wisselen mee. Kan genest worden zoals switch_to_blog():Free
tranzly_translatable_attributes( string $block_name ): arrayDe attribuutnamen die Tranzly vertaalt voor een bloktype: `role: content` in zijn block.json, aangepast via de `tranzly_translatable_attributes`-filter.Free
tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( )Vertaal een bericht naar een taal met een engine, als de huidige gebruiker (diens rechten zijn van toepassing).Gratis

Acties en filters

Elke hook die de plug-in biedt, met de beschrijving uit de broncode. Filters wijzigen een waarde; acties stellen je in staat om code op een bepaald moment uit te voeren; entry points zijn acties die je aanroept om de plug-in te vragen iets te doen.

HookTypeWat het doetParametersEditie
tranzly_admin_barActionWordt geactiveerd nadat het admin-balkmenu Vertalingen is opgebouwd (de visuele editor van Pro voegt hier zijn item “Vertaal op deze pagina” toe).\WP_Admin_Bar $bar
int $id
Free
tranzly_admin_dataFilterFiltert de gegevens waarmee de beheer-app opstart. De premium-laag gebruikt dit om zijn editie te melden; gevoelige gegevens horen hier niet thuis, omdat dit in de pagina wordt afgedrukt.geenFree
tranzly_ai_modelFilterFiltert de AI-provider en het model die naar een taal vertalen. Free: de gekozen provider en het model voor de `translate`-taak, voor elke taal. Tranzly Pro: de eigen keuze van de taal, anders de keuze “alle overige talen”.string $targetFree
tranzly_ai_providers_in_useFilterFiltert de AI-providers die voor specifieke talen zijn gekozen. Geen in de gratis plugin: elke taal gebruikt de provider en het model die zijn gekozen voor de `translate`-taak. Tranzly Pro toont de providers van de modellen per taal.geenFree
tranzly_content_before_rebuildFilterFiltert de broninhoud net voordat vertaalde segmenten erin worden geschreven, per taal (de Pro-afbeeldingswissel per taal gebruikt dit).string $content
string $lang
Free
tranzly_copy_meta_keysFilterFiltert de metasleutels die van een bericht naar de nieuwe vertaling worden gekopieerd. Verder wordt er niets gekopieerd.int $source_idFree
tranzly_deepl_hostFilterFiltert de DeepL API-host (een proxy of een testdouble).string $host
string $key
Free
tranzly_deepl_price_per_millionFilterFiltert DeepL’s prijs per miljoen tekens in Amerikaanse dollars.float $priceFree
tranzly_default_engineFilterFiltert het id van de engine die wordt gebruikt als er geen is opgegeven.string $idFree
tranzly_engine_capFilterFiltert de maandelijkse limiet van een engine in Amerikaanse dollars: geen in de gratis plugin.float|null $cap
string $engine
Free
tranzly_engine_chainFilterFiltert de engines die voor een taal moeten worden geprobeerd, op volgorde. Free: de standaardengine. De premium-laag voegt de eigen engine van de taal en de fallback-lijst toe.string $lang
string $first
Free
tranzly_engine_optionsFilterFiltert de opties die aan de engine worden doorgegeven (niet-vertalenlijst, woordenlijst, formaliteit, instructies).string $target
Engine $engine
Free
tranzly_engine_settings_saveFilterSlaat de engines en AI-modellen per taal, de fallback-lijst en de maandelijkse limieten op. Alleen de premium-laag reageert (WordPress.org-richtlijn 5: geen Pro-gedrag in de gratis plugin).geenFree
tranzly_frontend_prefixFilterFiltert het neutrale front-end class-voorvoegsel.string $prefixFree
tranzly_fs_loadedActionWordt geactiveerd zodra de licentie-SDK is geladen (in het hoofdbestand, vóór enige Tranzly-code). Haak hierop in om te communiceren met `tranzly_fs()`.geenFree
tranzly_glossary_optionsFilterFiltert de engine-opties voor een doeltaal: de niet-vertalenlijst, plus de woordenlijst en toon wanneer de premium-laag deze toevoegt.string $langFree
tranzly_glossary_saveFilterSlaat voorkeursvertalingen en toon per taal op. Alleen de premium-laag reageert (WordPress.org-richtlijn 5: geen Pro-gedrag in de gratis plugin).geenFree
tranzly_google_price_per_millionFilterFiltert de prijs per miljoen tekens van Google Cloud Translation in Amerikaanse dollars.float $pricePro
tranzly_install_language_packsFilterOf Tranzly de taalpakketten van WordPress, thema’s en plugins installeert voor een taal die aan de site is toegevoegd (zodat de eigen woorden van WordPress en WooCommerce vertaald verschijnen). Standaard ingeschakeld.bool $installFree
tranzly_integration_availableFilterFiltert of een integratie actief is wanneer de bijbehorende plugin niet wordt gedetecteerd — voor inhoud die een builder heeft achtergelaten nadat deze is uitgeschakeld, of een plugin die op een ongebruikelijke manier is geladen.bool $on
string $id
Free
tranzly_integrationsFilterFiltert de integraties die Tranzly uitvoert. Voeg een `Integration`-subklasse toe om een andere plugin te ondersteunen.geenFree
tranzly_is_proFilterFiltert of de premium-laag actief is. Alleen de premium-laag reageert hierop.bool $proFree
tranzly_job_createdActionWordt geactiveerd nadat een vertaaltaak is aangemaakt.int $job
int $items
Free
tranzly_job_finishedActieWordt geactiveerd wanneer een vertaaltaak geen werk meer over heeft.int $job_idGratis
tranzly_kit_api_baseFilterFiltert de Zinn Digital® API-basis die de ondersteuningsschermen aanroepen.string $baseGratis
tranzly_kit_diagnosticsFilterFiltert de diagnostische gegevens voordat de site-eigenaar ze ziet. Een plugin voegt zijn eigen feiten toe onder `extra`. ⛔ Dit draait VÓÓR het voorbeeld, nooit tussen het voorbeeld en het verzenden.geenGratis
tranzly_kit_footprint_freeFilterFiltert of deze site footprint-vrij is, zodat Zinn® Ads er nooit op gepromoot wordt.bool $footprint_freeGratis
tranzly_kit_promotionsFilterFiltert het promotie-register voordat het wordt verwerkt. Voeg een rij toe om een ander product te promoten: `id`, `kind` (hosting|marketplace|platform|plugin|bundle|ads), `slot` (promo|cross-sell), en `url` of (voor een plugin) `name`, `site`, `main_files`.geenGratis
tranzly_kit_tierFilterFiltert het abonnementsniveau dat de kit meldt voor deze plugin (tests en staging; de licentie bepaalt dit in productie).string $tierGratis
tranzly_localize_linksFilterFiltert of Tranzly de interne links van deze pagina naar hun vertalingen laat verwijzen.bool $localize
string $lang
Gratis
tranzly_memory_enabledFilterFiltert of vertaalgeheugen wordt gebruikt.bool $onPro
tranzly_microsoft_price_per_millionFilterFiltert de prijs per miljoen tekens van Microsoft Translator, in Amerikaanse dollars.float $pricePro
tranzly_network_enabledFilterFiltert of de multisite-netwerklaag is ingeschakeld.bool $agencyGratis
tranzly_pbs_internal_post_typesFilterFiltert de Page Builder Sandwich-berichttemplates die Tranzly ongemoeid laat.geenGratis
tranzly_post_segmentsFilterFiltert de segmenten van een bericht die naar de engine worden gestuurd. Sleutel => `text` + `format` (`text` of `html`). De block-aware parser en integraties voegen hier segmenten toe, splitsen of vervangen ze, en schrijven ze terug naar `tranzly_translated_post_fields`.\WP_Post $postGratis
tranzly_post_translatedActieWordt geactiveerd nadat een engine een bericht heeft vertaald (of nadat een bestand van een persoon of een import er een heeft geschreven).int $target
int $source_id
string $code
string $engine
Gratis
tranzly_post_translation_createdActieWordt geactiveerd nadat Tranzly een berichtvertaling aanmaakt.int $new_id
int $source_id
string $code
Gratis
tranzly_post_typesFilterFiltert de berichttypen die Tranzly vertaalt.geenGratis
tranzly_pre_current_languageFilterOnderbreekt de huidige taal: retourneer een taalcode om deze te gebruiken. Dit is hoe tranzly_switch_language() werkt; retourneer null om Tranzly te laten beslissen.string|null $langGratis
tranzly_query_varFilterFiltert de query-variabele die de taal selecteert.string $varGratis
tranzly_queue_lease_secondsFilterFiltert de leasetijd op een geclaimd item: hierna geeft een worker die halverwege is gestopt het item terug aan de andere workers. Langer dan de langzaamste individuele vertaling.int $secondsGratis
tranzly_queue_worker_secondsFilterFiltert hoelang één worker draait alvorens over te dragen, in seconden.int $secondsGratis
tranzly_queue_workersFilterFiltert hoeveel workers één taak tegelijkertijd uitvoert. Een limiet op WORKERS, om de vertaaldienst te ontzien; nooit een limiet op het aantal items dat wordt voltooid.int $workers
int $job_id
Gratis
tranzly_rate_source_FilterKoersen van een andere bron (zie `tranzly_rate_sources`).geenPro
tranzly_rate_sourcesFilterFiltert de wisselkoersbronnen. Voeg er een toe met een `tranzly_rate_source_<id>`-filter dat `[ code => koers ten opzichte van referentie ]` of een WP_Error retourneert.geenPro
tranzly_register_enginesActieRegistreer vertaal-engines. Roep `$registry->add( new Your_Engine() )` aan.Registry $registryGratis
tranzly_relations_changedActieWordt geactiveerd nadat de vertaalkoppelingen van objecten zijn gewijzigd: gekoppeld, ontkoppeld, verplaatst naar een andere taal of verwijderd. Wordt één keer geactiveerd per gewijzigde groep, dus een enkele koppeling kan het twee keer activeren.string $type
array<int> $ids
Gratis
tranzly_robots_meta_keysFilterFiltert de post-meta-sleutels die robots-instellingen bevatten; elk volgt het origineel naar de bijbehorende vertalingen.geenGratis
tranzly_shared_string_scopesFilterFiltert de gedeelde tekstbereiken (lane L06, T6: integraties voegen `woocommerce`, `forms` en `theme` toe; hun teksten komen binnen op `tranzly_shared_strings`).geenGratis
tranzly_shared_stringsFilterFiltert de gedeelde teksten die Tranzly als strings vertaalt, per bereik. De Pro-laag voegt bloktemplates, template-onderdelen en patronen toe aan `templates`.string $scopeGratis
tranzly_shared_strings_coveredFilterFiltert de teksten van een gedeeld tekstbereik die een taalpakket voor een taal vertaalt. De Pro-laag rapporteert de geregistreerde patronen van het thema en de core voor `templates`.string $scope
string $lang
Gratis
tranzly_source_changedActieWordt geactiveerd wanneer de vertaalbare inhoud van een origineel is gewijzigd, zodat de bijbehorende vertalingen nu verouderd zijn.int $post_id
string $now
string $before
Gratis
tranzly_source_meta_keysFilterFiltert de metasleutels waarvan een wijziging de vertalingen van een pagina verouderd maakt. Integraties voegen de sleutels toe die ze vertalen (builder-gegevens, SEO-velden, aangepaste velden).int $post_idGratis
tranzly_source_publishedActieWordt eenmalig geactiveerd wanneer een origineel voor het eerst wordt gepubliceerd (nadat de meta is opgeslagen).int $post_idGratis
tranzly_style_rules_enabledFilterBepaalt of Tranzly de stijlregels van het WordPress.org-vertaalteam van de taal (aanhalingstekens, spaties rond leestekens, apostrofs, beletseltekens, Japanse spatiëring, aanspreekvormen) toepast op elke nieuwe vertaling. Standaard ingeschakeld.bool $enabled
string $locale
Gratis
tranzly_taxonomiesFilterFiltert de taxonomieën die Tranzly vertaalt.geenGratis
tranzly_term_segmentsFilterFiltert de segmenten van een term die naar de engine worden gestuurd (`name`, `description`, plus wat integraties toevoegen: SEO-titels, aangepaste velden). Schrijf toegevoegde segmenten weg via `tranzly_term_translated`.\WP_Term $termGratis
tranzly_term_translatedActieWordt geactiveerd nadat een engine een term heeft vertaald, met elk vertaald segment (integraties schrijven de segmenten die ze hebben toegevoegd op `tranzly_term_segments`).int $target
int $term_id
string $code
Gratis
tranzly_term_translation_createdActieWordt geactiveerd nadat Tranzly een termvertaling heeft aangemaakt.int $new_id
int $term_id
string $code
Gratis
tranzly_translatable_attributesFilterFiltert de attributen die Tranzly vertaalt voor een bloktype.string $block_nameGratis
tranzly_translate_stringFilterFiltert één vertaalbare string naar een taal.string $value
string $code
array $context
Gratis
tranzly_translated_post_fieldsFilterFiltert de berichtvelden die in een vertaling worden weggeschreven, nadat de engine is uitgevoerd. Integraties die hun eigen segmenten hebben toegevoegd (aangepaste velden, builder-gegevens) schrijven ze hier weg.\WP_Post $post
string $code
Gratis
tranzly_translation_memoryFilterFiltert het gebruikte vertaalgeheugen: geen in de gratis plugin; de premium-laag biedt er een (docs/843, WordPress.org-richtlijn 5).Translation_Memory|null $memoryGratis