Хук page_link в WPFTS

Хук page_link в WordPress — это фильтр, который позволяет изменять URL-адрес страницы перед его выводом. WPFTS использует этот фильтр для применения Smart Excerpts к ссылкам на страницы, отображаемые в результатах поиска. Логика работы практически идентична фильтру attachment_link.

Что делает WPFTS при вызове page_link:

1. Проверка условий: WPFTS проверяет, выполняются ли следующие условия:

   • Плагин активен, и опция Smart Excerpts включена (is_smart_excerpts).

   • Запрос выполняется на странице результатов поиска (is_search()).

   • Запрос не из административной панели (!is_admin()).

   • Ссылка выводится внутри цикла WordPress, или в Gutenberg блоке, выводящем заголовок поста (in_the_loop()).

   • Или, если $wpfts_core->forced_se_query не равен false (принудительный вызов Smart Excerpts).

2. Применение Smart Excerpts к ссылке: Если все условия выполнены, WPFTS создает объект WPFTS_Result_Item для страницы и вызывает его метод TitleLink(), который возвращает модифицированную ссылку.

Важные функции, задействованные в обработке page_link:

• WPFTS_Core::get_option()

• is_search()

• is_admin()

• in_the_loop()

• WPFTS_Result_Item::TitleLink()

• WPFTS_Core::ForceSmartExcerpts() (проверяется значение $wpfts_core->forced_se_query)

Как это использовать в разработке аддонов:

Разработчикам аддонов важно понимать, что WPFTS модифицирует ссылки на страницы в результатах поиска, если используются Smart Excerpts. Если ваш аддон также модифицирует ссылки на страницы, убедитесь, что ваша логика не конфликтует с WPFTS.

Дополнительные замечания:

• Smart Excerpts применяются к ссылкам на страницы только в результатах поиска.

• Фильтр page_link вызывается для каждой страницы, отображаемой на странице результатов поиска.

• WPFTS добавляет дополнительную проверку для совместимости с блочным редактором Gutenberg.