Расширение функционалаХуки Action/Filterwpfts_widget_instance

wpfts_widget_instance (Filter)

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

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

Этот фильтр может быть полезен, если вам нужно изменить настройки виджета в зависимости от контекста, например:

  • Изменение заголовка виджета в зависимости от текущей страницы.
  • Установка различных placeholder’ов для разных видов поиска.
  • Добавление или изменение CSS-классов виджета.

Аргументы

  • $instance (array): Ассоциативный массив данных экземпляра виджета. Содержит такие ключи, как title, wpfts_wdgt, placeholder, button_text, hide_button, class и др.
  • $id_base (string): Базовый идентификатор виджета (в данном случае wpfts_custom_widget).

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

  • $instance (array): Модифицированный массив данных экземпляра виджета.

Пример (изменение заголовка виджета на странице категории товаров)

add_filter('wpfts_widget_instance', 'change_widget_title', 10, 2);
function change_widget_title($instance, $id_base)
{
	if (is_product_category()) {
		$instance['title'] = __('Search Products', 'my-theme');
	}
	return $instance;
}

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

  • Фильтр wpfts_widget_instance вызывается перед отображением виджета.
  • Изменения, внесенные в массив $instance, будут применены к отображаемому виджету.

Фильтр wpfts_widget_instance дает разработчикам гибкость в настройке отображения виджета поиска WPFTS в зависимости от контекста страницы.

wpfts_widget_htmlIndex