Changeset 3461910

Timestamp:

02/15/2026 04:00:51 PM (6 days ago)

Author:

gkanters

Message:

Release 2.2.7: sync trunk from Git source

Location:

ai-translate/trunk

Files:

• README.md (modified) (3 diffs)
• ai-translate.php (modified) (4 diffs)
• includes/admin-page.php (modified) (1 diff)
• includes/class-ai-ob.php (modified) (1 diff)
• includes/class-ai-seo.php (modified) (7 diffs)
• includes/class-ai-sitemap.php (modified) (5 diffs)
• includes/class-ai-translate-core.php (modified) (2 diffs)

ai-translate/trunk/README.md

@@ -4 +4 @@
 Requires at least: 5.0  
 Tested up to: 6.9  
-Stable tag: 2.2.6
+Stable tag: 2.2.7
 Requires PHP: 8.0
 License: GPLv2 or later  
@@ -185 +185 @@
 ## Changelog
 
-### 2.2.6
+### 2.2.7
 - Improve system prompt (role, what and how).
 - Improve website context generator (what is the website about).
@@ -191 +191 @@
 - All enabled and detectable languages added to Wordpress sitemap (/wp-sitemap.xml) 
 - Code base refactoring. Improve performance and security, thighening code.
+- Better detect usable models from OpenAI.  
+- Change language switcher url to fixed urls instead of query param.
 
 

ai-translate/trunk/ai-translate.php

@@ -6 +6 @@
  * Author: NetCare
  * Author URI: https://netcare.nl/
- * Version: 2.2.6
+ * Version: 2.2.7
  * Requires at least: 5.0
  * Tested up to: 6.9
@@ -1004 +1004 @@
     foreach ($enabled as $code) {
         $code = sanitize_key($code);
-        $label = strtoupper($code === $default ? $default : $code);
-        // Use ?switch_lang= parameter to ensure cookie is set via init hook
+        $isDefaultLang = (strtolower($code) === strtolower((string) $default));
+        $label = strtoupper($isDefaultLang ? $default : $code);
+        // Use one canonical public URL format:
+        // - default language => /
+        // - non-default language => /{lang}/
         // Build relative URL to avoid host/home filters
-        $url = '/?switch_lang=' . $code;
+        $url = $isDefaultLang ? '/' : '/' . $code . '/';
         $url = esc_url($url);
         $flag = esc_url($flags_url . $code . '.png');
@@ -1102 +1105 @@
     foreach ($enabled as $code) {
         $code = sanitize_key($code);
+        $isDefaultLang = (strtolower($code) === strtolower((string) $default));
 
         // Skip current language
@@ -1108 +1112 @@
         }
 
-        $label = strtoupper($code === $default ? $default : $code);
-        // Use ?switch_lang= parameter to ensure cookie is set via init hook
+        $label = strtoupper($isDefaultLang ? $default : $code);
+        // Use one canonical public URL format:
+        // - default language => /
+        // - non-default language => /{lang}/
         // Build relative URL to avoid host/home filters
-        $url = '/?switch_lang=' . $code;
+        $url = $isDefaultLang ? '/' : '/' . $code . '/';
         $url = esc_url($url);
         $flag = esc_url($flags_url . $code . '.png');

ai-translate/trunk/includes/admin-page.php

@@ -2528 +2528 @@
     }, $data['data']);
     $models = array_filter($models);
-    // o1/o3 reasoning models don't support temperature; block from selection to avoid API errors
+    // Filter model families known to be incompatible with text translation chat/completions.
+    // Keep only models that are likely usable for this plugin's translation pipeline.
     $models = array_filter($models, function ($model) {
-        return !preg_match('/^(o1-|o3-)/i', $model);
+        if (preg_match('/^(o1-|o3-)/i', $model)) {
+            return false;
+        }
+        // Block non-chat capabilities even when they appear later in a GPT model ID.
+        return !preg_match('/(dall-e|whisper|audio|image|realtime|transcribe|tts|embedding|moderation|codex|instruct)/i', $model);
     });
     sort($models);

ai-translate/trunk/includes/class-ai-ob.php

@@ -457 +457 @@
             }
         }
