Как изменить заголовок виджетов в WordPress с помощью фильтра widget_title

Фильтр widget_title в WordPress предоставляет разработчикам возможность настраивать заголовки виджетов, позволяя изменить их внешний вид и содержание перед выводом на экран. Это может быть полезно, если вам нужно изменить стиль заголовков, добавить атрибуты или произвести другие манипуляции с текстом.

Как это работает

Когда виджет загружается, WordPress применяет фильтр widget_title к заголовку виджета. Этот фильтр позволяет перехватить текст заголовка, внести изменения и вернуть его в измененном виде. Он принимает один аргумент: текст заголовка виджета, что позволяет делать изменения в зависимости от типа виджета или его настроек.

Пример использования

Рассмотрим пример, в котором мы изменим заголовок виджета, добавляя к нему специальный префикс и оборачивая в тег <h2>. Мы будем использовать фильтр widget_title, чтобы сделать заголовок более привлекательным и информативным.

Шаг 1: Добавление функции для изменения заголовка виджета

Откройте файл functions.php вашей темы и добавьте следующий код:

function customize_widget_title( $title, $instance, $id_base ) {
    // Проверяем, что это заголовок определенного виджета
    if ( 'recent-posts' === $id_base ) {
        // Добавляем префикс и оборачиваем в <h2>
        $title = '<h2>Новые записи: ' . $title . '</h2>';
    }
    
    return $title; // Возвращаем измененный заголовок
}
add_filter( 'widget_title', 'customize_widget_title', 10, 3 );

Как работает этот код

  1. Функция customize_widget_title принимает три аргумента: $title — это исходный текст заголовка виджета, $instance — массив настроек виджета, и $id_base — базовый идентификатор виджета.
  2. Мы проверяем, что это заголовок виджета типа recent-posts, используя условие if. Это позволяет нам изменять только заголовки определенных виджетов, не затрагивая другие.
  3. Далее мы добавляем префикс «Новые записи: » и оборачиваем заголовок в тег <h2>, что делает его более заметным и привлекательным для пользователей.
  4. Наконец, мы возвращаем измененный заголовок виджета.

Зачем использовать widget_title?

Фильтр widget_title полезен в различных сценариях:

  • Настройка внешнего вида: Изменение стилей заголовков виджетов для улучшения визуального восприятия сайта.
  • Добавление дополнительной информации: Можно добавлять префиксы или суффиксы к заголовкам для большего информирования пользователей.
  • Динамическое изменение содержания: Изменение заголовков на основе определенных условий, таких как настройки виджета или контекст страницы.

Почитаем еще?: