Merge branch 'main' into fix/363

Author: swissspidy

.github/workflows/testing.yml

@@ -1,6 +1,7 @@
 name: Testing
 
 on:
+  workflow_dispatch:
   pull_request:
   push:
     branches:

README.md

@@ -86,6 +86,18 @@ wp plugin activate [<plugin>...] [--all] [--exclude=<name>] [--network]
     Plugin 'hello' network activated.
     Success: Network activated 1 of 1 plugins.
 
+    # Activate plugins that were recently active.
+    $ wp plugin activate $(wp plugin list --recently-active --field=name)
+    Plugin 'bbpress' activated.
+    Plugin 'buddypress' activated.
+    Success: Activated 2 of 2 plugins.
+
+    # Activate plugins that were recently active on a multisite.
+    $ wp plugin activate $(wp plugin list --recently-active --field=name) --network
+    Plugin 'bbpress' network activated.
+    Plugin 'buddypress' network activated.
+    Success: Activated 2 of 2 plugins.
+
 
 
 ### wp plugin deactivate
@@ -197,10 +209,28 @@ wp plugin get <plugin> [--field=<field>] [--fields=<fields>] [--format=<format>]
 		  - yaml
 		---
 
+**AVAILABLE FIELDS**
+
+These fields will be displayed by default for the plugin:
+
+* name
+* title
+* author
+* version
+* description
+* status
+
+These fields are optionally available:
+
+* requires_wp
+* requires_php
+* requires_plugins
+
 **EXAMPLES**
 
+    # Get plugin details.
     $ wp plugin get bbpress --format=json
-    {"name":"bbpress","title":"bbPress","author":"The bbPress Contributors","version":"2.6-alpha","description":"bbPress is forum software with a twist from the creators of WordPress.","status":"active"}
+    {"name":"bbpress","title":"bbPress","author":"The bbPress Contributors","version":"2.6.9","description":"bbPress is forum software with a twist from the creators of WordPress.","status":"active"}
 
 
 
@@ -209,7 +239,7 @@ wp plugin get <plugin> [--field=<field>] [--fields=<fields>] [--format=<format>]
 Installs one or more plugins.
 
 ~~~
-wp plugin install <plugin|zip|url>... [--version=<version>] [--force] [--activate] [--activate-network] [--insecure]
+wp plugin install <plugin|zip|url>... [--version=<version>] [--force] [--ignore-requirements] [--activate] [--activate-network] [--insecure]
 ~~~
 
 **OPTIONS**
