Merge pull request Zizaco#812 from yamenarahman/master

Adding scopeWithRole($name) to filter users according to their role.

README.md

@@ -172,7 +172,7 @@ class User extends Eloquent
 }
 ```
 
-This will enable the relation with `Role` and add the following methods `roles()`, `hasRole($name)`, `can($permission)`, and `ability($roles, $permissions, $options)` within your `User` model.
+This will enable the relation with `Role` and add the following methods `roles()`, `hasRole($name)`, `withRole($name)`, `can($permission)`, and `ability($roles, $permissions, $options)` within your `User` model.
 
 Don't forget to dump composer autoload
 
@@ -307,6 +307,13 @@ $user->can("admin.*"); // true
 $user->can("*_users"); // true
 ```
 
+To filter users according a specific role, you may use withRole() scope, for example to retrieve all admins:
+```
+$admins = User::withRole('admin')->get();
+// or maybe with a relationsship
+$company->users()->withRole('admin')->get();
+```
+
 
 #### User ability
 

src/Entrust/Traits/EntrustUserTrait.php

@@ -304,4 +304,18 @@ public function detachRoles($roles=null)
         }
     }
 
+    /**
+     *Filtering users according to their role 
+     *
+     *@param string $role
+     *@return users collection
+     */
+    public function scopeWithRole($query, $role)
+    {
+        return $query->whereHas('roles', function ($query) use ($role)
+        {
+            $query->where('name', $role);
+        });
+    }
+
 }