widget_title
Дозволяє змінити заголовок віджету у фронтенді.
Використання
add_filter( 'widget_title', 'wp_kama_widget_title_filter', 10, 3);
/**
* Function for `widget_title` filter-hook.
*
* @param string $title The widget title.
* @param array $instance Array of settings for the current widget.
* @param mixed $id_base The widget ID.
*
* @return string
*/
function wp_kama_widget_title_filter( $title, $instance, $id_base ){
// Filter...
return $title;
}-
$title
(рядок) - Заголовок віджету.
-
$instance
(масив) Налаштування поточного віджету. Наприклад, віджет “Рубрики” в залежності від налаштувань може містити такі дані:
Array ( [title] => Рубрики [count] => 0 [hierarchical] => 1 [dropdown] => 1 )
-
$id_base
(рядок) -
ID віджету, який вказується в конструкторі класу віджету. Наприклад, віджет “Рубрики” має
id = categories , а у віджета “Свіжі записи”
id = recent-posts .
Приклади
#1 Змінимо заголовок тільки у віджетів “Рубрики”.
Зробимо все те саме, що і в першому прикладі, але тільки для віджетів “Рубрики”.
/**
* Змінює заголовок у всіх віджетів "Рубрики".
*
* @param string $title
* @param array $instance
* @param string $id_base
*
* @return string
*/
function filter_widget_categories_title( $title, $instance, $id_base ) {
if ( 'categories' == $id_base ) {
$title = "<span class='my-custom-class'>$title</span>";
}
return $title;
}
add_filter( 'widget_title', 'filter_widget_categories_title', 10, 3);#2 Змінимо заголовок у всіх віджетів.
Обернемо заголовок у всіх віджетів у тег span з довільним CSS класом.
/**
* Змінює заголовок всіх віджетів.
*
* @param string $title
*
* @return string
*/
function filter_all_widget_title( $title ) {
return "<span class='my-custom-class'>$title</span>";
}
add_filter( 'widget_title', 'filter_all_widget_title');#3 Змінимо заголовок у всіх віджетів “Рубрики” у вигляді списку, що випадає.
/**
* Змінює заголовок у всіх віджетів "Рубрики" у вигляді списку, що випадає.
*
* @param string $title
* @param array $instance
* @param string $id_base
*
* @return string
*/
function filter_widget_categories_title( $title, $instance, $id_base ) {
if ( 'categories' == $id_base && ! empty( $instance['hierarchical'] ) ) {
$title .= 'у вигляді списку, що випадає';
}
return $title;
}
add_filter( 'widget_title', 'filter_widget_categories_title', 10, 3);
список змін
| З версії 2.6.0 | Введено. |
Де викликається хук
widget_title
widget_title
widget_title
widget_title
widget_title
widget_title
widget_title
widget_title
wp-includes/widgets/class-wp-widget-rss.php 87
$title = apply_filters( 'widget_title', $title, $instance, $this->id_base );
Де використовується хук у WordPress
wp-includes/default-filters.php 147
add_filter($filter, 'wptexturize');
wp-includes/default-filters.php 148
add_filter($filter, 'convert_chars');
wp-includes/default-filters.php 149
add_filter( $filter, 'esc_html');