wp_load_translations_early()

Attempts an early load of translations.

Description

Used for errors encountered during the initial loading process, before the locale has been properly detected and loaded.

Designed for unusual load sequences (like setup-config.php) or for when the script will then terminate with an error, otherwise there is a risk that a file can be double-included.

Source

function wp_load_translations_early() {
	global $wp_textdomain_registry, $wp_locale;
	static $loaded = false;

	if ( $loaded ) {
		return;
	}

	$loaded = true;

	if ( function_exists( 'did_action' ) && did_action( 'init' ) ) {
		return;
	}

	// We need $wp_local_package.
	require ABSPATH . WPINC . '/version.php';

	// Translation and localization.
	require_once ABSPATH . WPINC . '/pomo/mo.php';
	require_once ABSPATH . WPINC . '/l10n/class-wp-translation-controller.php';
	require_once ABSPATH . WPINC . '/l10n/class-wp-translations.php';
	require_once ABSPATH . WPINC . '/l10n/class-wp-translation-file.php';
	require_once ABSPATH . WPINC . '/l10n/class-wp-translation-file-mo.php';
	require_once ABSPATH . WPINC . '/l10n/class-wp-translation-file-php.php';
	require_once ABSPATH . WPINC . '/l10n.php';
	require_once ABSPATH . WPINC . '/class-wp-textdomain-registry.php';
	require_once ABSPATH . WPINC . '/class-wp-locale.php';
	require_once ABSPATH . WPINC . '/class-wp-locale-switcher.php';

	// General libraries.
	require_once ABSPATH . WPINC . '/plugin.php';

	$locales   = array();
	$locations = array();

	if ( ! $wp_textdomain_registry instanceof WP_Textdomain_Registry ) {
		$wp_textdomain_registry = new WP_Textdomain_Registry();
	}

	while ( true ) {
		if ( defined( 'WPLANG' ) ) {
			if ( '' === WPLANG ) {
				break;
			}
			$locales[] = WPLANG;
		}

		if ( isset( $wp_local_package ) ) {
			$locales[] = $wp_local_package;
		}

		if ( ! $locales ) {
			break;
		}

		if ( defined( 'WP_LANG_DIR' ) && @is_dir( WP_LANG_DIR ) ) {
			$locations[] = WP_LANG_DIR;
		}

		if ( defined( 'WP_CONTENT_DIR' ) && @is_dir( WP_CONTENT_DIR . '/languages' ) ) {
			$locations[] = WP_CONTENT_DIR . '/languages';
		}

		if ( @is_dir( ABSPATH . 'wp-content/languages' ) ) {
			$locations[] = ABSPATH . 'wp-content/languages';
		}

		if ( @is_dir( ABSPATH . WPINC . '/languages' ) ) {
			$locations[] = ABSPATH . WPINC . '/languages';
		}

		if ( ! $locations ) {
			break;
		}

		$locations = array_unique( $locations );

		foreach ( $locales as $locale ) {
			foreach ( $locations as $location ) {
				if ( file_exists( $location . '/' . $locale . '.mo' ) ) {
					load_textdomain( 'default', $location . '/' . $locale . '.mo', $locale );

					if ( defined( 'WP_SETUP_CONFIG' ) && file_exists( $location . '/admin-' . $locale . '.mo' ) ) {
						load_textdomain( 'default', $location . '/admin-' . $locale . '.mo', $locale );
					}

					break 2;
				}
			}
		}

		break;
	}

	$wp_locale = new WP_Locale();
}

View all references View on Trac View on GitHub

Uses	Description
load_textdomain()`wp-includes/l10n.php`	Loads a .mo file into the text domain $domain.
WP_Locale::__construct()`wp-includes/class-wp-locale.php`	Constructor which calls helper methods to set up object variables.
did_action()`wp-includes/plugin.php`	Retrieves the number of times an action has been fired during the current request.

Used by	Description
WP_Object_Cache::is_valid_key()`wp-includes/class-wp-object-cache.php`	Serves as a utility function to determine whether a key is valid.
WP_Fatal_Error_Handler::display_default_error_template()`wp-includes/class-wp-fatal-error-handler.php`	Displays the default PHP error template.
wpdb::process_fields()`wp-includes/class-wpdb.php`	Processes arrays of field/value pairs and field formats.
wp_check_php_mysql_versions()`wp-includes/load.php`	Checks for the required PHP version, and the mysqli extension or a database drop-in.
wp_maintenance()`wp-includes/load.php`	Dies with a maintenance message when conditions are met.
wp_set_wpdb_vars()`wp-includes/load.php`	Sets the database table prefix and the format specifiers for database table columns.
dead_db()`wp-includes/functions.php`	Loads custom DB error or display WordPress DB error.
is_blog_installed()`wp-includes/functions.php`	Determines whether WordPress is already installed.
ms_not_installed()`wp-includes/ms-load.php`	Displays a failure message.
wpdb::check_connection()`wp-includes/class-wpdb.php`	Checks that the connection to the database is still up. If not, try to reconnect.
wpdb::query()`wp-includes/class-wpdb.php`	Performs a database query, using current database connection.
wpdb::select()`wp-includes/class-wpdb.php`	Selects a database using the current or provided database connection.
wpdb::_real_escape()`wp-includes/class-wpdb.php`	Real escape using mysqli_real_escape_string().
wpdb::prepare()`wp-includes/class-wpdb.php`	Prepares a SQL query for safe execution.
wpdb::print_error()`wp-includes/class-wpdb.php`	Prints SQL/DB error.
wpdb::db_connect()`wp-includes/class-wpdb.php`	Connects to and selects database.

Show 11 more Show less

Changelog

Version	Description
3.4.0	Introduced.

In this article

Description

Source

Changelog

User Contributed Notes

wp_load_translations_early()

In this article

Description

Source

Related

Changelog

User Contributed Notes