Merge pull request #2 from mihkelallorg/get-translated

Add getTranslated method

src/Traits/Translatable.php

@@ -2,6 +2,7 @@
 
 namespace Mihkullorg\Translatable\Traits;
 
+use Illuminate\Support\Facades\App;
 use Mihkullorg\Translatable\Facades\Translator;
 use Mihkullorg\Translatable\Models\Translation;
 use Illuminate\Database\Eloquent\Relations\MorphMany;
@@ -93,4 +94,19 @@ public function getTranslationsAsArray()
             $values->put('language', $language);
         })->values()->toArray();
     }
+
+    /**
+     * Get the translated field value.
+     *
+     * @param $field
+     * @param null $language Defaults to the App locale
+     * @param null $default The return value if the translation does not exist
+     * @return string
+     */
+    public function getTranslated($field, $language = null, $default = null)
+    {
+        $language = $language ?: App::getLocale();
+
+        return object_get($this->translation($field, $language), 'value', $default);
+    }
 }

tests/TranslatableTest.php

@@ -3,6 +3,7 @@
 namespace Mihkullorg\Tests\Translatable;
 
 use Carbon\Carbon;
+use Illuminate\Support\Facades\App;
 use Mihkullorg\Translatable\Facades\Translator;
 use Mihkullorg\Tests\Translatable\Models\TestModel;
 
@@ -85,6 +86,24 @@ public function test_retrieve_translations_as_array()
         ], $translations));
     }
 
+    public function test_get_translated_method()
+    {
+        /** @var TestModel $model */
+        $model = factory(TestModel::class)->create();
+
+        $field = 'body';
+        $englishTranslation = 'English translation';
+        $model->createTranslation($field, 'en', $englishTranslation);
+
+        $this->assertEquals($model->getTranslated('body', 'en'), $englishTranslation);
+
+        App::setLocale('ru');
+        $this->assertNull($model->getTranslated('body'));
+
+        App::setLocale('en');
+        $this->assertEquals($model->getTranslated('body'), $englishTranslation);
+    }
+
     /**
      * @param TestModel $model
      * @param $field