Хук post_link в WPFTS

Хук post_link в WordPress, аналогично post_type_link, является фильтром, позволяющим модифицировать постоянную ссылку на запись перед ее выводом. WPFTS использует этот хук для применения Smart Excerpts к ссылкам на записи, отображаемые в результатах поиска. Функционально он практически идентичен хукам post_type_link, page_link и attachment_link.

Что делает WPFTS при вызове post_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(), который возвращает модифицированную ссылку.

Важные функции, задействованные в обработке post_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 применяются к ссылкам на посты только в результатах поиска.

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

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