_load_textdomain_just_in_time() │ WP 4.6.0

Loads plugin and theme textdomains just-in-time.

When a textdomain is encountered for the first time, we try to load the translation file from wp-content/languages, removing the need to call load_plugin_texdomain() or load_theme_texdomain().

This is an internal function for using it by WP core itself. It's not recommended to use this function in your code.

No Hooks.

Return

true|false. True when the textdomain is successfully loaded, false otherwise.

Usage

_load_textdomain_just_in_time( $domain );

$domain(string) (required): Text domain. Unique identifier for retrieving translated strings.

Notes

See: get_translations_for_domain()
Global. MO[]. $l10n_unloaded An array of all text domains that have been unloaded again.

Changelog

Since 4.6.0

Introduced.

Code of `_load_textdomain_just_in_time() load textdomain just in time` ^{WP 6.0}

wp-includes/l10n.php

function _load_textdomain_just_in_time( $domain ) {
	global $l10n_unloaded;

	$l10n_unloaded = (array) $l10n_unloaded;

	// Short-circuit if domain is 'default' which is reserved for core.
	if ( 'default' === $domain || isset( $l10n_unloaded[ $domain ] ) ) {
		return false;
	}

	$translation_path = _get_path_to_translation( $domain );
	if ( false === $translation_path ) {
		return false;
	}

	return load_textdomain( $domain, $translation_path );
}