'GET', 'callback' => array( $this, 'collections' ), 'permission_callback' => array( $this, 'can_view' ), ), array( 'methods' => 'POST', 'callback' => array( $this, 'create_collection' ), 'permission_callback' => array( $this, 'can_manage' ), ), ) ); register_rest_route( Router::NAMESPACE, '/collections/(?P\d+)', array( array( 'methods' => 'PATCH', 'callback' => array( $this, 'update_collection' ), 'permission_callback' => array( $this, 'can_manage' ), ), array( 'methods' => 'DELETE', 'callback' => array( $this, 'delete_collection' ), 'permission_callback' => array( $this, 'can_manage' ), ), ) ); register_rest_route( Router::NAMESPACE, '/collections/(?P\d+)/assets', array( array( 'methods' => 'GET', 'callback' => array( $this, 'collection_assets' ), 'permission_callback' => array( $this, 'can_view' ), ), ) ); } public function collections(): WP_REST_Response|\WP_Error { if ( $denied = $this->require_feature( 'smart_views' ) ) { return $denied; } $repo = new CollectionRepository(); $repo->ensure_defaults(); $repo->purge_legacy_exact_duplicates_view(); return new WP_REST_Response( array( 'items' => $repo->all() ) ); } public function create_collection( WP_REST_Request $request ): WP_REST_Response|\WP_Error { if ( $denied = $this->require_feature( 'smart_views' ) ) { return $denied; } $name = sanitize_text_field( (string) $request->get_param( 'name' ) ); if ( '' === $name ) { return $this->error( 'invalid_name', __( 'Enter a name for this smart view.', 'foldrocket' ) ); } $filters = $this->sanitize_collection_filters( $request->get_param( 'filters' ) ); if ( ! $filters ) { return $this->error( 'empty_filters', __( 'Set at least one library filter before saving a smart view.', 'foldrocket' ) ); } $item = ( new CollectionRepository() )->create( array( 'name' => $name, 'filters' => $filters, 'isSmart' => true, ) ); return new WP_REST_Response( $item, 201 ); } public function update_collection( WP_REST_Request $request ): WP_REST_Response|\WP_Error { if ( $denied = $this->require_feature( 'smart_views' ) ) { return $denied; } $data = array(); if ( null !== $request->get_param( 'name' ) ) { $name = sanitize_text_field( (string) $request->get_param( 'name' ) ); if ( '' === $name ) { return $this->error( 'invalid_name', __( 'Enter a name for this smart view.', 'foldrocket' ) ); } $data['name'] = $name; } if ( null !== $request->get_param( 'filters' ) ) { $filters = $this->sanitize_collection_filters( $request->get_param( 'filters' ) ); if ( ! $filters ) { return $this->error( 'empty_filters', __( 'Set at least one library filter before saving a smart view.', 'foldrocket' ) ); } $data['filters'] = $filters; } if ( ! $data ) { return $this->error( 'nothing_to_update', __( 'Nothing to update.', 'foldrocket' ) ); } $item = ( new CollectionRepository() )->update( $this->int_param( $request, 'id' ), $data ); if ( ! $item ) { return $this->error( 'not_found', __( 'Smart view not found.', 'foldrocket' ), 404 ); } return new WP_REST_Response( $item ); } public function delete_collection( WP_REST_Request $request ): WP_REST_Response|\WP_Error { if ( $denied = $this->require_feature( 'smart_views' ) ) { return $denied; } $id = $this->int_param( $request, 'id' ); $repo = new CollectionRepository(); if ( ! $repo->find( $id ) || ! $repo->delete( $id ) ) { return $this->error( 'not_found', __( 'Smart view not found.', 'foldrocket' ), 404 ); } return new WP_REST_Response( array( 'deleted' => true ) ); } public function collection_assets( WP_REST_Request $request ): WP_REST_Response|\WP_Error { if ( $denied = $this->require_feature( 'smart_views' ) ) { return $denied; } $collection = ( new CollectionRepository() )->find( $this->int_param( $request, 'id' ) ); if ( ! $collection ) { return $this->error( 'not_found', __( 'Smart view not found.', 'foldrocket' ), 404 ); } $filters = is_array( $collection['filters'] ) ? $collection['filters'] : array(); $page = max( 1, (int) $request->get_param( 'page' ) ?: 1 ); $result = ( new AssetRepository() )->list( array_merge( $filters, array( 'page' => $page, 'per_page' => min( 100, max( 1, (int) $request->get_param( 'per_page' ) ?: 48 ) ), ) ) ); $result['collection'] = $collection; return new WP_REST_Response( $result ); } /** * Whitelist AssetRepository list keys persisted by Smart Views. * * @param mixed $raw Request value. * @return array */ private function sanitize_collection_filters( $raw ): array { if ( ! is_array( $raw ) ) { return array(); } $out = array(); foreach ( array( 'mime', 'ai_status', 'orientation', 'date_from', 'date_to', 'search' ) as $key ) { if ( ! empty( $raw[ $key ] ) && is_string( $raw[ $key ] ) ) { $out[ $key ] = sanitize_text_field( $raw[ $key ] ); } } if ( ! empty( $raw['author_id'] ) && ( is_string( $raw['author_id'] ) || is_numeric( $raw['author_id'] ) ) ) { $out['author_id'] = (string) absint( $raw['author_id'] ); } if ( ! empty( $raw['duplicate_status'] ) && is_string( $raw['duplicate_status'] ) ) { $out['duplicate_status'] = sanitize_key( $raw['duplicate_status'] ); } if ( ! empty( $raw['folder_id'] ) ) { $out['folder_id'] = absint( $raw['folder_id'] ); } if ( ! empty( $raw['missing_alt'] ) ) { $out['missing_alt'] = true; } if ( ! empty( $raw['min_size'] ) ) { $out['min_size'] = max( 0, (int) $raw['min_size'] ); } if ( isset( $raw['usage_min'] ) && '' !== $raw['usage_min'] ) { $out['usage_min'] = max( 0, (int) $raw['usage_min'] ); } if ( array_key_exists( 'usage_max', $raw ) && null !== $raw['usage_max'] && '' !== $raw['usage_max'] ) { $out['usage_max'] = (int) $raw['usage_max']; } if ( ! empty( $raw['indexed_only'] ) ) { $out['indexed_only'] = true; } return $out; } }