钩子文档

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.

User Contributed Notes