# Changelog

## v11

### v11.11.0

* Change `\Astrotomic\Translatable\Traits\Relationship::translation()` relation to use the new `ofMany` - [#297](https://github.com/Astrotomic/laravel-translatable/pull/297)

### v11.10.0

* Drop PHP7 support
* Drop Laravel 5.8 and 6 and 7 support
* Add Laravel 9 support
* Add PHP8.1 support

### v11.9.1

* Fix all methods visibility to allow customization - [#198](https://github.com/Astrotomic/laravel-translatable/pull/198)

### v11.9.0

* Add Laravel 8 support - [#180](https://github.com/Astrotomic/laravel-translatable/pull/180)

### v11.8.3

* Fix `\Astrotomic\Translatable\Exception\LocalesNotDefinedException` exception message

### v11.8.1

* Fix custom locale column name in `\Astrotomic\Translatable\Traits\Relationship::translation()` method - [#146](https://github.com/Astrotomic/laravel-translatable/pull/146)

### v11.8.0

* Add Laravel 7 support - [#128](https://github.com/Astrotomic/laravel-translatable/pull/128)

### v11.7.1

* Add `.gitattributes` to exclude files from archive - [#126](https://github.com/Astrotomic/laravel-translatable/pull/126)

### v11.7.0

* Add `translateOrFail()` method - [#114](https://github.com/Astrotomic/laravel-translatable/pull/114)

### v11.6.1

* Fix PHP translation cascade deletion - [#105](https://github.com/Astrotomic/laravel-translatable/pull/105)

### v11.6.0

* Drop PHP 7.1 support
* Drop Laravel 5.6 & 5.7 support
* Add PHP side translation cascade deletion - [#98](https://github.com/Astrotomic/laravel-translatable/pull/98) (*disabled by default*)

### v11.5.2

* Fix scope `orderByTranslation()` to return all translations - [#72](https://github.com/Astrotomic/laravel-translatable/pull/72)

### v11.5.1

* Fix `getTranslationByLocaleKey()` to use `translation` relation if possible - [#49](https://github.com/Astrotomic/laravel-translatable/pull/49)

### v11.5.0

* Add rule parsing to `\Astrotomic\Translatable\Validation\RuleFactory` - [#56](https://github.com/Astrotomic/laravel-translatable/pull/56)

### v11.4.0

* Add Laravel 6 support - [#52](https://github.com/Astrotomic/laravel-translatable/pull/52)

### v11.3.0

* Add `\Astrotomic\Translatable\Validation\RuleFactory` - [#34](https://github.com/Astrotomic/laravel-translatable/pull/34)

### v11.2.1

* Fix duplicate checks of same locale - [#40](https://github.com/Astrotomic/laravel-translatable/pull/40)

### v11.2.0

* Add auto fallback locale finder - [#36](https://github.com/Astrotomic/laravel-translatable/pull/36)

### v11.1.3

* Fix conflict between attributes and locales during `fill()` - [#38](https://github.com/Astrotomic/laravel-translatable/pull/38)

### v11.1.2

* Refactor `translation` relationship - [#23](https://github.com/Astrotomic/laravel-translatable/pull/23)

### v11.1.1

* Add missing return type-hints - [#16](https://github.com/Astrotomic/laravel-translatable/pull/16)

### v11.1.0

* Add missing dependencies `illuminate/contracts` and `illuminate/database` - [#9](https://github.com/Astrotomic/laravel-translatable/pull/9)
* Add `\Astrotomic\Translatable\Contracts\Translatable` interface
* Split `\Astrotomic\Translatable\Translatable` into multiple traits - but use them in the main one
* Add `translation` relationship - [#3](https://github.com/Astrotomic/laravel-translatable/pull/3)
* Flag methods, not defined in interface as `@internal`
* Rename `getRelationKey()` to `getTranslationRelationKey()` to prevent conflicts - the original one is `@deprecated` and will be dropped in next major release
* Update the where translation scopes to unify them and remove duplicated code - [#2](https://github.com/Astrotomic/laravel-translatable/pull/2)

### v11.0.0

* Add PHP7 type-hints [#557](https://github.com/dimsav/laravel-translatable/pull/557)
* Move to `Astrotomic` [#1](https://github.com/Astrotomic/laravel-translatable/pull/1) & [#4](https://github.com/Astrotomic/laravel-translatable/pull/4)

**migrate from dimsav to astrotomic**

1. upgrade to `dimsav/laravel-translatable:v10.0.0`
2. run `composer remove dimsav/laravel-translatable`
3. run `composer require astrotomic/laravel-translatable`
4. replace `Dimsav\` by `Astrotomic\` in your whole project (namespace change)

## v10.0.0

* Add `Dimsav\Translatable\Locales` helper class [#574](https://github.com/dimsav/laravel-translatable/pull/574)
* Fix `getRelationKey()` [#575](https://github.com/dimsav/laravel-translatable/pull/575)
* drop custom save method in favor of saved event listener [#567](https://github.com/dimsav/laravel-translatable/pull/575)

## v9

### v9.5.0

* Add `isEmptyTranslatableAttribute()` method to allow custom empty attribute decision logic [#576](https://github.com/dimsav/laravel-translatable/pull/576)

### v9.4.0

* Add Laravel 5.8 support [#550](https://github.com/dimsav/laravel-translatable/pull/550) & [#556](https://github.com/dimsav/laravel-translatable/pull/556)

### v9.3.0

* Fix n+1 queries when updating non-translated model attributes [#533](https://github.com/dimsav/laravel-translatable/pull/533)

### v9.2.0

* Add support for Laravel 5.7 [#518](https://github.com/dimsav/laravel-translatable/pull/518)

### v9.1.0

* Do not call get translation with fallback locale and fallback enabled [#502](https://github.com/dimsav/laravel-translatable/pull/502)
* Allow `translateOrDefault()` and `translateOrNew()` to default to user app locale [#500](https://github.com/dimsav/laravel-translatable/pull/500)
* Change autoload translations behavior on runtime [#501](https://github.com/dimsav/laravel-translatable/pull/501)
* Use fallback in `attributesToArray()` [#503](https://github.com/dimsav/laravel-translatable/pull/503)
* Added `orderByTranslation()` scope [#504](https://github.com/dimsav/laravel-translatable/pull/504)
* Example in doc for locale filtering in `whereTranslation()` scope [#487](https://github.com/dimsav/laravel-translatable/pull/487)
* Fire saving event in every case [#457](https://github.com/dimsav/laravel-translatable/pull/457)
* Allow to change default translation model namespace from config file [#508](https://github.com/dimsav/laravel-translatable/pull/508)

### v9.0.0

* Added support for Laravel 5.6 [#435](https://github.com/dimsav/laravel-translatable/pull/435)

## v8

### v8.1.0

* Fixed error when fallback not available. [#422](https://github.com/dimsav/laravel-translatable/pull/422)
* Fixed withTranslation query scope performance [#417](https://github.com/dimsav/laravel-translatable/pull/417)
* Fixed fallback for country-based locales [#417](https://github.com/dimsav/laravel-translatable/pull/417)
* Fixed empty attribute values [#410](https://github.com/dimsav/laravel-translatable/pull/410)

### v8.0.0

* Added support for Laravel 5.5 [#394](https://github.com/dimsav/laravel-translatable/pull/394)

## v7

### v7.3.0

* Added compatibility with custom db connections. [#366](https://github.com/dimsav/laravel-translatable/pull/366)

### v7.2.1

* Fixed delete events not fired for translations. [#361](https://github.com/dimsav/laravel-translatable/pull/361)

### v7.2.0

* Added `replicateWithTranslations()`. [#346](https://github.com/dimsav/laravel-translatable/pull/346)
* Added `orWhereTranslation()` and `orWhereTranslationLike()` scopes. [#338](https://github.com/dimsav/laravel-translatable/pull/338)
* Added support for laravel auto-discovery. [#359](https://github.com/dimsav/laravel-translatable/pull/359)
* Added tag for publishing the config file. [#360](https://github.com/dimsav/laravel-translatable/pull/360)

### v7.1.0

* Added fallback per attribute. [#348](https://github.com/dimsav/laravel-translatable/pull/348)
* Added `getTranslationsArray()` [#347](https://github.com/dimsav/laravel-translatable/pull/347)
* Fixed filling 'property:locale' format was not validating the locale. [#356](https://github.com/dimsav/laravel-translatable/pull/356)

### v7.0.0

* Added compatibility with Laravel v5.4.
* Added default locale per model. [#271](https://github.com/dimsav/laravel-translatable/pull/271)

## v6

### v6.1.0

* Filling a model now supports using the 'property:locale' format in keys. [#314](https://github.com/dimsav/laravel-translatable/pull/314) For example: `$country->fill(['name:en' => 'Belgium'])`
* Added config to skip translations in `toArray()` for better performance when needed. [#315](https://github.com/dimsav/laravel-translatable/pull/315)

### v6.0.1

* Fix issue when trying to fetch a translation with a country based locale [#264](https://github.com/dimsav/laravel-translatable/pull/264)

### v6.0.0

* Translated fillable properties should only be defined in the translation model.
  * To update from version 5, move all the fillable properties belonging to a translation to the corresponding translation models.
* Added `deleteTranslations()` method for conveniently deleting translations

## v5

### v5.6.1

* Added support for Lumen without Facades [#259](https://github.com/dimsav/laravel-translatable/pull/259)
* Added support for Model accessors [#257](https://github.com/dimsav/laravel-translatable/pull/257)
* Updated code style and added [styleci](https://styleci.io/) to enforce it

### v5.6.0

* Added scope `notTranslatedIn()` [#235](https://github.com/dimsav/laravel-translatable/pull/235)

### v5.5.1

* Fixed a bug in locale fallback on `toArray()`

### v5.5.0

* Added Laravel 5.2 support
* Dropped Laravel 5.0 support
* Added scope `whereTranslationLike()` [#183](https://github.com/dimsav/laravel-translatable/pull/183)
* Fire 'updated' event when saving translations. [#190](https://github.com/dimsav/laravel-translatable/pull/190)
* `setAttribute()` returns the model itself, which is now the default in eloquent. [#201](https://github.com/dimsav/laravel-translatable/issues/201)

### v5.4

* Added compatibility with custom primary key [#174](https://github.com/dimsav/laravel-translatable/issues/174)

### v5.3

* Added `whereTranslation()` scope [#168](https://github.com/dimsav/laravel-translatable/issues/168)

### v5.2

* Added option to override default locale [#158](https://github.com/dimsav/laravel-translatable/issues/158)
* Added default value in `translatedIn()` scope [#148](https://github.com/dimsav/laravel-translatable/issues/148)
* Added new scope `withTranslation()]` to decrease the number of mysql calls made.
* Added [documentation](https://github.com/dimsav/laravel-translatable/blob/0715f46613769570b65b97ac9ffec10f9bf06d8d/readme.md#available-scopes) about scopes.

### v5.1.2

* Fixed db in tests is dropped and recreated to make tests more stable
* Fixed bug when using syntax `$country->{'name:en'}` and locale doesn't exist [#150](https://github.com/dimsav/laravel-translatable/issues/150)
* Method isTranslationAttribute() is now public [#151](https://github.com/dimsav/laravel-translatable/issues/151)

### v5.1.1

* Fixed compatibility with Lumen [#121](https://github.com/dimsav/laravel-translatable/issues/121)
* Fixed making an attribute on a translatable model hidden does not hide it [#133](https://github.com/dimsav/laravel-translatable/issues/133)

### v5.1.0

* Added mutator/accessor translations using the format `$country->{'name:de'}` thanks to [@barryvdh](https://github.com/barryvdh)
* Added documentation in readme file

### v5.0.1

* Applied PSR-2 code style.

### v5.0.0

* Laravel 5 ready
* Added configuration option for returning fallback translations

## v4

### v4.5.0

* Added scope to list translated attributes in the current locale.
* Force fire "saved" event when the original model is not saved, but the translation is [#85](https://github.com/dimsav/laravel-translatable/issues/85)

### v4.4.0

* Drops support for laravel 4.0.
* Compatible with laravel 4.1 and laravel 4.2.
* External config file.
* Fallback issue fixed.
* Added translated and translatedIn scopes.
* Changed behavior: getting non existing translations with `getTranslation()` used to return objects, now `null` is returned.
* Translated attributes now shown when converting `toArray()` or `toJson()`.
* Fixed bug: `fill()` created empty translations even when translated attributes were not fillable.
* Added option to make translated attributes always fillable.

### v4.3.0

* The `Translation` class suffix default can be overridden in the app config. See [7ecc0a75d](https://github.com/dimsav/laravel-translatable/commit/7ecc0a75dfcec58ebf694e0a7feb686294b49847)
* The `app.fallback_locale` setting can be overridden in each model separately. See [#33](https://github.com/dimsav/laravel-translatable/pull/33)
* Fallback translation is not returned if it is not defined.

### v4.2.0

* Fallback locale now is taken from `app.fallback_locale` config key.

### v4.1.1

* Fixed issue with saving translations, caused by the update of the laravel core.

### v4.1.0

* Added fallback to default locale if translations is missing. [#23](https://github.com/dimsav/laravel-translatable/issues/23)
* Added travis environment for laravel 4.2.

### v4.0.0

* Removed syntax `$model->en->name` because conflicts may happen if the model has a property named `en`. See [#18](https://github.com/dimsav/laravel-translatable/issues/18).
* Added method `hasTranslation($locale)`. See [#19](https://github.com/dimsav/laravel-translatable/issues/19).

## v3.0.0

* Fixed bug [#7](https://github.com/dimsav/laravel-translatable/issues/7). Model's Translations were deleted when the model delete failed.

## v2.0.0

* Translatable is now a trait and can be used as add-on to your models.
* 100% code coverage

## v1.0.0

* Initial version
* Translatable is a class extending Eloquent
* 96% code coverage