指定のroleの持つ権限を一覧表示する。

使用例

# bbPressモデレータの権限をアルファベット順に表示
wp cap list 'bbp_moderator' | sort

タブ補完の文字列を生成する。

オプション

–line=<line>
現在の行が実行される。

–point=<point>
コマンドを開始する場所を、現在のカーソル位置からの相対位置で指定する。

CLIの環境に関する様々な情報を表示する。

オプション

[–format=<format>]
指定可能な値： json

コメントを承認する。

オプション

<id>
承認するコメントのID

ブログ全体または指定した投稿のコメント数を表示する。

オプション

[<post-id>]
コメント数を返す投稿のID

使用例

wp comment count
wp comment count 42

コメントを挿入する。

オプション

–<field>=<value>
新しいコメントの連想配列。wp_insert_comment()参照。

[–porcelain]
新しいコメントのIDを返す。

使用例

wp comment create --comment_post_ID=15 --comment_content="hello blog" --comment_author="wp-cli"

コメントを削除する。

オプション

<id> …
削除するコメントのID。（複数指定可）

[–force]
ゴミ箱をスキップ。

使用例

wp comment delete 1337 --force
wp comment delete 1337 2341 --force

コメントが存在するかどうかを確認する。

オプション

<id>
確認したいコメントのID

使用例

wp comment exists 1337

1個のコメントを取り出す。

オプション

<id>
取り出すコメント

[–field=<field>]
コメント全体を返す代わりにコメントの値を返す。

[–format=<format>]
指定可能な値： table、json（デフォルトはtable）

使用例

wp comment get 1 --field=content

コメントの一覧を取得する。

オプション

[–field>=<value>]
WP_Comment_Queryに渡す引数。（複数指定可）

[–field=<field>]
それぞれのコメントついて、指定したフィールドの値を表示する。（複数指定不可）

[–fields=<fields>]
指定したフィールドのみ表示する。デフォルトは、comment_ID, comment_postID, comment_date, comment_approved, comment_author, comment_author_email

使用例

wp comment list --field=ID
wp comment list --post_id=2
wp comment list --number=20 --status=approve

コメントのカスタムフィールドを扱う。

オプション

–format=json
値をJSON形式としてエンコード/デコードする。

使用例

wp comment meta set 123 description "Mary is a WordPress developer."

サブコマンド

• add – メタフィールドを追加する。
  <id>
  オブジェクトのID
  <key>
  新規作成するメタフィールドの名前
  [<value>]
  メタフィールドの値。省略時には標準入力から読み込む。
  [–format=<format>]
  値のシリアル化形式。デフォルトはplaintext。
• delete – メタフィールドを削除する。
• get – メタフィールドの値を取得する。
• update – メタフィールドを更新する。
  <id>
  オブジェクトのID
  <key>
  更新するメタフィールドの名前。
  [<value>]
  新しい値。省略時には標準入力から読み込む。
  [–format=<format>]
  値をシリアル化する形式。デフォルトはplaintext。

スパム処理。

オプション

<id>
スパムとしてマークするコメントのID

使用例

wp comment spam 1337

コメントのステータスを取得する。

オプション

<id>
チェックするコメントのID

使用例

wp comment status 1337

コメントをゴミ箱に入れる。

オプション

<id>
ゴミ箱に入れるコメントのID

使用例

wp comment trash 1337

コメントを承認しない。

オプション

<id>
承認しないコメントのID

使用例

wp comment unapprove 1337

コメントのスパムとしてのマークを解除する。

オプション

<id>
スパムとしてのマークを解除するコメントのID

使用例

wp comment unspam 1337

コメントをゴミ箱から戻す。

オプション

<id>
ゴミ箱から戻すコメントのID

使用例

wp comment untrash 1337

コメントを更新する。（複数指定可）

オプション

<id> …
更新するコメントのID（複数指定可）

–<field>=<value>
更新するフィールド。（複数指定可） wp_update_comment()参照。

使用例

wp comment update 123 --comment_author='That Guy'

コメントのURLを取得する。

オプション

<id> …
URLを取得するコメントのID。（複数指定可）

使用例

wp comment url 123

wp-config.phpファイルを作成する。

オプション

–dbname=<dbname>
データベースの名前を指定する。

–dbuser=<dbuser>
データベースのユーザーを指定する。

[–dbpass=<dbpass>]
データベースのユーザーのパスワードを指定する。

[–dbhost=<dbhost>]
データベースホストを指定する。デフォルトは ‘localhost’

[–dbprefix=<dbprefix>]
データベースのプレフィクスを指定する。デフォルトは ‘wp_’

[–dbcharset=<dbcharset>]
データベースのcharsetを指定する。デフォルトは ‘utf8’

[–dbcollate=<dbcollate>]
データベースの照合順序を指定する。デフォルトは ”

[–locale=<locale>]
WPLANG定数の値を指定する。デフォルトは $wp_local_package の値。

[–extra-php]
指定されたとき、標準入力からPHPの追加コードを読み込む。

[–skip-salts]
指定されたとき、keys と salts が生成されない。ただし、–extra-phpで渡す必要がある。

[–skip-check]
指定されたとき、データベースとのコネクションを確認しない。

使用例

# 標準的なwp-config.phpファイル
wp core config --dbname=testing --dbuser=wp --dbpass=securepswd --locale=ja_JP

# WP_DEBUG と WP_DEBUG_LOG を有効にする。
wp core config --dbname=testing --dbuser=wp --dbpass=securepswd --extra-php <<PHP
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
PHP

WordPressのcoreファイルをダウンロードする。

オプション

[–path=<path>]
WordPressをインストールするpath。

[–locale=<locale>]
ダウンロードしたい言語を選択する。

[–version=<version>]
ダウンロードするバージョンを選択する。

[–force]
ファイルが既に存在していた場合、上書きするかどうかを指定する。

使用例

wp core download --locale=ja_JP

データベースにWordPressのテーブルを作成する。

オプション

–url=<url>
新しいサイトのアドレス。

