_get_path_to_translation_from_lang_dir() │ WP 4.7.0

Устарела с версии 6.1.0. Больше не поддерживается и может быть удалена. Рекомендуется заменить эту функцию на аналог.

Gets the path to a translation file in the languages directory for the current locale.

Holds a cached list of available .mo files to improve performance.

Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.

Хуков нет.

Возвращает

Строку|false. The path to the translation file or false if no translation file was found.

Использование

_get_path_to_translation_from_lang_dir( $domain );
$domain(строка) (обязательный)
Text domain. Unique identifier for retrieving translated strings.

Заметки

Список изменений

С версии 4.7.0 Введена.
Устарела с 6.1.0

Код _get_path_to_translation_from_lang_dir() WP 7.0

wp-includes/deprecated.php 
function _get_path_to_translation_from_lang_dir( $domain ) {
	_deprecated_function( __FUNCTION__, '6.1.0', 'WP_Textdomain_Registry' );

	static $cached_mofiles = null;

	if ( null === $cached_mofiles ) {
		$cached_mofiles = array();

		$locations = array(
			WP_LANG_DIR . '/plugins',
			WP_LANG_DIR . '/themes',
		);

		foreach ( $locations as $location ) {
			$mofiles = glob( $location . '/*.mo' );
			if ( $mofiles ) {
				$cached_mofiles = array_merge( $cached_mofiles, $mofiles );
			}
		}
	}

	$locale = determine_locale();
	$mofile = "{$domain}-{$locale}.mo";

	$path = WP_LANG_DIR . '/plugins/' . $mofile;
	if ( in_array( $path, $cached_mofiles, true ) ) {
		return $path;
	}

	$path = WP_LANG_DIR . '/themes/' . $mofile;
	if ( in_array( $path, $cached_mofiles, true ) ) {
		return $path;
	}

	return false;
}