Merge branch 'main' into copilot/fix-error-message-creating-user

Author: swissspidy

.github/workflows/copilot-setup-steps.yml

@@ -36,7 +36,7 @@ jobs:
 
       - name: Install Composer dependencies & cache dependencies
         if: steps.check_composer_file.outputs.files_exists == 'true'
-        uses: ramsey/composer-install@a35c6ebd3d08125aaf8852dff361e686a1a67947 # v3
+        uses: ramsey/composer-install@65e4f84970763564f46a70b8a54b90d033b3bdda # v3
         env:
           COMPOSER_ROOT_VERSION: dev-${{ github.event.repository.default_branch }}
         with:

README.md

@@ -7768,7 +7768,7 @@ Display WordPress users based on all arguments supported by
 		Control output by one or more arguments of WP_User_Query().
 
 	[--network]
-		List all users in the network for multisite.
+		List all users in the network for multisite. Roles are not included when using this flag, as users can have different roles on different sites in a multisite network.
 
 	[--field=<field>]
 		Prints the value of a single field for each user.

features/user-list.feature

@@ -27,6 +27,20 @@ Feature: List WordPress users
       bobjones
       """
 
+  Scenario: List network users excludes roles field
+    Given a WP multisite install
+    And I run `wp user create bobjones bob@example.com --role=author`
+
+    When I run `wp user list --network --format=csv`
+    Then STDOUT should contain:
+      """
+      ID,user_login,display_name,user_email,user_registered
+      """
+    And STDOUT should not contain:
+      """
+      roles
+      """
+
   @require-wp-4.9
   Scenario: List users without roles
     Given a WP install

src/User_Command.php

@@ -71,7 +71,7 @@ public function __construct() {
 	 * : Control output by one or more arguments of WP_User_Query().
 	 *
 	 * [--network]
-	 * : List all users in the network for multisite.
+	 * : List all users in the network for multisite. Roles are not included when using this flag, as users can have different roles on different sites in a multisite network.
 	 *
 	 * [--field=<field>]
 	 * : Prints the value of a single field for each user.