# wplingua/2.13.0/inc/url.php

Translate and Go multilingual – Automatic AI translation – wpLingua, version 2.13.0. 523 lines.

- Page: https://pluginprobe.com/plugins/wplingua/2.13.0/code/inc/url.php
- Raw: https://pluginprobe.com/plugins/wplingua/2.13.0/raw/inc/url.php
- Modified: 2026-05-21T00:12:40+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/wplingua/2.13.0/code/inc/url.php#L10-L20`.

```php
<?php

// If this file is called directly, abort.
if ( ! defined( 'WPINC' ) ) {
	die;
}


/**
 * Add language ID in path while preserving WordPress home base path.
 *
 * @param string $path
 * @param string $language_target_id
 * @return string
 */
function wplng_add_language_to_path( $path, $language_target_id ) {

	if ( ! is_string( $path ) || '' === $path ) {
		return '/' . $language_target_id . '/';
	}

	$path_only = $path;
	$suffix    = '';

	$query_pos    = strpos( $path_only, '?' );
	$fragment_pos = strpos( $path_only, '#' );
	$cut_pos      = false;

	if ( false !== $query_pos && false !== $fragment_pos ) {
		$cut_pos = min( $query_pos, $fragment_pos );
	} elseif ( false !== $query_pos ) {
		$cut_pos = $query_pos;
	} elseif ( false !== $fragment_pos ) {
		$cut_pos = $fragment_pos;
	}

	if ( false !== $cut_pos ) {
		$path_only = substr( $path_only, 0, $cut_pos );
		$suffix    = substr( $path, $cut_pos );
	}

	$home_base_path       = wplng_get_home_base_path();
	$home_base_with_slash = trailingslashit( $home_base_path );

	if ( '' !== $home_base_path
		&& ( $path_only === $home_base_path
			|| wplng_str_starts_with( $path_only, $home_base_with_slash ) )
	) {
		$path_after_base = substr( $path_only, strlen( $home_base_with_slash ) );
		$path_only       = $home_base_with_slash . $language_target_id . '/';

		if ( '' !== $path_after_base ) {
			$path_only .= ltrim( $path_after_base, '/' );
		}
	} elseif ( wplng_str_starts_with( $path_only, '/' ) ) {
		$path_only = '/' . $language_target_id . '/' . ltrim( $path_only, '/' );
	} else {
		$path_only = $language_target_id . '/' . $path_only;
	}

	$path_only = preg_replace( '#//+#', '/', $path_only );

	return $path_only . $suffix;
}


/**
 * Get the translated URL
 *
 * @param string $url
 * @param string $language_target_id
 * @return string Translated URL
 */
function wplng_url_translate( $url, $language_target_id = '' ) {
	return apply_filters(
		'wplng_url_translate',
		wplng_url_translate_no_filter(
			$url,
			$language_target_id
		)
	);
}


/**
 * Get the translated URL - No apply 'wplng_url_translate' filter
 *
 * @param string $url
 * @param string $language_target_id
 * @return string Translated URL
 */
function wplng_url_translate_no_filter( $url, $language_target_id = '' ) {

	// Check if URL is an empty string
	if ( '' === $url ) {
		return '';
	}

	// Get current target ID if not set
	if ( '' === $language_target_id ) {
		$language_target_id = wplng_get_language_current_id();
	}

	// Apply links / Medias rules
	$url_link_media_applied = wplng_link_media_apply_rules(
		$url,
		$language_target_id
	);

	// Check if a links / Medias rules was applied
	if ( $url_link_media_applied !== $url ) {
		return $url_link_media_applied;
	}

	// Check if URL is not translatable (exclude /admin/, ...)
	if ( ! wplng_url_is_translatable( $url ) ) {
		return $url;
	}

	$languages_target = wplng_get_languages_target();
	$home_base_path   = wplng_get_home_base_path();

	static $preg_domain     = null;
	static $parsed_url_home = null;

	if ( null === $parsed_url_home ) {
		$parsed_url_home = wp_parse_url( home_url() );
		$preg_domain     = '';
		if ( isset( $parsed_url_home['host'] )
			&& is_string( $parsed_url_home['host'] )
		) {
			$preg_domain = preg_quote( $parsed_url_home['host'] );
		}
	}

	if ( ! empty( $preg_domain )
		&& preg_match( '#^(http:\/\/|https:\/\/)?' . $preg_domain . '(.*)$#', $url )
	) {

		/**
		 * It's an URL starting y a domain name
		 */

		// Check if URL is already translated
		foreach ( $languages_target as $language_target ) {
			if ( wplng_str_contains( $url, '/' . $language_target['id'] . '/' ) ) {
				return $url;
			}
		}

		$parsed_url = wp_parse_url( $url );

		if ( '' === $home_base_path ) {

			if ( ! empty( $parsed_url['path'] ) ) {
				$url = str_replace(
					$parsed_url['path'],
					wplng_slug_translate_path(
						$parsed_url['path'],
						$language_target_id
					),
					$url
				);
			}

			$url = preg_replace(
				'#^(http:\/\/|https:\/\/)?' . $preg_domain . '(.*)$#',
				'${1}' . $parsed_url_home['host'] . '/' . $language_target_id . '${2}',
				$url
			);

		} else {

			$path = '/';

			if ( ! empty( $parsed_url['path'] ) ) {
				$path = $parsed_url['path'];
			}

			$path = wplng_slug_translate_path(
				$path,
				$language_target_id
			);

			$path = wplng_add_language_to_path(
				$path,
				$language_target_id
			);

			if ( ! empty( $parsed_url['path'] ) ) {
				$url = str_replace( $parsed_url['path'], $path, $url );
			} else {
				$url = untrailingslashit( $url ) . $path;
			}
		}

		if ( empty( $parsed_url['fragment'] )
			&& empty( $parsed_url['query'] )
		) {
			// Add slash at the end if is not an anchor link
			$url = trailingslashit( $url );
		}
	} elseif ( preg_match( '#^[^\/]+\/[^\/].*$|^\/[^\/].*$#', $url ) ) {

		/**
		 * It's a path
		 */

		// Check if URL is already translated
		foreach ( $languages_target as $language_target ) {
			if ( wplng_str_starts_with( $url, '/' . $language_target['id'] . '/' )
				|| wplng_str_starts_with( $url, $language_target['id'] . '/' )
			) {
				return $url;
			}
		}

		$url = wplng_slug_translate_path(
			$url,
			$language_target_id
		);

		if ( '' === $home_base_path ) {
			if ( wplng_str_starts_with( $url, '/' ) ) {
				$url = '/' . $language_target_id . $url;
			} else {
				$url = $language_target_id . '/' . $url;
			}
		} else {
			$url = wplng_add_language_to_path(
				$url,
				$language_target_id
			);
		}
	}

	return $url;
}


/**
 * Return true is $url is translatable
 *
 * @param string $url
 * @return bool
 */
function wplng_url_is_translatable( $url = '' ) {

	global $wplng_request_uri;

	// Get current URL if $url is empty
	if ( '' === $url ) {
		$url = sanitize_url( $wplng_request_uri );
	}

	$url = trailingslashit( $url );
	$url = wp_make_link_relative( $url );
	$url = strtolower( $url );

	return apply_filters(
		'wplng_url_is_translatable',
		wplng_url_is_translatable_no_filter( $url ),
		$url
	);
}


/**
 * Return true is $url is translatable - No apply 'wplng_url_translate' filter
 *
 * @param string $url
 * @return bool
 */
function wplng_url_is_translatable_no_filter( $url ) {

	// Check if is an admin page
	if ( wplng_str_contains( $url, wp_make_link_relative( get_admin_url() ) ) ) {
		return false;
	}

	// Check if URL is an anchor link for the current page
	if ( wplng_str_starts_with( $url, '#' ) ) {
		return false;
	}

	// Don't translate some WordPress and WooCommerce URLs
	// admin, REST API, rss and other special URLs
	if ( wplng_str_contains( $url, 'wp-login.php' )
		|| wplng_str_contains( $url, 'wp-register.php' )
		|| wplng_str_contains( $url, 'wp-comments-post.php' )
		|| wplng_str_contains( $url, 'wp-cron.php' )
		|| wplng_str_contains( $url, 'xmlrpc.php' )
		|| wplng_str_ends_with( $url, '/feed/' )
		|| wplng_str_contains( $url, '/wp-json/' )
		|| wplng_str_contains( $url, '/wp-includes/' )
		|| wplng_str_contains( $url, '/oembed/' )
		|| wplng_str_contains( $url, '?wc-ajax=' )
		|| wplng_str_contains( $url, '?feed=' )
		|| wplng_str_contains( $url, '?embed=' )
		|| wplng_str_contains( $url, '&wc-ajax=' )
		|| wplng_str_contains( $url, '&feed=' )
		|| wplng_str_contains( $url, '&embed=' )
		|| wplng_str_contains( $url, 'builder=true&builder_id=' ) // Fusion builder
	) {
		return false;
	}

	// Check if is Divi editor
	if ( current_user_can( 'edit_posts' )
		&& (
			wplng_str_contains( $url, '/?et_fb=1' )
			|| wplng_str_contains( $url, '&et_fb=1' )
		)
	) {
		return false;
	}

	// Check if is in wp-uploads
	if ( wplng_str_contains( $url, wp_make_link_relative( content_url() ) ) ) {
		return false;
	}

	// Exclude files URL
	$regex_is_file = '#\.(avi|css|js|map|docx?|exe|gif|html?|jfif|jpe?g|webp|bmp|midi?|mp3|mpe?g|avif|mov|qt|pdf|png|ra?m|rar|tiff?|txt|wav|zip|ico|xml|rss|xls[x]?|ttf|otf|woff2?|eot|svg)\/$#i';

	if ( preg_match( $regex_is_file, $url ) ) {
		return false;
	}

	// Check if URL is excluded in option page
	$url_original      = wplng_get_url_original( $url );
	$url_exclude_regex = wplng_get_url_exclude_regex();

	foreach ( $url_exclude_regex as $regex ) {
		if ( preg_match( $regex, $url_original ) ) {
			return false;
		}
	}

	return true;
}


/**
 * Get the REGEX list of excluded URLs
 *
 * @return array
 */
function wplng_get_url_exclude_regex() {

	global $wplng_url_exclude_regex;

	if ( null !== $wplng_url_exclude_regex ) {
		return $wplng_url_exclude_regex;
	}

	$url_exclude = array();

	// Get, check and sanitize excluded URL REGEX as string
	$option = get_option( 'wplng_excluded_url' );
	if ( empty( $option ) || ! is_string( $option ) ) {
		$option = '';
	} else {
		$option = sanitize_textarea_field( $option );
	}

	// Get exclude URL REGEX as array
	$option = explode( PHP_EOL, $option );

	// Check each URL REGEX
	foreach ( $option as $regex ) {
		$regex = trim( $regex );
		if ( '' !== $regex && false !== @preg_match( '#' . $regex . '#', '' ) ) {
			$url_exclude[] = '#' . $regex . '#';
		}
	}

	// Remove duplicate
	$url_exclude = array_unique( $url_exclude );

	// Apply wplng_url_exclude_regex filter
	$url_exclude = apply_filters(
		'wplng_url_exclude_regex',
		$url_exclude
	);

	$wplng_url_exclude_regex = $url_exclude;

	return $url_exclude;
}


/**
 * Get the untranslated / original URL
 *
 * @param string $url
 * @return string
 */
function wplng_get_url_original( $url = '' ) {

	if ( '' === $url ) {
		$url = wplng_get_url_current();
	}

	$target = wplng_get_languages_target_ids();

	foreach ( $target as $target_id ) {

		if ( ! wplng_str_contains( $url, '/' . $target_id . '/' ) ) {
			continue;
		}

		$url = str_replace(
			'/' . $target_id . '/',
			'/',
			$url
		);

		$parsed_url = wp_parse_url( $url );

		if ( isset( $parsed_url['path'] )
			&& $parsed_url['path'] !== ''
			&& $parsed_url['path'] !== '/'
		) {

			$url = str_replace(
				$parsed_url['path'],
				wplng_slug_original_path(
					$parsed_url['path'],
					$target_id
				),
				$url
			);
		}

		break;
	}

	$url = apply_filters(
		'wplng_url_original',
		$url
	);

	return $url;
}


/**
 * Get current path
 *
 * @return string
 */
function wplng_get_path_current() {
	global $wplng_request_uri;
	return $wplng_request_uri;
}


/**
 * Get current URL
 *
 * @return string
 */
function wplng_get_url_current() {
	return home_url( wplng_get_path_current() );
}


/**
 * Get the URL translated in specified language
 *
 * @param string $language_id
 * @return string
 */
function wplng_get_url_current_for_language( $language_id ) {
	return wplng_url_translate(
		wplng_get_url_original(),
		$language_id
	);
}


/**
 * Determines whether a given URL points to a sitemap XML file.
 *
 * This function checks if the URL matches common sitemap naming patterns such as:
 * - sitemap.xml
 * - sitemap_index.xml
 * - sitemap-posts.xml
 * - posts-sitemap.xml
 * and similar variations.
 *
 * If no URL is provided, the current URL will be used.
 * The check ignores query parameters and anchors.
 *
 * @param string $url The URL to check. Defaults to the current URL if empty.
 * @return bool True if the URL is identified as a sitemap, false otherwise.
 */
function wplng_url_is_sitemap_xml( $url = '' ) {

	if ( '' === $url ) {
		$url = wplng_get_url_current();
	}

	// Normalize the URL: convert to lowercase
	$url = strtolower( $url );

	// Remove GET parameters and anchors
	$parsed_url = wp_parse_url( $url );
	$url_path   = isset( $parsed_url['path'] ) ? $parsed_url['path'] : '';

	// Check if the URL matches common sitemap patterns
	$is_sitemap = wplng_str_contains( $url_path, 'sitemap' ) && wplng_str_contains( $url_path, '.xml' );

	/**
	 * Filter to allow customization of the sitemap detection logic
	 *
	 * @param bool   $is_sitemap Whether the URL is a sitemap.
	 * @param string $url        The URL being checked.
	 */
	return apply_filters( 'wplng_url_is_sitemap_xml', $is_sitemap, $url );
}

```