WordPress 5.4 对REST API 的更改

PetitQ WordPress教程 2020-3-01 1.19K 0 0

Posts Controller 现在支持分类法“OR”关系

查询/wp/v2/posts?tags=1&categories=2 返回了分配了 ID 为 1 的标签，并且分配了 ID 为 2 的分类下的所有文章。自 WordPress 4.7 以来，Posts Controller 一直只支持这种 AND 关系（必须同时满足多个分类法的分类关系。

也想出现在这里？联系我们吧

REST API /wp/v2/posts 端点以及从扩展过来的自定义文章类型端点 WP_REST_Posts_Controller（包括指定的自定义文章类型"show_in_rest" => true）现在支持一个新参数 tax_relation，该参数可用于返回与任一分类过滤器（而不是两者）匹配的文章，也就是“或者（ OR ）” 关系。

例如，在 WordPress 5.4 中，posts 端点查询：

/wp/v2/posts?tags=1&categories=2&tax_relation=OR

现在将返回标签 ID 为 1 或与分类 ID 为 2 的所有文章。

选择性链接嵌入

REST API 现在支持使用 _embed 参数返回有限的一组嵌入式对象。例如，在 WordPress 5.4 中，以下查询仅嵌入作者信息，而不包括所有评论，媒体等。

```
/wp/v2/posts/?_embed=author
```

如果 _embed 省略参数值或将其设置为 true 或 1 ，则将返回所有嵌入。

WP_REST_Server 方法更改

WordPress 5.4 更改了 WP_REST_Server 类中两个方法的签名。扩展 WP_REST_Server 和覆盖这些方法的开发人员应更新其代码以匹配新的签名，以避免出现 PHP 警告。

WP_REST_Server::embed_links()的签名现在为embed_links( $data, $embed = true )。新参数$embed接受链接关系（例如array( 'author', 'wp:term' )）的数组，并在响应这些关系时限制嵌入的链接。默认设置为true将保留以前在响应中嵌入所有链接的行为。有关更多详细信息，请参见＃39696。
WP_REST_Server::get_routes()的签名现在为get_routes( $namespace = '' )。新参数$namespace接受一个字符串，并将返回的路由限制为名称空间与该字符串匹配的路由。在内部，WP_REST_Server使用此新参数来提高性能，WP_REST_Server::dispatch()方法是减少将请求与注册路由相匹配所需的正则表达式检查次数。