Skip to content

Commit d5faa8f

Browse files
Regenerate README file - 2026-03-17 (#76)
Co-authored-by: Alain Schlesser <alain.schlesser@gmail.com>
1 parent 67bb805 commit d5faa8f

1 file changed

Lines changed: 22 additions & 8 deletions

File tree

README.md

Lines changed: 22 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -264,7 +264,7 @@ wp widget patch <action> <widget-id> <key-path>... [<value>] [--format=<format>]
264264
Resets sidebar.
265265

266266
~~~
267-
wp widget reset [<sidebar-id>...] [--all]
267+
wp widget reset [<sidebar-id>...] [--all] [--inactive]
268268
~~~
269269

270270
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.
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>]
401408
Lists 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

450464
This package is included with WP-CLI itself, no additional installation necessary.

0 commit comments

Comments
 (0)