Update method name in translatable trait

Author: richan-fongdasen

src/Contracts/TranslatableModel.php

@@ -95,7 +95,7 @@ public function setAttribute($key, $value);
      *
      * @return $this
      */
-    public function translate($locale): self;
+    public function translateTo($locale): self;
 
     /**
      * Resolve and get the translation model for current locale.

src/Eloquent/Concerns/Translatable.php

@@ -43,7 +43,7 @@ public static function bootTranslatable(): void
         static::observe(app(I18nObserver::class));
 
         static::registerModelEvent('booted', static function (TranslatableModel $model) {
-            $model->translate(App::getLocale());
+            $model->translateTo(App::getLocale());
         });
     }
 
@@ -214,7 +214,7 @@ public function setAttribute($key, $value)
      *
      * @return $this
      */
-    public function translate($locale): self
+    public function translateTo($locale): self
     {
         if (is_string($locale)) {
             $locale = I18n::getLocale($locale);

src/Eloquent/I18nObserver.php

@@ -19,7 +19,7 @@ class I18nObserver
      */
     public function retrieved(TranslatableModel $model): void
     {
-        $model->translate(App::getLocale());
+        $model->translateTo(App::getLocale());
     }
 
     /**

src/ServiceProvider.php

@@ -74,10 +74,10 @@ public function register(): void
      */
     protected function registerMacro(): void
     {
-        Collection::macro('translate', function ($locale) {
+        Collection::macro('translateTo', function ($locale) {
             $this->each(function ($item, $key) use ($locale) {
                 if ($item instanceof TranslatableModel) {
-                    $item->translate($locale);
+                    $item->translateTo($locale);
                 }
 
                 return $key;

tests/Eloquent/Concerns/TranslatableTest.php

@@ -12,7 +12,7 @@ class TranslatableTest extends TestCase
     public function it_can_create_new_translation_model_based_on_the_given_locale()
     {
         $product = new Product();
-        $product->translate('es');
+        $product->translateTo('es');
 
         $translation = $product->translation();
 
@@ -46,14 +46,14 @@ public function it_can_be_filled_with_complete_translation_attributes()
         $this->assertEquals(null, $product->getAttribute('published'));
 
         foreach (I18n::getAllLocale() as $locale) {
-            $product->translate($locale);
+            $product->translateTo($locale);
 
             $this->assertEquals($locale->name . ' title', $product->title);
             $this->assertEquals($locale->name . ' description', $product->description);
         }
 
         $this->expectException(\ErrorException::class);
-        $product->translate('id');
+        $product->translateTo('id');
     }
 
     /** @test */
@@ -74,11 +74,11 @@ public function it_can_be_filled_with_incomplete_translation_attributes()
             'published' => true
         ]);
 
-        $product->translate('es');
+        $product->translateTo('es');
         $this->assertEquals('English title', $product->title);
         $this->assertEquals('Spanish description', $product->description);
 
-        $product->translate('de');
+        $product->translateTo('de');
         $this->assertEquals('German title', $product->title);
         $this->assertEquals('English description', $product->description);
     }

tests/Features/GettingTranslatableAttributesTest.php

@@ -99,7 +99,7 @@ public function it_can_join_the_translation_table()
     /** @test */
     public function it_can_translate_the_model_based_on_the_given_locale_key()
     {
-        $product = Product::find(9)->translate('de');
+        $product = Product::find(9)->translateTo('de');
 
         $expected = DB::table('product_translations')
             ->where('product_id', 9)
@@ -145,7 +145,7 @@ public function it_can_retrieve_all_translatable_attribute_values()
     public function it_will_merge_the_translation_attributes_on_array_serialization()
     {
         $product = Product::find(8)
-            ->translate('es')
+            ->translateTo('es')
             ->setAppends(['title', 'description']);
 
         $translation = \DB::table('product_translations')
@@ -170,7 +170,7 @@ public function eloquent_collections_are_translatable()
     {
         $products = Product::where('product_category_id', 1)->get();
 
-        $products->translate('de');
+        $products->translateTo('de');
 
         foreach ($products as $product) {
             $translation = \DB::table('product_translations')

tests/Features/SavingTranslatableAttributesTest.php

@@ -18,15 +18,15 @@ public function it_can_save_the_translation_by_specifying_translatable_attribute
             'product_category_id' => 3,
             'published' => true
         ]);
-        $product->translate('en');
+        $product->translateTo('en');
         $product->title = 'English title';
         $product->description = 'English description';
 
-        $product->translate('es');
+        $product->translateTo('es');
         $product->title = 'Spanish title';
         $product->description = 'Spanish description';
 
-        $product->translate('de');
+        $product->translateTo('de');
         $product->title = 'German title';
         $product->description = 'German description';
 
@@ -35,7 +35,7 @@ public function it_can_save_the_translation_by_specifying_translatable_attribute
         $product = Product::orderBy('id', 'desc')->first();
 
         foreach (I18n::getAllLocale() as $locale) {
-            $product->translate($locale);
+            $product->translateTo($locale);
 
             self::assertEquals($locale->name . ' title', $product->title);
             self::assertEquals($locale->name . ' description', $product->description);
@@ -64,7 +64,7 @@ public function it_can_be_filled_and_saved_with_complete_translation_attributes(
         $product = Product::orderBy('id', 'desc')->first();
 
         foreach (I18n::getAllLocale() as $locale) {
-            $product->translate($locale);
+            $product->translateTo($locale);
 
             self::assertEquals($locale->name . ' title', $product->title);
             self::assertEquals($locale->name . ' description', $product->description);
@@ -91,15 +91,15 @@ public function it_can_be_filled_with_incomplete_translation_attributes()
 
         $product = Product::orderBy('id', 'desc')->first();
 
-        $product->translate('en');
+        $product->translateTo('en');
         self::assertEquals('English title', $product->title);
         self::assertEquals('English description', $product->description);
 
-        $product->translate('es');
+        $product->translateTo('es');
         self::assertEquals('English title', $product->title);
         self::assertEquals('Spanish description', $product->description);
 
-        $product->translate('de');
+        $product->translateTo('de');
         self::assertEquals('German title', $product->title);
         self::assertEquals('English description', $product->description);
     }
@@ -160,7 +160,7 @@ public function it_can_update_all_translation_records_with_mass_assignment()
         $product = Product::find($original->id);
 
         foreach (I18n::getAllLocale() as $locale) {
-            $product->translate($locale);
+            $product->translateTo($locale);
 
             self::assertEquals($locale->name . ' title 2', $product->title);
             self::assertEquals($locale->name . ' description 2', $product->description);
@@ -176,7 +176,7 @@ public function it_can_update_all_translation_records_with_single_assignment()
         $original->title = 'English title';
         $original->description = 'English description';
         // Spanish value
-        $original->translate('es');
+        $original->translateTo('es');
         $original->title = 'Spanish title';
         $original->description = 'Spanish description';
         $original->save();
@@ -186,19 +186,19 @@ public function it_can_update_all_translation_records_with_single_assignment()
         $product->title = 'English title 2';
         $product->description = 'English description 2';
         // Spanish value
-        $product->translate('es');
+        $product->translateTo('es');
         $product->title = 'Spanish title 2';
         $product->description = 'Spanish description 2';
         // German value
-        $product->translate('de');
+        $product->translateTo('de');
         $product->title = 'German title 2';
         $product->description = 'German description 2';
         $product->save();
 
         $product = Product::find($original->id);
 
         foreach (I18n::getAllLocale() as $locale) {
-            $product->translate($locale);
+            $product->translateTo($locale);
 
             self::assertEquals($locale->name . ' title 2', $product->title);
             self::assertEquals($locale->name . ' description 2', $product->description);