AccommodationTypeCategoriesController extends AbstractRestTermsController
in package

Table of Contents

$namespace  : string
Endpoint namespace.
$rest_base  : string
Route base.
$taxonomy  : string
Term name.
batch_items()  : array<string|int, mixed>
Bulk create, update and delete items.
batch_items_permissions_check()  : bool|WP_Error
Check if a given request has access batch create, update and delete items.
create_item()  : WP_REST_Request|WP_Error
Create a single term for a taxonomy.
create_item_permissions_check()  : WP_Error|bool
Check if a given request has access to create a term.
delete_item()  : WP_REST_Response|WP_Error
Delete a single term from a taxonomy.
delete_item_permissions_check()  : WP_Error|bool
Check if a given request has access to delete a term.
get_collection_params()  : array<string|int, mixed>
Get the query params for collections
get_endpoint_args_for_item_schema()  : array<string|int, mixed>
Compatibility functions for WP 5.5, since custom types are not supported anymore.
get_item()  : WP_REST_Request|WP_Error
Get a single term from a taxonomy.
get_item_permissions_check()  : WP_Error|bool
Check if a given request has access to read a term.
get_item_schema()  : array<string|int, mixed>
Get a schema that matches the JSON schema.
get_items()  : WP_REST_Response|WP_Error
Get terms associated with a taxonomy.
get_items_permissions_check()  : WP_Error|bool
Check if a given request has access to read the terms.
get_public_batch_schema()  : array<string|int, mixed>
Get the batch schema, conforming to JSON Schema.
prepare_item_for_response()  : WP_REST_Response
Prepare a single taxonomy output for response.
register_routes()  : mixed
Register the routes for terms.
update_item()  : WP_REST_Request|WP_Error
Update a single term from a taxonomy.
update_item_permissions_check()  : WP_Error|bool
Check if a given request has access to update a term.
validate_setting_checkbox_field()  : string|WP_Error
Validate checkbox based settings.
validate_setting_image_width_field()  : string|WP_Error
Validate image_width based settings.
validate_setting_multiselect_field()  : array<string|int, mixed>|WP_Error
Validate multiselect based settings.
validate_setting_radio_field()  : string|WP_Error
Validate radio based settings.
validate_setting_select_field()  : string|WP_Error
Validate select based settings.
validate_setting_text_field()  : string
Validate a text value for a text based setting.
validate_setting_textarea_field()  : string
Validate textarea based settings.
add_additional_fields_schema()  : array<string|int, mixed>
Add the schema from additional fields to an schema array.
add_meta_query()  : array<string|int, mixed>
Add meta query.
adjust_wp_5_5_datatype_compatibility()  : mixed
Change datatypes `date-time` to string, and `mixed` to composite of all built in types. This is required for maintaining forward compatibility with WP 5.5 since custom post types are not supported anymore.
check_batch_limit()  : bool|WP_Error
Check batch limit.
check_permissions()  : bool|WP_Error
Check permissions.
get_normalized_rest_base()  : string
Get normalized rest base.
prepare_links()  : array<string|int, mixed>
Prepare links for the request.
update_term_meta_fields()  : bool|WP_Error
Update term meta fields.

Properties

$namespace

Endpoint namespace.

protected string $namespace = 'mphb/v1'

$rest_base

Route base.

protected string $rest_base = 'accommodation_types/categories'

$taxonomy

Term name.

protected string $taxonomy = 'mphb_room_type_category'

Methods

batch_items()

Bulk create, update and delete items.

public batch_items(WP_REST_Request $request) : array<string|int, mixed>
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
array<string|int, mixed>

Of WP_Error or WP_REST_Response.

batch_items_permissions_check()

Check if a given request has access batch create, update and delete items.

public batch_items_permissions_check(WP_REST_Request $request) : bool|WP_Error
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
bool|WP_Error

create_item()

Create a single term for a taxonomy.

public create_item(WP_REST_Request $request) : WP_REST_Request|WP_Error
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_REST_Request|WP_Error

create_item_permissions_check()

Check if a given request has access to create a term.

public create_item_permissions_check(WP_REST_Request $request) : WP_Error|bool
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_Error|bool

delete_item()

Delete a single term from a taxonomy.

public delete_item(WP_REST_Request $request) : WP_REST_Response|WP_Error
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_REST_Response|WP_Error

delete_item_permissions_check()

Check if a given request has access to delete a term.

public delete_item_permissions_check(WP_REST_Request $request) : WP_Error|bool
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_Error|bool

get_collection_params()

Get the query params for collections

public get_collection_params() : array<string|int, mixed>
Return values
array<string|int, mixed>

get_endpoint_args_for_item_schema()

Compatibility functions for WP 5.5, since custom types are not supported anymore.

public get_endpoint_args_for_item_schema([string $method = WP_REST_Server::CREATABLE ]) : array<string|int, mixed>

See @link https://core.trac.wordpress.org/changeset/48306

Parameters
$method : string = WP_REST_Server::CREATABLE

Optional. HTTP method of the request.

Return values
array<string|int, mixed>

Endpoint arguments.

get_item()

Get a single term from a taxonomy.

public get_item(WP_REST_Request $request) : WP_REST_Request|WP_Error
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_REST_Request|WP_Error

get_item_permissions_check()

Check if a given request has access to read a term.

public get_item_permissions_check(WP_REST_Request $request) : WP_Error|bool
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_Error|bool

get_item_schema()

Get a schema that matches the JSON schema.

public get_item_schema() : array<string|int, mixed>
Return values
array<string|int, mixed>

get_items()

Get terms associated with a taxonomy.

