Compare commits

..
13 changed files with 121 additions and 322 deletions

View file

@ -1,35 +1,5 @@
== Changelog == == Changelog ==
= 1.3.0 =
_Release date: 2026-11-04_
**Highlights**
* New "AI provider" setting: pin translations to a specific configured AI provider instead of relying on the WordPress AI client automatic selection.
**Added**
* "AI provider" dropdown in the site and network settings pages. Options: "Automatic (WordPress picks the provider)" (default, previous behavior) and every provider registered with the WordPress AI client that has configured credentials. The selection is applied server-side through the AI client's `using_provider()` API to every translation path (editor REST endpoints, WP-CLI, MultilingualPress integration). Submitted values are validated against the live provider list; unknown or deconfigured providers fall back to "Automatic" when the form is saved.
**Changed**
* `AI_Translator_Admin::__construct()` now requires a third parameter, `AI_Translator_Translator $translator`. Third-party code constructing this internal class directly must pass it.
**Compatibility**
* WordPress: 7.0 - 7.2
* PHP: 8.3 - 8.6
* WP-CLI: 2.12 or newer
**Tests**
* PHP Coding Standards: WordPress-Core, WordPress-Docs, WordPress-Extra (0 errors, 0 warnings)
* PHPCompatibility: 8.3 - 8.6 (declared range) and 5.6 - 8.6 (informational full range) — 0 errors
* PHPStan: level max/10, no baseline (incl. wp-compat @ Requires at least 7.0)
* PHPUnit: 68/68 tests passing (single-site) on WordPress 7.2-beta4 / PHP 8.6, including new tests for the provider setting and the provider list helper
* composer audit: no known CVEs
= 1.2.4 = = 1.2.4 =
_Release date: 2026-11-04_ _Release date: 2026-11-04_

View file

@ -67,28 +67,17 @@ if ( ! class_exists( 'AI_Translator_Admin' ) ) {
*/ */
private $manager_notice; private $manager_notice;
/**
* Translator handler, used to list the available AI providers.
*
* @since 1.3.0
* @var AI_Translator_Translator
*/
private $translator;
/** /**
* Constructor. * Constructor.
* *
* @since 1.0.0 * @since 1.0.0
* @since 1.3.0 Added the $translator parameter.
* *
* @param AI_Translator_Settings $settings Settings handler. * @param AI_Translator_Settings $settings Settings handler.
* @param AI_Translator_Manager_Notice $manager_notice Manager notice handler. * @param AI_Translator_Manager_Notice $manager_notice Manager notice handler.
* @param AI_Translator_Translator $translator Translator handler.
*/ */
public function __construct( AI_Translator_Settings $settings, AI_Translator_Manager_Notice $manager_notice, AI_Translator_Translator $translator ) { public function __construct( AI_Translator_Settings $settings, AI_Translator_Manager_Notice $manager_notice ) {
$this->settings = $settings; $this->settings = $settings;
$this->manager_notice = $manager_notice; $this->manager_notice = $manager_notice;
$this->translator = $translator;
} }
/** /**
@ -302,8 +291,6 @@ if ( ! class_exists( 'AI_Translator_Admin' ) ) {
</td> </td>
</tr> </tr>
<?php $this->render_provider_field( $current, 'ai-translator' ); ?>
<?php if ( class_exists( '\Inpsyde\MultilingualPress\TranslationUi\Post\MetaboxAction' ) ) : ?> <?php if ( class_exists( '\Inpsyde\MultilingualPress\TranslationUi\Post\MetaboxAction' ) ) : ?>
<tr> <tr>
<th scope="row"><?php echo esc_html__( 'MultilingualPress', 'robotstxt-ai-translator' ); ?></th> <th scope="row"><?php echo esc_html__( 'MultilingualPress', 'robotstxt-ai-translator' ); ?></th>
@ -450,8 +437,6 @@ if ( ! class_exists( 'AI_Translator_Admin' ) ) {
</td> </td>
</tr> </tr>
<?php $this->render_provider_field( $network, 'ai-translator-net' ); ?>
<?php if ( class_exists( '\Inpsyde\MultilingualPress\TranslationUi\Post\MetaboxAction' ) ) : ?> <?php if ( class_exists( '\Inpsyde\MultilingualPress\TranslationUi\Post\MetaboxAction' ) ) : ?>
<tr> <tr>
<th scope="row"><?php echo esc_html__( 'MultilingualPress', 'robotstxt-ai-translator' ); ?></th> <th scope="row"><?php echo esc_html__( 'MultilingualPress', 'robotstxt-ai-translator' ); ?></th>
@ -552,68 +537,6 @@ if ( ! class_exists( 'AI_Translator_Admin' ) ) {
exit; exit;
} }
/**
* Renders the AI provider selector row shared by the site and network forms.
*
* @since 1.3.0
*
* @param array<string,bool|int|string> $current Effective settings for the form being rendered.
* @param string $id_base Unique prefix for the element IDs ('ai-translator' or 'ai-translator-net').
*
* @return void
*/
private function render_provider_field( array $current, $id_base ) {
$providers = $this->translator->get_available_providers();
$selected = isset( $current['ai_provider'] ) && is_string( $current['ai_provider'] ) ? $current['ai_provider'] : '';
?>
<tr>
<th scope="row">
<label for="<?php echo esc_attr( $id_base ); ?>-ai-provider"><?php echo esc_html__( 'AI provider', 'robotstxt-ai-translator' ); ?></label>
</th>
<td>
<select id="<?php echo esc_attr( $id_base ); ?>-ai-provider" name="ai_translator_settings[ai_provider]">
<option value="" <?php selected( $selected, '' ); ?>>
<?php echo esc_html__( 'Automatic (WordPress picks the provider)', 'robotstxt-ai-translator' ); ?>
</option>
<?php foreach ( $providers as $provider ) : ?>
<option value="<?php echo esc_attr( $provider['id'] ); ?>" <?php selected( $selected, $provider['id'] ); ?>>
<?php echo esc_html( $provider['name'] ); ?>
</option>
<?php endforeach; ?>
</select>
<p class="description">
<?php echo esc_html__( 'Provider used for translations. Only providers with configured credentials are listed.', 'robotstxt-ai-translator' ); ?>
</p>
</td>
</tr>
<?php
}
/**
* Sanitises the AI provider selection against the available providers.
*
* @since 1.3.0
*
* @param mixed $raw Raw value from the form.
*
* @return string Provider ID, or an empty string for "Automatic".
*/
private function sanitize_provider( $raw ) {
if ( ! is_string( $raw ) || '' === $raw ) {
return '';
}
$value = strtolower( trim( $raw ) );
foreach ( $this->translator->get_available_providers() as $provider ) {
if ( $provider['id'] === $value ) {
return $value;
}
}
return '';
}
/** /**
* Renders the model recommendations table. * Renders the model recommendations table.
* *
@ -735,7 +658,7 @@ if ( ! class_exists( 'AI_Translator_Admin' ) ) {
* only the known schema keys are read, so integer * only the known schema keys are read, so integer
* keys and unexpected values are ignored. * keys and unexpected values are ignored.
* *
* @return array<string,bool|int|string> * @return array<string,bool|int>
*/ */
private function sanitize_settings( array $raw ) { private function sanitize_settings( array $raw ) {
return array( return array(
@ -744,7 +667,6 @@ if ( ! class_exists( 'AI_Translator_Admin' ) ) {
'translate_excerpt' => ! empty( $raw['translate_excerpt'] ), 'translate_excerpt' => ! empty( $raw['translate_excerpt'] ),
'auto_translate_on_mlp_create' => ! empty( $raw['auto_translate_on_mlp_create'] ), 'auto_translate_on_mlp_create' => ! empty( $raw['auto_translate_on_mlp_create'] ),
'request_timeout' => max( 30, min( 300, isset( $raw['request_timeout'] ) && is_numeric( $raw['request_timeout'] ) ? (int) $raw['request_timeout'] : 60 ) ), 'request_timeout' => max( 30, min( 300, isset( $raw['request_timeout'] ) && is_numeric( $raw['request_timeout'] ) ? (int) $raw['request_timeout'] : 60 ) ),
'ai_provider' => $this->sanitize_provider( isset( $raw['ai_provider'] ) ? $raw['ai_provider'] : '' ),
); );
} }
} }

