云策 WordPress 开发者社区

函数文档

restore_previous_locale()

查看官方原文 ↗
💡 云策文档标注

概述

restore_previous_locale() 是一个 WordPress 函数，用于根据先前设置的区域设置恢复翻译。它返回成功时的区域设置字符串或错误时的 false。

关键要点

  • 函数功能：恢复先前区域设置的翻译，依赖于 WP_Locale_Switcher 类。
  • 返回值：成功时返回区域设置字符串，失败时返回 false。
  • 依赖条件：需要全局变量 $wp_locale_switcher 存在且有效。
  • 引入版本：WordPress 4.7.0 中首次引入。

代码示例

function restore_previous_locale() {
    /* @var WP_Locale_Switcher $wp_locale_switcher */
    global $wp_locale_switcher;

    if ( ! $wp_locale_switcher ) {
        return false;
    }

    return $wp_locale_switcher->restore_previous_locale();
}

注意事项

  • 函数内部调用 WP_Locale_Switcher::restore_previous_locale() 方法，确保 $wp_locale_switcher 已初始化。
  • 在相关使用场景中，如多站点通知、自动更新邮件发送等，此函数可能被间接调用以处理本地化翻译。
📄 原文内容

Restores the translations according to the previous locale.

Return

string|false Locale on success, false on error.

Source

function restore_previous_locale() {
	/* @var WP_Locale_Switcher $wp_locale_switcher */
	global $wp_locale_switcher;

	if ( ! $wp_locale_switcher ) {
		return false;
	}

	return $wp_locale_switcher->restore_previous_locale();
}

View all references View on Trac View on GitHub

Uses Description
WP_Locale_Switcher::restore_previous_locale()wp-includes/class-wp-locale-switcher.php

Restores the translations according to the previous locale.
Used by Description
wpmu_new_site_admin_notification()wp-includes/ms-functions.php

Notifies the Multisite network administrator that a new site was created.
WP_Automatic_Updater::send_plugin_theme_email()wp-admin/includes/class-wp-automatic-updater.php

Sends an email upon the completion or failure of a plugin or theme background update.
WP_Recovery_Mode_Email_Service::send_recovery_mode_email()wp-includes/class-wp-recovery-mode-email-service.php

Sends the Recovery Mode email to the site admin email address.
_wp_privacy_send_erasure_fulfillment_notification()wp-includes/user.php

Notifies the user when their erasure request is fulfilled.
wp_send_user_request()wp-includes/user.php

Send a confirmation request email to confirm an action.
wp_privacy_send_personal_data_export_email()wp-admin/includes/privacy-tools.php

Send an email to the user with a link to the personal data export file
update_network_option_new_admin_email()wp-includes/ms-functions.php

Sends a confirmation request email when a change of network admin email address is attempted.
WP_Customize_Selective_Refresh::export_preview_data()wp-includes/customize/class-wp-customize-selective-refresh.php

Exports data in preview after it has finished rendering so that partials can be added at runtime.
retrieve_password()wp-includes/user.php

Handles sending a password retrieval email to a user.
WP_Automatic_Updater::send_email()wp-admin/includes/class-wp-automatic-updater.php

Sends an email upon the completion or failure of a background core update.
WP_Automatic_Updater::send_debug_email()wp-admin/includes/class-wp-automatic-updater.php

Prepares and sends an email of a full log of background update results, useful for debugging and geekery.
update_option_new_admin_email()wp-admin/includes/misc.php

Sends a confirmation request email when a change of site admin email address is attempted.
insert_with_markers()wp-admin/includes/misc.php

Inserts an array of strings into a file (.htaccess), placing it between BEGIN and END markers.
WP_Customize_Manager::customize_preview_settings()wp-includes/class-wp-customize-manager.php

Prints JavaScript settings for preview frame.
wp_password_change_notification()wp-includes/pluggable.php

Notifies the blog admin of a user changing password, normally via email.
wp_new_user_notification()wp-includes/pluggable.php

Emails login credentials to a newly-registered user.
wp_notify_postauthor()wp-includes/pluggable.php

Notifies an author (and/or others) of a comment/trackback/pingback on a post.
wp_notify_moderator()wp-includes/pluggable.php

Notifies the moderator of the site about a new comment that is awaiting approval.
wp_update_user()wp-includes/user.php

Updates a user in the database.
wpmu_welcome_user_notification()wp-includes/ms-functions.php

Notifies a user that their account activation has been successful.
wpmu_welcome_notification()wp-includes/ms-functions.php

Notifies the site administrator that their site activation was successful.
wpmu_signup_blog_notification()wp-includes/ms-functions.php

Sends a confirmation request email to a user when they sign up for a new site. The new site will not become active until the confirmation link is clicked.
wpmu_signup_user_notification()wp-includes/ms-functions.php

Sends a confirmation request email to a user when they sign up for a new user account (without signing up for a site at the same time). The user account will not become active until the confirmation link is clicked.
WP_Customize_Widgets::export_preview_data()wp-includes/class-wp-customize-widgets.php

Communicates the sidebars that appeared on the page at the very end of the page, and at the very end of the wp_footer,

Show 19 moreShow less

Changelog

Version Description
4.7.0 Introduced.