Add setTranslatableUseFallback() - deprecate noFallbackLocale()

closes #66

README.md

@@ -251,11 +251,11 @@ It is also possible to translate theme customisation options. Just mark your for
 
 ## Fallback attribute values
 
-By default, untranslated attributes will fall back to the default locale. This behavior can be disabled by calling the `noFallbackLocale` method.
+By default, untranslated attributes will fall back to the default locale. This behavior can be disabled by calling the `setTranslatableUseFallback()` method.
 
     $user = User::first();
 
-    $user->noFallbackLocale()->lang('fr');
+    $user->setTranslatableUseFallback(false)->lang('fr');
 
     // Returns NULL if there is no French translation
     $user->name;

classes/TranslatableBehavior.php

@@ -129,13 +129,28 @@ public function isTranslatable($key)
         return in_array($key, $this->model->getTranslatableAttributes());
     }
 
+    /**
+     * Enables/disables translation fallback locale.
+     * @param bool $value
+     * @return \Winter\Storm\Database\Model
+     * @since 2.1.5
+     */
+    public function setTranslatableUseFallback(bool $value)
+    {
+        $this->translatableUseFallback = $value;
+
+        return $this->model;
+    }
+
     /**
      * Disables translation fallback locale.
-     * @return self
+     * @return \Winter\Storm\Database\Model
+     * @deprecated 2.1.5
+     * @see setTranslatableUseFallback()
      */
-    public function noFallbackLocale()
+    public function noFallbackLocale(): \Winter\Storm\Database\Model
     {
-        $this->translatableUseFallback = false;
+        $this->setTranslatableUseFallback(false);
 
         return $this->model;
     }

tests/unit/behaviors/TranslatableCmsObjectTest.php

@@ -78,6 +78,24 @@ public function testGetTranslationValue()
         $this->assertEquals('Awww yiss', $obj->markup);
     }
 
+    /**
+     * @since 2.1.5
+     */
+    public function testGetTranslationValueUseFallbackFalse()
+    {
+        $obj = FeatureModel::first();
+
+        $this->assertEquals('Awww yiss', $obj->markup);
+
+        $obj->setTranslatableUseFallback(false)->translateContext('fr');
+
+        $this->assertEquals(null, $obj->markup);
+    }
+
+    /**
+     * @deprecated 2.1.5
+     * @see testGetTranslationValueUseFallbackFalse()
+     */
     public function testGetTranslationValueNoFallback()
     {
         $obj = FeatureModel::first();

tests/unit/behaviors/TranslatableModelTest.php

@@ -68,6 +68,24 @@ public function testGetTranslationValue()
         $this->assertEquals('Australia', $obj->name);
     }
 
+    /**
+     * @since 2.1.5
+     */
+    public function testGetTranslationValueUseFallbackFalse()
+    {
+        $obj = CountryModel::first();
+
+        $this->assertEquals('Australia', $obj->name);
+
+        $obj->setTranslatableUseFallback(false)->translateContext('fr');
+
+        $this->assertEquals(null, $obj->name);
+    }
+
+    /**
+     * @deprecated 2.1.5
+     * @see testGetTranslationValueUseFallbackFalse()
+     */
     public function testGetTranslationValueNoFallback()
     {
         $obj = CountryModel::first();

tests/unit/behaviors/TranslatablePageTest.php

@@ -39,6 +39,26 @@ public function tearDown(): void
         parent::tearDown();
     }
 
+    /**
+     * @since 2.1.5
+     */
+    public function testUseFallbackFalse()
+    {
+        $page = TranslatablePage::create([
+            'fileName' => 'translatable',
+            'title' => 'english title',
+            'url' => '/test',
+        ]);
+        $page->translateContext('fr');
+        $this->assertEquals('english title', $page->title);
+        $page->setTranslatableUseFallback(false)->translateContext('fr');
+        $this->assertEquals(null, $page->title);
+    }
+
+    /**
+     * @deprecated 2.1.5
+     * @see testUseFallbackFalse()
+     */
     public function testUseFallback()
     {
         $page = TranslatablePage::create([

traits/MLControl.php

@@ -156,7 +156,7 @@ public function getLocaleValue($locale)
             $value = $this->model->$mutateMethod($locale);
         }
         elseif ($this->objectMethodExists($this->model, 'getAttributeTranslated') && $this->defaultLocale->code != $locale) {
-            $value = $this->model->noFallbackLocale()->getAttributeTranslated($key, $locale);
+            $value = $this->model->setTranslatableUseFallback(false)->getAttributeTranslated($key, $locale);
         }
         else {
             $value = $this->formField->value;