unction get_item_permissions_check( $request ) { $tax_obj = get_taxonomy( $request['taxonomy'] ); if ( $tax_obj ) { if ( empty( $tax_obj->show_in_rest ) ) { return false; } if ( 'edit' === $request['context'] && ! current_user_can( $tax_obj->cap->assign_terms ) ) { return new WP_Error( 'rest_forbidden_context', __( 'Sorry, you are not allowed to manage terms in this taxonomy.' ), array( 'status' => rest_authorization_required_code() ) ); } } return true; } /** * Retrieves a specific taxonomy. * * @since 4.7.0 * * @param WP_REST_Request $request Full details about the request. * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure. */ public function get_item( $request ) { $tax_obj = get_taxonomy( $request['taxonomy'] ); if ( empty( $tax_obj ) ) { return new WP_Error( 'rest_taxonomy_invalid', __( 'Invalid taxonomy.' ), array( 'status' => 404 ) ); } $data = $this->prepare_item_for_response( $tax_obj, $request ); return rest_ensure_response( $data ); } /** * Prepares a taxonomy object for serialization. * * @since 4.7.0 * @since 5.9.0 Renamed `$taxonomy` to `$item` to match parent class for PHP 8 named parameter support. * * @param WP_Taxonomy $item Taxonomy data. * @param WP_REST_Request $request Full details about the request. * @return WP_REST_Response Response object. */ public function prepare_item_for_response( $item, $request ) { // Restores the more descriptive, specific name for use within this method. $taxonomy = $item; $base = ! empty( $taxonomy->rest_base ) ? $taxonomy->rest_base : $taxonomy->name; $fields = $this->get_fields_for_response( $request ); $data = array(); if ( in_array( 'name', $fields, true ) ) { $data['name'] = $taxonomy->label; } if ( in_array( 'slug', $fields, true ) ) { $data['slug'] = $taxonomy->name; } if ( in_array( 'capabilities', $fields, true ) ) { $data['capabilities'] = $taxonomy->cap; } if ( in_array( 'description', $fields, true ) ) { $data['description'] = $taxonomy->description; } if ( in_array( 'labels', $fields, true ) ) { $data['labels'] = $taxonomy->labels; } if ( in_array( 'types', $fields, true ) ) { $data['types'] = array_values( $taxonomy->object_type ); } if ( in_array( 'show_cloud', $fields, true ) ) { $data['show_cloud'] = $taxonomy->show_tagcloud; } if ( in_array( 'hierarchical', $fields, true ) ) { $data['hierarchical'] = $taxonomy->hierarchical; } if ( in_array( 'rest_base', $fields, true ) ) { $data['rest_base'] = $base; } if ( in_array( 'rest_namespace', $fields, true ) ) { $data['rest_namespace'] = $taxonomy->rest_namespace; } if ( in_array( 'visibility', $fields, true ) ) { $data['visibility'] = array( 'public' => (bool) $taxonomy->public, 'publicly_queryable' => (bool) $taxonomy->publicly_queryable, 'show_admin_column' => (bool) $taxonomy->show_admin_column, 'show_in_nav_menus' => (bool) $taxonomy->show_in_nav_menus, 'show_in_quick_edit' => (bool) $taxonomy->show_in_quick_edit, 'show_ui' => (bool) $taxonomy->show_ui, ); } $context = ! empty( $request['context'] ) ? $request['context'] : 'view'; $data = $this->add_additional_fields_to_object( $data, $request ); $data = $this->filter_response_by_context( $data, $context ); // Wrap the data in a response object. $response = rest_ensure_response( $data ); if ( rest_is_field_included( '_links', $fields ) || rest_is_field_included( '_embedded', $fields ) ) { $response->add_links( $this->prepare_links( $taxonomy ) ); } /** * Filters a taxonomy returned from the REST API. * * Allows modification of the taxonomy data right before it is returned. * * @since 4.7.0 * * @param WP_REST_Response $response The response object. * @param WP_Taxonomy $item The original taxonomy object. * @param WP_REST_Request $request Request used to generate the response. */ return apply_filters( 'rest_prepare_taxonomy', $response, $taxonomy, $request ); } /** * Prepares links for the request. * * @since 6.1.0 * * @param WP_Taxonomy $taxonomy The taxonomy. * @return array Links for the given taxonomy. */ protected function prepare_links( $taxonomy ) { return array( 'collection' => array( 'href' => rest_url( sprintf( '%s/%s', $this->namespace, $this->rest_base ) ), ), 'https://api.w.org/items' => array( 'href' => rest_url( rest_get_route_for_taxonomy_items( $taxonomy->name ) ), ), ); } /** * Retrieves the taxonomy's schema, conforming to JSON Schema. * * @since 4.7.0 * @since 5.0.0 The `visibility` property was added. * @since 5.9.0 The `rest_namespace` property was added. * * @return array Item schema data. */ public function get_item_schema() { if ( $this->schema ) { return $this->add_additional_fields_schema( $this->schema ); } $schema = array( '$schema' => 'http://json-schema.org/draft-04/schema#', 'title' => 'taxonomy', 'type' => 'object', 'properties' => array( 'capabilities' => array( 'description' => __( 'All capabilities used by the taxonomy.' ), 'type' => 'object', 'context' => array( 'edit' ), 'readonly' => true, ), 'description' => array( 'description' => __( 'A human-readable description of the taxonomy.' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'hierarchical' => array( 'description' => __( 'Whether or not the taxonomy should have children.' ), 'type' => 'boolean', 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'labels' => array( 'description' => __( 'Human-readable labels for the taxonomy for various contexts.' ), 'type' => 'object', 'context' => array( 'edit' ), 'readonly' => true, ), 'name' => array( 'description' => __( 'The title for the taxonomy.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'slug' => array( 'description' => __( 'An alphanumeric identifier for the taxonomy.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'show_cloud' => array( 'description' => __( 'Whether or not the term cloud should be displayed.' ), 'type' => 'boolean', 'context' => array( 'edit' ), 'readonly' => true, ), 'types' => array( 'description' => __( 'Types associated with the taxonomy.' ), 'type' => 'array', 'items' => array( 'type' => 'string', ), 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'rest_base' => array( 'description' => __( 'REST base route for the taxonomy.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'rest_namespace' => array( 'description' => __( 'REST namespace route for the taxonomy.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'visibility' => array( 'description' => __( 'The visibility settings for the taxonomy.' ), 'type' => 'object', 'context' => array( 'edit' ), 'readonly' => true, 'properties' => array( 'public' => array( 'description' => __( 'Whether a taxonomy is intended for use publicly either via the admin interface or by front-end users.' ), 'type' => 'boolean', ), 'publicly_queryable' => array( 'description' => __( 'Whether the taxonomy is publicly queryable.' ), 'type' => 'boolean', ), 'show_ui' => array( 'description' => __( 'Whether to generate a default UI for managing this taxonomy.' ), 'type' => 'boolean', ), 'show_admin_column' => array( 'description' => __( 'Whether to allow automatic creation of taxonomy columns on associated post-types table.' ), 'type' => 'boolean', ), 'show_in_nav_menus' => array( 'description' => __( 'Whether to make the taxonomy available for selection in navigation menus.' ), 'type' => 'boolean', ), 'show_in_quick_edit' => array( 'description' => __( 'Whether to show the taxonomy in the quick/bulk edit panel.' ), 'type' => 'boolean', ), ), ), ), ); $this->schema = $schema; return $this->add_additional_fields_schema( $this->schema ); } /** * Retrieves the query params for collections. * * @since 4.7.0 * * @return array Collection parameters. */ public function get_collection_params() { $new_params = array(); $new_params['context'] = $this->get_context_param( array( 'default' => 'view' ) ); $new_params['type'] = array( 'description' => __( 'Limit results to taxonomies associated with a specific post type.' ), 'type' => 'string', ); return $new_params; } } = AMP_Theme_Support::STANDARD_MODE_SLUG; $options[ Option::ALL_TEMPLATES_SUPPORTED ] = true; return $options; }; foreach ( $filtered_hooks as $filter_hook ) { add_filter( $filter_hook, $options_filter ); } } $urls = array_filter( $this->scannable_url_provider->get_urls(), static function ( $item ) { return is_array( $item ) && isset( $item['url'] ); } ); if ( $options_filter ) { foreach ( $filtered_hooks as $filter_hook ) { remove_filter( $filter_hook, $options_filter ); } } return rest_ensure_response( array_map( function ( $item ) use ( $request ) { return $this->prepare_item_for_response( $item, $request )->get_data(); }, $urls ) ); } /** * Prepares the scannable URL entry for the REST response. * * @param array $item Scannable URL entry. * @param WP_REST_Request $request Request object. * @return WP_REST_Response Response object on success, or WP_Error object on failure. */ public function prepare_item_for_response( $item, $request ) { $item = wp_array_slice_assoc( $item, [ 'url', 'type', 'label' ] ); if ( amp_is_canonical() ) { $item['amp_url'] = $item['url']; } else { $item['amp_url'] = $this->paired_routing->add_endpoint( $item['url'] ); } $validated_url_post = AMP_Validated_URL_Post_Type::get_invalid_url_post( $item['url'] ); if ( $validated_url_post instanceof WP_Post ) { $item['validation_errors'] = []; $data = json_decode( $validated_url_post->post_content, true ); if ( is_array( $data ) ) { $item['validation_errors'] = wp_list_pluck( $data, 'data' ); } $item['validated_url_post'] = [ 'id' => $validated_url_post->ID, 'edit_link' => get_edit_post_link( $validated_url_post->ID, 'raw' ), ]; $item['stale'] = ( count( AMP_Validated_URL_Post_Type::get_post_staleness( $validated_url_post ) ) > 0 ); } else { $item['validation_errors'] = null; $item['validated_url_post'] = null; $item['stale'] = null; } return rest_ensure_response( $item ); } /** * Retrieves the block type' schema, conforming to JSON Schema. * * @return array Item schema data. */ public function get_item_schema() { return [ '$schema' => 'http://json-schema.org/draft-04/schema#', 'title' => 'amp-wp-' . $this->rest_base, 'type' => 'object', 'properties' => [ 'url' => [ 'description' => __( 'URL', 'amp' ), 'type' => 'string', 'format' => 'uri', 'readonly' => true, 'context' => [ 'view' ], ], 'amp_url' => [ 'description' => __( 'AMP URL', 'amp' ), 'type' => 'string', 'format' => 'uri', 'readonly' => true, 'context' => [ 'view' ], ], 'type' => [ 'description' => __( 'Type', 'amp' ), 'type' => 'string', 'readonly' => true, 'context' => [ 'view' ], ], 'label' => [ 'description' => __( 'Label', 'amp' ), 'type' => 'string', 'readonly' => true, 'context' => [ 'view' ], ], 'validated_url_post' => [ 'description' => __( 'Validated URL post if previously scanned.', 'amp' ), 'type' => [ 'object', 'null' ], 'properties' => [ 'id' => [ 'type' => 'integer', ], 'edit_link' => [ 'type' => 'string', 'format' => 'uri', ], ], 'readonly' => true, 'context' => [ 'view' ], ], 'validation_errors' => [ 'description' => __( 'Validation errors for validated URL if previously scanned.', 'amp' ), 'type' => [ 'array', 'null' ], 'readonly' => true, 'context' => [ 'view' ], ], 'stale' => [ 'description' => __( 'Whether the Validated URL post is stale.', 'amp' ), 'type' => [ 'boolean', 'null' ], 'readonly' => true, 'context' => [ 'view' ], ], ], ]; } } = AMP_Theme_Support::STANDARD_MODE_SLUG; $options[ Option::ALL_TEMPLATES_SUPPORTED ] = true; return $options; }; foreach ( $filtered_hooks as $filter_hook ) { add_filter( $filter_hook, $options_filter ); } } $urls = array_filter( $this->scannable_url_provider->get_urls(), static function ( $item ) { return is_array( $item ) && isset( $item['url'] ); } ); if ( $options_filter ) { foreach ( $filtered_hooks as $filter_hook ) { remove_filter( $filter_hook, $options_filter ); } } return rest_ensure_response( array_map( function ( $item ) use ( $request ) { return $this->prepare_item_for_response( $item, $request )->get_data(); }, $urls ) ); } /** * Prepares the scannable URL entry for the REST response. * * @param array $item Scannable URL entry. * @param WP_REST_Request $request Request object. * @return WP_REST_Response Response object on success, or WP_Error object on failure. */ public function prepare_item_for_response( $item, $request ) { $item = wp_array_slice_assoc( $item, [ 'url', 'type', 'label' ] ); if ( amp_is_canonical() ) { $item['amp_url'] = $item['url']; } else { $item['amp_url'] = $this->paired_routing->add_endpoint( $item['url'] ); } $validated_url_post = AMP_Validated_URL_Post_Type::get_invalid_url_post( $item['url'] ); if ( $validated_url_post instanceof WP_Post ) { $item['validation_errors'] = []; $data = json_decode( $validated_url_post->post_content, true ); if ( is_array( $data ) ) { $item['validation_errors'] = wp_list_pluck( $data, 'data' ); } $item['validated_url_post'] = [ 'id' => $validated_url_post->ID, 'edit_link' => get_edit_post_link( $validated_url_post->ID, 'raw' ), ]; $item['stale'] = ( count( AMP_Validated_URL_Post_Type::get_post_staleness( $validated_url_post ) ) > 0 ); } else { $item['validation_errors'] = null; $item['validated_url_post'] = null; $item['stale'] = null; } return rest_ensure_response( $item ); } /** * Retrieves the block type' schema, conforming to JSON Schema. * * @return array Item schema data. */ public function get_item_schema() { return [ '$schema' => 'http://json-schema.org/draft-04/schema#', 'title' => 'amp-wp-' . $this->rest_base, 'type' => 'object', 'properties' => [ 'url' => [ 'description' => __( 'URL', 'amp' ), 'type' => 'string', 'format' => 'uri', 'readonly' => true, 'context' => [ 'view' ], ], 'amp_url' => [ 'description' => __( 'AMP URL', 'amp' ), 'type' => 'string', 'format' => 'uri', 'readonly' => true, 'context' => [ 'view' ], ], 'type' => [ 'description' => __( 'Type', 'amp' ), 'type' => 'string', 'readonly' => true, 'context' => [ 'view' ], ], 'label' => [ 'description' => __( 'Label', 'amp' ), 'type' => 'string', 'readonly' => true, 'context' => [ 'view' ], ], 'validated_url_post' => [ 'description' => __( 'Validated URL post if previously scanned.', 'amp' ), 'type' => [ 'object', 'null' ], 'properties' => [ 'id' => [ 'type' => 'integer', ], 'edit_link' => [ 'type' => 'string', 'format' => 'uri', ], ], 'readonly' => true, 'context' => [ 'view' ], ], 'validation_errors' => [ 'description' => __( 'Validation errors for validated URL if previously scanned.', 'amp' ), 'type' => [ 'array', 'null' ], 'readonly' => true, 'context' => [ 'view' ], ], 'stale' => [ 'description' => __( 'Whether the Validated URL post is stale.', 'amp' ), 'type' => [ 'boolean', 'null' ], 'readonly' => true, 'context' => [ 'view' ], ], ], ]; } } = AMP_Theme_Support::STANDARD_MODE_SLUG; $options[ Option::ALL_TEMPLATES_SUPPORTED ] = true; return $options; }; foreach ( $filtered_hooks as $filter_hook ) { add_filter( $filter_hook, $options_filter ); } } $urls = array_filter( $this->scannable_url_provider->get_urls(), static function ( $item ) { return is_array( $item ) && isset( $item['url'] ); } ); if ( $options_filter ) { foreach ( $filtered_hooks as $filter_hook ) { remove_filter( $filter_hook, $options_filter ); } } return rest_ensure_response( array_map( function ( $item ) use ( $request ) { return $this->prepare_item_for_response( $item, $request )->get_data(); }, $urls ) ); } /** * Prepares the scannable URL entry for the REST response. * * @param array $item Scannable URL entry. * @param WP_REST_Request $request Request object. * @return WP_REST_Response Response object on success, or WP_Error object on failure. */ public function prepare_item_for_response( $item, $request ) { $item = wp_array_slice_assoc( $item, [ 'url', 'type', 'label' ] ); if ( amp_is_canonical() ) { $item['amp_url'] = $item['url']; } else { $item['amp_url'] = $this->paired_routing->add_endpoint( $item['url'] ); } $validated_url_post = AMP_Validated_URL_Post_Type::get_invalid_url_post( $item['url'] ); if ( $validated_url_post instanceof WP_Post ) { $item['validation_errors'] = []; $data = json_decode( $validated_url_post->post_content, true ); if ( is_array( $data ) ) { $item['validation_errors'] = wp_list_pluck( $data, 'data' ); } $item['validated_url_post'] = [ 'id' => $validated_url_post->ID, 'edit_link' => get_edit_post_link( $validated_url_post->ID, 'raw' ), ]; $item['stale'] = ( count( AMP_Validated_URL_Post_Type::get_post_staleness( $validated_url_post ) ) > 0 ); } else { $item['validation_errors'] = null; $item['validated_url_post'] = null; $item['stale'] = null; } return rest_ensure_response( $item ); } /** * Retrieves the block type' schema, conforming to JSON Schema. * * @return array Item schema data. */ public function get_item_schema() { return [ '$schema' => 'http://json-schema.org/draft-04/schema#', 'title' => 'amp-wp-' . $this->rest_base, 'type' => 'object', 'properties' => [ 'url' => [ 'description' => __( 'URL', 'amp' ), 'type' => 'string', 'format' => 'uri', 'readonly' => true, 'context' => [ 'view' ], ], 'amp_url' => [ 'description' => __( 'AMP URL', 'amp' ), 'type' => 'string', 'format' => 'uri', 'readonly' => true, 'context' => [ 'view' ], ], 'type' => [ 'description' => __( 'Type', 'amp' ), 'type' => 'string', 'readonly' => true, 'context' => [ 'view' ], ], 'label' => [ 'description' => __( 'Label', 'amp' ), 'type' => 'string', 'readonly' => true, 'context' => [ 'view' ], ], 'validated_url_post' => [ 'description' => __( 'Validated URL post if previously scanned.', 'amp' ), 'type' => [ 'object', 'null' ], 'properties' => [ 'id' => [ 'type' => 'integer', ], 'edit_link' => [ 'type' => 'string', 'format' => 'uri', ], ], 'readonly' => true, 'context' => [ 'view' ], ], 'validation_errors' => [ 'description' => __( 'Validation errors for validated URL if previously scanned.', 'amp' ), 'type' => [ 'array', 'null' ], 'readonly' => true, 'context' => [ 'view' ], ], 'stale' => [ 'description' => __( 'Whether the Validated URL post is stale.', 'amp' ), 'type' => [ 'boolean', 'null' ], 'readonly' => true, 'context' => [ 'view' ], ], ], ]; } } = AMP_Theme_Support::STANDARD_MODE_SLUG; $options[ Option::ALL_TEMPLATES_SUPPORTED ] = true; return $options; }; foreach ( $filtered_hooks as $filter_hook ) { add_filter( $filter_hook, $options_filter ); } } $urls = array_filter( $this->scannable_url_provider->get_urls(), static function ( $item ) { return is_array( $item ) && isset( $item['url'] ); } ); if ( $options_filter ) { foreach ( $filtered_hooks as $filter_hook ) { remove_filter( $filter_hook, $options_filter ); } } return rest_ensure_response( array_map( function ( $item ) use ( $request ) { return $this->prepare_item_for_response( $item, $request )->get_data(); }, $urls ) ); } /** * Prepares the scannable URL entry for the REST response. * * @param array $item Scannable URL entry. * @param WP_REST_Request $request Request object. * @return WP_REST_Response Response object on success, or WP_Error object on failure. */ public function prepare_item_for_response( $item, $request ) { $item = wp_array_slice_assoc( $item, [ 'url', 'type', 'label' ] ); if ( amp_is_canonical() ) { $item['amp_url'] = $item['url']; } else { $item['amp_url'] = $this->paired_routing->add_endpoint( $item['url'] ); } $validated_url_post = AMP_Validated_URL_Post_Type::get_invalid_url_post( $item['url'] ); if ( $validated_url_post instanceof WP_Post ) { $item['validation_errors'] = []; $data = json_decode( $validated_url_post->post_content, true ); if ( is_array( $data ) ) { $item['validation_errors'] = wp_list_pluck( $data, 'data' ); } $item['validated_url_post'] = [ 'id' => $validated_url_post->ID, 'edit_link' => get_edit_post_link( $validated_url_post->ID, 'raw' ), ]; $item['stale'] = ( count( AMP_Validated_URL_Post_Type::get_post_staleness( $validated_url_post ) ) > 0 ); } else { $item['validation_errors'] = null; $item['validated_url_post'] = null; $item['stale'] = null; } return rest_ensure_response( $item ); } /** * Retrieves the block type' schema, conforming to JSON Schema. * * @return array Item schema data. */ public function get_item_schema() { return [ '$schema' => 'http://json-schema.org/draft-04/schema#', 'title' => 'amp-wp-' . $this->rest_base, 'type' => 'object', 'properties' => [ 'url' => [ 'description' => __( 'URL', 'amp' ), 'type' => 'string', 'format' => 'uri', 'readonly' => true, 'context' => [ 'view' ], ], 'amp_url' => [ 'description' => __( 'AMP URL', 'amp' ), 'type' => 'string', 'format' => 'uri', 'readonly' => true, 'context' => [ 'view' ], ], 'type' => [ 'description' => __( 'Type', 'amp' ), 'type' => 'string', 'readonly' => true, 'context' => [ 'view' ], ], 'label' => [ 'description' => __( 'Label', 'amp' ), 'type' => 'string', 'readonly' => true, 'context' => [ 'view' ], ], 'validated_url_post' => [ 'description' => __( 'Validated URL post if previously scanned.', 'amp' ), 'type' => [ 'object', 'null' ], 'properties' => [ 'id' => [ 'type' => 'integer', ], 'edit_link' => [ 'type' => 'string', 'format' => 'uri', ], ], 'readonly' => true, 'context' => [ 'view' ], ], 'validation_errors' => [ 'description' => __( 'Validation errors for validated URL if previously scanned.', 'amp' ), 'type' => [ 'array', 'null' ], 'readonly' => true, 'context' => [ 'view' ], ], 'stale' => [ 'description' => __( 'Whether the Validated URL post is stale.', 'amp' ), 'type' => [ 'boolean', 'null' ], 'readonly' => true, 'context' => [ 'view' ], ], ], ]; } } ) { \update_option( 'wp_attachment_pages_enabled', (int) ! $new_value['disable-attachment'] ); } switch ( $new_value['disable-attachment'] ) { case false: $this->indexing_helper->set_reason( Indexing_Reasons::REASON_ATTACHMENTS_MADE_ENABLED ); return; case true: $this->attachment_cleanup->remove_attachment_indexables( false ); $this->attachment_cleanup->clean_attachment_links_from_target_indexable_ids( false ); if ( $this->indexable_helper->should_index_indexables() && ! \wp_next_scheduled( Cleanup_Integration::START_HOOK ) ) { // This just schedules the cleanup routine cron again. \wp_schedule_single_event( ( \time() + ( \MINUTE_IN_SECONDS * 5 ) ), Cleanup_Integration::START_HOOK ); } return; } } } }