Docs: Improve formatting of the `$fields` parameter description in `WP_Term_Query::__construct()`.

See #44305, #49572.

git-svn-id: https://develop.svn.wordpress.org/trunk@48562 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Sergey Biryukov 2020-07-22 11:33:51 +00:00
parent 3d2cd19b4f
commit e88e84c662
1 changed files with 11 additions and 7 deletions

View File

@ -128,19 +128,23 @@ class WP_Term_Query {
* @type int $offset The number by which to offset the terms query. Default empty.
* @type string $fields Term fields to query for. Accepts:
* - 'all' Returns an array of complete term objects (`WP_Term[]`).
* - 'all_with_object_id' Returns an array of term objects with the 'object_id'
* param (`WP_Term[]`). Works only when the `$object_ids` parameter is populated.
* - 'all_with_object_id' Returns an array of term objects
* with the 'object_id' param (`WP_Term[]`). Works only
* when the `$object_ids` parameter is populated.
* - 'ids' Returns an array of term IDs (`int[]`).
* - 'tt_ids' Returns an array of term taxonomy IDs (`int[]`).
* - 'names' Returns an array of term names (`string[]`).
* - 'slugs' Returns an array of term slugs (`string[]`).
* - 'count' Returns the number of matching terms (`int`).
* - 'id=>parent' Returns an associative array of parent term IDs, keyed by term ID (`int[]`).
* - 'id=>name' Returns an associative array of term names, keyed by term ID (`string[]`).
* - 'id=>slug' Returns an associative array of term slugs, keyed by term ID (`string[]`).
* - 'id=>parent' Returns an associative array of parent term IDs,
* keyed by term ID (`int[]`).
* - 'id=>name' Returns an associative array of term names,
* keyed by term ID (`string[]`).
* - 'id=>slug' Returns an associative array of term slugs,
* keyed by term ID (`string[]`).
* Default 'all'.
* @type bool $count Whether to return a term count. Will take precedence over `$fields` if true.
* Default false.
* @type bool $count Whether to return a term count. If true, will take precedence
* over `$fields`. Default false.
* @type string|array $name Optional. Name or array of names to return term(s) for.
* Default empty.
* @type string|array $slug Optional. Slug or array of slugs to return term(s) for.