@@ -225,6 +255,10 @@ wp plugin install <plugin|zip|url>... [--version=<version>] [--force] [--activat
 		If set, the command will overwrite any installed version of the plugin, without prompting
 		for confirmation.
 
+[--ignore-requirements]
+:If set, the command will install the plugin while ignoring any WordPress or PHP version requirements
+specified by the plugin authors.
+
 	[--activate]
 		If set, the plugin will be activated immediately after install.
 
@@ -322,7 +356,7 @@ Returns exit code 0 when installed, 1 when uninstalled.
 Gets a list of plugins.
 
 ~~~
-wp plugin list [--<field>=<value>] [--field=<field>] [--fields=<fields>] [--format=<format>] [--status=<status>] [--skip-update-check]
+wp plugin list [--<field>=<value>] [--field=<field>] [--fields=<fields>] [--format=<format>] [--status=<status>] [--skip-update-check] [--recently-active]
 ~~~
 
 Displays a list of the plugins installed on the site with activation
@@ -367,6 +401,9 @@ Use `--status=dropin` to list installed dropins (e.g. `object-cache.php`).
 	[--skip-update-check]
 		If set, the plugin update check will be skipped.
 
+	[--recently-active]
+		If set, only recently active plugins will be shown and the status filter will be ignored.
+
 **AVAILABLE FIELDS**
 
 These fields will be displayed by default for each plugin:
@@ -376,6 +413,7 @@ These fields will be displayed by default for each plugin:
 * update
 * version
 * update_version
+* auto_update
 
 These fields are optionally available:
 
@@ -384,29 +422,48 @@ These fields are optionally available:
 * title
 * description
 * file
-* auto_update
 * author
+* tested_up_to
+* requires
+* requires_php
+* wporg_status
+* wporg_last_updated
 
 **EXAMPLES**
 
     # List active plugins on the site.
     $ wp plugin list --status=active --format=json
-    [{"name":"dynamic-hostname","status":"active","update":"none","version":"0.4.2","update_version": ""},{"name":"tinymce-templates","status":"active","update":"none","version":"4.4.3","update_version": ""},{"name":"wp-multibyte-patch","status":"active","update":"none","version":"2.4","update_version": ""},{"name":"wp-total-hacks","status":"active","update":"none","version":"2.0.1","update_version": ""}]
+    [{"name":"dynamic-hostname","status":"active","update":"none","version":"0.4.2","update_version":"","auto_update":"off"},{"name":"tinymce-templates","status":"active","update":"none","version":"4.8.1","update_version":"","auto_update":"off"},{"name":"wp-multibyte-patch","status":"active","update":"none","version":"2.9","update_version":"","auto_update":"off"},{"name":"wp-total-hacks","status":"active","update":"none","version":"4.7.2","update_version":"","auto_update":"off"}]
 
     # List plugins on each site in a network.
     $ wp site list --field=url | xargs -I % wp plugin list --url=%
-    +---------+----------------+--------+---------+----------------+
-    | name    | status         | update | version | update_version |
-    +---------+----------------+--------+---------+----------------+
-    | akismet | active-network | none   | 3.1.11  |                |
-    | hello   | inactive       | none   | 1.6     | 1.7.2          |
-    +---------+----------------+--------+---------+----------------+
-    +---------+----------------+--------+---------+----------------+
-    | name    | status         | update | version | update_version |
-    +---------+----------------+--------+---------+----------------+
-    | akismet | active-network | none   | 3.1.11  |                |
-    | hello   | inactive       | none   | 1.6     | 1.7.2          |
-    +---------+----------------+--------+---------+----------------+
+    +---------+----------------+-----------+---------+-----------------+------------+
+    | name    | status         | update    | version | update_version | auto_update |
+    +---------+----------------+-----------+---------+----------------+-------------+
+    | akismet | active-network | none      | 5.3.1   |                | on          |
+    | hello   | inactive       | available | 1.6     | 1.7.2          | off         |
+    +---------+----------------+-----------+---------+----------------+-------------+
+    +---------+----------------+-----------+---------+----------------+-------------+
+    | name    | status         | update    | version | update_version | auto_update |
+    +---------+----------------+-----------+---------+----------------+-------------+
+    | akismet | active-network | none      | 5.3.1   |                | on          |
+    | hello   | inactive       | available | 1.6     | 1.7.2          | off         |
+    +---------+----------------+-----------+---------+----------------+-------------+
+
+    # Check whether plugins are still active on WordPress.org
+    $ wp plugin list --fields=name,wporg_status,wporg_last_updated
+    +--------------------+--------------+--------------------+
+    | name               | wporg_status | wporg_last_updated |
+    +--------------------+--------------+--------------------+
+    | akismet            | active       | 2023-12-11         |
+    | user-switching     | active       | 2023-11-17         |
+    | wordpress-importer | active       | 2023-04-28         |
+    | local              |              |                    |
+    +--------------------+--------------+--------------------+
+
+    # List recently active plugins on the site.
+    $ wp plugin list --recently-active --field=name --format=json
+    ["akismet","bbpress","buddypress"]
 
 
 
@@ -750,6 +807,7 @@ See the WordPress [Theme Handbook](https://developer.wordpress.org/themes/) deve
     Theme installed successfully.
     Activating 'twentysixteen'...
     Success: Switched to 'Twenty Sixteen' theme.
+    Success: Installed 1 of 1 themes.
 
     # Get details of an installed theme
     $ wp theme get twentysixteen --fields=name,title,version
@@ -941,7 +999,7 @@ wp theme get <theme> [--field=<field>] [--fields=<fields>] [--format=<format>]
 Installs one or more themes.
 
 ~~~
-wp theme install <theme|zip|url>... [--version=<version>] [--force] [--activate] [--insecure]
+wp theme install <theme|zip|url>... [--version=<version>] [--force] [--ignore-requirements] [--activate] [--insecure]
 ~~~
 
 **OPTIONS**
@@ -957,6 +1015,10 @@ wp theme install <theme|zip|url>... [--version=<version>] [--force] [--activate]
 		If set, the command will overwrite any installed version of the theme, without prompting
 		for confirmation.
 
+	[--ignore-requirements]
+		If set, the command will install the theme while ignoring any WordPress or PHP version requirements
+		specified by the theme authors.
+
 	[--activate]
 		If set, the theme will be activated immediately after install.
 
@@ -974,6 +1036,7 @@ wp theme install <theme|zip|url>... [--version=<version>] [--force] [--activate]
     Theme installed successfully.
     Activating 'twentysixteen'...
     Success: Switched to 'Twenty Sixteen' theme.
+    Success: Installed 1 of 1 themes.
 
     # Install from a local zip file
     $ wp theme install ../my-theme.zip
@@ -1059,22 +1122,22 @@ These fields will be displayed by default for each theme:
 * update
 * version
 * update_version
+* auto_update
 
 These fields are optionally available:
 
 * update_package
 * update_id
 * title
 * description
-* auto_update
 
 **EXAMPLES**
 
-    # List themes
+    # List inactive themes.
     $ wp theme list --status=inactive --format=csv
-    name,status,update,version,update_version
-    twentyfourteen,inactive,none,1.7,
-    twentysixteen,inactive,available,1.1,
+    name,status,update,version,update_version,auto_update
+    twentyfourteen,inactive,none,3.8,,off
+    twentysixteen,inactive,available,3.0,3.1,off
 
 
 
@@ -1090,7 +1153,7 @@ wp theme mod
 
     # Set the 'background_color' theme mod to '000000'.
     $ wp theme mod set background_color 000000
-    Success: Theme mod background_color set to 000000
+    Success: Theme mod background_color set to 000000.
 
     # Get single theme mod in JSON format.
     $ wp theme mod get background_color --format=json
@@ -1185,7 +1248,7 @@ wp theme mod set <mod> <value>
 
     # Set theme mod
     $ wp theme mod set background_color 000000
-    Success: Theme mod background_color set to 000000
+    Success: Theme mod background_color set to 000000.
 
 
 
@@ -1351,7 +1414,7 @@ wp theme status [<theme>]
 Updates one or more themes.
 
 ~~~
-wp theme update [<theme>...] [--all] [--exclude=<theme-names>] [--format=<format>] [--version=<version>] [--dry-run] [--insecure]
+wp theme update [<theme>...] [--all] [--exclude=<theme-names>] [--minor] [--patch] [--format=<format>] [--version=<version>] [--dry-run] [--insecure]
 ~~~
 
 **OPTIONS**
@@ -1365,6 +1428,12 @@ wp theme update [<theme>...] [--all] [--exclude=<theme-names>] [--format=<format
 	[--exclude=<theme-names>]
 		Comma separated list of theme names that should be excluded from updating.
 
+	[--minor]
+		Only perform updates for minor releases (e.g. from 1.3 to 1.4 instead of 2.0)
+
+	[--patch]
+		Only perform updates for patch releases (e.g. from 1.3 to 1.3.3 instead of 1.4)
+
 	[--format=<format>]
 		Render output in a particular format.
 		---

composer.json

@@ -18,22 +18,23 @@
     ],
     "require": {
         "composer/semver": "^1.4 || ^2 || ^3",
-        "wp-cli/wp-cli": "^2.5.1"
+        "wp-cli/wp-cli": "^2.12"
     },
     "require-dev": {
         "wp-cli/cache-command": "^2.0",
         "wp-cli/entity-command": "^1.3 || ^2",
         "wp-cli/language-command": "^2.0",
         "wp-cli/scaffold-command": "^1.2 || ^2",
-        "wp-cli/wp-cli-tests": "^4"
+        "wp-cli/wp-cli-tests": "^4.3.7"
     },
     "config": {
         "process-timeout": 7200,
         "sort-packages": true,
         "allow-plugins": {
             "dealerdirect/phpcodesniffer-composer-installer": true,
             "johnpbloch/wordpress-core-installer": true
-        }
+        },
+        "lock": false
     },
     "extra": {
         "branch-alias": {

features/extension-install.feature

@@ -1,21 +1,21 @@
 Feature: Manage WordPress extension installation
 
-	@require-wp-5.1.1
-	Scenario: Installing Extensions theme or plugin
-		Given a WP install
+  @require-wp-5.1.1
+  Scenario: Installing Extensions theme or plugin
+    Given a WP install
 
-		When I try `wp theme install test-ext --activate`
-		Then STDERR should be:
-			"""
-			Warning: test-ext: Theme not found
-			Warning: The 'test-ext' theme could not be found.
-			Error: No themes installed.
-			"""
+    When I try `wp theme install test-ext --activate`
+    Then STDERR should be:
+      """
+      Warning: test-ext: Theme not found
+      Warning: The 'test-ext' theme could not be found.
+      Error: No themes installed.
+      """
 
-		When I try `wp plugin install test-ext --activate`
-		Then STDERR should be:
-			"""
-			Warning: test-ext: Plugin not found.
-			Warning: The 'test-ext' plugin could not be found.
-			Error: No plugins installed.
-			"""
+    When I try `wp plugin install test-ext --activate`
+    Then STDERR should be:
+      """
+      Warning: test-ext: Plugin not found.
+      Warning: The 'test-ext' plugin could not be found.
+      Error: No plugins installed.
+      """