Функция rest_output_link_wp_head()
выводит ссылку на корневой REST API маршрут в секции <head>
на всех страницах сайта. Эта ссылка является уведомлением для клиентских приложений, что у сайта есть свой API.
rest_output_link_wp_head();
Параметры
Функция не принимает параметров.
Возвращаемое значение
Функция ничего не возвращает. Она добавляет ссылку в head
вашего сайта.
Добавление ссылки на REST API в head
По умолчанию функция rest_output_link_wp_head()
уже подключена к хуку wp_head
, что означает, что она автоматически добавляет ссылку на REST API в head
вашего сайта. Если по какой-то причине она была отключена, вы можете снова подключить ее следующим образом:
// Подключение функции rest_output_link_wp_head к хуку wp_head.
add_action( 'wp_head', 'rest_output_link_wp_head', 10, 0 );
Этот код добавит следующую строку в раздел head
вашего HTML-кода:
<link rel='https://api.w.org/' href='https://example.com/wp-json/' />
Удаление ссылки на REST API
Если вы хотите удалить ссылку на REST API из head
вашего сайта, вы можете сделать это следующим образом:
// Удаление функции rest_output_link_wp_head от хуку wp_head.
remove_action( 'wp_head', 'rest_output_link_wp_head' );
Этот код не отключает REST API, а лишь отменяет вывод ссылки на всех страницах сайта. Его можно вставить в файл functions.php
вашей темы или в плагин.
Добавление ссылки в заголовки ответа сервера
Аналогичная ссылка добавляется в заголовки ответа сервера функцией rest_output_link_header()
, которая по умолчанию подключена к хуку template_redirect
:
// Подключение функции rest_output_link_header к хуку template_redirect.
add_action( 'template_redirect', 'rest_output_link_header', 11, 0 );
Когда эта функция подключена, сервер будет отправлять заголовок HTTP, который выглядит следующим образом:
Link: <https://example.com/wp-json/>; rel="https://api.w.org/"
Заключение
Функция rest_output_link_wp_head()
автоматически добавляет ссылку на REST API в head
вашего сайта WordPress, что упрощает интеграцию и обнаружение REST API. Если по каким-то причинам эта функция была отключена, вы можете снова подключить ее с помощью хука wp_head
. Также вы можете отключить добавление ссылки, если это необходимо для вашего проекта.