wp_load_translations_early()

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Attempt 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

File: wp-includes/load.php 

function wp_load_translations_early() {
	global $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.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();

	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' );
					if ( defined( 'WP_SETUP_CONFIG' ) && file_exists( $location . '/admin-' . $locale . '.mo' ) ) {
						load_textdomain( 'default', $location . '/admin-' . $locale . '.mo' );
					}
					break 2;
				}
			}
		}

		break;
	}

	$wp_locale = new WP_Locale();
}

Uses

Uses Description
wp-includes/l10n.php: load_textdomain()

Load a .mo file into the text domain $domain.
wp-includes/class-wp-locale.php: WP_Locale::__construct()

Constructor which calls helper methods to set up object variables.
wp-includes/plugin.php: did_action()

Retrieves the number of times an action has been fired during the current request.

Used By

Used By Description
wp-includes/class-wp-fatal-error-handler.php: WP_Fatal_Error_Handler::display_default_error_template()

Displays the default PHP error template.
wp-includes/load.php: wp_check_php_mysql_versions()

Check for the required PHP version, and the MySQL extension or a database drop-in.
wp-includes/load.php: wp_maintenance()

Die with a maintenance message when conditions are met.
wp-includes/load.php: wp_set_wpdb_vars()

Set the database table prefix and the format specifiers for database table columns.
wp-includes/functions.php: dead_db()

Load custom DB error or display WordPress DB error.
wp-includes/functions.php: is_blog_installed()

Determines whether WordPress is already installed.
wp-includes/ms-load.php: ms_not_installed()

Displays a failure message.
wp-includes/wp-db.php: wpdb::check_connection()

Checks that the connection to the database is still up. If not, try to reconnect.
wp-includes/wp-db.php: wpdb::select()

Selects a database using the current database connection.
wp-includes/wp-db.php: wpdb::prepare()

Prepares a SQL query for safe execution.
wp-includes/wp-db.php: wpdb::print_error()

Prints SQL/DB error.
wp-includes/wp-db.php: wpdb::db_connect()

Connects to and selects database.

Changelog

Version Description
3.4.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_load_translations_early