diff --git a/README.md b/README.md index 7d0820a6..90233c93 100644 --- a/README.md +++ b/README.md @@ -264,7 +264,7 @@ wp widget patch ... [] [--format=] Resets sidebar. ~~~ -wp widget reset [...] [--all] +wp widget reset [...] [--all] [--inactive] ~~~ Removes all widgets from the sidebar and places them in Inactive Widgets. @@ -277,22 +277,29 @@ Removes all widgets from the sidebar and places them in Inactive Widgets. [--all] If set, all sidebars will be reset. + [--inactive] + If set, all inactive sidebars will also be reset, in addition to any sidebars specified via ... or selected with --all. + **EXAMPLES** # Reset a sidebar $ wp widget reset sidebar-1 - Success: Sidebar 'sidebar-1' reset. + Sidebar 'sidebar-1' reset. # Reset multiple sidebars $ wp widget reset sidebar-1 sidebar-2 - Success: Sidebar 'sidebar-1' reset. - Success: Sidebar 'sidebar-2' reset. + Sidebar 'sidebar-1' reset. + Sidebar 'sidebar-2' reset. # Reset all sidebars $ wp widget reset --all - Success: Sidebar 'sidebar-1' reset. - Success: Sidebar 'sidebar-2' reset. - Success: Sidebar 'sidebar-3' reset. + Sidebar 'sidebar-1' reset. + Sidebar 'sidebar-2' reset. + Sidebar 'sidebar-3' reset. + + # Reset all inactive sidebars + $ wp widget reset --inactive + Sidebar 'old-sidebar-1' reset. @@ -401,11 +408,14 @@ wp sidebar get [--fields=] [--format=] Lists registered sidebars. ~~~ -wp sidebar list [--fields=] [--format=] +wp sidebar list [--inactive] [--fields=] [--format=] ~~~ **OPTIONS** + [--inactive] + If set, only inactive sidebars will be listed. + [--fields=] Limit the output to specific object fields. @@ -445,6 +455,10 @@ These fields are optionally available: "Widget Area",sidebar-1 "Inactive Widgets",wp_inactive_widgets + $ wp sidebar list --inactive --fields=id --format=csv + id + old-sidebar-1 + ## Installing This package is included with WP-CLI itself, no additional installation necessary.