translatepress-url-seo-compatibility

TranslatePress URL, SEO, And Domain Compatibility

TranslatePress rewrites internal URLs for the active language. The Business SEO Pack can translate slugs and extend sitemaps; Different Domain per Language can map each language to another host. Plugin/theme code must use WordPress URL APIs, avoid manual language-prefix logic, and vary caches by language and host.

When to use this skill

Trigger when ANY of the following is true:

• Code calls home_url(), site_url(), get_permalink(), get_term_link(), post_type_link, term_link, rest_url(), admin_url(), or manually builds absolute links.
• Code parses $_SERVER['REQUEST_URI'], performs redirects, registers rewrites, or handles forms on translated pages.
• The task mentions TranslatePress SEO Pack, URL Slug Translation, trp_get_url_for_language, trp_translate_slugs_on_internal_links, trp_hreflang, Different Domain per Language, multilingual sitemap, translated WooCommerce slugs, CORS, canonical, or hreflang.

Generate URLs safely

Prefer WordPress URL functions and let TranslatePress filter them:

$url = get_permalink( $post_id );

When a URL is output in an unusual place or must target a specific language, use the documented URL converter:

if ( class_exists( 'TRP_Translate_Press' ) ) {
    $trp = TRP_Translate_Press::get_trp_instance();
    $url_converter = $trp->get_component( 'url_converter' );
    $url = $url_converter->get_url_for_language( 'de_DE', $source_url, '' );
}

Keep the third parameter as an empty string unless you have source-confirmed reasons to do otherwise.

Never manually prepend /en/, strip the first path segment, or concatenate language slugs from settings. That breaks translated slugs, default-language subdirectory mode, unpublished languages, and domain mapping.

External links

TranslatePress can inspect external links for URL translation. If an external link must never be rewritten, mark it explicitly:

echo '<a href="https://facebook.com/example" data-no-translation-href>Facebook</a>';