Merge pull request #127 from Laravel-Lang/5.x

Added information about the localization of locale names
Laravel-Lang · Nov 10, 2023 · a4d4b02 · a4d4b02
2 parents b239623 + 978b9cb
commit a4d4b02
Show file tree

Hide file tree

Showing 3 changed files with 42 additions and 13 deletions.
diff --git a/composer.json b/composer.json
@@ -52,7 +52,7 @@
         "laravel-lang/http-statuses": "^3.5.0",
         "laravel-lang/lang": "^13.3.0",
         "laravel-lang/locales": "^1.6",
-        "laravel-lang/native-locale-names": "^1.1",
+        "laravel-lang/native-locale-names": "^1.2",
         "laravel-lang/publisher": "^15.0"
     },
     "require-dev": {

diff --git a/docs/installation/upgrade-guide/publisher/15.md b/docs/installation/upgrade-guide/publisher/15.md
@@ -56,47 +56,57 @@ Also [changed](../../../usage/aliases.md) `aliases` section in the configuration
 ### Before
 
 ```php
-LaravelLang\Publisher\Facades\Helpers\Locales::available(); // array<string>
+use LaravelLang\Publisher\Facades\Helpers\Locales;
+
+return Locales::available(); // array<string>
 // ['en', 'fr', 'de', ...]
 
-LaravelLang\Publisher\Facades\Helpers\Locales::getDefault(); // string
+return Locales::getDefault(); // string
 // de-DE
 ```
 
 ### After
 
 ```php
-LaravelLang\Locales\Facades\Locales::available(); // array<LocaleData>
+use LaravelLang\Publisher\Facades\Helpers\Locales;
+
+return Locales::available(); // array<LocaleData>
 // [<object>, <object>, ...]
 
-LaravelLang\Locales\Facades\Locales::getDefault(); // LocaleData
+return Locales::getDefault(); // LocaleData
 // <object>
 
-LaravelLang\Locales\Facades\Locales::raw()->available(); // array<string>
+return Locales::raw()->available(); // array<string>
 // ['en', 'fr', 'de', ...]
 
-LaravelLang\Locales\Facades\Locales::raw()->getDefault(); // string
+return Locales::raw()->getDefault(); // string
 // de-DE
 ```
 
 `<object>` is a DTO class of `LocaleData`:
 
 ```php
+use LaravelLang\Locales\Data\LocaleData;
+
+app()->setLocale('vi');
+
 // Non aliased
-LaravelLang\Locales\Data\LocaleData {
+LocaleData {
   +code: "de"
   +type: "Latn"
   +name: "German"
   +native: "Deutsch"
+  +localized: "Tiếng Đức"
   +regional: "de_DE"
 }
 
 // Aliased
-LaravelLang\Locales\Data\LocaleData {
+LocaleData {
   +code: "de-DE"
   +type: "Latn"
   +name: "German"
   +native: "Deutsch"
+  +localized: "Tiếng Đức"
   +regional: "de_DE"
 }
 ```

diff --git a/docs/usage/features/facades.md b/docs/usage/features/facades.md
@@ -39,46 +39,65 @@ Locales::getFallback(): LocaleData
 For example:
 
 ```php
+use LaravelLang\Locales\Data\LocaleData;
+use LaravelLang\Locales\Facades\Locales;
+
+// config('app.locale') // de
+
 return Locales::getDefault();
 
 // Non aliased
-LaravelLang\Locales\Data\LocaleData {
+LocaleData {
   +code: "de"
   +type: "Latn"
   +name: "German"
   +native: "Deutsch"
+  +localized: "Deutsch"
   +regional: "de_DE"
 }
 
 // Aliased
-LaravelLang\Locales\Data\LocaleData {
+LocaleData {
   +code: "de-DE"
   +type: "Latn"
   +name: "German"
   +native: "Deutsch"
+  +localized: "Deutsch"
   +regional: "de_DE"
 }
 ```
 ```php
+use LaravelLang\Locales\Data\LocaleData;
+use LaravelLang\Locales\Facades\Locales;
+
+// config('app.locale') // vi
+
 return Locales::get('de');
 
-LaravelLang\Locales\Data\LocaleData {
+LocaleData {
   +code: "de"
   +type: "Latn"
   +name: "German"
   +native: "Deutsch"
+  +localized: "Tiếng Đức"
   +regional: "de_DE"
 }
 ```
 ```php
+use LaravelLang\Locales\Data\LocaleData;
+use LaravelLang\Locales\Facades\Locales;
+
+// config('app.locale') // de
+
 return Locales::get('foo');
 
 // Will return the default locale
-LaravelLang\Locales\Data\LocaleData {
+LocaleData {
   +code: "de"
   +type: "Latn"
   +name: "German"
   +native: "Deutsch"
+  +localized: "Deutsch"
   +regional: "de_DE"
 }
 ```