wp term

Управляет терминами таксономии и терминами meta с помощью команд create, delete и list.

Примеры

# Create a new term.
$ wp term create category Apple --description="A type of fruit"
Success: Created category 199.

# Get details about a term.
$ wp term get category 199 --format=json --fields=term_id,name,slug,count
{"term_id":199,"name":"Apple","slug":"apple","count":1}

# Update an existing term.
$ wp term update category 15 --name=Apple
Success: Term updated.

# Get the term's URL.
$ wp term list post_tag --include=123 --field=url
http://example.com/tag/tips-and-tricks

# Delete post category
$ wp term delete category 15
Success: Deleted category 15.

# Recount posts assigned to each categories and tags
$ wp term recount category post_tag
Success: Updated category term count
Success: Updated post_tag term count

Исходный код команд

• wp-cli/entity-command
  • Term_Command.php
  • Term_Meta_Command.php > CommandWithMeta

wp term list

Получает термины таксономии.

Использование

wp term list {taxonomy}... [--{field}={value}] [--field={field}] [--fields={fields}] [--format={format}]

Можно указать Глобальные параметры и следующие:

{taxonomy}...

List terms of one or more taxonomies

[--{field}={value}]

Filter by one or more fields (see get_terms() $args parameter for a list of fields).

[--field={field}]

Prints the value of a single field for each term.

[--fields={fields}]

Limit the output to specific object fields.

[--format={format}]

Render output in a particular format.
По умолчанию: table
Может быть:

• table
• csv
• ids
• json
• count
• yaml

Доступные поля

These fields will be displayed by default for each term:

• term_id
• term_taxonomy_id
• name
• slug
• description
• parent
• count

These fields are optionally available:

• url

Примеры

# List post categories
$ wp term list category --format=csv
term_id,term_taxonomy_id,name,slug,description,parent,count
2,2,aciform,aciform,,0,1
3,3,antiquarianism,antiquarianism,,0,1
4,4,arrangement,arrangement,,0,1
5,5,asmodeus,asmodeus,,0,1

# List post tags
$ wp term list post_tag --fields=name,slug
+-----------+-------------+
| name      | slug        |
+-----------+-------------+
| 8BIT      | 8bit        |
| alignment | alignment-2 |
| Articles  | articles    |
| aside     | aside       |
+-----------+-------------+

wp term create

Создает новый термин.

Использование

wp term create {taxonomy} {term} [--slug={slug}] [--description={description}] [--parent={term-id}] [--porcelain]

Можно указать Глобальные параметры и следующие:

{taxonomy}

Taxonomy for the new term.

{term}

A name for the new term.

[--slug={slug}]

A unique slug for the new term. Defaults to sanitized version of name.

[--description={description}]

A description for the new term.

[--parent={term-id}]

A parent for the new term.

[--porcelain]

Output just the new term id.

Примеры

# Create a new category "Apple" with a description.
$ wp term create category Apple --description="A type of fruit"
Success: Created category 199.

wp term get

Получает сведения о термине.

Использование

wp term get {taxonomy} {term} [--by={field}] [--field={field}] [--fields={fields}] [--format={format}]

Можно указать Глобальные параметры и следующие:

{taxonomy}

Taxonomy of the term to get

{term}

ID or slug of the term to get

[--by={field}]

Explicitly handle the term value as a slug or id.
По умолчанию: id
Может быть:

• slug
• id

[--field={field}]

Instead of returning the whole term, returns the value of a single field.

[--fields={fields}]

Limit the output to specific fields. Defaults to all fields.

[--format={format}]

Render output in a particular format.
По умолчанию: table
Может быть:

• table
• csv
• json
• yaml

Примеры

# Get details about a category with id 199.
$ wp term get category 199 --format=json
{"term_id":199,"name":"Apple","slug":"apple","term_group":0,"term_taxonomy_id":199,"taxonomy":"category","description":"A type of fruit","parent":0,"count":0,"filter":"raw"}

# Get details about a category with slug apple.
$ wp term get category apple --by=slug --format=json
{"term_id":199,"name":"Apple","slug":"apple","term_group":0,"term_taxonomy_id":199,"taxonomy":"category","description":"A type of fruit","parent":0,"count":0,"filter":"raw"}

wp term update

Обновляет существующий термин.

Использование

wp term update {taxonomy} {term} [--by={field}] [--name={name}] [--slug={slug}] [--description={description}] [--parent={term-id}]

Можно указать Глобальные параметры и следующие:

{taxonomy}

Taxonomy of the term to update.

{term}

ID or slug for the term to update.

[--by={field}]

Explicitly handle the term value as a slug or id.
По умолчанию: id
Может быть:

• slug
• id

[--name={name}]

A new name for the term.

[--slug={slug}]

A new slug for the term.

[--description={description}]

A new description for the term.

[--parent={term-id}]

A new parent for the term.

Примеры

# Change category with id 15 to use the name "Apple"
$ wp term update category 15 --name=Apple
Success: Term updated.

# Change category with slug apple to use the name "Apple"
$ wp term update category apple --by=slug --name=Apple
Success: Term updated.

wp term delete

Удаляет существующий термин.

Errors if the term doesn't exist, or there was a problem in deleting it.

Использование

wp term delete {taxonomy} {term}... [--by={field}]

Можно указать Глобальные параметры и следующие:

{taxonomy}

Taxonomy of the term to delete.

{term}...

One or more IDs or slugs of terms to delete.

[--by={field}]

Explicitly handle the term value as a slug or id.
По умолчанию: id
Может быть:

• slug
• id

Примеры

