Merge pull request czechbox#7 from Konafets/master

Get a plan feature by its code

README.md

@@ -127,6 +127,14 @@ $plan->features()->saveMany([
 ]);
 ```
 
+### Get the value of Feature 
+
+Say you want to show the value of the feature _pictures_per_listing_ from above. You can use `getFeatureByCode()`.
+
+```php
+$amountOfPictures = $plan->getFeatureByCode('pictures_per_listing')->value
+```
+
 ### Creating subscriptions
 
 You can subscribe a user to a plan by using the `newSubscription()` function available in the `PlanSubscriber` trait. First, retrieve an instance of your subscriber model, which typically will be your user model and an instance of the plan your user is subscribing to. Once you have retrieved the model instance, you may use the `newSubscription` method to create the model's subscription.

src/LaraPlans/Models/Plan.php

@@ -2,6 +2,7 @@
 
 namespace Gerardojbaez\LaraPlans\Models;
 
+use Gerardojbaez\LaraPlans\Exceptions\InvalidPlanFeatureException;
 use Gerardojbaez\LaraPlans\Period;
 use Illuminate\Database\Eloquent\Model;
 use Gerardojbaez\LaraPlans\Contracts\PlanInterface;
@@ -112,4 +113,24 @@ public function hasTrial()
     {
         return (is_numeric($this->trial_period_days) and $this->trial_period_days > 0);
     }
+
+    /**
+     * Returns the demanded feature
+     *
+     * @param String $code
+     * @return PlanFeature
+     * @throws InvalidPlanFeatureException
+     */
+    public function getFeatureByCode($code)
+    {
+        $feature = $this->features()->getEager()->first(function($item) use ($code) {
+            return $item->code === $code;
+        });
+
+        if (is_null($feature)) {
+            throw new InvalidPlanFeatureException($code);
+        }
+
+        return $feature;
+    }
 }