Added model's ownership

docs/usage/concepts.rst

@@ -176,3 +176,18 @@ The ``Laratrust`` class has a shortcut to ``ability()`` for the currently logged
    // is identical to
 
    Auth::user()->ability('admin,owner', 'create-post,edit-user');
+
+Model's Ownership
+^^^^^^^^^^^^^^^^^
+
+If you need to check if the user owns a model you can use the user function ``owns``:
+
+.. code-block:: php
+   
+   public function update (Post $post) {
+      if ($user->owns($post)) {
+         abort(403);
+      }
+
+      ...
+   }

src/Laratrust/Traits/LaratrustUserTrait.php

@@ -307,6 +307,18 @@ public function detachRoles($roles = null)
         return $this;
     }
 
+    /**
+     * Checks if the user owns the thing
+     * @param  Model $thing
+     * @return boolean
+     */
+    public function owns($thing)
+    {
+        $foreignKeyName = snake_case(get_class($this). 'Id');
+
+        return $thing->$foreignKeyName == $this->getKey();
+    }
+
     /**
      * This scope allows to retrive users with an specific role
      * @param  Illuminate\Database\Eloquent\Builder $query

tests/LaratrustUserTest.php

@@ -1102,6 +1102,19 @@ public function testDetachAllRoles()
 
     }
 
+    function testUserOwnsaPostModel()
+    {
+        $user = m::mock('HasRoleUser')->makePartial();
+        $post = new stdClass();
+        $post->mockery_11__has_role_user_id = $user->getKey();
+
+        $post2 = new stdClass();
+        $post2->mockery_11__has_role_user_id = 9;
+
+        $this->assertTrue($user->owns($post));
+        $this->assertFalse($user->owns($post2));
+    }
+
     protected function mockPermission($permName)
     {
         $permMock = m::mock('Laratrust\Permission');