wp_validate_site_data
云策文档标注
概述
wp_validate_site_data 是一个 WordPress Hook，在站点数据插入或更新到数据库前触发，用于验证数据。插件可以通过此 Hook 添加验证错误。
关键要点
- 触发时机：在站点数据插入或更新到数据库前执行验证。
- 参数：$errors（WP_Error 对象，用于添加验证错误）、$data（关联数组，包含完整的站点数据）、$old_site（WP_Site 对象或 null，表示旧站点或新站点）。
- 用途：插件应使用 WP_Error::add() 方法向 $errors 对象添加验证错误。
- 相关函数：与 wp_prepare_site_data() 配合使用，用于准备站点数据。
- 版本：自 WordPress 5.1.0 引入。
原文内容
Fires when data should be validated for a site prior to inserting or updating in the database.
Description
Plugins should amend the $errors object via its WP_Error::add() method.
Parameters
$errorsWP_Error-
Error object to add validation errors to.
$dataarray-
Associative array of complete site data. See wp_insert_site() for the included data.
$old_siteWP_Site|null-
The old site object if the data belongs to a site being updated, or null if it is a new site being inserted.
Source
do_action( 'wp_validate_site_data', $errors, $data, $old_site );
Changelog
| Version | Description |
|---|---|
| 5.1.0 | Introduced. |