login_form_top
云策文档标注
概述
login_form_top 是一个 WordPress 过滤器,用于在登录表单顶部添加自定义内容。它仅在 wp_login_form() 函数生成的表单中生效,不适用于默认的 wp-login.php 页面。
关键要点
- 过滤器名称:login_form_top
- 作用位置:紧跟在登录表单的打开标签之后
- 参数:$content(字符串,默认空)和 $args(数组,登录表单参数)
- 使用场景:仅适用于 wp_login_form() 函数创建的登录表单
- 注意事项:无法用于默认的 wp-login.php 页面
代码示例
$login_form_top = apply_filters( 'login_form_top', '', $args );注意事项
此过滤器在 WordPress 3.0.0 版本中引入,开发者需注意其适用范围限制。
原文内容
Filters content to display at the top of the login form.
Description
The filter evaluates just following the opening form tag element.
Parameters
$contentstring-
Content to display. Default empty.
$argsarray-
Array of login form arguments.
Source
$login_form_top = apply_filters( 'login_form_top', '', $args );
Changelog
| Version | Description |
|---|---|
| 3.0.0 | Introduced. |
Skip to note 2 content
Deepak Rajpal
Note: The filter
login_form_topis not available in wp-login.php, so you cannot use to customize default login form. This will only works if you are using forms created bywp_login_form()function.