Développeurs
Référence des capacités de Tranzly
Tranzly enregistre ses actions auprès de l’API WordPress Abilities. Ces mêmes capacités sont des outils MCP sur le propre serveur du site et des routes REST sous /wp-json/wp-abilities/v1. Cette page est générée à partir du registre propre à l’extension.
Points de terminaison
| Capacité | REST |
|---|---|
| MCP sur HTTP (streamable) | /wp-json/tranzly/v1/mcp |
| MCP sur WP-CLI (entrée et sortie standard) | wp mcp-adapter serve --server=tranzly --user=<login> |
| REST : lister les capacités | /wp-json/wp-abilities/v1/abilities?category=tranzly |
| REST : exécuter une capacité | /wp-json/wp-abilities/v1/abilities/<name>/run (GET avec ?input= pour les capacités en lecture seule, POST {"input": {...}} sinon) |
Authentification et autorisations
Les requêtes HTTP s’authentifient avec un mot de passe d’application WordPress (HTTP Basic). La connexion au serveur MCP nécessite la capacité indiquée ci-dessous ; chaque capacité vérifie ensuite sa propre autorisation, par objet. Les capacités en lecture seule s’exécutent avec GET et leur entrée dans la chaîne de requête ; les autres avec POST et un corps JSON ‘{« input » : {…}}’.
un mot de passe d'application WordPress (HTTP) ou --user (WP-CLI) ; l'utilisateur a besoin de la capacité indiquée par chaque capacité · Réglages : Autoriser les agents IA (MCP), activé par défaut
Toutes les capacités
| Capacité | Édition | REST | Permission | Paramètres |
|---|---|---|---|---|
tranzly/bulk-translateLance des tâches de traduction en arrière-plan pour chaque élément d’origine des types de contenu indiqués (tous les types traduits si aucun n’est précisé) : les traductions manquantes, obsolètes ou l’ensemble d’entre elles. Renvoie les tâches lancées, à raison d’une par langue. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/bulk-translate/run | edit_posts ; publish_posts pour publier | languages (requis)post_typesscope : missing, stale, allenginepublish |
tranzly/cancel-jobArrête une tâche ; les traductions déjà effectuées sont conservées. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/cancel-job/run | manage_options (vérification propre à la route REST) | id (requis) |
tranzly/check-qualityFait comparer par l’IA une traduction avec son original pour lui attribuer une note, puis enregistre le rapport dans la traduction. Utilise le modèle d’IA de contrôle qualité configuré dans les réglages de flux de travail de Tranzly. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/check-quality/run | edit_post sur cette traduction | id (requis) |
tranzly/connect-supportConnecte ce site au support de Zinn Digital® (nom, e-mail, consentement). | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/connect-support/run | manage_options (vérification propre à la route REST) | email (requis)nameconsent (requis) |
tranzly/correct-segmentsEnregistre les segments corrigés d’une traduction (segments : clé vers texte) ; le texte corrigé est protégé contre toute nouvelle traduction. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/correct-segments/run | edit_post (vérification propre à la route REST) | id (requis)segmentstexts |
tranzly/create-jobLance une tâche en arrière-plan pour traduire les publications indiquées (posts) ou un type de publication complet vers les langues cibles (langs). | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-job/run | edit_posts (vérification propre à la route REST) | postspost_typelangs (requis)enginestatus : publish, draftforce |
tranzly/create-post-translationCrée un brouillon de traduction d’une publication dans une langue (lang) pour une rédaction manuelle, sans moteur de traduction. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-post-translation/run | vérification propre de permission par élément de la route REST | id (requis)lang (requis)nameslugdescription |
tranzly/create-term-translationCrée la traduction d’un terme dans une langue avec le nom, l’identifiant et la description que vous fournissez. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/create-term-translation/run | vérification propre de permission par élément de la route REST | id (requis)lang (requis)nameslugdescription |
tranzly/disconnect-supportDéconnecte ce site de l’assistance. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/disconnect-support/run | manage_options (vérification propre à la route REST) | aucun |
tranzly/estimateEstime le nombre de caractères et le coût pour traduire des publications (posts ou post_type) dans les langues cibles (langs) avec un moteur, avant de procéder aux dépenses. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate/run | edit_posts (vérification propre à la route REST) | postspost_typelangs (requis)engine |
tranzly/estimate-bulkEstime la traduction de l’ensemble du site dans une langue (post_types, scope, engine) avant de la lancer. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/estimate-bulk/run | edit_posts (vérification propre à la route REST) | post_typesscope : missing, stale, allenginelang (requis)after |
tranzly/export-translation-fileRenvoie un fichier XLIFF ou CSV (au format texte) contenant les originaux et leurs traductions dans une langue, destiné à un traducteur ou à une agence de traduction : les publications indiquées, ou une page d’un maximum de 100 originaux d’un type de contenu dans un état donné (missing, stale, translated ou all ; à répéter avec after). Ce même fichier peut être réimporté une fois traduit. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/export-translation-file/run | edit_posts ; chaque publication est incluse uniquement si la personne connectée peut la modifier | lang (requis)format : xliff, csvpostspost_typestate : all, missing, stale, translatedafter |
tranzly/fix-statusMet en file d’attente la traduction de chaque élément manquant (ou obsolète) pour une langue et un type de publication. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/fix-status/run | edit_posts (propre vérification de la route REST) | post_type chaînelang chaîne (obligatoire)state chaîne (obligatoire) : missing, stale, quality |
tranzly/get-comments-settingIndique si les commentaires sont partagés entre les langues ou conservés par langue. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-comments-setting/run | moderate_comments (propre vérification de la route REST) | aucun |
tranzly/get-deepl-usageRenvoie le nombre de caractères utilisés et la limite de la clé DeepL enregistrée pour ce mois-ci. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-deepl-usage/run | manage_options (propre vérification de la route REST) | aucun |
tranzly/get-diagnosticsRenvoie les données de diagnostic qu’un ticket de support contiendrait : versions, extensions actives, limites et erreurs récentes. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-diagnostics/run | manage_options (propre vérification de la route REST) | aucun |
tranzly/get-displayRenvoie les options du sélecteur de langue et d’affichage des crédits. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-display/run | manage_options (propre vérification de la route REST) | aucun |
tranzly/get-engine-settingsRenvoie les moteurs par défaut et de secours, les moteurs et modèles d’IA par langue, l’état de chaque moteur, les fournisseurs d’IA connectés avec leurs modèles, ainsi que les dépenses de ce mois-ci. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-engine-settings/run | manage_options (propre vérification de la route REST) | aucun |
tranzly/get-glossaryRenvoie les termes non traduits, les traductions de termes fixes et le ton par langue. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-glossary/run | manage_options | aucun |
tranzly/get-integrationsListe les extensions de SEO, WooCommerce, constructeurs de pages et formulaires prises en charge par Tranzly qui sont actives sur ce site. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-integrations/run | manage_options (propre vérification de la route REST) | aucun |
tranzly/get-jobRenvoie la progression et les compteurs d’une tâche. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job/run | manage_options (propre vérification de la route REST) | id chaîne (obligatoire) |
tranzly/get-job-failuresListe les éléments en échec d’une tâche ainsi que leur motif. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-job-failures/run | manage_options (propre vérification de la route REST) | id chaîne (obligatoire) |
tranzly/get-legacy-importRenvoie l’état et le rapport de l’importation des traductions depuis Tranzly 2.x. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-legacy-import/run | manage_options (propre vérification de la route REST) | aucun |
tranzly/get-licenceRenvoie l’offre Tranzly, l’état de la licence, la date de renouvellement et les fonctionnalités incluses pour ce site. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-licence/run | manage_options (propre vérification de la route REST) | aucun |
tranzly/get-menusIndique quel menu est affiché par chaque langue à chaque emplacement de menu. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-menus/run | edit_theme_options (propre vérification de la route REST) | aucun |
tranzly/get-post-groupListe le groupe de traduction d’une publication : chaque élément de chaque langue avec son titre, son état et son lien de modification. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-post-group/run | edit_post et edit_term (propre vérification de la route REST) | id chaîne (obligatoire) |
tranzly/get-quality-reportRenvoie le rapport de qualité de l’IA pour une traduction : note et segments signalés. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-quality-report/run | edit_post (propre vérification de la route REST) | id chaîne (obligatoire) |
tranzly/get-segmentsAffiche les segments d’une traduction à côté de l’original, pour relecture et correction. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-segments/run | edit_post (propre vérification de la route REST) | id chaîne (obligatoire) |
tranzly/get-shared-stringsRenvoie les textes des thèmes et des extensions (portée) dans une langue avec leurs traductions. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-shared-strings/run | edit_theme_options (propre vérification de la route REST) | lang chaîne (obligatoire)scope chaîne : menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug> |
tranzly/get-site-stringsRenvoie le titre du site, le slogan et les textes des widgets dans une langue. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-site-strings/run | manage_options (propre vérification de la route REST) | lang chaîne (obligatoire) |
tranzly/get-support-connectionIndique si ce site est connecté au support de Zinn Digital®, et sous quelle identité. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-support-connection/run | manage_options (vérification propre à la route REST) | refresh booléen |
tranzly/get-term-groupListe le groupe de traduction d’une catégorie ou d’une étiquette. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-term-group/run | edit_post et edit_term (vérification propre à la route REST) | id chaîne (requis) |
tranzly/get-urlsRenvoie la façon dont les langues apparaissent dans les adresses (dossier, sous-domaine ou domaine), les slugs et bases traduits, ainsi que le noindex pour les pages non traduites. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-urls/run | manage_options (vérification propre à la route REST) | aucun |
tranzly/get-workflow-settingsRenvoie la traduction automatique lors de la publication et de la mise à jour, la relecture avant publication, ainsi que le seuil, le fournisseur et le modèle du contrôle de qualité par IA. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/get-workflow-settings/run | manage_options (vérification propre à la route REST) | aucun |
tranzly/import-from-sourceImporte la page suivante de traductions depuis une autre extension multilingue (mode : dry-run ou run ; cursor). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-from-source/run | manage_options (vérification propre à la route REST) | source chaîne (requis)mode chaîne : dry-run, run, undocursor chaîne |
tranzly/import-translation-fileÉcrit la page suivante de publications à partir d’un fichier de traduction téléversé (répétez avec after jusqu’à la fin). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/import-translation-file/run | edit_posts (vérification propre à la route REST) | token chaîne (requis)after entier |
tranzly/link-postDéfinit une publication existante (target) comme la traduction de cette publication dans une langue. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-post/run | edit_post et edit_term (vérification propre à la route REST) | id chaîne (requis)lang chaîne (requis)target entier (requis) |
tranzly/link-termDéfinit un terme existant (target) comme la traduction de ce terme dans une langue. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/link-term/run | edit_post et edit_term (vérification propre à la route REST) | id chaîne (requis)lang chaîne (requis)target entier (requis) |
tranzly/list-enginesListe les moteurs de traduction, indique si chacun est configuré et lequel est utilisé par défaut. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-engines/run | edit_posts | aucun |
tranzly/list-import-sourcesListe les données WPML, Polylang et TranslatePress trouvées sur ce site pouvant être importées. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-import-sources/run | manage_options (vérification propre à la route REST) | aucun |
tranzly/list-jobsListe les tâches de traduction en arrière-plan, de la plus récente à la plus ancienne, avec leur progression. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-jobs/run | edit_posts (vérification propre à la route REST) | aucun |
tranzly/list-languagesListe les langues du site. La première est la langue dans laquelle le contenu original est rédigé. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-languages/run | edit_posts | aucun |
tranzly/list-status-itemsListe les originaux avec leur état de traduction dans une langue (état : missing, stale, current), page par page. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-status-items/run | edit_posts (vérification propre à la route REST) | post_type chaînelang chaîne (requis)state chaîne : all, missing, stale, translated, human, machine, review, qualityafter entier |
tranzly/list-theme-stringsListe les thèmes et les extensions dont les textes peuvent être analysés pour la traduction, ainsi que le nombre de chaînes pour chacun. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/list-theme-strings/run | manage_options (vérification propre à la route REST) | aucun |
tranzly/open-support-ticketCrée un ticket de support (objet, message, type, e-mail), avec les diagnostics de ce site si l’administrateur ou l’administratrice a donné son accord. Ne crée ni n’envoie jamais d’identifiants de connexion. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/open-support-ticket/run | manage_options (vérification propre à la route REST) | subject chaîne (requis)message chaîne (requis)kind chaîne : help, bug, feedback, feature_requestemail chaînename chaînediagnostics booléen |
tranzly/record-support-consentEnregistre le consentement de l’administration pour envoyer les diagnostics avec les tickets de support. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/record-support-consent/run | manage_options (vérification propre à la route REST) | consent booléen (requis) |
tranzly/retry-job-itemRelance un élément ayant échoué (action : retry, éventuellement avec un autre moteur) ou le marque pour une traduction manuelle (action : by-hand). | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/retry-job-item/run | edit_post et manage_options (vérification propre de la route REST) | item chaîne (requis)action chaîne (requis)engine chaîne |
tranzly/review-translationApprouve une traduction (et la publie si l’original est publié) ou la renvoie (decision, note). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/review-translation/run | edit_post (vérification propre de la route REST) | id chaîne (requis)decision chaîne (requis) : approve, changes, pendingnote chaîne |
tranzly/run-legacy-importExécute l’import 2.x : simulation (rapport uniquement), exécution ou annulation. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/run-legacy-import/run | manage_options (vérification propre de la route REST) | action chaîne (requis) |
tranzly/scan-theme-stringsAnalyse la page suivante des fichiers PHP d’un composant à la recherche de textes traduisibles (à répéter avec after jusqu’à la fin). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/scan-theme-strings/run | manage_options (vérification propre de la route REST) | component chaîne (requis)after entier |
tranzly/schedule-quality-checkPlanifie le contrôle qualité par IA de la page suivante des traductions d’une langue (ou des publications spécifiées). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/schedule-quality-check/run | edit_posts (vérification propre de la route REST) | lang chaîne (requis)post_type chaîneposts tableauafter entier |
tranzly/seo-auditVérifie les traductions à la recherche de titres, descriptions, identifiants et balises hreflang SEO manquants dans une langue, page par page. | Pro | GET /wp-json/wp-abilities/v1/abilities/tranzly/seo-audit/run | manage_options (vérification propre de la route REST) | lang chaîne (requis)after entier |
tranzly/set-comments-settingPartage les commentaires entre les traductions d’une publication ou les conserve par langue (mode). | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-comments-setting/run | manage_options et moderate_comments (vérification propre de la route REST) | mode chaîne (requis) : off, show, translate |
tranzly/set-engine-keyEnregistre la clé d’API (et la région pour Microsoft) de DeepL, Google ou Microsoft ; laisser vide pour la supprimer. Les clés sont stockées chiffrées et ne sont jamais retournées. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-engine-key/run | manage_options (vérification propre de la route REST) | engine chaîne (requis)key chaîne (requis)region chaîne |
tranzly/set-menusAssigne un menu par langue et par emplacement (map). | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-menus/run | edit_theme_options (vérification propre de la route REST) | map objet (requis) |
tranzly/set-protectionProtège une traduction contre l’écrasement par le moteur (protected : true), ou la déverrouille. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-protection/run | edit_post (vérification propre de la route REST) | id chaîne (requis)protected booléen (requis) |
tranzly/set-shared-stringsEnregistre les traductions corrigées des textes de thèmes et d’extensions (strings) ; elles deviennent protégées. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-shared-strings/run | edit_theme_options (vérification propre de la route REST) | lang chaîne (requis)scope chaîne : menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>strings objet (requis) |
tranzly/set-site-stringEnregistre un texte de site (key) dans une langue, par exemple le titre ou le slogan du site. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-site-string/run | edit_theme_options et manage_options (vérification propre de la route REST) | lang chaîne (requis)key chaîne (requis)translation chaîne (requis) |
tranzly/set-urlsDéfinit le mode d’adresse (mode), les domaines par langue, les bases et segments traduits, noindex_untranslated et les suggestions d’identifiants. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/set-urls/run | manage_options (vérification propre de la route REST) | mode chaînesegments objetdomains objetbases objetsuggest booléennoindex_untranslated booléen |
tranzly/start-trialActive l’essai de 14 jours de Tranzly Pro pour ce site (sans obligation de paiement). | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/start-trial/run | manage_options (vérification propre de la route REST) | aucun |
tranzly/translate-media-fieldEnregistre le texte alternatif, le titre ou la légende d’une image (champ) dans une langue (lang). | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-media-field/run | edit_post (vérification propre à la route REST) | id chaîne (obligatoire)lang chaîne (obligatoire)field chaîne (obligatoire) : alt, caption, titletranslation chaîne (obligatoire) |
tranzly/translate-postTraduit une publication ou une page dans une ou plusieurs langues du site avec un moteur de traduction, en créant chaque traduction ou en la mettant à jour. Les nouvelles traductions sont des brouillons sauf si publish est défini sur true. Une traduction modifiée par une personne est ignorée sauf si force est défini sur true. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-post/run | peut traduire cette publication (edit_post sur celle-ci) ; edit_post sur une traduction existante ; droit de publication du type concerné pour publier | id entier (obligatoire)languages tableau (obligatoire)engine chaînepublish booléenforce booléen |
tranzly/translate-shared-stringsTraduit la page suivante de textes non traduits des thèmes et extensions dans une langue avec le moteur par défaut (répétez avec after jusqu’à la fin). | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-shared-strings/run | edit_theme_options (vérification propre à la route REST) | lang chaîne (obligatoire)scope chaîne : menus, site, templates, gettext.plugin-<slug>, gettext.theme-<slug>after entier |
tranzly/translate-siteUn flux de travail guidé : l’agent vérifie les langues et le moteur, estime le coût, et traduit ce qui manque, en demandant confirmation avant toute dépense ou publication. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-site/run | edit_posts | languages chaîne (obligatoire) |
tranzly/translate-termTraduit un terme (catégorie, étiquette ou attribut de produit) dans une langue (lang) avec un moteur, en créant ou mettant à jour sa traduction. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/translate-term/run | vérification des droits par élément propre à la route REST | id chaîne (obligatoire)lang chaîne (obligatoire)engine chaîneforce booléenstatus chaîne : publish, draft |
tranzly/translation-statusAvec un ID de publication : traduction de cette publication pour chaque langue, son état d’actualisation et sa paternité. Sans ID : niveau de traduction du site, par langue. | Gratuit | GET /wp-json/wp-abilities/v1/abilities/tranzly/translation-status/run | edit_post sur cette publication ; edit_posts pour le récapitulatif du site | id entierpost_type chaîne |
tranzly/unlink-postRetire une publication de son groupe de traduction ; elle conserve sa langue. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-post/run | edit_post et edit_term (vérification propre à la route REST) | id chaîne (obligatoire) |
tranzly/unlink-termRetire un terme de son groupe de traduction. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/unlink-term/run | edit_post et edit_term (vérification propre à la route REST) | id chaîne (obligatoire) |
tranzly/update-displayModifie le sélecteur (style, drapeaux, noms, emplacement) et la mention de crédit. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-display/run | manage_options (vérification propre à la route REST) | switcher objetcredit booléen |
tranzly/update-engine-settingsDéfinit le moteur par défaut, un moteur de secours, les moteurs par langue et les modèles d’IA par langue (default, fallback, per_lang, models, caps). Tout sauf le moteur par défaut nécessite la version Pro. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-engine-settings/run | manage_options (vérification propre à la route REST) | default chaîneper_lang objetfallback tableaucaps objetmodels objet |
tranzly/update-glossaryRemplace les parties du glossaire transmises (mots à ne jamais traduire, traductions de termes, ton) ; les éléments omis sont conservés. Utilisé par chaque moteur dès la traduction suivante. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-glossary/run | manage_options | dnt tableauterms objettone objet |
tranzly/update-settingsDéfinit les langues du site (languages : liste de codes et noms ; la première est la langue d’origine), le préfixe de classe de l’interface publique, et si les agents d’IA (MCP) sont autorisés. | Gratuit | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-settings/run | manage_options (vérification propre à la route REST) | prefix chaînemcp booléenlanguages tableau |
tranzly/update-workflow-settingsDéfinit on_update (off, stale, translate), on_publish, review, quality_threshold, quality_provider et quality_model. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/update-workflow-settings/run | manage_options (vérification propre à la route REST) | on_update chaîne : off, stale, translateon_publish booléenreview booléenquality_threshold entierquality_provider chaînequality_model chaîne |
tranzly/upload-translation-fileTéléverse un fichier XLIFF ou CSV Tranzly (contenu, nom de fichier) traduit ailleurs ; renvoie un jeton identifiant le téléversement pour l’importation. | Pro | POST /wp-json/wp-abilities/v1/abilities/tranzly/upload-translation-file/run | edit_posts (vérification propre à la route REST) | content chaîne (obligatoire)filename chaîne (obligatoire) |
Généré à partir du fichier abilities.json de l’extension, qui est lui-même généré à partir d’un site en ligne ; un test échoue en cas de divergence entre les deux.
Commandes WP-CLI
Exécutez-les sur le serveur avec WP-CLI. Chaque commande vérifie les mêmes autorisations que les écrans de l’extension ; les exemples sont tirés du texte d’aide de l’extension elle-même.
| Commande | Ce qu’elle fait | Édition |
|---|---|---|
wp tranzly create <id> [--term]wp tranzly create 42 --lang=de_DE --user=admin | Créer un brouillon de traduction d’une publication (ou d’un terme), lié à celle-ci. | Gratuit |
wp tranzly engines | Lister les moteurs de traduction. | Gratuit |
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 | Tâches de traduction en arrière-plan. | Gratuit |
wp tranzly legacy <action> [--format=<format>]wp tranzly legacy dry-runwp tranzly legacy runwp tranzly legacy undo | Afficher, tester à blanc (dry-run), exécuter ou annuler l’importation des traductions d’un ancien site Tranzly (2.x). | Gratuit |
wp tranzly link <source> <target> [--term] | Lier une publication (ou un terme) existante comme traduction d’une autre. | Gratuit |
wp tranzly network <action> [--languages=<codes>]wp tranzly network setupwp tranzly network languages --languages=en_US,de_DE,fr_FR | Multisite (Agency) : configurer chaque site du réseau, ou définir les langues initiales des nouveaux sites. | Gratuit |
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 | Traduire des publications avec un moteur. | Gratuit |
wp tranzly translations <id> [--term] [--format=<format>] | Lister les traductions d’une publication (ou d’un terme). | Gratuit |
Fonctions PHP
Fonctions que les thèmes et autres extensions peuvent appeler. Vérifiez d’abord avec function_exists() afin que votre code continue de fonctionner lorsque l’extension est inactive.
| Fonction | Description | Édition |
|---|---|---|
icl_object_id( $id, $type = 'post', $return_original_if_missing = false, $lang = null ) | WPML : traduction d’un objet. | Pro |
pll__( $text ) | Polylang : chaîne enregistrée, traduite. Tranzly traduit les chaînes de thèmes via le gettext natif de WordPress, la chaîne est donc renvoyée telle quelle. | Pro |
pll_current_language( $field = 'slug' ) | Polylang : langue actuelle. | Pro |
pll_default_language( $field = 'slug' ) | Polylang : langue par défaut. | Pro |
pll_e( $text ) | Polylang : affiche une chaîne enregistrée et échappée. | Pro |
pll_get_post( $post_id, $lang = null ) | Polylang : traduction d’une publication. | Pro |
pll_get_post_language( $post_id, $field = 'slug' ) | Polylang : langue d’une publication. | Pro |
pll_get_post_translations( $post_id ) | Polylang : toutes les traductions d’une publication, slug => ID. | Pro |
pll_get_term( $term_id, $lang = null ) | Polylang : traduction d’un terme. | Pro |
pll_get_term_language( $term_id, $field = 'slug' ) | Polylang : langue d’un terme. | Pro |
pll_get_term_translations( $term_id ) | Polylang : toutes les traductions d’un terme, slug => ID. | Pro |
pll_home_url( $lang = '' ) | Polylang : URL d’accueil dans une langue donnée. | Pro |
pll_is_translated_post_type( $post_type ) | Polylang : ce type de publication est-il traduit ? | Pro |
pll_is_translated_taxonomy( $taxonomy ) | Polylang : cette taxonomie est-elle traduite ? | Pro |
pll_languages_list( $args = array( ) | Polylang : liste des langues. | Pro |
pll_register_string() | Polylang : enregistre une chaîne (acceptée et ignorée — voir pll__()). | Pro |
pll_the_languages( $args = array( ) | Polylang : sélecteur de langue. `raw` renvoie le tableau Polylang (slug => détails) ; sinon une liste `<li>` au format Polylang, affichée sauf si `echo` vaut 0. Prend en compte `hide_current`, `hide_if_no_translation` et `display_names_as` (`name` ou `slug`). Une valeur `dropdown` est rendue sous forme de liste : utilisez plutôt le bloc/widget de sélection de Tranzly pour une liste déroulante. | Pro |
pll_translate_string( $text ) | Polylang : chaîne enregistrée dans une langue. Comme pour pll__(), la chaîne est renvoyée telle quelle. | Pro |
tranzly_compat_field( string $code, string $field ) | Un champ d’une langue, selon le vocabulaire de Polylang. | Pro |
tranzly_current_language(): string | Langue de la requête actuelle (code de locale WordPress tel que `fr_FR`). | Free |
tranzly_default_language(): string | Langue par défaut : la première de la liste. | Free |
tranzly_get_engines(): array | Moteurs disponibles : id => nom. | Free |
tranzly_get_post_language( int $post_id ): string | Langue de rédaction d’une publication. | Free |
tranzly_get_term_language( int $term_id ): string | Langue de rédaction d’un terme. | Free |
tranzly_get_term_translation( int $term_id, string $lang ): ?int | Traduction d’un terme dans une langue, ou null. | Free |
tranzly_get_term_translations( int $term_id ): array | Toutes les versions d’un terme : code de langue => ID du terme. | Free |
tranzly_get_translation( int $post_id, string $lang ): ?int | ID de la traduction d’une publication dans une langue, ou null si absente. Renvoie l’ID même de la publication si elle est déjà rédigée dans cette langue. | Free |
tranzly_get_translations( int $post_id ): array | Toutes les versions d’une publication, publication d’origine incluse : code de langue => ID de la publication. Une publication sans traduction ne renvoie qu’elle-même dans sa propre langue. | Free |
tranzly_language_switcher( array $args = array( ) | Code HTML d’un sélecteur de langue, pour tout thème, constructeur de page ou extension (T5). Utilisé par l’élément de Page Builder Sandwich, vous pouvez également l’appeler. Vide s’il existe moins de deux langues. | Free |
tranzly_language_url( string $lang, ?string $url = null ): string | URL affichant la langue demandée. | Free |
tranzly_languages(): array | Langues du site, la langue par défaut en premier. | Free |
tranzly_register_engine( Engine $engine ) | Ajoute un moteur de traduction. Appelez cette fonction lors de l’action `tranzly_register_engines`, ou à tout moment avant la première traduction de la requête. | Free |
tranzly_restore_language(): bool | Annule le dernier appel à tranzly_switch_language(). | Free |
tranzly_switch_language( string $lang ): bool | Exécute le code dans une autre langue jusqu’à l’appel de tranzly_restore_language() : la langue actuelle et les traductions natives de WordPress basculent toutes deux. S’imbrique comme switch_to_blog() : | Free |
tranzly_translatable_attributes( string $block_name ): array | Noms des attributs traduits par Tranzly pour un type de bloc : `role: content` dans son fichier block.json, modulé par le filtre `tranzly_translatable_attributes`. | Free |
tranzly_translate_post( int $post_id, string $lang, string $engine = '', array $args = array( ) | Traduire une publication dans une langue avec un moteur, en tant qu’utilisateur actuel ou utilisatrice actuelle (ses droits s’appliquent). | Gratuit |
Actions et filtres
Tous les hooks proposés par l’extension, accompagnés de la description issue de son code source. Les filtres modifient une valeur ; les actions vous permettent d’exécuter du code à un moment précis ; les points d’entrée sont des actions que vous déclenchez pour demander à l’extension d’effectuer une opération.
| Crochet | Type | Description | Paramètres | Édition |
|---|---|---|---|---|
tranzly_admin_bar | Action | Se déclenche après la création du menu Traductions dans la barre d’administration (l’éditeur visuel Pro y ajoute son élément « Traduire sur cette page »). | \WP_Admin_Bar $barint $id | Gratuit |
tranzly_admin_data | Filtre | Filtre les données de démarrage de l’application d’administration. La version premium l’utilise pour indiquer son édition ; aucune donnée sensible ne doit y figurer car elle est affichée dans la page. | aucun | Gratuit |
tranzly_ai_model | Filtre | Filtre le fournisseur d’IA et le modèle qui traduisent vers une langue. Version gratuite : le fournisseur et le modèle choisis pour la tâche `translate`, pour chaque langue. Tranzly Pro : le choix spécifique à la langue, sinon le choix défini pour « toutes les autres langues ». | string $target | Gratuit |
tranzly_ai_providers_in_use | Filtre | Filtre les fournisseurs d’IA sélectionnés pour des langues spécifiques. Aucun dans l’extension gratuite : chaque langue utilise le fournisseur et le modèle choisis pour la tâche `translate`. Tranzly Pro liste les fournisseurs de ses modèles par langue. | aucun | Gratuit |
tranzly_content_before_rebuild | Filtre | Filtre le contenu source juste avant que les segments traduits n’y soient insérés, par langue (le remplacement d’images par langue de la version Pro l’utilise). | string $contentstring $lang | Gratuit |
tranzly_copy_meta_keys | Filtre | Filtre les clés méta copiées depuis une publication vers sa nouvelle traduction. Rien d’autre n’est copié. | int $source_id | Gratuit |
tranzly_deepl_host | Filtre | Filtre l’hôte de l’API DeepL (un proxy ou une doublure de test). | string $hoststring $key | Gratuit |
tranzly_deepl_price_per_million | Filtre | Filtre le prix de DeepL par million de caractères en dollars américains. | float $price | Gratuit |
tranzly_default_engine | Filtre | Filtre l’identifiant du moteur utilisé lorsqu’aucun n’est spécifié. | string $id | Gratuit |
tranzly_engine_cap | Filtre | Filtre le plafond mensuel d’un moteur en dollars américains : aucun dans l’extension gratuite. | float|null $capstring $engine | Gratuit |
tranzly_engine_chain | Filtre | Filtre les moteurs à essayer pour une langue, par ordre de priorité. Version gratuite : le moteur par défaut. La version premium ajoute le moteur propre à la langue et la liste de secours. | string $langstring $first | Gratuit |
tranzly_engine_options | Filtre | Filtre les options transmises au moteur (liste des termes à ne pas traduire, glossaire, formalité, consignes). | string $targetEngine $engine | Gratuit |
tranzly_engine_settings_save | Filtre | Enregistre les moteurs et modèles d’IA par langue, la liste de secours et les plafonds mensuels. Seule la version premium y répond (règle 5 de WordPress.org : aucun comportement Pro dans l’extension gratuite). | aucun | Gratuit |
tranzly_frontend_prefix | Filtre | Filtre le préfixe de classe neutre pour le front-end. | string $prefix | Gratuit |
tranzly_fs_loaded | Action | Se déclenche une fois le SDK de licence chargé (dans le fichier principal, avant tout code Tranzly). Utilisez ce point d’accroche pour interagir avec `tranzly_fs()`. | aucun | Gratuit |
tranzly_glossary_options | Filtre | Filtre les options du moteur pour une langue cible : la liste des termes à ne pas traduire, ainsi que le glossaire et le ton lorsque la version premium les ajoute. | string $lang | Gratuit |
tranzly_glossary_save | Filtre | Enregistre les traductions préférées et le ton par langue. Seule la version premium y répond (règle 5 de WordPress.org : aucun comportement Pro dans l’extension gratuite). | aucun | Gratuit |
tranzly_google_price_per_million | Filtre | Filtre le prix de Google Cloud Translation par million de caractères, en dollars américains. | float $price | Pro |
tranzly_install_language_packs | Filtre | Indique si Tranzly installe les paquets de langue de WordPress, du thème et des extensions pour toute langue ajoutée au site (afin que les chaînes natives de WordPress et de WooCommerce apparaissent traduites). Activé par défaut. | bool $install | Gratuit |
tranzly_integration_available | Filtre | Filtre l’exécution d’une intégration lorsque son extension n’est pas détectée — pour les contenus laissés par un constructeur de page après sa désactivation, ou pour une extension chargée de manière inhabituelle. | bool $onstring $id | Gratuit |
tranzly_integrations | Filtre | Filtre les intégrations exécutées par Tranzly. Ajoutez une sous-classe `Integration` pour prendre en charge une autre extension. | aucun | Gratuit |
tranzly_is_pro | Filtre | Filtre l’état d’exécution de la version premium. Seule la version premium y répond. | bool $pro | Gratuit |
tranzly_job_created | Action | Se déclenche après la création d’une tâche de traduction. | int $jobint $items | Gratuit |
tranzly_job_finished | Action | Se déclenche lorsqu’une tâche de traduction n’a plus de travail restant. | int $job_id | Gratuit |
tranzly_kit_api_base | Filtre | Filtre la base de l’API Zinn Digital® appelée par les écrans de support. | string $base | Gratuit |
tranzly_kit_diagnostics | Filtre | Filtre les diagnostics avant que la personne propriétaire du site ne les voie. Une extension ajoute ses propres données sous `extra`. ⛔ S’exécute AVANT la prévisualisation, jamais entre la prévisualisation et l’envoi. | aucun | Gratuit |
tranzly_kit_footprint_free | Filtre | Filtre si ce site est exempt d’empreinte, afin que Zinn® Ads n’y soit jamais promu. | bool $footprint_free | Gratuit |
tranzly_kit_promotions | Filtre | Filtre le registre de promotions avant sa résolution. Ajoutez une ligne pour promouvoir un autre produit : `id`, `kind` (hosting|marketplace|platform|plugin|bundle|ads), `slot` (promo|cross-sell), et `url` ou (pour une extension) `name`, `site`, `main_files`. | aucun | Gratuit |
tranzly_kit_tier | Filtre | Filtre le niveau de plan signalé par le kit pour cette extension (tests et préproduction ; la licence décide en production). | string $tier | Gratuit |
tranzly_localize_links | Filtre | Filtre si Tranzly fait pointer les liens internes de cette page vers leurs traductions. | bool $localizestring $lang | Gratuit |
tranzly_memory_enabled | Filtre | Filtre si la mémoire de traduction est utilisée. | bool $on | Pro |
tranzly_microsoft_price_per_million | Filtre | Filtre le tarif de Microsoft Translator par million de caractères, en dollars américains. | float $price | Pro |
tranzly_network_enabled | Filtre | Filtre si la couche réseau pour multisite est activée. | bool $agency | Gratuit |
tranzly_pbs_internal_post_types | Filtre | Filtre les types de publication de Page Builder Sandwich que Tranzly ignore. | aucun | Gratuit |
tranzly_post_segments | Filtre | Filtre les segments d’une publication envoyés au moteur. Clé => `text` + `format` (`text` ou `html`). L’analyseur compatible avec les blocs et les intégrations ajoutent, divisent ou remplacent des segments ici, et les réécrivent sur `tranzly_translated_post_fields`. | \WP_Post $post | Gratuit |
tranzly_post_translated | Action | Se déclenche après qu’un moteur a traduit une publication (ou après l’écriture par un fichier humain ou une importation). | int $targetint $source_idstring $codestring $engine | Gratuit |
tranzly_post_translation_created | Action | Se déclenche après la création d’une traduction de publication par Tranzly. | int $new_idint $source_idstring $code | Gratuit |
tranzly_post_types | Filtre | Filtre les types de publication traduits par Tranzly. | aucun | Gratuit |
tranzly_pre_current_language | Filtre | Court-circuite la langue actuelle : renvoyez un code de langue pour l’utiliser. C’est ainsi que fonctionne tranzly_switch_language() ; renvoyez null pour laisser Tranzly décider. | string|null $lang | Gratuit |
tranzly_query_var | Filtre | Filtre la variable de requête qui sélectionne la langue. | string $var | Gratuit |
tranzly_queue_lease_seconds | Filtre | Filtre le bail sur un élément réservé : après celui-ci, un processus arrêté en cours de traitement rend l’élément aux autres. Doit dépasser la durée de la traduction la plus lente. | int $seconds | Gratuit |
tranzly_queue_worker_seconds | Filtre | Filtre la durée d’exécution d’un processus avant de passer la main, en secondes. | int $seconds | Gratuit |
tranzly_queue_workers | Filtre | Filtre le nombre de processus qu’une tâche exécute simultanément. Une limite sur les PROCESSUS, pour ménager le service de traduction ; jamais une limite sur le nombre d’éléments traités. | int $workersint $job_id | Gratuit |
tranzly_rate_source_ | Filtre | Taux d’une autre source (voir `tranzly_rate_sources`). | aucun | Pro |
tranzly_rate_sources | Filtre | Filtre les sources de taux de change. Ajoutez-en une avec un filtre `tranzly_rate_source_<id>` renvoyant `[ code => taux par rapport à sa référence ]`, ou une WP_Error. | aucun | Pro |
tranzly_register_engines | Action | Enregistrer les moteurs de traduction. Appelez `$registry->add( new Votre_Moteur() )`. | Registry $registry | Gratuit |
tranzly_relations_changed | Action | Se déclenche après la modification des liaisons de traduction d’objets : liés, déliés, déplacés vers une autre langue ou retirés. Se déclenche une fois par groupe touché, donc une seule liaison peut le déclencher deux fois. | string $typearray<int> $ids | Gratuit |
tranzly_robots_meta_keys | Filtre | Filtre les clés méta de publication contenant les réglages robots ; chacune suit l’original vers ses traductions. | aucun | Gratuit |
tranzly_shared_string_scopes | Filtre | Filtre les périmètres de texte partagé (voie L06, T6 : les intégrations ajoutent `woocommerce`, `forms` et `theme` ; leurs textes arrivent sur `tranzly_shared_strings`). | aucun | Gratuit |
tranzly_shared_strings | Filtre | Filtre les textes partagés que Tranzly traduit en tant que chaînes, par périmètre. La version Pro ajoute les modèles de blocs, les éléments de modèle et les compositions à `templates`. | string $scope | Gratuit |
tranzly_shared_strings_covered | Filtre | Filtre les textes d’un périmètre de texte partagé qu’un pack de langue traduit pour une langue. La version Pro signale les compositions enregistrées du thème et du cœur pour `templates`. | string $scopestring $lang | Gratuit |
tranzly_source_changed | Action | Se déclenche lorsque le contenu traduisible d’un original a changé, rendant ses traductions obsolètes. | int $post_idstring $nowstring $before | Gratuit |
tranzly_source_meta_keys | Filtre | Filtre les clés méta dont la modification rend obsolètes les traductions d’une page. Les intégrations ajoutent les clés qu’elles traduisent (données de constructeur de page, champs SEO, champs personnalisés). | int $post_id | Gratuit |
tranzly_source_published | Action | Se déclenche une fois lors de la première publication d’un original (après l’enregistrement de ses métadonnées). | int $post_id | Gratuit |
tranzly_style_rules_enabled | Filtre | Détermine si Tranzly applique les règles typographiques de l’équipe de traduction WordPress.org de la langue (guillemets, espaces autour de la ponctuation, apostrophes, points de suspension, espacement japonais, pronoms d’adresse) à chaque nouvelle traduction. Activé par défaut. | bool $enabledstring $locale | Gratuit |
tranzly_taxonomies | Filtre | Filtre les taxonomies que Tranzly traduit. | aucun | Gratuit |
tranzly_term_segments | Filtre | Filtre les segments d’un terme envoyés au moteur (`name`, `description`, ainsi que tout ce que les intégrations ajoutent : titres SEO, champs personnalisés). Écrivez les ajouts sur `tranzly_term_translated`. | \WP_Term $term | Gratuit |
tranzly_term_translated | Action | Se déclenche après la traduction d’un terme par un moteur, avec chaque segment traduit (les intégrations écrivent les segments qu’elles ont ajoutés sur `tranzly_term_segments`). | int $targetint $term_idstring $code | Gratuit |
tranzly_term_translation_created | Action | Se déclenche après la création par Tranzly de la traduction d’un terme. | int $new_idint $term_idstring $code | Gratuit |
tranzly_translatable_attributes | Filtre | Filtre les attributs que Tranzly traduit pour un type de bloc. | string $block_name | Gratuit |
tranzly_translate_string | Filtre | Filtre une chaîne traduisible vers une langue. | string $valuestring $codearray $context | Gratuit |
tranzly_translated_post_fields | Filtre | Filtre les champs de publication enregistrés dans une traduction, après l’exécution du moteur. Les intégrations ayant ajouté leurs propres segments (champs personnalisés, données de constructeur de page) les écrivent ici. | \WP_Post $poststring $code | Gratuit |
tranzly_translation_memory | Filtre | Filtre la mémoire de traduction utilisée : aucune dans l’extension gratuite ; la version payante en propose une (docs/843, consigne 5 de WordPress.org). | Translation_Memory|null $memory | Gratuit |