wordpress / latest / classes / wp_locale_switcher / switch_to_locale.html

WP_Locale_Switcher::switch_to_locale( string $locale ): bool

Switches the translations according to the given locale.

Parameters

$locale string Required
The locale to switch to.

Return

bool True on success, false on failure.

Source

File: wp-includes/class-wp-locale-switcher.php. View all references

public function switch_to_locale( $locale ) {
	$current_locale = determine_locale();
	if ( $current_locale === $locale ) {
		return false;
	}

	if ( ! in_array( $locale, $this->available_languages, true ) ) {
		return false;
	}

	$this->locales[] = $locale;

	$this->change_locale( $locale );

	/**
	 * Fires when the locale is switched.
	 *
	 * @since 4.7.0
	 *
	 * @param string $locale The new locale.
	 */
	do_action( 'switch_locale', $locale );

	return true;
}

Hooks

Uses

Uses Description

Used By

Used By Description

Changelog

Version Description
4.7.0 Introduced.

© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_locale_switcher/switch_to_locale