View file

@ -51,11 +51,10 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
/** /**
* Default settings values. * Default settings values.
* *
* Boolean keys are coerced to bool on read/write; integer keys to int; * Boolean keys are coerced to bool on read/write; integer keys to int.
* string keys to string.
* *
* @since 1.0.0 * @since 1.0.0
* @var array<string,bool|int|string> * @var array<string,bool|int>
*/ */
const DEFAULTS = array( const DEFAULTS = array(
'translate_title' => true, 'translate_title' => true,
@ -63,7 +62,6 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
'translate_excerpt' => true, 'translate_excerpt' => true,
'auto_translate_on_mlp_create' => false, 'auto_translate_on_mlp_create' => false,
'request_timeout' => 60, 'request_timeout' => 60,
'ai_provider' => '',
); );
/** /**
@ -109,7 +107,7 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
* *
* @param int|null $blog_id Optional blog ID. Defaults to the current site. * @param int|null $blog_id Optional blog ID. Defaults to the current site.
* *
* @return array<string,bool|int|string> Settings array with typed values. * @return array<string,bool|int> Settings array with typed values.
*/ */
public function get_settings( $blog_id = null ) { public function get_settings( $blog_id = null ) {
if ( ! is_multisite() ) { if ( ! is_multisite() ) {
@ -144,7 +142,7 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
* *
* @since 1.0.0 * @since 1.0.0
* *
* @return array<string,bool|int|string> * @return array<string,bool|int>
*/ */
public function get_network_settings() { public function get_network_settings() {
return $this->normalize( (array) get_site_option( self::OPTION_NETWORK, array() ) ); return $this->normalize( (array) get_site_option( self::OPTION_NETWORK, array() ) );
@ -155,7 +153,7 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
* *
* @since 1.0.0 * @since 1.0.0
* *
* @return array<string,bool|int|string> * @return array<string,bool|int>
*/ */
public function get_site_settings() { public function get_site_settings() {
return $this->normalize( (array) get_option( self::OPTION_SITE, array() ) ); return $this->normalize( (array) get_option( self::OPTION_SITE, array() ) );
@ -166,7 +164,7 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
* *
* @since 1.0.0 * @since 1.0.0
* *
* @param array<string,bool|int|string> $settings Settings to store. * @param array<string,bool|int> $settings Settings to store.
* *
* @return bool True on success. * @return bool True on success.
*/ */
@ -183,7 +181,7 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
* *
* @since 1.0.0 * @since 1.0.0
* *
* @param array<string,bool|int|string> $settings Settings to store. * @param array<string,bool|int> $settings Settings to store.
* *
* @return bool True on success. * @return bool True on success.
*/ */
@ -194,16 +192,15 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
/** /**
* Normalises raw settings into a typed array matching the schema. * Normalises raw settings into a typed array matching the schema.
* *
* Boolean keys are coerced to strict bool; integer keys to strict int; * Boolean keys are coerced to strict bool; integer keys to strict int.
* string keys to trimmed, lowercased strings. The DEFAULTS constant is * The DEFAULTS constant is the authoritative schema: any key not present
* the authoritative schema: any key not present there is silently * there is silently dropped, and any missing key falls back to its default.
* dropped, and any missing key falls back to its default.
* *
* @since 1.0.0 * @since 1.0.0
* *
* @param array<int|string,mixed> $settings Raw settings. * @param array<int|string,mixed> $settings Raw settings.
* *
* @return array<string,bool|int|string> * @return array<string,bool|int>
*/ */
private function normalize( array $settings ) { private function normalize( array $settings ) {
$normalized = array(); $normalized = array();
@ -215,8 +212,6 @@ if ( ! class_exists( 'AI_Translator_Settings' ) ) {
// Reject non-numeric input instead of casting it: garbage // Reject non-numeric input instead of casting it: garbage
// falls back to the schema default. // falls back to the schema default.
$normalized[ $key ] = is_numeric( $value ) ? (int) $value : $default; $normalized[ $key ] = is_numeric( $value ) ? (int) $value : $default;
} elseif ( is_string( $default ) ) {
$normalized[ $key ] = is_scalar( $settings[ $key ] ) ? strtolower( trim( (string) $settings[ $key ] ) ) : $default;
} else { } else {
$normalized[ $key ] = (bool) $settings[ $key ]; $normalized[ $key ] = (bool) $settings[ $key ];
} }

View file

@ -134,45 +134,6 @@ if ( ! class_exists( 'AI_Translator_Translator' ) ) {
} }
} }
/**
* Returns the AI providers available for translation on this site.
*
* Only providers registered with the WordPress AI client (core since
* WordPress 7.0) that also have their credentials configured are
* listed, since those are the only ones capable of serving requests.
*
* @since 1.3.0
*
* @return array<int,array{id:string,name:string}> List of provider IDs and names.
*/
public function get_available_providers() {
$registry = \WordPress\AiClient\AiClient::defaultRegistry();
$providers = array();
foreach ( $registry->getRegisteredProviderIds() as $provider_id ) {
$provider_id = (string) $provider_id;
try {
if ( ! $registry->isProviderConfigured( $provider_id ) ) {
continue;
}
$name = $registry->getProviderClassName( $provider_id )::metadata()->getName();
} catch ( Throwable $e ) {
// A misbehaving provider must not break the settings page:
// skip it and keep enumerating the rest.
continue;
}
$providers[] = array(
'id' => $provider_id,
'name' => '' !== $name ? $name : $provider_id,
);
}
return $providers;
}
/** /**
* Translates a single piece of text to the target locale. * Translates a single piece of text to the target locale.
* *
@ -234,15 +195,7 @@ if ( ! class_exists( 'AI_Translator_Translator' ) ) {
add_filter( 'wp_ai_client_default_request_timeout', array( $this, 'filter_ai_default_timeout' ), PHP_INT_MAX ); add_filter( 'wp_ai_client_default_request_timeout', array( $this, 'filter_ai_default_timeout' ), PHP_INT_MAX );
try { try {
$prompt = wp_ai_client_prompt( $text ); $result = wp_ai_client_prompt( $text )
// Pin the configured provider when one is selected. An empty
// value keeps the WordPress AI client default resolution.
if ( isset( $site_settings['ai_provider'] ) && is_string( $site_settings['ai_provider'] ) && '' !== $site_settings['ai_provider'] ) {
$prompt = $prompt->using_provider( $site_settings['ai_provider'] );
}
$result = $prompt
->using_system_instruction( $system_instruction ) ->using_system_instruction( $system_instruction )
->generate_text(); ->generate_text();
} catch ( Exception $e ) { } catch ( Exception $e ) {

File diff suppressed because one or more lines are too long

View file

@ -1,10 +1,10 @@
msgid "" msgid ""
msgstr "" msgstr ""
"Project-Id-Version: AI Translator (by ROBOTSTXT) 1.3.0\n" "Project-Id-Version: AI Translator (by ROBOTSTXT) 1.2.3\n"
"Report-Msgid-Bugs-To: https://www.robotstxt.software/plugins/robotstxt-ai-" "Report-Msgid-Bugs-To: https://www.robotstxt.software/plugins/robotstxt-ai-"
"translator/\n" "translator/\n"
"POT-Creation-Date: 2026-08-24T11:03:38+00:00\n" "POT-Creation-Date: 2026-08-24T11:03:38+00:00\n"
"PO-Revision-Date: 2026-11-04 17:20+0000\n" "PO-Revision-Date: 2026-08-24 11:17+0000\n"
"Last-Translator: ROBOTSTXT <hello@robotstxt.es>\n" "Last-Translator: ROBOTSTXT <hello@robotstxt.es>\n"
"Language-Team: Catalan\n" "Language-Team: Catalan\n"
"Language: ca\n" "Language: ca\n"
@ -549,19 +549,3 @@ msgstr ""
#: robotstxt-ai-translator.php:146 #: robotstxt-ai-translator.php:146
msgid "Settings → AI" msgid "Settings → AI"
msgstr "Ajustos → IA" msgstr "Ajustos → IA"
#: includes/class-ai-translator-admin.php
msgid "AI provider"
msgstr "Proveïdor d'IA"
#: includes/class-ai-translator-admin.php
msgid "Automatic (WordPress picks the provider)"
msgstr "Automàtic (el WordPress tria el proveïdor)"
#: includes/class-ai-translator-admin.php
msgid ""
"Provider used for translations. Only providers with configured credentials "
"are listed."
msgstr ""
"Proveïdor utilitzat per a les traduccions. Només es llisten els proveïdors "
"amb credencials configurades."

File diff suppressed because one or more lines are too long

View file

@ -1,10 +1,10 @@
msgid "" msgid ""
msgstr "" msgstr ""
"Project-Id-Version: AI Translator (by ROBOTSTXT) 1.3.0\n" "Project-Id-Version: AI Translator (by ROBOTSTXT) 1.2.3\n"
"Report-Msgid-Bugs-To: https://www.robotstxt.software/plugins/robotstxt-ai-" "Report-Msgid-Bugs-To: https://www.robotstxt.software/plugins/robotstxt-ai-"
"translator/\n" "translator/\n"
"POT-Creation-Date: 2026-08-24T11:03:38+00:00\n" "POT-Creation-Date: 2026-08-24T11:03:38+00:00\n"
"PO-Revision-Date: 2026-11-04 17:20+0000\n" "PO-Revision-Date: 2026-08-24 11:17+0000\n"
"Last-Translator: ROBOTSTXT <hello@robotstxt.es>\n" "Last-Translator: ROBOTSTXT <hello@robotstxt.es>\n"
"Language-Team: Spanish (Spain)\n" "Language-Team: Spanish (Spain)\n"
"Language: es_ES\n" "Language: es_ES\n"
@ -551,19 +551,3 @@ msgstr ""
#: robotstxt-ai-translator.php:146 #: robotstxt-ai-translator.php:146
msgid "Settings → AI" msgid "Settings → AI"
msgstr "Ajustes → IA" msgstr "Ajustes → IA"
#: includes/class-ai-translator-admin.php
msgid "AI provider"
msgstr "Proveedor de IA"
#: includes/class-ai-translator-admin.php
msgid "Automatic (WordPress picks the provider)"
msgstr "Automático (WordPress elige el proveedor)"
#: includes/class-ai-translator-admin.php
msgid ""
"Provider used for translations. Only providers with configured credentials "
"are listed."
msgstr ""
"Proveedor utilizado para las traducciones. Solo se listan los proveedores "
"con credenciales configuradas."

View file

@ -2,14 +2,14 @@
# This file is distributed under the GPL-3.0-or-later. # This file is distributed under the GPL-3.0-or-later.
msgid "" msgid ""
msgstr "" msgstr ""
"Project-Id-Version: AI Translator (by ROBOTSTXT) 1.3.0\n" "Project-Id-Version: AI Translator (by ROBOTSTXT) 1.2.4\n"
"Report-Msgid-Bugs-To: https://www.robotstxt.software/plugins/robotstxt-ai-translator/\n" "Report-Msgid-Bugs-To: https://www.robotstxt.software/plugins/robotstxt-ai-translator/\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n" "Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n" "MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n" "Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n" "Content-Transfer-Encoding: 8bit\n"
"POT-Creation-Date: 2026-11-04T17:00:52+00:00\n" "POT-Creation-Date: 2026-11-04T15:09:57+00:00\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"X-Generator: WP-CLI 2.12.0\n" "X-Generator: WP-CLI 2.12.0\n"
"X-Domain: robotstxt-ai-translator\n" "X-Domain: robotstxt-ai-translator\n"
@ -39,274 +39,262 @@ msgstr ""
msgid "https://www.robotstxt.software/" msgid "https://www.robotstxt.software/"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:133 #: includes/class-ai-translator-admin.php:122
#: includes/class-ai-translator-admin.php:134 #: includes/class-ai-translator-admin.php:123
#: includes/class-ai-translator-admin.php:151 #: includes/class-ai-translator-admin.php:140
#: includes/class-ai-translator-admin.php:152 #: includes/class-ai-translator-admin.php:141
#: includes/class-ai-translator-editor-ui.php:402 #: includes/class-ai-translator-editor-ui.php:402
#: includes/class-ai-translator-editor-ui.php:558 #: includes/class-ai-translator-editor-ui.php:558
msgid "AI Translator" msgid "AI Translator"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:174 #: includes/class-ai-translator-admin.php:163
#: includes/class-ai-translator-admin.php:192 #: includes/class-ai-translator-admin.php:181
msgid "Settings" msgid "Settings"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:208 #: includes/class-ai-translator-admin.php:197
#: includes/class-ai-translator-admin.php:346 #: includes/class-ai-translator-admin.php:333
msgid "You do not have permission to access this page." msgid "You do not have permission to access this page."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:217 #: includes/class-ai-translator-admin.php:206
msgid "AI Translator Settings" msgid "AI Translator Settings"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:223 #: includes/class-ai-translator-admin.php:212
msgid "Settings saved." msgid "Settings saved."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:234 #: includes/class-ai-translator-admin.php:223
#: includes/class-ai-translator-admin.php:237 #: includes/class-ai-translator-admin.php:226
#: includes/class-ai-translator-admin.php:391 #: includes/class-ai-translator-admin.php:378
#: includes/class-ai-translator-admin.php:395 #: includes/class-ai-translator-admin.php:382
msgid "Translation fields" msgid "Translation fields"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:241 #: includes/class-ai-translator-admin.php:230
#: includes/class-ai-translator-admin.php:399 #: includes/class-ai-translator-admin.php:386
#: includes/class-ai-translator-editor-ui.php:565 #: includes/class-ai-translator-editor-ui.php:565
msgid "Translate title" msgid "Translate title"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:246 #: includes/class-ai-translator-admin.php:235
#: includes/class-ai-translator-admin.php:404 #: includes/class-ai-translator-admin.php:391
#: includes/class-ai-translator-editor-ui.php:566 #: includes/class-ai-translator-editor-ui.php:566
msgid "Translate content" msgid "Translate content"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:251 #: includes/class-ai-translator-admin.php:240
#: includes/class-ai-translator-admin.php:409 #: includes/class-ai-translator-admin.php:396
#: includes/class-ai-translator-editor-ui.php:567 #: includes/class-ai-translator-editor-ui.php:567
msgid "Translate excerpt" msgid "Translate excerpt"
msgstr "" msgstr ""
#. translators: 1: title default, 2: content default, 3: excerpt default. #. translators: 1: title default, 2: content default, 3: excerpt default.
#: includes/class-ai-translator-admin.php:259 #: includes/class-ai-translator-admin.php:248
#, php-format #, php-format
msgid "Network defaults: title %1$s, content %2$s, excerpt %3$s." msgid "Network defaults: title %1$s, content %2$s, excerpt %3$s."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:260 #: includes/class-ai-translator-admin.php:249
#: includes/class-ai-translator-admin.php:261 #: includes/class-ai-translator-admin.php:250
#: includes/class-ai-translator-admin.php:262 #: includes/class-ai-translator-admin.php:251
msgid "enabled" msgid "enabled"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:260 #: includes/class-ai-translator-admin.php:249
#: includes/class-ai-translator-admin.php:261 #: includes/class-ai-translator-admin.php:250
#: includes/class-ai-translator-admin.php:262 #: includes/class-ai-translator-admin.php:251
msgid "disabled" msgid "disabled"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:273 #: includes/class-ai-translator-admin.php:262
#: includes/class-ai-translator-admin.php:421 #: includes/class-ai-translator-admin.php:408
msgid "Request timeout" msgid "Request timeout"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:286 #: includes/class-ai-translator-admin.php:275
#: includes/class-ai-translator-admin.php:434 #: includes/class-ai-translator-admin.php:421
msgid "seconds" msgid "seconds"
msgstr "" msgstr ""
#. translators: %d: PHP max_execution_time in seconds. #. translators: %d: PHP max_execution_time in seconds.
#: includes/class-ai-translator-admin.php:294 #: includes/class-ai-translator-admin.php:283
#: includes/class-ai-translator-admin.php:442 #: includes/class-ai-translator-admin.php:429
#, php-format #, php-format
msgid "Maximum time the server waits for an AI response. PHP max_execution_time is %d s — values above this have no effect." msgid "Maximum time the server waits for an AI response. PHP max_execution_time is %d s — values above this have no effect."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:298 #: includes/class-ai-translator-admin.php:287
#: includes/class-ai-translator-admin.php:446 #: includes/class-ai-translator-admin.php:433
msgid "Maximum time the server waits for an AI response. PHP max_execution_time is unlimited." msgid "Maximum time the server waits for an AI response. PHP max_execution_time is unlimited."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:309 #: includes/class-ai-translator-admin.php:296
#: includes/class-ai-translator-admin.php:312 #: includes/class-ai-translator-admin.php:299
#: includes/class-ai-translator-admin.php:457 #: includes/class-ai-translator-admin.php:442
#: includes/class-ai-translator-admin.php:460 #: includes/class-ai-translator-admin.php:445
msgid "MultilingualPress" msgid "MultilingualPress"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:316 #: includes/class-ai-translator-admin.php:303
#: includes/class-ai-translator-admin.php:464 #: includes/class-ai-translator-admin.php:449
msgid "Auto-translate new connected posts" msgid "Auto-translate new connected posts"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:320 #: includes/class-ai-translator-admin.php:307
#: includes/class-ai-translator-admin.php:468 #: includes/class-ai-translator-admin.php:453
msgid "When MultilingualPress creates a new connected post, automatically translate its enabled fields into the target site's language. The translation runs synchronously during save." msgid "When MultilingualPress creates a new connected post, automatically translate its enabled fields into the target site's language. The translation runs synchronously during save."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:355 #: includes/class-ai-translator-admin.php:342
msgid "AI Translator Network Settings" msgid "AI Translator Network Settings"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:361 #: includes/class-ai-translator-admin.php:348
msgid "Network settings saved." msgid "Network settings saved."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:371 #: includes/class-ai-translator-admin.php:358
#: includes/class-ai-translator-admin.php:374 #: includes/class-ai-translator-admin.php:361
msgid "Configuration mode" msgid "Configuration mode"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:378 #: includes/class-ai-translator-admin.php:365
msgid "Global configuration: a single setting applies to every site." msgid "Global configuration: a single setting applies to every site."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:383 #: includes/class-ai-translator-admin.php:370
msgid "Per-site configuration: each site can override these defaults." msgid "Per-site configuration: each site can override these defaults."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:413 #: includes/class-ai-translator-admin.php:400
msgid "In global mode this is the configuration for the whole network. In per-site mode these values are used as defaults for sites that have not been configured individually." msgid "In global mode this is the configuration for the whole network. In per-site mode these values are used as defaults for sites that have not been configured individually."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:494 #: includes/class-ai-translator-admin.php:479
#: includes/class-ai-translator-admin.php:526 #: includes/class-ai-translator-admin.php:511
msgid "You do not have permission to perform this action." msgid "You do not have permission to perform this action."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:571 #: includes/class-ai-translator-admin.php:555
msgid "AI provider"
msgstr ""
#: includes/class-ai-translator-admin.php:576
msgid "Automatic (WordPress picks the provider)"
msgstr ""
#: includes/class-ai-translator-admin.php:585
msgid "Provider used for translations. Only providers with configured credentials are listed."
msgstr ""
#: includes/class-ai-translator-admin.php:632
msgid "Recommended models" msgid "Recommended models"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:635 #: includes/class-ai-translator-admin.php:558
msgid "This plugin does not call AI providers directly. Configure your preferred provider in the WordPress AI plugin settings. The table below is a guide to help you pick a model based on your translation use case." msgid "This plugin does not call AI providers directly. Configure your preferred provider in the WordPress AI plugin settings. The table below is a guide to help you pick a model based on your translation use case."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:641 #: includes/class-ai-translator-admin.php:564
msgid "Use case" msgid "Use case"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:642 #: includes/class-ai-translator-admin.php:565
msgid "Recommended model" msgid "Recommended model"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:643 #: includes/class-ai-translator-admin.php:566
msgid "Why" msgid "Why"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:658 #: includes/class-ai-translator-admin.php:581
msgid "These recommendations are based on public benchmarks and community feedback as of the plugin release date. They may change as providers update their models." msgid "These recommendations are based on public benchmarks and community feedback as of the plugin release date. They may change as providers update their models."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:673 #: includes/class-ai-translator-admin.php:596
msgid "European languages (ES, CA, FR, DE, IT, PT)" msgid "European languages (ES, CA, FR, DE, IT, PT)"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:674 #: includes/class-ai-translator-admin.php:597
msgid "DeepL API Pro" msgid "DeepL API Pro"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:675 #: includes/class-ai-translator-admin.php:598
msgid "Best fluency and naturalness (92/100 in benchmarks). Formality control and custom glossaries." msgid "Best fluency and naturalness (92/100 in benchmarks). Formality control and custom glossaries."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:678 #: includes/class-ai-translator-admin.php:601
msgid "Asian languages (ZH, JA, KO)" msgid "Asian languages (ZH, JA, KO)"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:679 #: includes/class-ai-translator-admin.php:602
msgid "GPT-4o / GPT-5 or Claude Sonnet 4" msgid "GPT-4o / GPT-5 or Claude Sonnet 4"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:680 #: includes/class-ai-translator-admin.php:603
msgid "Better handling of implicit subjects, honorifics, and cultural references. DeepL falls behind here." msgid "Better handling of implicit subjects, honorifics, and cultural references. DeepL falls behind here."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:683 #: includes/class-ai-translator-admin.php:606
msgid "Marketing / brand tone" msgid "Marketing / brand tone"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:684 #: includes/class-ai-translator-admin.php:607
msgid "Claude Sonnet 4 / Opus 4" msgid "Claude Sonnet 4 / Opus 4"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:685 #: includes/class-ai-translator-admin.php:608
msgid "Better preservation of tone, brand voice, and nuance. Ideal for creative copy." msgid "Better preservation of tone, brand voice, and nuance. Ideal for creative copy."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:688 #: includes/class-ai-translator-admin.php:611
msgid "Technical documentation / code" msgid "Technical documentation / code"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:689 #: includes/class-ai-translator-admin.php:612
msgid "GPT-4o / GPT-5" msgid "GPT-4o / GPT-5"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:690 #: includes/class-ai-translator-admin.php:613
msgid "Higher accuracy with variables, structured formats, and technical terminology." msgid "Higher accuracy with variables, structured formats, and technical terminology."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:693 #: includes/class-ai-translator-admin.php:616
msgid "Long documents (100+ pages)" msgid "Long documents (100+ pages)"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:694 #: includes/class-ai-translator-admin.php:617
msgid "Gemini 2.5 Pro" msgid "Gemini 2.5 Pro"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:695 #: includes/class-ai-translator-admin.php:618
msgid "1M token context window. Maintains terminological consistency across long texts." msgid "1M token context window. Maintains terminological consistency across long texts."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:698 #: includes/class-ai-translator-admin.php:621
msgid "High volume / low cost" msgid "High volume / low cost"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:699 #: includes/class-ai-translator-admin.php:622
msgid "DeepSeek-V3" msgid "DeepSeek-V3"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:700 #: includes/class-ai-translator-admin.php:623
msgid "Quality comparable to GPT-5 at ~$0.14/M tokens (20-50x cheaper than Claude/GPT)." msgid "Quality comparable to GPT-5 at ~$0.14/M tokens (20-50x cheaper than Claude/GPT)."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:703 #: includes/class-ai-translator-admin.php:626
msgid "Rare / indigenous languages" msgid "Rare / indigenous languages"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:704 #: includes/class-ai-translator-admin.php:627
msgid "Claude Sonnet or Taskade Translate (multi-model routing)" msgid "Claude Sonnet or Taskade Translate (multi-model routing)"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:705 #: includes/class-ai-translator-admin.php:628
msgid "Better coverage for uncommon language pairs." msgid "Better coverage for uncommon language pairs."
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:708 #: includes/class-ai-translator-admin.php:631
msgid "Maximum coverage (133+ languages)" msgid "Maximum coverage (133+ languages)"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:709 #: includes/class-ai-translator-admin.php:632
msgid "Google Cloud Translation" msgid "Google Cloud Translation"
msgstr "" msgstr ""
#: includes/class-ai-translator-admin.php:710 #: includes/class-ai-translator-admin.php:633
msgid "The most complete option, though with slightly lower quality on European languages." msgid "The most complete option, though with slightly lower quality on European languages."
msgstr "" msgstr ""
@ -331,12 +319,12 @@ msgstr ""
#: includes/class-ai-translator-cli.php:145 #: includes/class-ai-translator-cli.php:145
#: includes/class-ai-translator-editor-ui.php:427 #: includes/class-ai-translator-editor-ui.php:427
#: includes/class-ai-translator-editor-ui.php:563 #: includes/class-ai-translator-editor-ui.php:563
#: includes/class-ai-translator-translator.php:196 #: includes/class-ai-translator-translator.php:163
msgid "AI features are disabled for this WordPress installation." msgid "AI features are disabled for this WordPress installation."
msgstr "" msgstr ""
#: includes/class-ai-translator-cli.php:149 #: includes/class-ai-translator-cli.php:149
#: includes/class-ai-translator-translator.php:203 #: includes/class-ai-translator-translator.php:170
msgid "No AI provider is configured for text generation. Open Settings → AI to set one up." msgid "No AI provider is configured for text generation. Open Settings → AI to set one up."
msgstr "" msgstr ""
@ -431,17 +419,17 @@ msgstr ""
msgid "Dismiss this notice" msgid "Dismiss this notice"
msgstr "" msgstr ""
#: includes/class-ai-translator-translator.php:212 #: includes/class-ai-translator-translator.php:179
msgid "The target language is not installed on this site." msgid "The target language is not installed on this site."
msgstr "" msgstr ""
#. translators: %s: target language name. #. translators: %s: target language name.
#: includes/class-ai-translator-translator.php:218 #: includes/class-ai-translator-translator.php:185
#, php-format #, php-format
msgid "You are a professional translator. Translate the user message into %s. Preserve any HTML, shortcodes, line breaks, and Markdown exactly as they appear. Return only the translated text, without explanations, prefaces, or quotation marks." msgid "You are a professional translator. Translate the user message into %s. Preserve any HTML, shortcodes, line breaks, and Markdown exactly as they appear. Return only the translated text, without explanations, prefaces, or quotation marks."
msgstr "" msgstr ""
#: includes/class-ai-translator-translator.php:259 #: includes/class-ai-translator-translator.php:218
msgid "The AI service returned an unexpected response." msgid "The AI service returned an unexpected response."
msgstr "" msgstr ""

View file

@ -4,7 +4,7 @@ Tags: ai, translation, multilingual, multisite, editor
Requires at least: 7.0 Requires at least: 7.0
Tested up to: 7.2 Tested up to: 7.2
Requires PHP: 8.3 Requires PHP: 8.3
Stable tag: 1.3.0 Stable tag: 1.2.4
License: GPL-3.0-or-later License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.txt License URI: https://www.gnu.org/licenses/gpl-3.0.txt
@ -14,7 +14,7 @@ Translate post titles and content from the WordPress editor using the native Wor
AI Translator (by ROBOTSTXT) adds a one-click translation panel to the post editor. It reads the saved post title and content, sends them to the configured AI provider through the official WordPress AI plugin, and writes the translated text back into the editor for review. AI Translator (by ROBOTSTXT) adds a one-click translation panel to the post editor. It reads the saved post title and content, sends them to the configured AI provider through the official WordPress AI plugin, and writes the translated text back into the editor for review.
The plugin is provider-agnostic: it relies on the WordPress AI plugin to route requests to whichever service the site administrator has configured (OpenAI, Anthropic, Google, etc.). No API keys are stored by this plugin. Since 1.3.0, an "AI provider" setting pins translations to a specific configured provider (default: automatic selection by WordPress). The plugin is provider-agnostic: it relies on the WordPress AI plugin to route requests to whichever service the site administrator has configured (OpenAI, Anthropic, Google, etc.). No API keys are stored by this plugin.
Multisite is supported out of the box. When network-activated, the network administrator chooses between a single global configuration shared by every site, or per-site configuration where each subsite owns its own settings. Multisite is supported out of the box. When network-activated, the network administrator chooses between a single global configuration shared by every site, or per-site configuration where each subsite owns its own settings.
@ -142,10 +142,6 @@ The plugin reads the post title and content from the database, not from the edit
Only the 3 last versions. The full changelog will be at changelog.txt Only the 3 last versions. The full changelog will be at changelog.txt
= 1.3.0 =
* Added an "AI provider" setting (site and network admin): pin translations to a specific AI provider with configured credentials, or keep "Automatic" and let the WordPress AI client choose. Useful when several connectors are configured and one runs out of credits.
= 1.2.4 = = 1.2.4 =
* Confirmed compatibility with WordPress 7.2 (including the refactored AI client, which now proxies the builder methods through a shared base class) and with PHP 8.6. * Confirmed compatibility with WordPress 7.2 (including the refactored AI client, which now proxies the builder methods through a shared base class) and with PHP 8.6.
@ -156,6 +152,13 @@ Only the 3 last versions. The full changelog will be at changelog.txt
* Manager (by ROBOTSTXT) detection now uses the ecosystem presence constant `ROBOTSTXT_MANAGER_NOTICED` (Manager 1.6.2+) instead of scanning the plugin list, falling back to the plugin-list scan for older Manager versions. * Manager (by ROBOTSTXT) detection now uses the ecosystem presence constant `ROBOTSTXT_MANAGER_NOTICED` (Manager 1.6.2+) instead of scanning the plugin list, falling back to the plugin-list scan for older Manager versions.
= 1.2.2 =
* Added a dismissible admin notice on the Plugins list screens recommending Manager (by ROBOTSTXT) when it is not installed and active, plus a persistent warning on the plugin settings pages. Updates for the ROBOTSTXT plugins are delivered through Manager.
* Removed the bundled JSON updater (`class-robotstxt-updater.php` and `update.json`). Plugin updates are now handled by Manager.
* Changed the Plugin URI and Update URI to `https://www.robotstxt.software/plugins/robotstxt-ai-translator/`.
* Lowered the minimum PHP version from 7.4 to 5.6 (verified with PHPCompatibility 5.6-8.5). WordPress 7.0+ remains the minimum WordPress version because the plugin uses the native WordPress AI client.
= Previous versions = = Previous versions =
If you want to see the full changelog, visit the [changelog](https://www.robotstxt.software/plugins/robotstxt-ai-translator/) page. If you want to see the full changelog, visit the [changelog](https://www.robotstxt.software/plugins/robotstxt-ai-translator/) page.

View file

@ -4,7 +4,7 @@
* Plugin URI: https://www.robotstxt.software/plugins/robotstxt-ai-translator/ * Plugin URI: https://www.robotstxt.software/plugins/robotstxt-ai-translator/
* Update URI: https://www.robotstxt.software/plugins/robotstxt-ai-translator/ * Update URI: https://www.robotstxt.software/plugins/robotstxt-ai-translator/
* Description: Translate post titles and content from the editor using the native WordPress AI client (available in WP 7.0+). Multisite-ready with global or per-site configuration. * Description: Translate post titles and content from the editor using the native WordPress AI client (available in WP 7.0+). Multisite-ready with global or per-site configuration.
* Version: 1.3.0 * Version: 1.2.4
* Author: ROBOTSTXT * Author: ROBOTSTXT
* Author URI: https://www.robotstxt.software/ * Author URI: https://www.robotstxt.software/
* License: GPL-3.0-or-later * License: GPL-3.0-or-later
@ -25,7 +25,7 @@ if ( ! defined( 'ABSPATH' ) ) {
/** /**
* Plugin version. * Plugin version.
*/ */
define( 'AI_TRANSLATOR_VERSION', '1.3.0' ); define( 'AI_TRANSLATOR_VERSION', '1.2.4' );
/** /**
* Main plugin file path. * Main plugin file path.
@ -96,7 +96,7 @@ function ai_translator_bootstrap() {
$settings = new AI_Translator_Settings(); $settings = new AI_Translator_Settings();
$translator = new AI_Translator_Translator( $settings ); $translator = new AI_Translator_Translator( $settings );
$manager_notice = new AI_Translator_Manager_Notice(); $manager_notice = new AI_Translator_Manager_Notice();
$admin = new AI_Translator_Admin( $settings, $manager_notice, $translator ); $admin = new AI_Translator_Admin( $settings, $manager_notice );
$editor_ui = new AI_Translator_Editor_UI( $settings, $translator ); $editor_ui = new AI_Translator_Editor_UI( $settings, $translator );
$admin->register(); $admin->register();