# Delete post category by id
$ wp term delete category 15
Deleted category 15.
Success: Deleted 1 of 1 terms.

# Delete post category by slug
$ wp term delete category apple --by=slug
Deleted category 15.
Success: Deleted 1 of 1 terms.

# Delete all post tags
$ wp term list post_tag --field=term_id | xargs wp term delete post_tag
Deleted post_tag 159.
Deleted post_tag 160.
Deleted post_tag 161.
Success: Deleted 3 of 3 terms.

wp term generate

Генерирует термины.

Creates a specified number of new terms with dummy data.

Использование

wp term generate {taxonomy} [--count={number}] [--max_depth={number}] [--format={format}]

Можно указать Глобальные параметры и следующие:

{taxonomy}

The taxonomy for the generated terms.

[--count={number}]

How many terms to generate?
По умолчанию: 100

[--max_depth={number}]

Generate child terms down to a certain depth.
По умолчанию: 1

[--format={format}]

Render output in a particular format.
По умолчанию: progress
Может быть:

• progress
• ids

Примеры

# Generate post categories.
$ wp term generate category --count=10
Generating terms  100% [=========] 0:02 / 0:02

# Add meta to every generated term.
$ wp term generate category --format=ids --count=3 | xargs -d ' ' -I % wp term meta add % foo bar
Success: Added custom field.
Success: Added custom field.
Success: Added custom field.

wp term recount

Пересчитывает количество записей в каждом термине.

In instances where manual updates are made to the terms assigned to posts in the database, the number of posts associated with a term can become out-of-sync with the actual number of posts.

This command runs wp_update_term_count() on the taxonomy's terms to bring the count back to the correct value.

Использование

wp term recount {taxonomy}...

Можно указать Глобальные параметры и следующие:

{taxonomy}...

One or more taxonomies to recalculate.

Примеры

# Recount posts assigned to each categories and tags
$ wp term recount category post_tag
Success: Updated category term count.
Success: Updated post_tag term count.

# Recount all listed taxonomies
$ wp taxonomy list --field=name | xargs wp term recount
Success: Updated category term count.
Success: Updated post_tag term count.
Success: Updated nav_menu term count.
Success: Updated link_category term count.
Success: Updated post_format term count.

wp term meta list

Список всех метаданных, связанных с объектом.

Использование

wp term meta list {id} [--keys={keys}] [--fields={fields}] [--format={format}] [--orderby={fields}] [--order={order}]

Можно указать Глобальные параметры и следующие:

{id}

ID for the object.

[--keys={keys}]

Limit output to metadata of specific keys.

[--fields={fields}]

Limit the output to specific row fields. Defaults to id,meta_key,meta_value.

[--format={format}]

Render output in a particular format.
По умолчанию: table
Может быть:

• table
• csv
• json
• yaml
• count

[--orderby={fields}]

Set orderby which field.
По умолчанию: id
Может быть:

• id
• meta_key
• meta_value

[--order={order}]

Set ascending or descending order.
По умолчанию: asc
Может быть:

• asc
• desc

wp term meta get

Получает значение мета-поля.

Использование

wp term meta get {id} {key} [--format={format}]

Можно указать Глобальные параметры и следующие:

{id}

The ID of the object.

{key}

The name of the meta field to get.

[--format={format}]

Get value in a particular format.
По умолчанию: var_export
Может быть:

• var_export
• json
• yaml

wp term meta delete

Удаляет мета-поле.

Использование

wp term meta delete {id} [{key}] [{value}] [--all]

Можно указать Глобальные параметры и следующие:

{id}

The ID of the object.

[{key}]

The name of the meta field to delete.

[{value}]

The value to delete. If omitted, all rows with key will deleted.

[--all]

Delete all meta for the object.

wp term meta add

Добавляет мета-поле.

Использование

wp term meta add {id} {key} [{value}] [--format={format}]

Можно указать Глобальные параметры и следующие:

{id}

The ID of the object.

{key}

The name of the meta field to create.

[{value}]

The value of the meta field. If omitted, the value is read from STDIN.

[--format={format}]

The serialization format for the value.
По умолчанию: plaintext
Может быть:

• plaintext
• json

wp term meta update

Обновляет мета-поле.

Использование

wp term meta update {id} {key} [{value}] [--format={format}]

Можно указать Глобальные параметры и следующие:

{id}

The ID of the object.

{key}

The name of the meta field to update.

[{value}]

The new value. If omitted, the value is read from STDIN.

[--format={format}]

The serialization format for the value.
По умолчанию: plaintext
Может быть:

• plaintext
• json

wp term meta pluck

Получает вложенное значение из мета-поля (из сериал-го массива).

Использование

wp term meta pluck {id} {key} {key-path}... [--format={format}]

Можно указать Глобальные параметры и следующие:

{id}

The ID of the object.

{key}

The name of the meta field to get.

{key-path}...

The name(s) of the keys within the value to locate the value to pluck.

[--format={format}]

The output format of the value.
--- По умолчанию: plaintext
Может быть:

• plaintext
• json
• yaml

wp term meta patch

Обновляет вложенное значение мета-поля (сериал-го массива).

Использование

wp term meta patch {action} {id} {key} {key-path}... [{value}] [--format={format}]

Можно указать Глобальные параметры и следующие:

{action}

Patch action to perform.

Может быть:

• insert
• update
• delete

{id}

The ID of the object.

{key}

The name of the meta field to update.

{key-path}...

The name(s) of the keys within the value to locate the value to patch.

[{value}]

The new value. If omitted, the value is read from STDIN.

[--format={format}]

The serialization format for the value.
По умолчанию: plaintext
Может быть:

• plaintext
• json