+
+        // Translate Twitter Card and JSON-LD text that Jetpack/plugins inject via wp_head.
+        // These run as regex on the final HTML because DOMDocument placeholder divs break
+        // the <head> structure, causing these meta/script tags to be inaccessible in the DOM pass.
+        $html3 = AI_SEO::translateTwitterCards($html3, $lang);
+        $html3 = AI_SEO::translateJsonLd($html3, $lang);
 
         // Translate chatbot greeting strings embedded in inline script JSON (e.g. Kognetiks kchat_settings).

ai-translate/trunk/includes/class-ai-seo.php

@@ -256 +256 @@
         
         if ($ogLocale !== '') {
-            $existingOgLocale = $xpath->query('//head/meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:locale"]');
+            $existingOgLocale = $xpath->query('//meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:locale"]');
             if ($existingOgLocale && $existingOgLocale->length > 0) {
                 for ($i = $existingOgLocale->length - 1; $i >= 0; $i--) {
@@ -377 +377 @@
             }
             if ($shouldReplaceOgDesc && $ogDesc !== '') {
-                $existingOgDesc = $xpath->query('//head/meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:description"]');
+                $existingOgDesc = $xpath->query('//meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:description"]');
                 if ($existingOgDesc && $existingOgDesc->length > 0) {
                     $ogDescElem = $existingOgDesc->item(0);
@@ -391 +391 @@
                 }
             } elseif ($isTranslatedLang && $shouldReplaceOgDesc && $ogDesc === '') {
-                $existingOgDesc = $xpath->query('//head/meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:description"]');
+                $existingOgDesc = $xpath->query('//meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:description"]');
                 if ($existingOgDesc && $existingOgDesc->length > 0) {
                     $ogDescElem = $existingOgDesc->item(0);
@@ -407 +407 @@
             }
             if (($ogImageMissing || $shouldReplaceOgImage) && $ogImage !== '') {
-                $existingOgImage = $xpath->query('//head/meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:image"]');
+                $existingOgImage = $xpath->query('//meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:image"]');
                 if ($existingOgImage && $existingOgImage->length > 0) {
                     $ogImageElem = $existingOgImage->item(0);
@@ -422 +422 @@
             }
             if ($isTranslatedLang) {
-                $existingOgImageAlt = $xpath->query('//head/meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:image:alt"]');
+                $existingOgImageAlt = $xpath->query('//meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="og:image:alt"]');
                 if ($existingOgImageAlt && $existingOgImageAlt->length > 0) {
                     $ogImageAltElem = $existingOgImageAlt->item(0);
@@ -778 +778 @@
     private static function isOgMissing($xpath, $prop)
     {
-        $q = sprintf('//head/meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="%s"]', strtolower($prop));
+        // Search entire document, not just <head>. DOMDocument may move OG tags from
+        // Jetpack/Yoast/RankMath to <body> when placeholder <div>s break <head> structure.
+        $q = sprintf('//meta[translate(@property, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", "abcdefghijklmnopqrstuvwxyz")="%s"]', strtolower($prop));
         $nodes = $xpath->query($q);
         return !($nodes && $nodes->length > 0);
@@ -843 +845 @@
         return home_url($path);
     }
+
+    /**
+     * Translate Twitter Card meta tags in final HTML.
+     * Runs on the fully assembled HTML (after DOMDocument + placeholder restore)
+     * because DOMDocument may move Jetpack meta tags out of <head> when
+     * preceding script/style placeholders break the head structure.
+     *
+     * @param string $html Full HTML output.
+     * @param string $lang Target language code.
+     * @return string HTML with translated Twitter Card meta tags.
+     */
+    public static function translateTwitterCards($html, $lang)
+    {
+        $default = AI_Lang::default();
+        if ($default === null || strtolower((string) $lang) === strtolower((string) $default)) {
+            return $html;
+        }
+
+        $twitterNames = ['twitter:text:title', 'twitter:title', 'twitter:description', 'twitter:image:alt'];
+        $names = implode('|', array_map(function ($n) { return preg_quote($n, '#'); }, $twitterNames));
+        $pattern = '#(<meta\s+name="(?:' . $names . ')"\s+content=")([^"]+)("[^>]*>)#i';
+
+        return preg_replace_callback($pattern, function ($m) use ($default, $lang) {
+            $original = html_entity_decode($m[2], ENT_QUOTES, 'UTF-8');
+            if (trim($original) === '') {
+                return $m[0];
+            }
+            $translated = self::maybeTranslateMeta($original, $default, $lang);
+            if (!is_string($translated) || $translated === '' || $translated === $original) {
+                return $m[0];
+            }
+            return $m[1] . esc_attr($translated) . $m[3];
+        }, $html);
+    }
+
+    /**
+     * Translate JSON-LD BreadcrumbList name fields in final HTML.
+     * Called after script placeholders have been restored.
+     *
+     * @param string $html Full HTML output.
+     * @param string $lang Target language code.
+     * @return string HTML with translated JSON-LD.
+     */
+    public static function translateJsonLd($html, $lang)
+    {
+        $default = AI_Lang::default();
+        if ($default === null || strtolower((string) $lang) === strtolower((string) $default)) {
+            return $html;
+        }
+
+        return preg_replace_callback(
+            '#(<script\b[^>]*type=["\']application/ld\+json["\'][^>]*>)(.*?)(</script>)#is',
+            function ($m) use ($default, $lang) {
+                $json = json_decode($m[2], true);
+                if (!is_array($json)) {
+                    return $m[0];
+                }
+
+                $changed = self::translateJsonLdNode($json, $default, $lang);
+                if (!$changed) {
+                    return $m[0];
+                }
+
+                $encoded = wp_json_encode($json, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+                if (!is_string($encoded) || $encoded === '') {
+                    return $m[0];
+                }
+                return $m[1] . $encoded . $m[3];
+            },
+            $html
+        );
+    }
+
+    /**
+     * Recursively translate name/description fields in JSON-LD BreadcrumbList nodes.
+     *
+     * @param array  &$node   JSON-LD node (modified in place).
+     * @param string $default Default language.
+     * @param string $lang    Target language.
+     * @return bool Whether any field was translated.
+     */
+    private static function translateJsonLdNode(array &$node, $default, $lang)
+    {
+        $type = $node['@type'] ?? '';
+        $changed = false;
+
+        if ($type === 'BreadcrumbList' && isset($node['itemListElement']) && is_array($node['itemListElement'])) {
+            foreach ($node['itemListElement'] as &$item) {
+                if (isset($item['name']) && is_string($item['name']) && trim($item['name']) !== '') {
+                    $translated = self::maybeTranslateMeta($item['name'], $default, $lang);
+                    if (is_string($translated) && $translated !== '' && $translated !== $item['name']) {
+                        $item['name'] = $translated;
+                        $changed = true;
+                    }
+                }
+            }
+            unset($item);
+        }
+
+        // Handle @graph arrays (used by Yoast and others)
+        if (isset($node['@graph']) && is_array($node['@graph'])) {
+            foreach ($node['@graph'] as &$graphNode) {
+                if (is_array($graphNode)) {
+                    if (self::translateJsonLdNode($graphNode, $default, $lang)) {
+                        $changed = true;
+                    }
+                }
+            }
+            unset($graphNode);
+        }        return $changed;
+    }
 }
-
-

ai-translate/trunk/includes/class-ai-sitemap.php

@@ -40 +40 @@
     public static function register_providers()
     {
-        $provider = new AI_Sitemap_Provider_Languages();
-        wp_register_sitemap_provider('languages', $provider);
+        // Language homepages (/{lang}/)
+        wp_register_sitemap_provider('languages', new AI_Sitemap_Provider_Languages());
+
+        // Translated posts/pages/CPT (/{lang}/{translated-slug}/)
+        wp_register_sitemap_provider('ai-translate-posts', new AI_Sitemap_Provider_Translated());
     }
 
@@ -87 +90 @@
 
     // ──────────────────────────────────────────────
+    //  Translated post/page/CPT entries
+    // ──────────────────────────────────────────────
+
+    /**
+     * Get translated post entries for a specific language.
+     *
+     * Only includes posts that already have a translated slug in the slugs table.
+     * Does NOT trigger API calls.
+     *
+     * @param string $lang   Language code (e.g. 'de', 'it').
+     * @param int    $limit  Max entries to return.
+     * @param int    $offset Offset for pagination.
+     * @return array[] Each entry has 'loc' (string) and optional 'lastmod' (string ISO 8601).
+     */
+    public static function get_translated_entries($lang, $limit = 2000, $offset = 0)
+    {
+        global $wpdb;
+        $table    = $wpdb->prefix . 'ai_translate_slugs';
+        $col_lang = self::slug_lang_column();
+
+        $public_types = get_post_types(['public' => true], 'names');
+        $public_types = array_diff($public_types, ['attachment']);
+        if (empty($public_types)) {
+            $public_types = ['post', 'page'];
+        }
+        $placeholders = implode(', ', array_fill(0, count($public_types), '%s'));
+
+        $rows = $wpdb->get_results($wpdb->prepare(
+            "SELECT s.translated_slug, p.post_modified_gmt
+             FROM `{$table}` s
+             JOIN `{$wpdb->posts}` p ON p.ID = s.post_id
+             WHERE s.`{$col_lang}` = %s
+               AND p.post_status = 'publish'
+               AND p.post_type IN ({$placeholders})
+               AND s.translated_slug != ''
+             ORDER BY s.post_id ASC
+             LIMIT %d OFFSET %d",
+            array_merge([$lang], array_values($public_types), [$limit, $offset])
+        ), ARRAY_A);
+
+        if (!is_array($rows) || empty($rows)) {
+            return [];
+        }
+
+        $home = rtrim(home_url('/'), '/');
+        $entries = [];
+        foreach ($rows as $row) {
+            $slug = ltrim($row['translated_slug'], '/');
+            if ($slug === '') {
+                continue;
+            }
+            $entry = [
+                'loc' => $home . '/' . $lang . '/' . $slug . '/',
+            ];
+            if (!empty($row['post_modified_gmt']) && $row['post_modified_gmt'] !== '0000-00-00 00:00:00') {
+                $entry['lastmod'] = strtotime($row['post_modified_gmt']);
+            }
+            $entries[] = $entry;
+        }
+
+        return $entries;
+    }
+
+    /**
+     * Count translated post entries for a specific language.
+     *
+     * @param string $lang Language code.
+     * @return int
+     */
+    public static function count_translated_entries($lang)
+    {
+        global $wpdb;
+        $table    = $wpdb->prefix . 'ai_translate_slugs';
+        $col_lang = self::slug_lang_column();
+
+        $public_types = get_post_types(['public' => true], 'names');
+        $public_types = array_diff($public_types, ['attachment']);
+        if (empty($public_types)) {
+            $public_types = ['post', 'page'];
+        }
+        $placeholders = implode(', ', array_fill(0, count($public_types), '%s'));
+
+        return (int) $wpdb->get_var($wpdb->prepare(
+            "SELECT COUNT(*)
+             FROM `{$table}` s
+             JOIN `{$wpdb->posts}` p ON p.ID = s.post_id
+             WHERE s.`{$col_lang}` = %s
+               AND p.post_status = 'publish'
+               AND p.post_type IN ({$placeholders})
+               AND s.translated_slug != ''",
+            array_merge([$lang], array_values($public_types))
+        ));
+    }
+
+    /**
+     * Get non-default languages that have at least one translated entry.
+     *
+     * @return string[]
+     */
+    public static function get_sitemap_languages()
+    {
+        $default    = AI_Lang::default();
+        $enabled    = AI_Lang::enabled();
+        $detectable = AI_Lang::detectable();
+        $langs      = array_values(array_unique(array_merge($enabled, $detectable)));
+
+        $result = [];
+        foreach ($langs as $lang) {
+            $lang = strtolower((string) $lang);
+            if ($default !== null && $lang === strtolower((string) $default)) {
+                continue;
+            }
+            $result[] = $lang;
+        }
+        return $result;
+    }
+
+    /**
+     * Detect slug table language column name.
+     *
+     * Uses the transient set by AI_Slugs::detect_schema() to avoid extra SHOW COLUMNS queries.
+     *
+     * @return string Column name ('lang' or 'language_code').
+     */
+    private static function slug_lang_column()
+    {
+        $schema = get_transient('ai_tr_slugs_schema');
+        return ($schema === 'original') ? 'language_code' : 'lang';
+    }
+
+    // ──────────────────────────────────────────────
     //  Google XML Sitemaps plugin integration
     // ──────────────────────────────────────────────
 
     /**
-     * Hook: sm_build_index – add our sitemap to the Google XML Sitemaps index.
+     * Hook: sm_build_index – add our sitemaps to the Google XML Sitemaps index.
      *
      * @param \GoogleSitemapGenerator $gsg
@@ -97 +231 @@
     public static function gsm_build_index($gsg)
     {
-        $entries = self::get_language_entries();
-        if (empty($entries)) {
-            return;
-        }
-
-        $lastmod = 0;
-        foreach ($entries as $e) {
-            if (!empty($e['lastmod']) && $e['lastmod'] > $lastmod) {
-                $lastmod = $e['lastmod'];
-            }
-        }
-
-        $gsg->add_sitemap('languages-sitemap', null, $lastmod);
-    }
-
-    /**
-     * Hook: sm_build_content – output language homepage URLs when our type is requested.
-     * Google XML Sitemaps routes languages-sitemap.xml as type='pt', params='languages-p...'
+        // Language homepages
+        $lang_entries = self::get_language_entries();
+        if (!empty($lang_entries)) {
+            $lastmod = 0;
+            foreach ($lang_entries as $e) {
+                if (!empty($e['lastmod']) && $e['lastmod'] > $lastmod) {
+                    $lastmod = $e['lastmod'];
+                }
+            }
+            $gsg->add_sitemap('languages-sitemap', null, $lastmod);
+        }
+
+        // Translated posts per language
+        foreach (self::get_sitemap_languages() as $lang) {
+            $entries = self::get_translated_entries($lang, 1, 0);
+            if (!empty($entries)) {
+                $lastmod = !empty($entries[0]['lastmod']) ? $entries[0]['lastmod'] : 0;
+                $gsg->add_sitemap('translated-' . $lang . '-sitemap', null, $lastmod);
+            }
+        }
+    }
+
+    /**
+     * Hook: sm_build_content – output language homepage + translated post URLs.
      *
      * @param \GoogleSitemapGenerator $gsg
@@ -122 +262 @@
     public static function gsm_build_content($gsg, $type, $params)
     {
-        // The plugin routes unknown sitemap types as pt-{name}-p{page}-...
-        $is_ours = ($type === 'languages')
+        // Language homepages sitemap
+        $is_lang = ($type === 'languages')
             || ($type === 'pt' && is_string($params) && strpos($params, 'languages') === 0);
 
-        if (!$is_ours) {
+        if ($is_lang) {
+            foreach (self::get_language_entries() as $e) {
+                $gsg->add_url($e['loc'], $e['lastmod'], 'weekly', 0.5);
+            }
             return;
         }
 
-        $entries = self::get_language_entries();
-        foreach ($entries as $e) {
-            $gsg->add_url(
-                $e['loc'],
-                $e['lastmod'],
-                'weekly',
-                0.5
-            );
+        // Translated posts sitemaps: translated-{lang}-sitemap
+        $is_translated = ($type === 'pt' && is_string($params) && strpos($params, 'translated-') === 0);
+        if (!$is_translated) {
+            return;
+        }
+
+        // Extract language code from params: "translated-{lang}-sitemap..."
+        if (preg_match('/^translated-([a-z]{2,5})-/', $params, $m)) {
+            $lang    = $m[1];
+            $entries = self::get_translated_entries($lang, 50000, 0);
+            foreach ($entries as $e) {
+                $lastmod = !empty($e['lastmod']) ? $e['lastmod'] : 0;
+                $gsg->add_url($e['loc'], $lastmod, 'weekly', 0.5);
+            }
         }
     }
@@ -184 +333 @@
     }
 }
+
+/**
+ * WP native sitemap provider for translated posts/pages/CPT.
+ *
+ * Registers one subtype per non-default language. Each subtype sitemap contains
+ * all translated posts for that language, using the translated slugs from the
+ * ai_translate_slugs table.
+ *
+ * Sitemap URLs look like: /wp-sitemap-ai-translate-posts-{lang}-{page}.xml
+ */
+class AI_Sitemap_Provider_Translated extends \WP_Sitemaps_Provider
+{
+    public function __construct()
+    {
+        $this->name        = 'ai-translate-posts';
+        $this->object_type = 'ai-translate-posts';
+    }
+
+    /**
+     * Return one subtype per non-default language.
+     *
+     * @return \stdClass[]
+     */
+    public function get_object_subtypes()
+    {
+        $subtypes = [];
+        foreach (AI_Sitemap::get_sitemap_languages() as $lang) {
+            $obj       = new \stdClass();
+            $obj->name = $lang;
+            $subtypes[$lang] = $obj;
+        }
+        return $subtypes;
+    }
+
+    /**
+     * @param int    $page_num
+     * @param string $object_subtype Language code.
+     * @return array[]
+     */
+    public function get_url_list($page_num, $object_subtype = '')
+    {
+        $lang = sanitize_key($object_subtype);
+        if ($lang === '') {
+            return [];
+        }
+
+        $max_urls = wp_sitemaps_get_max_urls($this->object_type);
+        $offset   = ($page_num - 1) * $max_urls;
+
+        $entries = AI_Sitemap::get_translated_entries($lang, $max_urls, $offset);
+
+        $urls = [];
+        foreach ($entries as $e) {
+            $entry = ['loc' => $e['loc']];
+            if (!empty($e['lastmod'])) {
+                $entry['lastmod'] = wp_date('c', $e['lastmod']);
+            }
+            $urls[] = $entry;
+        }
+        return $urls;
+    }
+
+    /**
+     * @param string $object_subtype Language code.
+     * @return int
+     */
+    public function get_max_num_pages($object_subtype = '')
+    {
+        $lang = sanitize_key($object_subtype);
+        if ($lang === '') {
+            return 0;
+        }
+
+        $count    = AI_Sitemap::count_translated_entries($lang);
+        $max_urls = wp_sitemaps_get_max_urls($this->object_type);
+
+        return (int) ceil($count / $max_urls);
+    }
+}

ai-translate/trunk/includes/class-ai-translate-core.php

@@ -351 +351 @@
         // If model is provided, test the API endpoint to ensure model is actually usable
         if ($model !== '') {
+            // Early guard for model families that are known to be non-chat/non-translation models.
+            if (preg_match('/(dall-e|whisper|audio|image|realtime|transcribe|tts|embedding|moderation|codex|instruct)/i', $model)) {
+                throw new \Exception(
+                    sprintf(
+                        /* translators: %s is the selected model ID */
+                        __('Selected model "%s" is not a chat/completions model and cannot be used for translations. Choose a text chat model (for example: gpt-4o-mini, gpt-4.1-mini, deepseek-chat).', 'ai-translate'),
+                        $model
+                    )
+                );
+            }
+
             $endpointPath = self::get_model_endpoint_path($model);
             $chatEndpoint = rtrim($base, '/') . $endpointPath;
@@ -383 +394 @@
             if ($chatCode !== 200) {
                 $chatBodyText = (string) wp_remote_retrieve_body($chatResp);
+                $chatErrorMessage = '';
+                $chatErrorData = json_decode($chatBodyText, true);
+                if (
+                    is_array($chatErrorData)
+                    && isset($chatErrorData['error'])
+                    && is_array($chatErrorData['error'])
+                    && isset($chatErrorData['error']['message'])
+                ) {
+                    $chatErrorMessage = (string) $chatErrorData['error']['message'];
+                }
+                $haystack = strtolower($chatErrorMessage . ' ' . $chatBodyText);
+                $nonChatModelError = (
+                    strpos($haystack, 'not allowed to sample from this model') !== false
+                    || strpos($haystack, 'not a chat model') !== false
+                    || strpos($haystack, 'v1/completions') !== false
+                    || strpos($haystack, 'completions endpoint') !== false
+                    || strpos($haystack, 'does not support') !== false
+                    || strpos($haystack, 'image generation') !== false
+                    || strpos($haystack, 'embedding') !== false
+                    || strpos($haystack, 'moderation') !== false
+                    || strpos($haystack, 'audio') !== false
+                    || strpos($haystack, 'codex') !== false
+                );
+                if ($nonChatModelError) {
+                    throw new \Exception(
+                        sprintf(
+                            /* translators: %s is the selected model ID */
+                            __('Selected model "%s" is not supported for chat-based translations. Choose a chat/completions model instead.', 'ai-translate'),
+                            $model
+                        )
+                    );
+                }
                 // Auto-detect /responses API requirement and retry once
                 if ($chatCode === 404 && self::is_responses_api_error($chatBodyText)) {