public get_items(WP_REST_Request $request) : WP_REST_Response|WP_Error
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_REST_Response|WP_Error

get_items_permissions_check()

Check if a given request has access to read the terms.

public get_items_permissions_check(WP_REST_Request $request) : WP_Error|bool
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_Error|bool

get_public_batch_schema()

Get the batch schema, conforming to JSON Schema.

public get_public_batch_schema() : array<string|int, mixed>
Return values
array<string|int, mixed>

prepare_item_for_response()

Prepare a single taxonomy output for response.

public prepare_item_for_response(WP_Term $item, WP_REST_Request $request) : WP_REST_Response
Parameters
$item : WP_Term

Term object.

$request : WP_REST_Request

Request instance.

Return values
WP_REST_Response

register_routes()

Register the routes for terms.

public register_routes() : mixed
Return values
mixed

update_item()

Update a single term from a taxonomy.

public update_item(WP_REST_Request $request) : WP_REST_Request|WP_Error
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_REST_Request|WP_Error

update_item_permissions_check()

Check if a given request has access to update a term.

public update_item_permissions_check(WP_REST_Request $request) : WP_Error|bool
Parameters
$request : WP_REST_Request

Full details about the request.

Return values
WP_Error|bool

validate_setting_checkbox_field()

Validate checkbox based settings.

public validate_setting_checkbox_field(string $value, array<string|int, mixed> $setting) : string|WP_Error
Parameters
$value : string

Value.

$setting : array<string|int, mixed>

Setting.

Return values
string|WP_Error

validate_setting_image_width_field()

Validate image_width based settings.

public validate_setting_image_width_field(array<string|int, mixed> $values, array<string|int, mixed> $setting) : string|WP_Error
Parameters
$values : array<string|int, mixed>

Values.

$setting : array<string|int, mixed>

Setting.

Return values
string|WP_Error

validate_setting_multiselect_field()

Validate multiselect based settings.

public validate_setting_multiselect_field(array<string|int, mixed> $values, array<string|int, mixed> $setting) : array<string|int, mixed>|WP_Error
Parameters
$values : array<string|int, mixed>

Values.

$setting : array<string|int, mixed>

Setting.

Return values
array<string|int, mixed>|WP_Error

validate_setting_radio_field()

Validate radio based settings.

public validate_setting_radio_field(string $value, array<string|int, mixed> $setting) : string|WP_Error
Parameters
$value : string

Value.

$setting : array<string|int, mixed>

Setting.

Return values
string|WP_Error

validate_setting_select_field()

Validate select based settings.

public validate_setting_select_field(string $value, array<string|int, mixed> $setting) : string|WP_Error
Parameters
$value : string

Value.

$setting : array<string|int, mixed>

Setting.

Return values
string|WP_Error

validate_setting_text_field()

Validate a text value for a text based setting.

public validate_setting_text_field(string $value, array<string|int, mixed> $setting) : string
Parameters
$value : string

Value.

$setting : array<string|int, mixed>

Setting.

Return values
string

validate_setting_textarea_field()

Validate textarea based settings.

public validate_setting_textarea_field(string $value, array<string|int, mixed> $setting) : string
Parameters
$value : string

Value.

$setting : array<string|int, mixed>

Setting.

Return values
string

add_additional_fields_schema()

Add the schema from additional fields to an schema array.

protected add_additional_fields_schema(array<string|int, mixed> $schema) : array<string|int, mixed>

The type of object is inferred from the passed schema.

Parameters
$schema : array<string|int, mixed>

Schema array.

Return values
array<string|int, mixed>

add_meta_query()

Add meta query.

protected add_meta_query(array<string|int, mixed> $args, array<string|int, mixed> $meta_query) : array<string|int, mixed>
Parameters
$args : array<string|int, mixed>

Query args.

$meta_query : array<string|int, mixed>

Meta query.

Return values
array<string|int, mixed>

adjust_wp_5_5_datatype_compatibility()

Change datatypes `date-time` to string, and `mixed` to composite of all built in types. This is required for maintaining forward compatibility with WP 5.5 since custom post types are not supported anymore.

protected adjust_wp_5_5_datatype_compatibility(array<string|int, mixed> $endpoint_args) : mixed

See @link https://core.trac.wordpress.org/changeset/48306

We still use the 'mixed' type, since if we convert to composite type everywhere, it won't work in 5.4 anymore because they require to define the full schema.

Parameters
$endpoint_args : array<string|int, mixed>

Schema with datatypes to convert.

Return values
mixed

Schema with converted datatype.

check_batch_limit()

Check batch limit.

protected check_batch_limit(array<string|int, mixed> $items) : bool|WP_Error
Parameters
$items : array<string|int, mixed>

Request items.

Return values
bool|WP_Error

check_permissions()

Check permissions.

protected check_permissions(WP_REST_Request $request[, string $context = 'read' ]) : bool|WP_Error
Parameters
$request : WP_REST_Request

Full details about the request.

$context : string = 'read'

Request context.

Return values
bool|WP_Error

get_normalized_rest_base()

Get normalized rest base.

protected get_normalized_rest_base() : string
Return values
string

Prepare links for the request.

protected prepare_links(object $term, WP_REST_Request $request) : array<string|int, mixed>
Parameters
$term : object

Term object.

$request : WP_REST_Request

Full details about the request.

Return values
array<string|int, mixed>

Links for the given term.

update_term_meta_fields()

Update term meta fields.

protected update_term_meta_fields(WP_Term $term, WP_REST_Request $request) : bool|WP_Error
Parameters
$term : WP_Term

Term object.

$request : WP_REST_Request

Full details about the request.

Return values
bool|WP_Error

Search results