Docs: Correct and improve the readability of some parameters of `WP_Term_Query`.

See #48303


git-svn-id: https://develop.svn.wordpress.org/trunk@46652 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
John Blackbourn 2019-11-04 17:48:55 +00:00
parent 9ed5e8c9f7
commit f6cb28a6a2
1 changed files with 14 additions and 14 deletions

View File

@ -121,20 +121,20 @@ class WP_Term_Query {
* not return accurate results when coupled with $object_ids.
* See #41796 for details.
* @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), 'all_with_object_id' (returns an
* array of term objects with the 'object_id' param; works only
* when the `$object_ids` parameter is populated), 'ids'
* (returns an array of ids), 'tt_ids' (returns an array of
* term taxonomy ids), 'id=>parent' (returns an associative
* array with ids as keys, parent term IDs as values), 'names'
* (returns an array of term names), 'count' (returns the number
* of matching terms), 'id=>name' (returns an associative array
* with ids as keys, term names as values), or 'id=>slug'
* (returns an associative array with ids as keys, term slugs
* as values). Default 'all'.
* @type bool $count Whether to return a term count (true) or array of term objects
* (false). Will take precedence over `$fields` if true.
* @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.
* - '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[]`).
* Default 'all'.
* @type bool $count Whether to return a term count. Will take precedence over `$fields` if true.
* Default false.
* @type string|array $name Optional. Name or array of names to return term(s) for.
* Default empty.