–title=<site-title>
新しいサイトのタイトル。

–admin_user=<username>
管理者名。

–admin_password=<password>
管理者のパスワード。

–admin_email=<email>
管理者の電子メールアドレス。

WordPressのテーブルがインストールされているかどうかを返す。

オプション

[–network]
マルチサイトとしてインストールされているかどうかを確認する。

使用例

if ! $(wp core is-installed); then
  wp core install
fi

シングルサイトとしてインストールされたものをマルチサイトに変換する。

オプション

[–title=<network-title>]
新しいネットワークのタイトル。

[–base=<url-path>]
それぞれのサイトのURLのpathのベース部分。。デフォルトは ‘/’

[–subdomains]
指定されたとき、サブディレクトリの代わりにサブドメインを使用する。

マルチサイトを始めからインストールする。

オプション

[–url=<url>]
新しいサイトのアドレス。

[–base=<url-path>]
それぞれのサイトのURLのpathのベース部分。デフォルトは ‘/’

[–subdomains]
指定されたとき、サブディレクトリの代わりにサブドメインを使用する。

–title=<site-title>
新サイトのタイトル

–admin_user=<username>
管理者名。

–admin_password=<password>
管理者のパスワード。

–admin_email=<email>
管理者の電子メールアドレス。

WordPressをアップデートする。

オプション

[<zip>]
インストールに使用するzipファイルの置き場所を指定する。指定がなければwordpress.orgからダウンロードする。

[–version=<version>]
インストールするバージョンを指定。指定がなければ最新版をインストールする。

[–force]
すでにインストールされているWordPressのバージョンの方が新しくても、指定されたバージョンで上書きする。

[–locale=<locale>]
ダウンロードする言語を指定する。

使用例

wp core update
wp core update --version=3.8 ../latest.zip
wp core update --version=3.1 --force

WordPressのバージョンを表示する。

オプション

[–extra]
バージョンに関する詳細な情報を表示する。

データベースを削除する。

オプション

[–yes]
確認メッセージに yes と入力する。

データベースから指定されたファイルまたは標準出力にエクスポートする。

オプション

[<file>]
エクスポート先のSQLファイル名。 ‘-‘ を指定すると標準出力に出力する。省略時には ‘{dbname}.sql’ に出力する。

[–field>=<value>]
mysqldumpに渡す追加の変数。

[–tables=<tables>]
エクスポートするテーブル名をカンマで区切って指定する。省略時にはすべてのテーブルをエクスポートする。

使用例

wp db export --add-drop-table
wp db export --tables=wp_options,wp_users

データベースに指定されたファイルまたは標準入力からインポートする。

オプション

[<file>]
インポートするSQLファイル名。 ‘-‘ を指定すると標準入力から読み込む。省略時には ‘{dbname}.sql’ を探す。

データベースにクエリーを実行する。

オプション

[<sql>]
SQLクエリー。指定がない場合には標準入力から読み込む。

使用例

# ファイルに格納されたクエリーを実行する
wp db query < debug.sql

データベースからすべてのテーブルを削除する。

オプション

[–yes]
確認メッセージに yes と入力する。

データベース上のテーブルを一覧表示する。

オプション

[–scope=<scope>]
all、global、ms_global、blogまたはold_tablesを指定する。デフォルトはall。

使用例

# 特定のサイトのテーブルのみエクスポートする
wp db export -tables$(wp db tables -url=sub.example.com | tr '\n' ',')

ローカルファイルまたはURLから添付ファイルを作成する。

オプション

<file>
インポートするファイル（複数指定可）のpath。使用中のシェルのglob(3)機能を利用可。指定されたファイルがURLとして認識された場合（httpやftp）、取り込み前に一時ファイルにダウンロードする。

–post_id=<post_id>
インポートしたファイルを添付する投稿のID。

–title=<title>
添付のタイトル（投稿のタイトル欄）

–caption=<caption>
添付のキャプション（投稿の抜粋欄）

–alt=<alt_text>
画像のAltテキスト（投稿のmetaデータとして保存）

–desc=<description>
添付投稿の “Description” フィールド（投稿の本文）。

–featured_image
指定されたとき、添付する投稿のアイキャッチ画像に設定する。

使用例

