钩子文档

signup_extra_fields

💡 云策文档标注

概述

signup_extra_fields 是一个 WordPress 动作钩子,在新用户账户注册表单的末尾触发,允许开发者添加自定义字段或处理错误。

关键要点

  • 触发时机:在新用户账户注册表单的末尾执行。
  • 参数:接受一个 WP_Error 对象 $errors,包含 'user_name' 或 'user_email' 相关的错误信息。
  • 用途:常用于扩展注册表单,添加额外字段或基于错误进行自定义处理。
  • 相关函数:与 show_user_form() 函数关联,该函数在 wp-signup.php 中显示新用户账户注册表单的字段。
  • 版本历史:从 WordPress 3.0.0 版本开始引入。

📄 原文内容

Fires at the end of the new user account registration form.

Parameters

$errorsWP_Error
A WP_Error object containing 'user_name' or 'user_email' errors.

Source

do_action( 'signup_extra_fields', $errors );

Changelog

Version Description
3.0.0 Introduced.