mirror of
https://git.sindominio.net/estibadores/wordpress.git
synced 2024-11-14 23:21:07 +01:00
315 lines
9.9 KiB
PHP
315 lines
9.9 KiB
PHP
<?php
|
|
|
|
new WPCOM_JSON_API_Update_Taxonomy_Endpoint( array(
|
|
'description' => 'Create a new category.',
|
|
'group' => 'taxonomy',
|
|
'stat' => 'categories:new',
|
|
|
|
'method' => 'POST',
|
|
'path' => '/sites/%s/categories/new',
|
|
'path_labels' => array(
|
|
'$site' => '(int|string) Site ID or domain',
|
|
),
|
|
|
|
'request_format' => array(
|
|
'name' => '(string) Name of the category',
|
|
'description' => '(string) A description of the category',
|
|
'parent' => '(int) ID of the parent category',
|
|
),
|
|
|
|
'example_request' => 'https://public-api.wordpress.com/rest/v1/sites/82974409/categories/new/',
|
|
'example_request_data' => array(
|
|
'headers' => array(
|
|
'authorization' => 'Bearer YOUR_API_TOKEN'
|
|
),
|
|
'body' => array(
|
|
'name' => 'Puppies',
|
|
)
|
|
)
|
|
) );
|
|
|
|
new WPCOM_JSON_API_Update_Taxonomy_Endpoint( array(
|
|
'description' => 'Create a new tag.',
|
|
'group' => 'taxonomy',
|
|
'stat' => 'tags:new',
|
|
|
|
'method' => 'POST',
|
|
'path' => '/sites/%s/tags/new',
|
|
'path_labels' => array(
|
|
'$site' => '(int|string) Site ID or domain',
|
|
),
|
|
|
|
'request_format' => array(
|
|
'name' => '(string) Name of the tag',
|
|
'description' => '(string) A description of the tag',
|
|
),
|
|
|
|
'example_request' => 'https://public-api.wordpress.com/rest/v1/sites/82974409/tags/new/',
|
|
'example_request_data' => array(
|
|
'headers' => array(
|
|
'authorization' => 'Bearer YOUR_API_TOKEN'
|
|
),
|
|
'body' => array(
|
|
'name' => 'Kitties'
|
|
)
|
|
)
|
|
) );
|
|
|
|
new WPCOM_JSON_API_Update_Taxonomy_Endpoint( array(
|
|
'description' => 'Edit a tag.',
|
|
'group' => 'taxonomy',
|
|
'stat' => 'tags:1:POST',
|
|
|
|
'method' => 'POST',
|
|
'path' => '/sites/%s/tags/slug:%s',
|
|
'path_labels' => array(
|
|
'$site' => '(int|string) Site ID or domain',
|
|
'$tag' => '(string) The tag slug',
|
|
),
|
|
|
|
'request_format' => array(
|
|
'name' => '(string) Name of the tag',
|
|
'description' => '(string) A description of the tag',
|
|
),
|
|
|
|
'example_request' => 'https://public-api.wordpress.com/rest/v1/sites/82974409/tags/slug:testing-tag',
|
|
'example_request_data' => array(
|
|
'headers' => array(
|
|
'authorization' => 'Bearer YOUR_API_TOKEN'
|
|
),
|
|
'body' => array(
|
|
'description' => 'Kitties are awesome!'
|
|
)
|
|
)
|
|
) );
|
|
|
|
new WPCOM_JSON_API_Update_Taxonomy_Endpoint( array(
|
|
'description' => 'Edit a category.',
|
|
'group' => 'taxonomy',
|
|
'stat' => 'categories:1:POST',
|
|
|
|
'method' => 'POST',
|
|
'path' => '/sites/%s/categories/slug:%s',
|
|
'path_labels' => array(
|
|
'$site' => '(int|string) Site ID or domain',
|
|
'$category' => '(string) The category slug',
|
|
),
|
|
|
|
'request_format' => array(
|
|
'name' => '(string) Name of the category',
|
|
'description' => '(string) A description of the category',
|
|
'parent' => '(int) ID of the parent category',
|
|
),
|
|
|
|
'example_request' => 'https://public-api.wordpress.com/rest/v1/sites/82974409/categories/slug:testing-category',
|
|
'example_request_data' => array(
|
|
'headers' => array(
|
|
'authorization' => 'Bearer YOUR_API_TOKEN'
|
|
),
|
|
'body' => array(
|
|
'description' => 'Puppies are great!'
|
|
)
|
|
)
|
|
) );
|
|
|
|
new WPCOM_JSON_API_Update_Taxonomy_Endpoint( array(
|
|
'description' => 'Delete a category.',
|
|
'group' => 'taxonomy',
|
|
'stat' => 'categories:1:delete',
|
|
|
|
'method' => 'POST',
|
|
'path' => '/sites/%s/categories/slug:%s/delete',
|
|
'path_labels' => array(
|
|
'$site' => '(int|string) Site ID or domain',
|
|
'$category' => '(string) The category slug',
|
|
),
|
|
'response_format' => array(
|
|
'slug' => '(string) The slug of the deleted category',
|
|
'success' => '(bool) Was the operation successful?',
|
|
),
|
|
|
|
'example_request' => 'https://public-api.wordpress.com/rest/v1/sites/82974409/categories/slug:$category/delete',
|
|
'example_request_data' => array(
|
|
'headers' => array(
|
|
'authorization' => 'Bearer YOUR_API_TOKEN'
|
|
),
|
|
)
|
|
) );
|
|
|
|
new WPCOM_JSON_API_Update_Taxonomy_Endpoint( array(
|
|
'description' => 'Delete a tag.',
|
|
'group' => 'taxonomy',
|
|
'stat' => 'tags:1:delete',
|
|
|
|
'method' => 'POST',
|
|
'path' => '/sites/%s/tags/slug:%s/delete',
|
|
'path_labels' => array(
|
|
'$site' => '(int|string) Site ID or domain',
|
|
'$tag' => '(string) The tag slug',
|
|
),
|
|
'response_format' => array(
|
|
'slug' => '(string) The slug of the deleted tag',
|
|
'success' => '(bool) Was the operation successful?',
|
|
),
|
|
|
|
'example_request' => 'https://public-api.wordpress.com/rest/v1/sites/82974409/tags/slug:$tag/delete',
|
|
'example_request_data' => array(
|
|
'headers' => array(
|
|
'authorization' => 'Bearer YOUR_API_TOKEN'
|
|
),
|
|
)
|
|
) );
|
|
|
|
class WPCOM_JSON_API_Update_Taxonomy_Endpoint extends WPCOM_JSON_API_Taxonomy_Endpoint {
|
|
// /sites/%s/tags|categories/new -> $blog_id
|
|
// /sites/%s/tags|categories/slug:%s -> $blog_id, $taxonomy_id
|
|
// /sites/%s/tags|categories/slug:%s/delete -> $blog_id, $taxonomy_id
|
|
function callback( $path = '', $blog_id = 0, $object_id = 0 ) {
|
|
$blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) );
|
|
if ( is_wp_error( $blog_id ) ) {
|
|
return $blog_id;
|
|
}
|
|
|
|
if ( preg_match( '#/tags/#i', $path ) ) {
|
|
$taxonomy_type = "post_tag";
|
|
} else {
|
|
$taxonomy_type = "category";
|
|
}
|
|
|
|
if ( $this->api->ends_with( $path, '/delete' ) ) {
|
|
return $this->delete_taxonomy( $path, $blog_id, $object_id, $taxonomy_type );
|
|
} elseif ( $this->api->ends_with( $path, '/new' ) ) {
|
|
return $this->new_taxonomy( $path, $blog_id, $taxonomy_type );
|
|
}
|
|
|
|
return $this->update_taxonomy( $path, $blog_id, $object_id, $taxonomy_type );
|
|
}
|
|
|
|
// /sites/%s/tags|categories/new -> $blog_id
|
|
function new_taxonomy( $path, $blog_id, $taxonomy_type ) {
|
|
$args = $this->query_args();
|
|
$input = $this->input();
|
|
if ( !is_array( $input ) || !$input || !strlen( $input['name'] ) ) {
|
|
return new WP_Error( 'invalid_input', 'Unknown data passed', 400 );
|
|
}
|
|
|
|
$user = wp_get_current_user();
|
|
if ( !$user || is_wp_error( $user ) || !$user->ID ) {
|
|
return new WP_Error( 'authorization_required', 'An active access token must be used to manage taxonomies.', 403 );
|
|
}
|
|
|
|
$tax = get_taxonomy( $taxonomy_type );
|
|
if ( !current_user_can( $tax->cap->edit_terms ) ) {
|
|
return new WP_Error( 'unauthorized', 'User cannot edit taxonomy', 403 );
|
|
}
|
|
|
|
if ( 'category' !== $taxonomy_type || ! isset( $input['parent'] ) )
|
|
$input['parent'] = 0;
|
|
|
|
if ( $term = get_term_by( 'name', $input['name'], $taxonomy_type ) ) {
|
|
// the same name is allowed as long as the parents are different
|
|
if ( $input['parent'] === $term->parent ) {
|
|
return new WP_Error( 'duplicate', 'A taxonomy with that name already exists', 400 );
|
|
}
|
|
}
|
|
|
|
$data = wp_insert_term( addslashes( $input['name'] ), $taxonomy_type,
|
|
array(
|
|
'description' => isset( $input['description'] ) ? addslashes( $input['description'] ) : '',
|
|
'parent' => $input['parent']
|
|
)
|
|
);
|
|
|
|
if ( is_wp_error( $data ) )
|
|
return $data;
|
|
|
|
$taxonomy = get_term_by( 'id', $data['term_id'], $taxonomy_type );
|
|
|
|
$return = $this->get_taxonomy( $taxonomy->slug, $taxonomy_type, $args['context'] );
|
|
if ( !$return || is_wp_error( $return ) ) {
|
|
return $return;
|
|
}
|
|
|
|
/** This action is documented in json-endpoints/class.wpcom-json-api-site-settings-endpoint.php */
|
|
do_action( 'wpcom_json_api_objects', 'taxonomies' );
|
|
return $return;
|
|
}
|
|
|
|
// /sites/%s/tags|categories/slug:%s -> $blog_id, $taxonomy_id
|
|
function update_taxonomy( $path, $blog_id, $object_id, $taxonomy_type ) {
|
|
$taxonomy = get_term_by( 'slug', $object_id, $taxonomy_type );
|
|
$tax = get_taxonomy( $taxonomy_type );
|
|
if ( !current_user_can( $tax->cap->edit_terms ) )
|
|
return new WP_Error( 'unauthorized', 'User cannot edit taxonomy', 403 );
|
|
|
|
if ( !$taxonomy || is_wp_error( $taxonomy ) ) {
|
|
return new WP_Error( 'unknown_taxonomy', 'Unknown taxonomy', 404 );
|
|
}
|
|
|
|
if ( false === term_exists( $object_id, $taxonomy_type ) ) {
|
|
return new WP_Error( 'unknown_taxonomy', 'That taxonomy does not exist', 404 );
|
|
}
|
|
|
|
$args = $this->query_args();
|
|
$input = $this->input( false );
|
|
if ( !is_array( $input ) || !$input ) {
|
|
return new WP_Error( 'invalid_input', 'Invalid request input', 400 );
|
|
}
|
|
|
|
$update = array();
|
|
if ( 'category' === $taxonomy_type && !empty( $input['parent'] ) )
|
|
$update['parent'] = $input['parent'];
|
|
|
|
if ( !empty( $input['description'] ) )
|
|
$update['description'] = addslashes( $input['description'] );
|
|
|
|
if ( !empty( $input['name'] ) )
|
|
$update['name'] = addslashes( $input['name'] );
|
|
|
|
|
|
$data = wp_update_term( $taxonomy->term_id, $taxonomy_type, $update );
|
|
$taxonomy = get_term_by( 'id', $data['term_id'], $taxonomy_type );
|
|
|
|
$return = $this->get_taxonomy( $taxonomy->slug, $taxonomy_type, $args['context'] );
|
|
if ( !$return || is_wp_error( $return ) ) {
|
|
return $return;
|
|
}
|
|
|
|
/** This action is documented in json-endpoints/class.wpcom-json-api-site-settings-endpoint.php */
|
|
do_action( 'wpcom_json_api_objects', 'taxonomies' );
|
|
return $return;
|
|
}
|
|
|
|
// /sites/%s/tags|categories/%s/delete -> $blog_id, $taxonomy_id
|
|
function delete_taxonomy( $path, $blog_id, $object_id, $taxonomy_type ) {
|
|
$taxonomy = get_term_by( 'slug', $object_id, $taxonomy_type );
|
|
$tax = get_taxonomy( $taxonomy_type );
|
|
if ( !current_user_can( $tax->cap->delete_terms ) )
|
|
return new WP_Error( 'unauthorized', 'User cannot edit taxonomy', 403 );
|
|
|
|
if ( !$taxonomy || is_wp_error( $taxonomy ) ) {
|
|
return new WP_Error( 'unknown_taxonomy', 'Unknown taxonomy', 404 );
|
|
}
|
|
|
|
if ( false === term_exists( $object_id, $taxonomy_type ) ) {
|
|
return new WP_Error( 'unknown_taxonomy', 'That taxonomy does not exist', 404 );
|
|
}
|
|
|
|
$args = $this->query_args();
|
|
$return = $this->get_taxonomy( $taxonomy->slug, $taxonomy_type, $args['context'] );
|
|
if ( !$return || is_wp_error( $return ) ) {
|
|
return $return;
|
|
}
|
|
|
|
/** This action is documented in json-endpoints/class.wpcom-json-api-site-settings-endpoint.php */
|
|
do_action( 'wpcom_json_api_objects', 'taxonomies' );
|
|
|
|
wp_delete_term( $taxonomy->term_id, $taxonomy_type );
|
|
|
|
return array(
|
|
'slug' => (string) $taxonomy->slug,
|
|
'success' => 'true',
|
|
);
|
|
}
|
|
}
|