# 現在のユーザーの "Pictures" ディレクトリ下にある、投稿に添付されていないすべてのjpegファイルをインポートする
wp media import ~/Pictures/**\/*.jpg

# ローカルイメージをインポートし、投稿のアイキャッチ画像とする
wp media import ~/Downloads/image.png --post_id=123 --title="A downloaded picture" --featured_image

# Webからイメージをインポートする。
wp media import http://s.wordpress.org/style/images/wp-header-logo.png --title='The WordPress logo' --alt="Semantic personal publishing"

サムネイルを再生成する。

オプション

[<attachment-id> …]
サムネイルを再生成する添付ファイルのID（複数指定可）。

[–yes]
確認メッセージにyesと答える。

使用例

# 確認なしですべてのサムネイルを再生成
wp media regenerate --yes

# IDが1000～2000の画像すべてのサムネイルを再生成する。
seq 1000 2000 | xargs wp media regenerate

新しいメニューを作成。

オプション

<menu-name>
メニューの説明文。

[–porcelain]
新しいメニューのIDを出力。

使用例

wp menu create "My Menu"

オプション

<menu> …
削除するメニューの名前、スラグ、またはID。（複数指定可）

使用例

wp menu delete "My Menu"

メニュー項目の一覧表示、追加、削除。

使用例

# 既存のメニューを既存の投稿に追加
wp menu item add-post sidebar-menu 33 --title"Custom Test Post"

# 新しいメニューリンクを作成
wp menu item add-custom sidebar-menu Apple http://apple.com --porcelain

サブコマンド

• add-custom – カスタムメニュー項目を追加
  <menu>
  メニューの名前、スラグ、またはID。
  <title>
  リンクのタイトル。
  <link>
  リンクのURL。
  [–description=<description>]
  メニュー項目の説明。
  [–attr-title=<attr-title>]
  メニュー項目のタイトル属性。
  [–target=<target>]
  メニュー項目のtarget属性。
  [–classes=<classes>]
  メニュー項目のクラス。
  [–position=<position>]
  メニュー項目の位置。
  [–parent-id=<parent-id>]
  メニュー項目の親メニュー項目を指定。
  [–porcelain]
  新しいメニュー項目のIDのみを表示。
  

  使用例

  wp menu item add-custom sidebar-menu Apple http://apple.com --porcelain

• add-post – 投稿をメニュー項目として追加
  <menu>
  メニューの名前、スラグ、またはID。
  <post-id>
  メニューに追加する投稿のID。
  [–title=<title>]
  リンクのタイトル。
  [–link=<link>]
  リンクのURL。
  [–description=<description>]
  メニュー項目の説明。
  [–attr-title=<attr-title>]
  メニュー項目のタイトル属性。
  [–target=<target>]
  メニュー項目のtarget属性。
  [–classes=<classes>]
  メニュー項目のクラス。
  [–position=<position>]
  メニュー項目の位置。
  [–parent-id=<parent-id>]
  メニュー項目の親メニュー項目を指定。
  [–porcelain]
  新しいメニュー項目のIDのみを表示。
  

  使用例

  wp menu item add-post sidebar-menu 33 --title="Custom Test Post"

• add-term – タクソノミータームをメニュー項目として追加
  <menu>
  メニューの名前、スラグ、またはID。
  <taxonomy>
  追加するタクソノミー。
  <term-id>
  メニューに追加するタームのID。
  [–title=<title>]
  リンクのタイトル。
  [–link=<link>]
  リンクのURL。
  [–description=<description>]
  メニュー項目の説明。
  [–attr-title=<attr-title>]
  メニュー項目のタイトル属性。
  [–target=<target>]
  メニュー項目のtarget属性。
  [–classes=<classes>]
  メニュー項目のクラス。
  [–position=<position>]
  メニュー項目の位置。
  [–parent-id=<parent-id>]
  メニュー項目の親メニュー項目を指定。
  [–porcelain]
  新しいメニュー項目のIDのみを表示。
  

  使用例

  wp menu item add-term sidebar-menu post_tag 24

• delete – メニューから項目を削除
  <db-id>
  削除するメニュー項目のデータベースID。
  

  使用例

  wp menu item remove 45

• list – メニューの項目を一覧表示
  <menu>
  メニューの名前、スラグ、またはID。
  [–fields=<fields>]
  指定したオブジェクトフィールドのみ出力する。デフォルトではdb_id,type,title,link
  

  使用例

  wp menu item list <menu>

• update – メニューの項目を更新
  <db-id>
  メニュー項目のデータベースID。
  [–title=<title>]
  リンクのタイトル。
  [–link=<link>]
  リンクのURL。
  [–description=<description>]
  メニュー項目の説明。
  [–attr-title=<attr-title>]
  メニュー項目のタイトル属性。
  [–target=<target>]
  メニュー項目のtarget属性。
  [–classes=<classes>]
  メニュー項目のクラス。
  [–position=<position>]
  メニュー項目の位置。
  [–parent-id=<parent-id>]
  メニュー項目の親メニュー項目を指定。
  

  使用例

  wp menu item update 45 --title=WordPress --link='http://wordpress.org' --target=_blank --position=2

メニューの一覧を取得。

オプション

[–fields=<fields>]
指定したオブジェクトフィールドのみ出力する。デフォルトではdb_id,type,title,link

[–format=<format>]
指定可能な値は、table、csv、json、count、ids。デフォルトはtable。

使用例

wp menu list

メニュー位置の設定。

使用例

# 可能なメニュー位置の表示
wp menu location list

# 'primary-menu'メニューを'primary'位置に割り当て
wp menu location assign primary-menu primary

# 'primary'位置から'primary-menu'メニューを削除
wp menu location remove primary-menu primary

サブコマンド

• assign – メニューにロケーションを割り当て
  <menu>
  メニューの名前、スラグ、またはID。
  <location>
  ロケーションのスラグ。
  

  使用例

  wp menu location assign primary-menu primary

• list – 現在のテーマ内のロケーションを一覧表示
  [–format=<format>]
  指定可能な値は、table、csv、json、count、ids。デフォルトはtable。
  

  使用例

  wp menu location list

• remove – メニューからロケーションを削除
  <menu>
  メニューの名前、スラグ、またはID。
  <location>
  ロケーションのスラグ。
  

  使用例

  wp menu location remove primary-menu primary

オプションを追加。

オプション

<key>
追加するオプションの名前。

[<value>]
追加するオプションの値。省略時には標準入力から読み込む。

[–format=<format>]
値のシリアル化形式。デフォルトはplaintext。

[–autoload=<autoload>]
このオプションが自動的に読み込まれるべきかどうかを指定する。指定可能な値はyes, no。デフォルトはyes。

使用例

# JSONファイルを読み込みオプションを生成
wp option add my_option --format=json < config.json

オプションを更新。

オプション

<key>
追加するオプションの名前。

[<value>]
追加するオプションの値。省略時には標準入力から読み込む。

[–format=<format>]
値のシリアル化形式。デフォルトはplaintext。

使用例

# ファイルから読み込んでオプションを更新
wp option update my_option < value.txt

プラグインを有効にする。

オプション

<plugin>
有効にするプラグイン（複数指定可）。

[–network]
指定時、マルチサイトネットワーク全体でプラグインを有効化する。

プラグインを無効にする。

オプション

<plugin>
無効にするプラグイン（複数指定可）。

[–all]
指定時、すべてのプラグインが無効化する。

[–network]
指定時、マルチサイトネットワーク全体でプラグインを無効化する。

プラグインのファイルを削除する。

オプション

<plugin>
削除するプラグイン（複数指定可）。

使用例

wp plugin delete hello

プラグインの情報を取得する。

オプション

<plugin>
情報を取得するプラグイン（複数指定可）。

[–field=<field>]
プラグインの情報すべてではなく、指定したフィールドのみを表示する。

[–format=<format>]
出力する一覧をtableまたはJSONから選択する。デフォルトはtable。

使用例

wp plugin get bbpress --format=json

プラグインをインストールする。

オプション

<plugin|zip|url>
インストール取得するプラグインのスラグ、ローカルなzipファイルまたはネットワーク上のURL。

[–version=<version>]
wordpress.orgから指定したバージョンを取得。省略時には安定バージョンを取得する。

[–force]
確認のプロンプトを出さずにインストール済みのプラグインを上書きする。

[–activate]
プラグインをインストールした後すぐに有効化する。

[–activate-network]
プラグインをインストールした後すぐにネットワーク全体で有効化する。

使用例

# wordpress.orgから最新版をインストールして有効化
wp plugin install bbpress --activate

# wordpress.orgから開発版をインストール
wp plugin install bbpress --version=dev

# ローカルなzipファイルからインストール
wp plugin install ../my-plugin.zip

# ネットワーク上のzipファイルからインストール
wp plugin install http://s3.amazonaws.com/bucketname/my-plugin.zip?AWSAccessKeyID=123&Expires=456&Signature=abcdef

指定されたプラグインがインストール済みかどうかを確認する。

オプション

<plugin>
確認するプラグイン。

使用例

wp plugin is-installed hello

プラグインの一覧を表示する。

オプション

[–field=<value>]
フィールドの値によって結果をフィルタする。

[–field=<field>]
それぞれのプラグインの指定したフィールドを表示する。

[–fields=<fields>]
指定したフィールドのみ表示する。デフォルトはname,status,update,version

[–format=<format>]
指定可能な値は、table、csv、json、count。デフォルトはtable。

使用例

wp plugin list --status=active --format=json

プラグインのディレクトリへのpathを表示する。

オプション

[<plugin>]
pathを取得したいプラグインを指定。指定がなければプラグインディレクトリへのpathを表示。

[–dir]
指定時、プラグインファイルではなくそのファイルの置かれたディレクトリのpathを表示。

使用例

cd $(wp plugin path)

wordpress.orgプラグインリポジトリを検索する。

オプション

<search>
検索する文字列。

[–per-page=<per-page>]
結果を表示する数。デフォルトは10。

[–field=<field>]
それぞれのプラグインの指定したフィールドを表示する。

[–fields<fields>]

[–format=<format>]
指定可能な値は、table、csv、json、count。デフォルトはtable。

使用例

wp plugin search dsgnwrks --per-page=20 --format=json
wp plugin search dsgnwrks --fields=name,version,slug,rating,num_ratings

指定されたプラグインの状態を表示する。

オプション

[<plugin>]
状態を取得したいプラグインを指定。

プラグインの有効/無効状態を切り替える。

オプション

<plugin> …
状態を切り替えたいプラグインを指定。複数指定可。

[–network]
指定時、マルチサイト全体の状態を切り替える。

プラグインをアンインストールする。

オプション

<plugin> …
アンインストールプラグインを指定。複数指定可。

[–no-delete]
指定時、プラグインのファイルは削除しない。アンインストールの処理のみ走らせる。

使用例

wp plugin uninstall hello

プラグインを更新する。

オプション

[<plugin> …]
更新するプラグインを指定。複数指定可。

[–all]
設定時、新しいバージョンが出ているすべてのプラグインを更新する。

[–version=<version>]
設定時、現在どのバージョンがインストールされているかにかかわらず、最新の開発バージョンに更新する。

[–dry-run]
どのプラグインが更新されるのかをプレビューする。

使用例

wp plugin update bbpress --version=dev
wp plugin update --all

投稿を新規作成する。

オプション

[<file>]
<file>から投稿の本文を読み込む。この値が指定されているとき、–post_content引数は無視する。ファイル名として ‘-‘ を渡すと標準入力から投稿本文を読み込む。

[–<field>=<value>]
作成する投稿に関する連想配列。wp_insert_post()参照。

[–edit]
投稿の本文を編集するためにシステムのエディタを開く。本文がファイル、標準出力、または–post_contentで与えられたときには、それをエディタ内に読み込む。

[–porcelain]
新しい投稿のIDのみを出力する。

使用例

wp post create --post_type=page --post_status=publish --post_title='A future post' --post-status=future --post_date='2020-12-01 07:00:00'
wp post create ./post-content.txt --post_category=201,345 --post_title='Post from file'

IDで指定した投稿を削除する。

オプション

<id> …
削除する投稿のID。複数指定可。

[–force]
ゴミ箱をスキップする。

使用例

wp post delete 123 --force
wp post delete $(wp post list --post_type'page' --format=ids)

投稿の本文を編集する。

オプション

<id> …
編集する投稿のID。複数指定可。

使用例

wp post edit 123

複数の投稿を生成する。

オプション

[–count=<number>]
生成する投稿の数。デフォルトは100。

[–post_type=<type>]
生成する投稿のタイプ。デフォルトは ‘post’。

[–post_status=<status>]
生成する投稿の状態。デフォルトは ‘publish’。

[–post_author=<login>]
生成する投稿の著者。デフォルトはnone。

[–post_date=<yyyy-mm-dd>]
生成する投稿の日時。デフォルトは現在時刻。

[–post_content]
指定時、投稿の本文を標準入力から読み込む。

[–max_depth=<number>]
階層的な投稿タイプの場合、子の投稿を作成する深さの最大値を指定。デフォルトは1。

使用例

wp post generate --count=10 --post_type=page --post_date=1999-01-04
curl http://oripsum.net/api/5 | wp post generate --post_content --count=10

IDで指定した投稿の本文を取得する。

オプション

<id>
取得する投稿のID。

[–field=<field>]
投稿全体を返す代わりに、指定したフィールドのみを返す。

[–format=<format>]
指定可能な値はtable、json。デフォルトはtable。

使用例

# 投稿の本文をファイルに保存
wp post get 12 --field=content > file.txt

投稿の一覧を取得する。

オプション

[–<field>=<value>]
WP_Queryに渡す引数。複数指定可。

[–field=<field>]
それぞれの投稿の指定したフィールドを表示。

[–fields=<fields>]
指定したフィールドのみ表示する。デフォルトはID, post_tytle, post_name, post_date, post_status。

[–format=<format>]
指定可能な値はtable、csv、json、count、ids。デフォルトはtable。

使用例

wp post list --field=ID
wp post list --post_type=post --posts_per_page=5 --format=json
wp post list --post_type=page --fields=post_tytoe,post_status
wp post list --post_type=page,post --format=ids

投稿のカスタムフィールドを管理する。

オプション

[–format=json]
値をJSONでエンコード/デコードする。

使用例

wp post meta set 123 _wp_page_template about.php

サブコマンド

• add – カスタムフィールドを追加
  <id>
  オブジェクトのID。
  <key>
  作成するカスタムフィールド名。
  [<value>]
  カスタムフィールドの値。省略時には標準入力から読み込む。
  [–format=<format>]
  値のシリアル化形式。デフォルトはplaintext。
• delete – カスタムフィールドを削除
• get – カスタムフィールドの値を取得
• update – カスタムフィールドを更新
  <id>
  オブジェクトのID。
  <key>
  作成するカスタムフィールド名。
  [<value>]
  カスタムフィールドの値。省略時には標準入力から読み込む。
  [–format=<format>]
  値のシリアル化形式。デフォルトはplaintext。

投稿を更新する。複数更新可。

オプション

<id> …
更新する投稿のID。複数指定可。

–<field>=<value>
更新するフィールド。wp_update_post()参照。

使用例

wp post update 123 --post_name=something --post_status=draft

投稿のURLを取得する。

オプション

<id> …
URLを取得する投稿のID。複数指定可。

使用例

wp post url 123
wp post url 123 324

rewrite ruleをフラッシュする。

オプション

[–hard]
ハード的にフラッシュする。すなわち、データベース内部のrewriteルールと同時に.htaccessのルールも更新する。

現在のrewriteルールを表示する。

オプション

[–match=<url>]
指定したURLに合うrewriteルールを表示。

[–source=<source>]
指定したソースのrewriteルールを表示。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp rewrite list --format=csv

permalink構造を更新する。

オプション

<permastruct>
適用するpermalink構造。

[–category-base=<base>]
カテゴリpermalinkのベース（i.e. ‘/category/’）を指定する。

[–tag-base=<base>]
タグpermalinkのベース（i.e. ‘/tag/’）を指定する。

[–hard]
ハード的にフラッシュする。すなわち、データベース内部のrewriteルールと同時に.htaccessのルールも更新する。

使用例

wp rewrite structure '/%year%/%monthnum%/%postname%'

新しい権限グループを作成する。

オプション

<role-key>
権限グループの内部的な名前。

<role-name>
権限グループの表示用の名前。

使用例

wp role create approver Approver
wp role create productadmin "Product Administrator"

既存の権限グループを削除する。

オプション

<role-key>
削除する権限グループの内部名。

使用例

wp role delete approver
wp rolse delete productadmin

指定された権限グループが存在するか確認する。存在すれば0、存在しなければ1を返す。

オプション

<role-key>
存在を確認する権限グループの内部名。

使用例

wp role exists editor

権限グループの一覧を表示する。

オプション

[–fields=<fields>]
指定したフィールドのみを表示する。デフォルトはname,role。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp role list --fields=role --format=csv

デフォルトの権限グループの権限を初期化する。

オプション

[<role-key> …]
初期化する権限グループの内部名。複数指定可。

[–all]
指定時、すべてのデフォルト権限グループを初期化する。

使用例

wp role exists editor

テーマのひな形コードを生成する。

オプション

<slug>
新しいテーマのスラグ。関数名のプレフィクスとして使用する。

[–activate]
新しくダウンロードしたテーマを有効化する。

[–theme_name=<title>]
style.cssの ‘Theme Name:’ ヘッダに設定する値。

[–author=<full-name>]
style.cssの ‘Author:’ ヘッダに設定する値。

[–author_uri=<uri>]
style.cssの ‘Author URI:’ ヘッダに設定する値。

空の子テーマを生成する。

オプション

<slug>
新しい子テーマのスラグ。

–parent_theme=<slug>
style.cssの ‘Template:’ ヘッダに設定する値。

[–theme_name=<title>]
style.cssの ‘Theme Name:’ ヘッダに設定する値。

[–author=<full-name>]
style.cssの ‘Author:’ ヘッダに設定する値。

[–author_uri=<uri>]
style.cssの ‘Author URI:’ ヘッダに設定する値。

[–theme_uri=<uri>]
style.cssの ‘Theme URI:’ ヘッダに設定する値。

[–activate]
新しくダウンロードしたテーマを有効化する。

pluginのひな形コードを生成する。

オプション

<slug>
プラグインの内部名。

[–plugin_name=<title>]
‘Plugin Name:’ ヘッダに設定する値。

[–skip-tests]
単体テスト用のファイルを生成しない。

[–activate]
新しく作成したプラグインを有効化する。

PHPUnitを使ったテストに必要なPHPコードを生成する。作成するファイルは次のとおり。

• phpunit.xml – PHPUnitのためのコンフィグファイル
• .travis.yml – Travis CIのためのコンフィグファイル
• tests/bootstrap.php – テストスイートを走らせたときに現在のプラグインを有効化するためのファイル
• tests/test-sample.php – 実際のテスト内容を含むサンプルファイル

環境変数

tests/bootstrap.php ファイルは WP_TESTS_DIR 環境変数を参照する。

オプション

<slug>
テスト用のファイルを生成するプラグインの内部名。

使用例

wp scaffold plugin-tests hello

カスタム投稿型を登録するためのPHPコードを生成する。

オプション

<slug>
カスタム投稿型の内部名。

[–label=<label>]
更新メッセージの翻訳に使用するテキスト。

[–textdomain=<textdomain>]
ラベルに使用するtextdomain。

[–theme]
標準出力に出力するかわりに、現在有効化されているテーマのディレクトリにファイルを生成する。–theme=<theme> と指定すると、指定したテーマのディレクトリにファイルを生成する。

[–plugin=<plugin>]
標準出力に出力するかわりに、指定したプラグインのディレクトリにファイルを生成する。

[–raw]
register_post_type()コールのみを生成する。

カスタムタクソノミーを登録するためのPHPコードを生成する。

オプション

<slug>
カスタムタクソノミーの内部名。

[–post_types=<post-types>]
タクソノミーを登録する投稿型。

[–label=<label>]
更新メッセージの翻訳に使用するテキスト。

[–textdomain=<textdomain>]
ラベルに使用するtextdomain。

[–theme]
標準出力に出力するかわりに、現在有効化されているテーマのディレクトリにファイルを生成する。–theme=<theme> と指定すると、指定したテーマのディレクトリにファイルを生成する。

[–plugin=<plugin>]
標準出力に出力するかわりに、指定したプラグインのディレクトリにファイルを生成する。

[–raw]
register_taxonomy()コールのみを生成する。

登録されているサイドバーを一覧表示。

オプション

[–fields=<fields>]
指定されたフィールドのみ出力する。デフォルトはname,id,description。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp sidebar list --fields=name,id --format=csv

マルチサイトにサイトをインストールする。

オプション

–slug=<slug>
新しいサイトへのpath。サブドメイン型の場合にはサブドメイン、サブディレクトリ型の場合にはサブディレクトリ。

–title=<title>
新しいサイトのタイトル。デフォルトはスラグに指定された値。

–email=<email>
管理者ユーザーの電子メールアドレス。ユーザーが存在しなければ作成する。含まれていなければSuper Adminに割り当てる。（？）

–network_id=<network-id>
新しいサイトを作成するネットワーク。デフォルトはカレントネットワーク。（だいたいの場合は1）

–private
指定時、新しいサイトは非公開（インデックス対象としない）とする。

–porcelain
作成できたサイトのIDのみを表示する。

マルチサイトからサイトを削除する。

オプション

[<site-id>]
削除するサイトのID。IDを指定しない場合には、–slug引数で指定する。

[–slug=<slug>]
削除するブログへのpath。サブドメイン型の場合にはサブドメイン、サブディレクトリ型の場合にはサブディレクトリ。

[–yes]
確認メッセージにyesと答える。

[–keep-tables]
具ログを一覧から削除するが、テーブルはdropしない。

サイトの中身を空にする。（投稿、コメント、タグ）

オプション

[–yes]
確認メッセージにyesと答える。

マルチサイトにインストールされているサイトの一覧を表示する。

オプション

[–network=<id>]
サイトの属しているネットワーク。

[–field=<field>]
指定したフィールドのみを表示。

[–fields=<fields>]
カンマ区切りで指定したフィールドのみ表示。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

# サイトURLのみの一覧を作成
wp site list --field=url

サイトのURLを取得する。

オプション

<id> …
URLを取得したいサイトのID。複数指定可。

使用例

wp site url 123

特権管理者権限をユーザーに与える。

オプション

<user> …
特権管理者権限を与えるユーザーのID、電子メールアドレス、またはログイン名。

特権からスーパー管理者権限を剥奪する。

オプション

<user> …
特権管理者権限を剥奪するユーザーのID、電子メールアドレス、またはログイン名。

タームを作成する。

オプション

<taxonomy>
新しくタームを作成するタクソノミー。

<term>
新しく作成するタームの名前。

[–slug=<slug>]
新しいタームのユニークなスラグ。デフォルトでは名前をサニタイズしたもの。

[–description=<description>]
作成するタームの説明。

[–parent=<term-id>]
作成するタームの親。

[–porcelain]
新しいタームのIDのみを表示する。

使用例

wp term create category Apple --description="A type of fruit"

タームを削除する。

オプション

<taxonomy>
タームを削除するタクソノミー。

<term-id> …
削除するタームのID。複数指定可。

使用例

# すべての投稿タグを削除
wp term list post_tag --field=ID | xargs wp term delete post_tag

複数のタームを生成する。

オプション

<taxonomy>
タームを作成するタクソノミー。

[–count=<number>]
作成するタームの数。デフォルトでは100。

[–max_depth=<number>]
指定された深さまでの子タームを作成する。デフォルトは1。

使用例

wp term generate --count=10

タクソノミータームを取得する。

オプション

<taxonomy>
タームを取得するタクソノミー。

[–field=<field>]
指定したフィールドのみ出力する。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp term get category 1 --format=json

タクソノミー中のタームを一覧表示する。

オプション

<taxonomy>
指定したタクソノミーのタームを一覧表示。

[–<field>=<value>]
指定したフィールドでフィルタする。指定可能なフィールドについてはget_terms()参照。

[–field=<field>]
指定したフィールドのみ出力する。単体指定。

[–fields=<fields>]
指定したフィールドのみ出力する。複数指定。デフォルトはタームのすべてのフィールド。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp term list category --format=csv
wp term list post_tag --fields=name,slug

タームを更新する。

オプション

<taxonomy>
タームを更新するタクソノミー。

<term-id>
更新するタームのID。

[–name=<name>]
タームの名前。

[–slug=<slug>]
タームのスラグ。

[–description=<description>]
タームの説明。

[–parent=<term-id>]
親とするタームのID。

使用例

wp term update category 15 --name=Apple

タームのURLを取得する。

オプション

<taxonomy>
URLを取得したいタームのタクソノミー。

<term-id> …
URLを取得するするタームのID。複数指定可。

使用例

wp term url post_tag 123
wp term url post_tag 123 324

テーマを有効化する。

オプション

<theme>
有効化するテーマ。

テーマを削除する。

オプション

<theme> …
削除するテーマ。複数指定可。

使用例

wp theme delete twentyeleven

マルチサイトの中のテーマを無効化する。

オプション

<theme>
無効化するテーマ。

[–network]
指定時、ネットワークレベルで無効化する。ただし、サイトで個別に有効化していればそのサイトでは有効。

使用例

wp theme disable twentythirteen
wp theme disable twentythirteen --network

マルチサイトの中のテーマを有効化する。

オプション

<theme>
有効化するテーマ。

[–network]
指定時、ネットワークレベルで有効化する。

[–activate]
指定時、カレントサイトで指定されたテーマを有効化する。–networkフラグはこの設定と無関係であることに注意。

使用例

wp theme enable twentythirteen
wp theme enable twentythirteen --network
wp theme enable twentythirteen --activate

テーマを取得する。

オプション

<theme>
取得するするテーマ。

[–field=<field>]
指定したフィールドのみ表示する。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp theme get twentytwelve --format=json

テーマをインストールする。

オプション

<theme|zip|url>
インストール取得するテーマのスラグ、ローカルなzipファイルまたはネットワーク上のURL。

[–version=<version>]
wordpress.orgから指定したバージョンを取得。省略時には安定バージョンを取得する。

[–force]
確認のプロンプトを出さずにインストール済みのテーマを上書きする。

[–activate]
テーマをインストールした後すぐに有効化する。

使用例

# wordpress.orgから最新版をインストールして有効化
wp theme install twentytwelve --activate

# ローカルなzipファイルからインストール
wp theme install ../my-theme.zip

# ネットワーク上のzipファイルからインストール
wp theme install http://s3.amazonaws.com/bucketname/my-theme.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef

テーマがインストールされているか確認する。

オプション

<theme>
確認するテーマ。

使用例

wp theme is-installed twentytwelve

テーマの一覧を取得する。

オプション

[–<field>=<value>]
指定したフィールドと値でフィルタする。

[—field=<field>]
指定したフィールドのみ表示する。単体指定。

[–fields=fields>]
指定したフィールドのみ表示する。複数指定。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp theme list --status=inactive --format=csv

テーマの設定情報を管理する。

サブコマンド

• get – テーマの設定情報を一覧表示
  [<mod> …]
  表示する設定。複数指定可。
  [–all]
  すべての設定を表示。
  [–format=<format>]
  指定可能な値はtable、csv、json、count。デフォルトはtable。
  

  使用例

  wp theme mod get --all
  wp theme mod get background_color --format=json
  wp theme mod get background_color header_textcolor

• remove – テーマの設定情報を削除
  [<mod> …]
  削除する設定。複数指定可。
  [–all]
  すべての設定を削除。
  

  使用例

  wp theme mod remove --all
  wp theme mod remove background_color --format=json
  wp theme mod remove background_color header_textcolor

• set – テーマの設定情報を設定
  <mod>
  新しく設定、または値を更新する設定の名前。
  <value>
  設定する値。
  

  使用例

  wp theme mod set background_color 000000

テーマまたはテーマディレクトリへのpathを取得する。

オプション

[<theme>]
pathを取得するテーマ。style.cssファイルをpathに含む。省略時には、テーマディレクトリへのpathを表示する。

[–dir]
指定時に、指定したテーマのstyle.cssのかわりに、そのファイルの置かれているディレクトリを表示する。

使用例

cd $(wp theme path)

wordpress.orgテーマリポジトリを検索する。

オプション

<search>
検索語。

[–per-page=<per-page>]
表示する結果の数。デフォルトでは10。

[–field=<field>]
指定したフィールドのみ表示。単体指定。

[–fields=<fields>]
指定したフィールドのみ表示。複数指定。デフォルトではname,slug,author,rating。指定可能な値は次のとおり。

• name – テーマの名前
• slug – テーマのスラグ
• version – 現在のバージョン番号
• author – 作者名
• preview_url – プレビューのURL
• screenshot_url – スクリーンショットのURL
• rating – テーマの評価
• homepage – テーマ作者のホームページ
• description – テーマの説明

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp theme search automattic --per-page=20
wp theme search automattic -fields=name,version,slug,rating,num_ragings<description

テーマの状態を表示する。

オプション

[<theme>]
状態を表示したいテーマ。指定がなければすべてのテーマの状態を表示。

テーマを更新する。

オプション

[<theme> …]
更新するテーマ。複数指定可。

[–all]
新しいヴァージョンが出ているすべてのテーマを更新。

[–version=<version>]
現在インストールされているテーマのバージョンにかかわらず、最新の開発バージョンにアップデート。

[–dry-run]
どのテーマがアップデートされるのかをプレビュー。

使用例

wp theme update twentyeleven twentytwelve
wp theme update --all

ユーザーに権限を追加する。

オプション

<user>
ユーザーID、ユーザーの電子メールアドレス、またはログインユーザー名。

<cap>
追加する権限。

使用例

wp user add-cap john create_premium_item
wp user add-cap 15 edit_product

ユーザーに権限グループを追加する。

オプション

<user>
ユーザーID、ユーザーの電子メールアドレス、またはログインユーザー名。

<role>
追加する権限グループ。

使用例

wp user add-role bob author
wp user add-role 12 author

オプション

<user-login>
新規追加するユーザーのログイン名。

<user-email>
新規追加するユーザーの電子メールアドレス。

[–role=<role>]
新規追加するユーザーの権限グループ。デフォルトはrole。

[–user_pass=<password>]
ユーザーのパスワード。デフォルトはランダムに生成された値。

[–user_registered=<yyyy-mm-dd>]
ユーザー登録の日時。デフォルトは現在時刻。

[–display_name=<name>]
ユーザーの表示用の名前。

[–send-email]
指定時、ユーザーにアカウント情報を記したメールを送信。

[–porcelain]
新規追加されるユーザーのIDのみを出力。

使用例

wp user create bob bob@example.com --role=author

ユーザーを削除する。複数指定可。

オプション

<user>
削除するユーザーのID、電子メールアドレス、またはログイン名。

[–network]
マルチサイトにおいて、ネットワーク全体からユーザーを削除。

[–reassign=<user-id>]
投稿を割り当てるユーザーID。

[–yes]
すべての確認プロンプトにyesと答える。

使用例

# ユーザー123を削除し、その投稿をすべてユーザー567に割り当てる
wp user delete 123 --reassign=567

複数ユーザーをまとめて生成する。

オプション

[–count=<number>]
何人分のユーザーを生成するか。デフォルトでは100。

[–role=<role>]
生成するユーザーの権限グループ。デフォルトは、WordPressでデフォルトとしている権限グループ。

ひとりのユーザー情報を取得する。

オプション

<user>
ユーザーID、ユーザーの電子メールアドレス、またはログインユーザー名。

[–field=<field>]
指定したフィールドのみ表示する。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp user get 123 --field=login
wp user get bob --format=json > bob.json

CSVファイルからユーザーをインポートする。

オプション

<file>
ユーザーをインポートするCSVファイル。

[–send-email]
指定時、新規登録されたユーザーにアカウント情報を電子メールで送信。

使用例

wp user import-csv /path/to/users.csv

users.csvのサンプル

user_login,user_email,display_name,role
bobjones,bobjones@domain.com,Bob Jones,contributor
newuser1,newuser1@domain.com,New User,author
existinguser,existinguser@domain.com,Existing User,administrator

ユーザーを一覧表示する。

オプション

[–role=<role>]
指定の権限グループのユーザーのみ表示。

[–<field>=<value>]
指定したフィールドの値により結果をフィルタする。指定可能なフィールドについてはget_users()参照。

[–field=<field>]
指定したフィールドの値のみ表示。単体指定。

[–fields=<fields>]
指定したフィールドの値のみ表示。複数指定。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp user list --field=ID
wp user list --role=administrator --format=csv
wp user list --fields=display_name,user_email --format=json

ユーザーのすべての権限を表示する。

オプション

<user>
表示するユーザーのID、電子メールアドレス、またはログイン名。

使用例

wp user list-caps admin
wp user list-caps 21

ユーザーのカスタムフィールドを管理する。

オプション

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp user meta set 123 description "Mary is WordPress developer."
wp user meta update admin first_name "George"

サブコマンド

• add – カスタムフィールドを追加
  <user>
  カスタムフィールドを追加するユーザーのID、電子メールアドレス、またはログイン名。
  <key>
  カスタムフィールドのキー。
  <value>
  カスタムフィールドの値。
• delete – カスタムフィールドを削除
  <user>
  カスタムフィールドを削除するユーザーのID、電子メールアドレス、またはログイン名。
  <key>
  カスタムフィールドのキー。
• get – カスタムフィールドの値を表示
  <user>
  カスタムフィールドを取得するユーザーのID、電子メールアドレス、またはログイン名。
  <key>
  カスタムフィールドのキー。
  [–format=<format>]
  指定可能な値はtable、csv、json、count。デフォルトはtable。
• update – カスタムフィールドの値を更新
  <user>
  カスタムフィールドを更新するユーザーのID、電子メールアドレス、またはログイン名。
  <key>
  カスタムフィールドのキー。
  <value>
  カスタムフィールドの値。

ユーザーの権限を削除する。

オプション

<user>
権限を削除するユーザーのID、電子メールアドレス、またはログイン名。

<cap>
削除する権限。

使用例

wp user remove-cap bob edit_themes
wp user remove-cap 11 publish_newsletters

ユーザーの権限グループを削除する。

オプション

<user>
権限グループを削除するユーザーのID、電子メールアドレス、またはログイン名。

[<role>]
削除する権限グループ。

使用例

wp user remove-role bob
wp user remove-role 12 editor

特定のブログでのユーザーの権限グループを設定する。

オプション

<user>
権限グループを設定するユーザーのID、電子メールアドレス、またはログイン名。

[<role>]
ユーザーに割り当てる権限グループ。省略時にはデフォルトの権限グループを割り当て。

使用例

wp user set-role bob author
wp user set-role 12 author

ユーザー情報を更新する。

オプション

<user> …
情報を更新するユーザーのID、電子メールアドレス、またはログイン名。

–<field>=<value>
更新するフィールド。複数指定可。指定可能なフィールドについては、wp_update_user()参照。

使用例

wp user update 123 --display_name=Mary --user_pass=marypass

サイドバーにウィジェットを追加する。

オプション

<name>
ウィジェット名。

<sidebar-id>
関連付けるサイドバーのＩＤ。

[<position>]
サイドバー上の位置。デフォルトはlast。

[–<field>=<value>]
追加するウィジェットのオプションと設定値。複数指定可。

使用例

wp widget add calendar sidebar-1 2 --title="Calendar"

有効化されているサイドバーからウィジェットを無効化する。

オプション

<widget-id> …
ウィジェットのユニークID。複数指定可。

使用例

wp widget deactivate recent-comments-2

サイドバーからウィジェットを削除する。

オプション

<widget-id> …
ウィジェットのユニークID。複数指定可。

使用例

wp widget delete recent-comments-2

サイドバーに関連付けられているウィジェットを一覧表示する。

オプション

<sidebar-id>
一覧表示したいサイドバーのID。

[–fields=<fields>]
指定したフィールドのみ表示する。デフォルトはname, id, description。

[–format=<format>]
指定可能な値はtable、csv、json、count。デフォルトはtable。

使用例

wp widget list <sidebar-id> --fields=name --format=csv

サイドバー上のウィジェットの位置を移動する。

オプション

<widget-id>
ウィジェットのユニークID。

[–position=<position>]
新しい位置を割り当て。

[–sidebar-id=<sidebar-id>]
新しいサイドバーに割り当て。

使用例

wp wiedget move recent-comment-2 --position=2
wp widget move recent-comments-2 --sidebar-id=wp_inactive_widgets

指定したウィジェットのオプションを更新する。

オプション

<widget-id>
ウィジェットのユニークID。

[–<field>=<value>]
更新するウィジェットのオプションと設定値。複数指定可。

使用例

wp wiedget update calendar-1 --title="Calendar"