rest_prepare_taxonomy хук-фильтр . WP 4.7.0

Позволяет изменять данные таксономии при REST запросе непосредственно перед их возвращением.

Использование

add_filter( 'rest_prepare_taxonomy', 'filter_function_name_1746', 10, 3 );
function filter_function_name_1746( $response, $taxonomy, $request ){
	// Изменяем...

	return $response;
}

$response(WP_REST_Response)

Объект ответа (WP_REST_Response).

$item(WP_Taxonomy)

Объект таксономии (WP_Taxonomy).

$request(WP_REST_Request)

Запрос, используемый для генерации ответа (WP_REST_Request).

Примеры

#1 Добавим в ответ REST API свойство labels таксономии category

add_filter( 'rest_prepare_taxonomy', 'filter_rest_prepare_taxonomy', 10, 3 );

/**
 * Добавляет в ответ REST API свойство labels таксономии category.
 *
 * @param WP_REST_Response $response The response object.
 * @param WP_Taxonomy      $taxonomy The original taxonomy object.
 * @param WP_REST_Request  $request  Request used to generate the response.
 *
 * @return WP_REST_Response
 */
function filter_rest_prepare_taxonomy( $response, $taxonomy, $request ) {
	if ( 'category' === $taxonomy->name ) {
		$response->data['labels'] = $taxonomy->labels;
	}

	return $response;
}

Теперь при обращение по адресу домен/wp-json/wp/v2/taxonomies/category получим json:

{
	"name": "Рубрики",
	"slug": "category",
	"description": "",
	"types": [
		"post"
	],
	"hierarchical": true,
	"rest_base": "categories",
	"labels": {
		"name": "Рубрики",
		"singular_name": "Рубрика",
		"search_items": "Поиск рубрик",
		"popular_items": null,
		"all_items": "Все рубрики",
		"parent_item": "Родительская рубрика",
		"parent_item_colon": "Родительская рубрика:",
		"edit_item": "Изменить рубрику",
		"view_item": "Просмотреть рубрику",
		"update_item": "Обновить рубрику",
		"add_new_item": "Добавить новую рубрику",
		"new_item_name": "Название новой рубрики",
		"separate_items_with_commas": null,
		"add_or_remove_items": null,
		"choose_from_most_used": null,
		"not_found": "Рубрик не найдено.",
		"no_terms": "Рубрик нет",
		"filter_by_item": "Фильтр по рубрике",
		"items_list_navigation": "Навигация по списку рубрик",
		"items_list": "Список рубрик",
		"most_used": "Часто используемые",
		"back_to_items": "← Перейти к рубрикам",
		"menu_name": "Рубрики",
		"name_admin_bar": "category"
	},
	"_links": {
		"collection": [
			{
				"href": "https://wp-test.ru/wp-json/wp/v2/taxonomies"
			}
		],
		"wp:items": [
			{
				"href": "https://wp-test.ru/wp-json/wp/v2/categories"
			}
		],
		"curies": [
			{
				"name": "wp",
				"href": "https://api.w.org/{rel}",
				"templated": true
			}
		]
	}
}

Список изменений

Где вызывается хук

rest_prepare_taxonomy

Где используется хук в ядре WordPress

Использование не найдено.

Читать полностью wp-kama.ru