By default a translation is saved as soon as the AI returns a well-formed answer. The plugin
\nchecks that the answer is valid JSON and that its fields match the ones that were sent \u2014 it does
\nnot read the text. If the model mistranslates a term, the mistranslation goes live.<\/p>\n
The Typical uses:<\/p>\n What it cannot do.<\/strong> These are text checks, not comprehension. A translation that reverses the It runs for post translations and String Translation batches, in both background and synchronous In delta mode<\/strong> (“Translate only changed strings”) the filter only ever sees the fields that Return the array with whatever changes you want saved.<\/p>\n Fields you remove from the array are not written: the field keeps the translation it already had, Return a A retry sends the same prompt again.<\/strong> Nothing tells the model what you objected to, so a model What it does By default a translation is saved as soon as the AI returns a well-formed answer. The plugin checks that the answer is valid\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_latwm_translated_slug":"","footnotes":""},"categories":[3],"tags":[],"class_list":["post-62","post","type-post","status-publish","format-standard","hentry","category-latw-for-wpml"],"_links":{"self":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/62","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/comments?post=62"}],"version-history":[{"count":2,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/62\/revisions"}],"predecessor-version":[{"id":78,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/posts\/62\/revisions\/78"}],"wp:attachment":[{"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/media?parent=62"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/categories?post=62"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.latw.ai\/pl\/wp-json\/wp\/v2\/tags?post=62"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}latwaitr_translated_strings<\/code> filter is the point where your site can look at the finished
\ntranslation before<\/em> WPML writes it, and either correct it or reject it.<\/p>\n\n
\nmeaning of a sentence while keeping every number, tag and glossary term intact will pass every
\ndeterministic rule you write here. Catching that needs a second AI call, which this filter lets
\nyou make, but does not make for you.<\/p>\nWhere it runs<\/h2>\n
AI answers \u2192 JSON parsed \u2192 fields matched to WPML tids \u2192 latwaitr_translated_strings \u2192 WPML saves<\/code><\/pre>\n
\nmode, and on the same cron process that saves the translation. Taxonomy term translations do not
\ngo through it.<\/p>\n
\nwere actually sent to the AI. The unchanged parts of the post keep their existing translation and
\nnever reach your code \u2014 so a check that needs to see the whole post should load the target post
\nitself rather than assume $strings<\/code> is complete.<\/p>\nThe filter<\/h2>\n
add_filter( 'latwaitr_translated_strings', function ( $strings, $context ) {\n return $strings;\n}, 10, 2 );<\/code><\/pre>\n$strings<\/code> is an array of field name => translated text<\/code>. The field names are WPML’s
\n(title<\/code>, body<\/code>, field-<something><\/code> for page builders, and so on).<\/p>\n$context<\/code> describes the job:<\/p>\n\n\n
\n \nKey<\/th>\n Type<\/th>\n Meaning<\/th>\n<\/tr>\n<\/thead>\n \n source<\/code><\/td>\narray<\/td>\n The same field names, holding the source<\/strong> text that was sent.<\/td>\n<\/tr>\n \n source_lang<\/code><\/td>\nstring<\/td>\n Language code translated from, e.g. en<\/code>.<\/td>\n<\/tr>\n\n target_lang<\/code><\/td>\nstring<\/td>\n Language code translated into, e.g. de<\/code>.<\/td>\n<\/tr>\n\n source_post_id<\/code><\/td>\nint<\/td>\n The original post. 0<\/code> for String Translation batches.<\/td>\n<\/tr>\n\n element_type<\/code><\/td>\nstring<\/td>\n ts_job<\/code> for posts, ts_string_job<\/code> for String Translation batches.<\/td>\n<\/tr>\n\n model<\/code><\/td>\nstring<\/td>\n The model this job was actually sent to.<\/td>\n<\/tr>\n \n wpml_job_id<\/code><\/td>\nint<\/td>\n WPML translation job id.<\/td>\n<\/tr>\n \n translation_id<\/code><\/td>\nint<\/td>\n Row id in the plugin’s queue table, as shown on the Translations screen.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Returning a corrected translation<\/h3>\n
\/\/ Editors kept fixing this one word by hand after every translation.\nadd_filter( 'latwaitr_translated_strings', function ( $strings, $context ) {\n if ( $context['target_lang'] !== 'de' ) {\n return $strings;\n }\n\n foreach ( $strings as $field => $translated ) {\n $strings[ $field ] = str_replace( 'Bodensatz', 'Sediment', $translated );\n }\n\n return $strings;\n}, 10, 2 );<\/code><\/pre>\n
\nrather than being emptied. Fields you add are ignored \u2014 WPML has no place to put a field that was
\nnever part of the job. A return value that is not an array is ignored, and the model’s translation
\nis saved unchanged.<\/p>\nRejecting a translation<\/h3>\n
WP_Error<\/code> and nothing is saved. The job is then treated exactly like a failed API call:
\nit is sent to the model again, up to three attempts in total, and parked as failed<\/strong> after that.
\nThe post keeps whatever translation it had before, and the reason is stored on the queue row and
\nwritten to the log.<\/p>\n\/\/ Words that must never appear, per language.\nadd_filter( 'latwaitr_translated_strings', function ( $strings, $context ) {\n $banned = array(\n 'de' => array( '\/bBodensatzb\/u' ),\n 'it' => array( '\/bspremiagrumib\/iu' ),\n 'hr' => array( '\/bpresudab\/iu' ),\n );\n\n if ( empty( $banned[ $context['target_lang'] ] ) ) {\n return $strings;\n }\n\n foreach ( $strings as $field => $translated ) {\n foreach ( $banned[ $context['target_lang'] ] as $pattern ) {\n if ( preg_match( $pattern, $translated ) ) {\n return new WP_Error(\n 'latwaitrp_banned_term',\n sprintf( 'Banned term in field \"%s\" (%s)', $field, $pattern )\n );\n }\n }\n }\n\n return $strings;\n}, 10, 2 );<\/code><\/pre>\n\/\/ Every measurement in the source must appear in the translation.\nadd_filter( 'latwaitr_translated_strings', function ( $strings, $context ) {\n $measurement = '\/d+(?:[.,]d+)?s?(?:mm|cm|m|ml|l|g|kg|%)b\/u';\n\n foreach ( $strings as $field => $translated ) {\n $source = isset( $context['source'][ $field ] ) ? $context['source'][ $field ] : '';\n\n preg_match_all( $measurement, wp_strip_all_tags( $source ), $in_source );\n preg_match_all( $measurement, wp_strip_all_tags( $translated ), $in_translation );\n\n if ( count( $in_source[0] ) !== count( $in_translation[0] ) ) {\n return new WP_Error(\n 'latwaitrp_measurements_lost',\n sprintf(\n 'Field \"%s\": %d measurements in the source, %d in the translation.',\n $field,\n count( $in_source[0] ),\n count( $in_translation[0] )\n )\n );\n }\n }\n\n return $strings;\n}, 10, 2 );<\/code><\/pre>\n
\nthat made a deliberate word choice will usually make it again and the job will end up failed after
\nthree attempts \u2014 at your provider’s expense. Rejection is best used for mistakes a model makes
\noccasionally<\/em> (a dropped number, a truncated field). For a word the model keeps choosing, correct
\nit in the filter, add the preferred term to the glossary, or say so in the translation prompt.<\/p>\nWhere to check on it<\/h2>\n
\n
Retrying (attempt 1): Rejected: \u2026<\/code>, or Max retries exceeded. Last error: Rejected: \u2026<\/code>.<\/li>\nTranslation rejected by latwaitr_translated_strings<\/code> with the field and
\nthe error message, and Retrying failed response<\/code> for each new attempt.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"