WP_Locale_Switcher::restore_previous_locale(): string|false

In this article

Restores the translations according to the previous locale.

Return

string|false Locale on success, false on failure.

Source

public function restore_previous_locale() {
	$previous_locale = array_pop( $this->stack );

	if ( null === $previous_locale ) {
		// The stack is empty, bail.
		return false;
	}

	$entry  = end( $this->stack );
	$locale = is_array( $entry ) ? $entry[0] : false;

	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[0] );

	return $locale;
}

Hooks

do_action( ‘restore_previous_locale’, string $locale, string $previous_locale )

Fires when the locale is restored to the previous one.

Changelog

VersionDescription
4.7.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.