Add namespaced events

README.md

@@ -32,12 +32,14 @@ class Post extends Eloquent
 		'content' => 'required'
 	];
 
-	protected $messages = [
+	protected $validationMessages = [
 		'slug.unique' => "Another post is using that slug already."
 	];
 }
 ```
 
+If you'd prefer a slightly easier route, just have your models extend from `Watson\Validating\ValidatingModel` instead of Eloquent.
+
 Now, you have access to some plesant functionality.
 
 ```php
@@ -202,6 +204,26 @@ $post->setMessages(['title.required' => "Please, please set a title."])
 
 These are handy if you need to adjust the rules or messages in a specific scenario differently.
 
+### Events
+
+Various events are fired by the trait during the validation process which you can hook into to impact the validation process.
+
+When validation is about to occur, the `validating.$event` event will be fired, where `$event` will be `saving`, `creating`, `updating`, `deleting` or `restoring`. If you listen for any of these events and return a value you can prevent validation from occurring completely.
+
+```php
+Event::listen('validating.*', function($model)
+{
+    // Psuedo-Russian roulette validation.
+    if (rand(1, 6) === 1)
+    {
+        return false;
+    }
+}
+});
+```
+
+After validation occurs, either `validating.passed` or `validating.failed` will be fired depending on the state of the validation.
+
 ## Controller usage
 
 There are a few ways to go about using the validating model in your controllers, but here's the simple way I like to do it. Really clean, clear as to what is going on and easy to test. Of course you can mix it up as you need, it's just one approach.

src/ValidatingObserver.php

@@ -1,6 +1,7 @@
 <?php namespace Watson\Validating;
 
 use \Illuminate\Database\Eloquent\Model;
+use \Illuminate\Support\Facades\Event;
 use \Watson\Validating\ValidationException;
 
 class ValidatingObserver {
@@ -74,20 +75,42 @@ public function restoring(Model $model)
     protected function performValidation(Model $model, $event)
     {
         // If the model has validating enabled, perform it.
-        if ($model->getValidating() && $model->isValid($event) === false)
+        if ($model->getValidating())
         {
-            if ($model->getThrowValidationExceptions())
+            // Fire the namespaced validating event and prevent validation
+            // if it returns a value.
+            if ($this->fireValidatingEvent($event, $model) !== null) return;
+
+            if ($model->isValid($event) === false)
             {
-                $exception = new ValidationException(get_class($model) . ' model could not be persisted as it failed validation.');
+                // Fire the validating.failed event.
+                $this->fireValidatedEvent('failed', $model);
 
-                $exception->setModel($model);
-                $exception->setErrors($model->getErrors());
+                if ($model->getThrowValidationExceptions())
+                {
+                    $exception = new ValidationException(get_class($model) . ' model could not be persisted as it failed validation.');
 
-                throw $exception;
-            }
+                    $exception->setModel($model);
+                    $exception->setErrors($model->getErrors());
+
+                    throw $exception;
+                }
 
-            return false;
+                return false;
+            }
+            // Fire the validating.passed event.
+            $this->fireValidatedEvent('passed', $model);
         }
     }
 
+    protected function fireValidatingEvent($event, Model $model)
+    {
+        return Event::until('validating.'.$event, [$model]);
+    }
+
+    protected function fireValidatedEvent($event, Model $model)
+    {
+        return Event::fire('validating.'.$event, [$model]);
+    }
+
 }