Initial Commit

plugins/jetpack/json-endpoints/class.wpcom-json-api-list-roles-endpoint.php

@@ -0,0 +1,64 @@
+<?php
+class WPCOM_JSON_API_List_Roles_Endpoint extends WPCOM_JSON_API_Endpoint {
+
+	var $response_format = array(
+		'roles'  => '(array:role) Array of role objects',
+	);
+
+	static function role_sort( $a, $b ) {
+		$core_role_names = array( 'administrator', 'editor', 'author', 'contributor', 'subscriber' );
+		$a_is_core_role = in_array( $a->name, $core_role_names );
+		$b_is_core_role = in_array( $b->name, $core_role_names );
+
+		// if $a is a core_role and $b is not, $a always comes first
+		if ( $a_is_core_role && ! $b_is_core_role ) {
+			return -1;
+		}
+
+		// if $b is a core_role and $a is not, $b always comes first
+		if ( $b_is_core_role && ! $a_is_core_role ) {
+			return 1;
+		}
+
+		// otherwise the one with the > number of capabilities comes first
+		$a_cap_count = count( $a->capabilities );
+		$b_cap_count = count( $b->capabilities );
+
+		if ( $a_cap_count === $b_cap_count ) {
+			return 0;
+		}
+
+		return ( $a_cap_count > $b_cap_count ) ? -1 : 1;
+	}
+
+	// /sites/%s/roles/ -> $blog_id
+	function callback( $path = '', $blog_id = 0 ) {
+
+		$blog_id = $this->api->switch_to_blog_and_validate_user( $this->api->get_blog_id( $blog_id ) );
+		if ( is_wp_error( $blog_id ) ) {
+			return $blog_id;
+		}
+
+		if ( ! current_user_can( 'list_users' ) ) {
+			return new WP_Error( 'unauthorized', 'User cannot view roles for specified site', 403 );
+		}
+
+		$roles = array();
+
+		global $wp_roles;
+		$wp_roles->reinit();
+		$role_names = $wp_roles->get_names();
+		$role_keys = array_keys( $role_names );
+
+		foreach ( (array) $role_keys as $role_key ) {
+			$role_details = get_role( $role_key );
+			$role_details->display_name = $role_names[$role_key];
+			$roles[] = $role_details;
+		}
+
+		// Sort the array so roles with the most number of capabilities comes first, then the next role, and so on
+		usort( $roles, array( 'self', 'role_sort' ) );
+
+		return array( 'roles' => $roles );
+	}
+}