WP_Locale_Switcher::restore_previous_locale() WordPress Method
TheWP_Locale_Switcher::restore_previous_locale()method is used to restore the previous locale that was active before the current one. This is useful for restoring the original locale after a user has changed the locale for a specific action or request.
WP_Locale_Switcher::restore_previous_locale() #
Restores the translations according to the previous locale.
Return
(string|false) Locale on success, false on failure.
Source
File: wp-includes/class-wp-locale-switcher.php
public function restore_previous_locale() { $previous_locale = array_pop( $this->locales ); if ( null === $previous_locale ) { // The stack is empty, bail. return false; } $locale = end( $this->locales ); if ( ! $locale ) { // There's nothing left in the stack: go back to the original locale. $locale = $this->original_locale; } $this->change_locale( $locale ); /** * Fires when the locale is restored to the previous one. * * @since 4.7.0 * * @param string $locale The new locale. * @param string $previous_locale The previous locale. */ do_action( 'restore_previous_locale', $locale, $previous_locale ); return $locale; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.7.0 | Introduced. |