0) { $mod = get_post_field('post_modified_gmt', $page_on_front); if ($mod) { $lastmod_ts = strtotime($mod); } } foreach ($langs as $lang) { $lang = strtolower((string) $lang); // Skip default language (already in standard sitemap) if ($lang === strtolower((string) $default)) { continue; } $entries[] = [ 'loc' => $home . '/' . $lang . '/', 'lastmod' => $lastmod_ts, ]; } return $entries; } // ────────────────────────────────────────────── // 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')); // phpcs:disable WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber -- $placeholders is a server-built '%s, %s, ...' string for IN(); $table/$col_lang are passed via %i below $rows = $wpdb->get_results($wpdb->prepare( "SELECT s.translated_slug, p.post_modified_gmt FROM %i s JOIN {$wpdb->posts} p ON p.ID = s.post_id WHERE s.%i = %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([$table, $col_lang, $lang], array_values($public_types), [$limit, $offset]) ), ARRAY_A); // phpcs:enable WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber 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')); // phpcs:disable WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber -- $placeholders is a server-built '%s, %s, ...' string for IN(); $table/$col_lang are passed via %i below $count = (int) $wpdb->get_var($wpdb->prepare( "SELECT COUNT(*) FROM %i s JOIN {$wpdb->posts} p ON p.ID = s.post_id WHERE s.%i = %s AND p.post_status = 'publish' AND p.post_type IN ({$placeholders}) AND s.translated_slug != ''", array_merge([$table, $col_lang, $lang], array_values($public_types)) )); // phpcs:enable WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber return $count; } /** * 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'; } /** * Build a standard sitemap XML string from entry arrays. * * @param array[] $entries Each entry has 'loc' (string) and optional 'lastmod' (int unix timestamp). * @return string Complete XML document. */ private static function build_sitemap_xml(array $entries) { $xml = '' . "\n"; foreach ($entries as $entry) { $xml .= "\t\n"; $xml .= "\t\t" . esc_url($entry['loc']) . "\n"; if (!empty($entry['lastmod'])) { $xml .= "\t\t" . wp_date('c', (int) $entry['lastmod']) . "\n"; } $xml .= "\t\n"; } $xml .= ''; return $xml; } // ────────────────────────────────────────────── // Yoast SEO sitemap integration // ────────────────────────────────────────────── /** * Register hooks for Yoast SEO sitemaps when that plugin is active. */ public static function maybe_register_yoast_hooks() { global $wpseo_sitemaps; if (!isset($wpseo_sitemaps) || !is_object($wpseo_sitemaps) || !method_exists($wpseo_sitemaps, 'register_sitemap')) { return; } $wpseo_sitemaps->register_sitemap( 'ai-translate-languages', [__CLASS__, 'yoast_render_languages'] ); foreach (self::get_sitemap_languages() as $lang) { $wpseo_sitemaps->register_sitemap( 'translated-' . $lang, [__CLASS__, 'yoast_render_translated'] ); } add_filter('wpseo_sitemap_index', [__CLASS__, 'yoast_sitemap_index']); } /** * Filter: wpseo_sitemap_index – add translated sitemaps to the Yoast index. * * @param string $index Existing sitemap index XML. * @return string */ public static function yoast_sitemap_index($index) { $home = rtrim(home_url('/'), '/'); if (!empty(self::get_language_entries())) { $index .= "\t\n"; $index .= "\t\t" . esc_url($home . '/ai-translate-languages-sitemap.xml') . "\n"; $index .= "\t\n"; } foreach (self::get_sitemap_languages() as $lang) { if (self::count_translated_entries($lang) > 0) { $index .= "\t\n"; $index .= "\t\t" . esc_url($home . '/translated-' . $lang . '-sitemap.xml') . "\n"; $index .= "\t\n"; } } return $index; } // ────────────────────────────────────────────── // Rank Math sitemap integration // ────────────────────────────────────────────── /** * Register hooks for Rank Math sitemaps when that plugin is active. */ public static function maybe_register_rank_math_hooks() { if (!class_exists('\RankMath\Sitemap\Router')) { return; } add_filter('rank_math/sitemap/providers', [__CLASS__, 'rank_math_sitemap_providers']); } /** * Filter: rank_math/sitemap/providers – add the AI Translate provider. * * @param array $providers Existing Rank Math sitemap providers. * @return array */ public static function rank_math_sitemap_providers($providers) { if (!is_array($providers)) { $providers = []; } $providers['ai-translate'] = new AI_RankMath_Sitemap_Provider(); return $providers; } /** * Yoast callback: render language homepages sitemap. */ public static function yoast_render_languages() { global $wpseo_sitemaps; $wpseo_sitemaps->set_sitemap(self::build_sitemap_xml(self::get_language_entries())); } /** * Yoast callback: render translated posts sitemap. * * The target language is derived from the current action name * (wpseo_do_sitemap_translated-{lang}). */ public static function yoast_render_translated() { global $wpseo_sitemaps; $lang = str_replace('wpseo_do_sitemap_translated-', '', current_action()); $lang = sanitize_key($lang); if ($lang === '') { $wpseo_sitemaps->set_sitemap(self::build_sitemap_xml([])); return; } $entries = self::get_translated_entries($lang, 50000, 0); $wpseo_sitemaps->set_sitemap(self::build_sitemap_xml($entries)); } // ────────────────────────────────────────────── // Google XML Sitemaps plugin integration // ────────────────────────────────────────────── /** * Hook: sm_build_index – add our sitemaps to the Google XML Sitemaps index. * * @param \GoogleSitemapGenerator $gsg */ public static function gsm_build_index($gsg) { // 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 * @param string $type * @param string $params */ public static function gsm_build_content($gsg, $type, $params) { // Language homepages sitemap $is_lang = ($type === 'languages') || ($type === 'pt' && is_string($params) && strpos($params, 'languages') === 0); if ($is_lang) { foreach (self::get_language_entries() as $e) { $gsg->add_url($e['loc'], $e['lastmod'], 'weekly', 0.5); } return; } // 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); } } } } /** * WP native sitemap provider for language homepages. */ class AI_Sitemap_Provider_Languages extends \WP_Sitemaps_Provider { public function __construct() { $this->name = 'languages'; $this->object_type = 'ai-translate'; } /** * @param int $page_num * @param string $object_subtype * @return array[] */ public function get_url_list($page_num, $object_subtype = '') { if ($page_num > 1) { return []; } $urls = []; foreach (AI_Sitemap::get_language_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 * @return int */ public function get_max_num_pages($object_subtype = '') { return 1; } } /** * 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); } } /** * Rank Math sitemap provider for translated language homepages and posts. */ class AI_RankMath_Sitemap_Provider { const TYPE_LANGUAGES = 'ai-translate-languages'; const TYPE_TRANSLATED_PREFIX = 'translated-'; /** * @param string $type Requested sitemap type. * @return bool */ public function handles_type($type) { $type = sanitize_key((string) $type); if ($type === self::TYPE_LANGUAGES) { return true; } if (strpos($type, self::TYPE_TRANSLATED_PREFIX) !== 0) { return false; } $lang = substr($type, strlen(self::TYPE_TRANSLATED_PREFIX)); return $lang !== '' && in_array($lang, AI_Sitemap::get_sitemap_languages(), true); } /** * Return custom sitemap links for the Rank Math sitemap index. * * @param int $max_entries Rank Math max URLs per sitemap. * @return array[] */ public function get_index_links($max_entries) { $links = []; $language_entries = AI_Sitemap::get_language_entries(); if (!empty($language_entries)) { $links[] = [ 'loc' => $this->base_url(self::TYPE_LANGUAGES . '-sitemap.xml'), 'lastmod' => $this->latest_lastmod($language_entries), ]; } foreach (AI_Sitemap::get_sitemap_languages() as $lang) { if (AI_Sitemap::count_translated_entries($lang) < 1) { continue; } $entries = AI_Sitemap::get_translated_entries($lang, 1, 0); $links[] = [ 'loc' => $this->base_url(self::TYPE_TRANSLATED_PREFIX . $lang . '-sitemap.xml'), 'lastmod' => $this->latest_lastmod($entries), ]; } return $links; } /** * Return URL entries for a specific Rank Math sitemap. * * @param string $type Requested sitemap type. * @param int $max_entries Rank Math max URLs per sitemap. * @param int $current_page Current sitemap page. * @return array[] */ public function get_sitemap_links($type, $max_entries, $current_page) { $type = sanitize_key((string) $type); $max_entries = max(1, (int) $max_entries); $current_page = max(1, (int) $current_page); if ($type === self::TYPE_LANGUAGES) { if ($current_page > 1) { return []; } return $this->format_sitemap_links(AI_Sitemap::get_language_entries()); } if (strpos($type, self::TYPE_TRANSLATED_PREFIX) !== 0) { return []; } $lang = substr($type, strlen(self::TYPE_TRANSLATED_PREFIX)); if ($lang === '' || !in_array($lang, AI_Sitemap::get_sitemap_languages(), true)) { return []; } $offset = ($current_page - 1) * $max_entries; $entries = AI_Sitemap::get_translated_entries($lang, $max_entries, $offset); return $this->format_sitemap_links($entries); } /** * @param string $file Sitemap file name. * @return string */ private function base_url($file) { if (class_exists('\RankMath\Sitemap\Router') && method_exists('\RankMath\Sitemap\Router', 'get_base_url')) { return \RankMath\Sitemap\Router::get_base_url($file); } return home_url('/' . ltrim($file, '/')); } /** * @param array[] $entries AI Translate sitemap entries. * @return array[] */ private function format_sitemap_links(array $entries) { $links = []; foreach ($entries as $entry) { if (empty($entry['loc'])) { continue; } $link = [ 'loc' => $entry['loc'], ]; if (!empty($entry['lastmod'])) { $link['mod'] = wp_date('c', (int) $entry['lastmod']); } $links[] = $link; } return $links; } /** * @param array[] $entries AI Translate sitemap entries. * @return string */ private function latest_lastmod(array $entries) { $latest = 0; foreach ($entries as $entry) { if (!empty($entry['lastmod']) && (int) $entry['lastmod'] > $latest) { $latest = (int) $entry['lastmod']; } } return $latest > 0 ? wp_date('c', $latest) : ''; } }