Темы (themes)

Эти маршруты позволяют получить данные (настройки) темы. Добавлено в WP 5.0.

Возможные маршруты (конечные точки маршрутов описаны ниже):

/wp/v2/themes

Класс контроллера: WP_REST_Themes_Controller{}

Схема ресурса

Схема показывает все поля, которые существуют для объекта: поля объекта которые вернет запрос.

Параметр	Контекст	Описание
stylesheet string readonly	any	Таблица стилей темы, однозначно определяющая тему.
template string readonly	any	Шаблон темы. Для дочерней темы это относится к родительской темы, иначе - совпадает с таблицей стиля темы.
author object readonly	any	Автор темы.
author_uri object readonly	any	Сайт автора темы.
description object readonly	any	Описание темы.
is_block_theme boolean readonly	any	Основана ли тема на блоках.
name object readonly	any	Название темы.
requires_php string readonly	any	Минимальная версия PHP, требуемая для работы темы.
requires_wp string readonly	any	Минимальная версия WordPress, требуемая для работы темы.
screenshot string readonly	any	URL скриншота темы.
tags object readonly	any	Метки для стилей и возможностей темы.
textdomain string readonly	any	Текстовый домен темы.
theme_supports object readonly	any	Возможности поддерживаемые этой темой.
theme_uri object readonly	any	URL страницы темы.
version string readonly	any	Текущая версия темы.
status string	any	Именованный статус для темы. Одно из: inactive, active

Описание маршрута

Запрос OPTIONS к маршруту вернет полное описание этого маршрута: эндпоинты их параметры, схему.

$ curl -X OPTIONS -i http://demo.wp-api.org/wp-json/wp/v2/themes

GitHub

{
    "namespace": "wp/v2",
    "methods": [
        "GET"
    ],
    "endpoints": [
        {
            "methods": [
                "GET"
            ],
            "args": {
                "context": {
                    "required": false,
                    "description": "Scope under which the request is made; determines fields present in response.",
                    "type": "string"
                },
                "page": {
                    "required": false,
                    "default": 1,
                    "description": "Current page of the collection.",
                    "type": "integer"
                },
                "per_page": {
                    "required": false,
                    "default": 10,
                    "description": "Maximum number of items to be returned in result set.",
                    "type": "integer"
                },
                "search": {
                    "required": false,
                    "description": "Limit results to those matching a string.",
                    "type": "string"
                },
                "status": {
                    "required": true,
                    "description": "Limit result set to themes assigned one or more statuses.",
                    "type": "array",
                    "items": {
                        "enum": [
                            "active"
                        ],
                        "type": "string"
                    }
                }
            }
        }
    ],
    "schema": {
        "$schema": "http://json-schema.org/draft-04/schema#",
        "title": "theme",
        "type": "object",
        "properties": {
            "theme_supports": {
                "description": "Features supported by this theme.",
                "type": "array",
                "readonly": true,
                "properties": {
                    "formats": {
                        "description": "Post formats supported.",
                        "type": "array",
                        "readonly": true
                    },
                    "post-thumbnails": {
                        "description": "Whether the theme supports post thumbnails.",
                        "type": [
                            "array",
                            "bool"
                        ],
                        "readonly": true
                    },
                    "responsive-embeds": {
                        "description": "Whether the theme supports responsive embedded content.",
                        "type": "bool",
                        "readonly": true
                    }
                }
            }
        }
    },
    "_links": {
        "self": "https://demo.wp-api.org/wp-json/wp/v2/themes"
    }
}

Получение настроек темы

Получает указанные настройки темы.

Вид запроса

Доступ: нужна авторизация

GET /wp-json/wp/v2/themes?status=active

Параметры запроса

"context": {
	"required": false,
	"description": "Scope under which the request is made; determines fields present in response.",
	"type": "string"
},
"page": {
	"required": false,
	"default": 1,
	"description": "Current page of the collection.",
	"type": "integer"
},
"per_page": {
	"required": false,
	"default": 10,
	"description": "Maximum number of items to be returned in result set.",
	"type": "integer"
},
"search": {
	"required": false,
	"description": "Limit results to those matching a string.",
	"type": "string"
},
"status": {
	"required": true,
	"description": "Limit result set to themes assigned one or more statuses.",
	"type": "array",
	"items": {
		"enum": [
			"active"
		],
		"type": "string"
	}
}

Пример запроса

$ curl http://example.com/wp-json/wp/v2/themes?status=active

Ответ:

[
	{
		"theme_supports": {
			"formats": [
				"standard",
				"aside",
				"image",
				"video",
				"quote",
				"link",
				"gallery",
				"status",
				"audio",
				"chat"
			],
			"post-thumbnails": true,
			"responsive-embeds": true
		}
	}
]