wpfts_apply_sentence_styles (Filter)

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

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

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

• Применение пользовательских стилей к предложениям: Вы можете добавить CSS-классы или inline-стили к каждому предложению.
• Добавление ссылок на предложения: Вы можете обернуть каждое предложение в ссылку, ведущую на страницу поста с выделенным предложением.
• Изменение текста предложения: Вы можете изменить текст предложения перед его выводом, например, сократить его или добавить к нему префикс/суффикс.

Аргументы

• $outtext (string): HTML-код предложения, сгенерированный плагином.
• $sentence_styles (array): Массив стилей предложений, заданных в настройках плагина.
• $key (string): Ключ кластера, из которого было извлечено предложение.
• $words (array): Массив поисковых слов.
• $sentence (string): Оригинальный текст предложения.

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

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

Пример (добавление CSS-класса к каждому предложению)

 
add_filter('wpfts_apply_sentence_styles', 'add_custom_class_to_sentences', 10, 5);
 
function add_custom_class_to_sentences($outtext, $sentence_styles, $key, $words, $sentence) {
 
	// добавляем класс 'my-custom-sentence-class' к каждому предложению
	$outtext = str_replace('<span class="wpfts-sentence">', '<span class="wpfts-sentence my-custom-sentence-class">', $outtext);
 
	return $outtext;
}
 

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

• Фильтр wpfts_apply_sentence_styles вызывается для каждого предложения в Smart Excerpts.
• Изменения, внесенные в $outtext, будут отображены на странице результатов поиска.
• Вы можете использовать аргументы $sentence_styles, $key, $words и $sentence для динамического изменения HTML-кода предложения.

Фильтр wpfts_apply_sentence_styles предоставляет разработчикам возможность тонкой настройки отображения Smart Excerpts в WP Fast Total Search.