云策 WordPress 开发者社区

钩子文档

widget_title

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

概述

widget_title 是一个 WordPress 过滤器钩子，用于修改小部件标题。它允许开发者在渲染小部件时动态调整标题内容。

关键要点

  • 过滤器钩子：widget_title，用于过滤小部件标题。
  • 参数：$title（标题字符串，默认 'Pages'）、$instance（当前小部件设置数组）、$id_base（小部件 ID）。
  • 用法：通过 apply_filters('widget_title', $title, $instance, $this->id_base) 调用。
  • 相关函数：被多个核心小部件类（如 WP_Widget_Pages、WP_Widget_Text 等）的 widget() 方法使用。
  • 版本历史：自 WordPress 2.6.0 引入。
📄 原文内容

Filters the widget title.

Parameters

$titlestring
The widget title. Default 'Pages'.
$instancearray
Array of settings for the current widget.
$id_basemixed
The widget ID.

Source

$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );

View all references View on Trac View on GitHub

Used by Description
WP_Widget_Custom_HTML::widget()wp-includes/widgets/class-wp-widget-custom-html.php

Outputs the content for the current Custom HTML widget instance.
WP_Widget_Media::widget()wp-includes/widgets/class-wp-widget-media.php

Displays the widget on the front-end.
WP_Nav_Menu_Widget::widget()wp-includes/widgets/class-wp-nav-menu-widget.php

Outputs the content for the current Navigation Menu widget instance.
WP_Widget_Tag_Cloud::widget()wp-includes/widgets/class-wp-widget-tag-cloud.php

Outputs the content for the current Tag Cloud widget instance.
WP_Widget_RSS::widget()wp-includes/widgets/class-wp-widget-rss.php

Outputs the content for the current RSS widget instance.
WP_Widget_Recent_Posts::widget()wp-includes/widgets/class-wp-widget-recent-posts.php

Outputs the content for the current Recent Posts widget instance.
WP_Widget_Recent_Comments::widget()wp-includes/widgets/class-wp-widget-recent-comments.php

Outputs the content for the current Recent Comments widget instance.
WP_Widget_Categories::widget()wp-includes/widgets/class-wp-widget-categories.php

Outputs the content for the current Categories widget instance.
WP_Widget_Calendar::widget()wp-includes/widgets/class-wp-widget-calendar.php

Outputs the content for the current Calendar widget instance.
WP_Widget_Text::widget()wp-includes/widgets/class-wp-widget-text.php

Outputs the content for the current Text widget instance.
WP_Widget_Archives::widget()wp-includes/widgets/class-wp-widget-archives.php

Outputs the content for the current Archives widget instance.
WP_Widget_Meta::widget()wp-includes/widgets/class-wp-widget-meta.php

Outputs the content for the current Meta widget instance.
WP_Widget_Search::widget()wp-includes/widgets/class-wp-widget-search.php

Outputs the content for the current Search widget instance.
WP_Widget_Pages::widget()wp-includes/widgets/class-wp-widget-pages.php

Outputs the content for the current Pages widget instance.

Show 9 moreShow less

Changelog

Version Description
2.6.0 Introduced.