wpfts_widget_html (Filter)

Фильтр wpfts_widget_html в WP Fast Total Search позволяет разработчикам модифицировать HTML-код виджета поиска перед его выводом на странице. Это дает полный контроль над разметкой виджета и позволяет добавлять, изменять или удалять элементы HTML.

Когда используется

Этот фильтр полезен в следующих случаях:

• Добавление новых элементов в виджет: Например, вы можете добавить поле для выбора категории поиска или другие элементы управления.
• Изменение существующих элементов виджета: Вы можете изменить атрибуты элементов, например, добавить CSS-классы или стили.
• Удаление элементов виджета: Вы можете скрыть или удалить ненужные элементы.
• Полная замена разметки виджета: Вы можете полностью переопределить HTML-код виджета.

Аргументы

• $out (string): HTML-код виджета, сгенерированный плагином.
• $preset (array): Массив данных пресета, используемого виджетом.
• $preset_id (string): Идентификатор пресета.
• $context (string): Контекст использования виджета (в данном случае ‘widget’).

Возвращаемое значение

• $out (string): Модифицированный HTML-код виджета.

Пример (добавление поля для выбора категории)

add_filter('wpfts_widget_html', 'add_category_select', 10, 4);
 
function add_category_select($out, $preset, $preset_id, $context)
{
    $categories = get_categories();
    $select = '<select name="category">';
    foreach ($categories as $category) {
        $select .= '<option value="' . $category->term_id . '">' . $category->name . '</option>';
    }
    $select .= '</select>';
 
    // Вставляем select перед полем поиска.
    $out = str_replace('<input type="search"', $select . '<input type="search"', $out);
    return $out;
}

Важные замечания

• Фильтр wpfts_widget_html вызывается перед выводом HTML-кода виджета на странице.
• Изменения, внесенные в $out, будут отображены на сайте. Будьте осторожны при модификации HTML-кода.
• Параметры $preset, $preset_id и $context могут быть использованы для динамического изменения HTML-кода в зависимости от настроек виджета.

Фильтр wpfts_widget_html — это мощный инструмент для кастомизации виджета поиска WPFTS, дающий разработчикам полный контроль над его разметкой.