@@ -264,7 +264,7 @@ wp widget patch <action> <widget-id> <key-path>... [<value>] [--format=<format>]
264264Resets sidebar.
265265
266266~~~
267- wp widget reset [<sidebar-id>...] [--all]
267+ wp widget reset [<sidebar-id>...] [--all] [--inactive]
268268~~~
269269
270270Removes 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.
277277 [--all]
278278 If set, all sidebars will be reset.
279279
280+ [--inactive]
281+ If set, all inactive sidebars will also be reset, in addition to any sidebars specified via <sidebar-id>... or selected with --all.
282+
280283** EXAMPLES**
281284
282285 # Reset a sidebar
283286 $ wp widget reset sidebar-1
284- Success: Sidebar 'sidebar-1' reset.
287+ Sidebar 'sidebar-1' reset.
285288
286289 # Reset multiple sidebars
287290 $ wp widget reset sidebar-1 sidebar-2
288- Success: Sidebar 'sidebar-1' reset.
289- Success: Sidebar 'sidebar-2' reset.
291+ Sidebar 'sidebar-1' reset.
292+ Sidebar 'sidebar-2' reset.
290293
291294 # Reset all sidebars
292295 $ wp widget reset --all
293- Success: Sidebar 'sidebar-1' reset.
294- Success: Sidebar 'sidebar-2' reset.
295- Success: Sidebar 'sidebar-3' reset.
296+ Sidebar 'sidebar-1' reset.
297+ Sidebar 'sidebar-2' reset.
298+ Sidebar 'sidebar-3' reset.
299+
300+ # Reset all inactive sidebars
301+ $ wp widget reset --inactive
302+ Sidebar 'old-sidebar-1' reset.
296303
297304
298305
@@ -401,11 +408,14 @@ wp sidebar get <id> [--fields=<fields>] [--format=<format>]
401408Lists registered sidebars.
402409
403410~~~
404- wp sidebar list [--fields=<fields>] [--format=<format>]
411+ wp sidebar list [--inactive] [-- fields=<fields>] [--format=<format>]
405412~~~
406413
407414** OPTIONS**
408415
416+ [--inactive]
417+ If set, only inactive sidebars will be listed.
418+
409419 [--fields=<fields>]
410420 Limit the output to specific object fields.
411421
@@ -445,6 +455,10 @@ These fields are optionally available:
445455 "Widget Area",sidebar-1
446456 "Inactive Widgets",wp_inactive_widgets
447457
458+ $ wp sidebar list --inactive --fields=id --format=csv
459+ id
460+ old-sidebar-1
461+
448462## Installing
449463
450464This package is included with WP-CLI itself, no additional installation necessary.
0 commit comments