├── LICENSE.md
├── README.md
├── composer.json
├── pint.json
├── publishable
    └── config
    │   └── translatable.php
└── src
    ├── Facades
        └── Translatable.php
    ├── Helpers
        └── helpers.php
    ├── Macros
        └── TranslatableRoutesMacro.php
    ├── Middleware
        └── TranslatableRoutesHandler.php
    ├── Traits
        └── HasTranslations.php
    ├── Translatable.php
    └── TranslatableServiceProvider.php


/LICENSE.md:
--------------------------------------------------------------------------------
 1 | MIT License
 2 | 
 3 | Copyright (c) 2019 Sertxu Developer
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | 
  2 | <p align="center"><img src="/art/socialcard.png" alt="Laravel Translatable by Sertxu Developer"></p>
  3 | 
  4 | # Laravel Translatable
  5 | 
  6 | ![](https://img.shields.io/github/v/release/sertxudeveloper/laravel-translatable) ![](https://img.shields.io/github/license/sertxudeveloper/laravel-translatable) ![](https://img.shields.io/librariesio/github/sertxudeveloper/laravel-translatable) ![](https://img.shields.io/github/repo-size/sertxudeveloper/laravel-translatable) ![](https://img.shields.io/packagist/dt/sertxudeveloper/laravel-translatable) ![](https://img.shields.io/github/issues/sertxudeveloper/laravel-translatable) ![](https://img.shields.io/packagist/php-v/sertxudeveloper/laravel-translatable)
  7 | 
  8 | **Manage localized routes and use translatable models in a Laravel app.**
  9 |  - Automatically register the routes for each locale you wish to support.
 10 |  - Optionally remove the locale slug from the URL for your main language.
 11 |  - Generate localized route URLs using the `trans_route()` helper.
 12 |  - Allow routes to be cached.
 13 | 
 14 | ## Requirements
 15 |   - PHP >= 7.4
 16 |   - Laravel >= 8.x
 17 | 
 18 | ## Installation
 19 | You can install this package using Composer.
 20 | 
 21 | ```sh
 22 | composer require sertxudeveloper/laravel-translatable
 23 | ```
 24 | 
 25 | ## Configuration
 26 | First you should publish the configuration file.
 27 | 
 28 | ```sh
 29 | php artisan vendor:publish --tag='trans-config'
 30 | ```
 31 | 
 32 | After running this command, you will now find a `translatable.php`` file in the `config` folder.
 33 | 
 34 | ### Locales available
 35 | You can set the locales availables in your application. The localized routes will be registered with all of these locales.
 36 | 
 37 | ```php
 38 | 'locales' => ['es', 'en', 'it'],
 39 | ```
 40 | ### Fallback locale
 41 | The fallback locale should be the one that not require to be translated.
 42 | 
 43 | ```php
 44 | 'fallback_locale' => 'es',
 45 | ```
 46 | You can also hide the fallback locale from the URL prefix.
 47 | 
 48 | ```php
 49 | "hide_fallback_locale" => true,
 50 | ```
 51 | 
 52 | # Routes
 53 | ## Register Routes
 54 | All the routes you want lo localize should be registered inside the `Route::localized` closure.
 55 | 
 56 | ```php
 57 | // Not Localized
 58 | Route::get('home', [HomeController::class, 'index'])->name('home');
 59 | 
 60 | // Localized
 61 | Route::localized(function () {
 62 |   Route::get('blog', [BlogController::class, 'index'])->name('blog')
 63 |   Route::get('{slug}', [PageController::class, 'index'])->name('page')
 64 | });
 65 | 
 66 | // Not Localized
 67 | Route::get('about', [AboutController::class, 'index'])->name('about');
 68 | ```
 69 | 
 70 | Inside this closure you can use Route Groups such as Middlewares, Namespaces or even Sub-Domain Routing. This closure will prepend the locale to the route's URI and name.
 71 | 
 72 | This will be the result of the viewed configuration examples.
 73 | 
 74 | | URI | Name | Locale |
 75 | | --- | --- | --- |
 76 | | /home | home | es - en - it |
 77 | | --- | --- | --- |
 78 | | /blog | blog | es |
 79 | | /es/blog | es.blog | es |
 80 | | /en/blog | en.blog | en |
 81 | | /it/blog | it.blog | it |
 82 | | --- | --- | --- |
 83 | | /{slug} | page | es |
 84 | | /es/{slug} | es.page | es |
 85 | | /en/{slug} | en.page | en |
 86 | | /it/{slug} | it.page | it |
 87 | | --- | --- | --- |
 88 | | /about | about | es - en - it |
 89 | 
 90 | > Beware that you don't register the same URL twice when omitting the locale. You can't have a localized /about route and also register a non-localized /about route in this case. The same idea applies to the / (root) route! Also note that the route names still have the locale prefix.
 91 | 
 92 | ## Generate Localized URLs
 93 | You should use the `trans_route` helper in order to get the requested route localized. To this helper you can pass a route name or a route url, in booth cases it will be localized.
 94 | 
 95 | ```php
 96 | trans_route($name, $parameters = [], $absolute = false, $locale = null)
 97 | ```
 98 | 
 99 | If you pass only the route it will be localized using the current locale (`'en'`).
100 | 
101 | ```php
102 | trans_route('blog') // /en/blog
103 | ```
104 | 
105 | You can also pass params to the helper.
106 | 
107 | ```php
108 | trans_route('page', ['help']) // /en/help
109 | ```
110 | 
111 | The third param is a boolean to make it absolute or not.
112 | 
113 | ```php
114 | trans_route('page', ['help'], true) // https://yourdomain.test/en/help
115 | ```
116 | 
117 | ```php
118 | trans_route('page', ['help'], false) // /en/help
119 | ```
120 | 
121 | The last param is used for specify the locale to use.
122 | 
123 | ```php
124 | trans_route('blog', [], false, 'it') // /it/blog
125 | ```
126 | 
127 | ## Switch Locale
128 | If you're building a dropdown or similar with links to change the locale of the application, you should use the `switch_to_locale` helper.
129 | ```php
130 | switch_to_locale('en') // Changes to 'en' locale without changing the route
131 | ```
132 | 
133 | # Eloquent translations
134 | 
135 | ## Create translations tables
136 | You can to customize the name of the translations tables.
137 | 
138 | ```php
139 | 'table_suffix' => '_translations'
140 | ```
141 | 
142 | The usage of this value will be the following one. If you have the model `Page` with the trait `HasTranslations` and the model table is `pages`.
143 | This package will look up for the translations at the table `page_translations`. Always the model table followed by the table suffix in the config file.
144 | 
145 | The translations tables should contain the translatable fields from the model, the id, a column `locale` to specify the language saved, `created_at` and `updated_at`.
146 | The column `deleted_at` should **never** be in the translations table, regardless the models is `softDeleted` or not.
147 | 
148 | As you can see in the following example,
149 | 
150 | #### Pages table
151 | | id | name | slug | excerpt | body | image | status | created_at | updated_at |
152 | | --- | --- | --- | --- | --- | --- | --- | --- | --- |
153 | | int | varchar | varchar | varchar | text | varchar | enum | datetime | datetime |
154 | 
155 | #### Pages translation table
156 | | id | locale | name | excerpt | body | created_at | updated_at |
157 | | --- | --- | --- | --- | --- | --- | --- |
158 | | int | varchar(2) | varchar | varchar | text | datetime | datetime |
159 | 
160 | ## Get Eloquent Translated Attribute
161 | In order to get a translated attribute you should use the ``getTranslated`` method.
162 | 
163 | ```php
164 | $post = Post::find(1);
165 | echo $post->getTranslated('name');
166 | ```
167 | 
168 | ## Cache Routes
169 | In production, you can safely cache your routes per usual.
170 | 
171 | ```sh
172 | php artisan route:cache
173 | ```
174 | 
175 | <br><br>
176 | <p align="center">Copyright © 2022 Sertxu Developer</p>
177 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "sertxudeveloper/laravel-translatable",
 3 |     "description": "Manage localized routes and use translatable models in a Laravel app.",
 4 |     "keywords": [
 5 |         "laravel",
 6 |         "translatable",
 7 |         "localization"
 8 |     ],
 9 |     "homepage": "https://github.com/sertxudeveloper/laravel-translatable",
10 |     "license": "MIT",
11 |     "authors": [
12 |         {
13 |             "name": "Sertxu Developer",
14 |             "email": "dev.sertxu@gmail.com",
15 |             "role": "Developer"
16 |         }
17 |     ],
18 |     "require": {
19 |         "php": "^8.1|^8.2",
20 |         "illuminate/contracts": "^10.0|^11.0",
21 |         "illuminate/support": "^10.0|^11.0",
22 |         "illuminate/database": "^10.0|^11.0"
23 |     },
24 |     "require-dev": {
25 |         "orchestra/testbench": "^8.0|^9.0",
26 |         "phpunit/phpunit": "^9.5|^10.0"
27 |     },
28 |     "autoload": {
29 |         "psr-4": {
30 |             "SertxuDeveloper\\Translatable\\": "src/"
31 |         }
32 |     },
33 |     "autoload-dev": {
34 |         "psr-4": {
35 |             "SertxuDeveloper\\Translatable\\Tests\\": "tests/",
36 |             "SertxuDeveloper\\Translatable\\Tests\\Database\\Factories\\": "tests/database/factories"
37 |         }
38 |     },
39 |     "scripts": {
40 |         "test": "vendor/bin/phpunit",
41 |         "test-coverage": "vendor/bin/phpunit --coverage-html coverage"
42 |     },
43 |     "config": {
44 |         "sort-packages": true
45 |     },
46 |     "extra": {
47 |         "laravel": {
48 |             "providers": [
49 |                 "SertxuDeveloper\\Translatable\\TranslatableServiceProvider"
50 |             ],
51 |             "aliases": {
52 |                 "Translatable": "SertxuDeveloper\\Translatable\\Facades\\Translatable"
53 |             }
54 |         }
55 |     },
56 |     "minimum-stability": "dev",
57 |     "prefer-stable": true
58 | }
59 | 


--------------------------------------------------------------------------------
/pint.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "preset": "laravel",
 3 |   "rules": {
 4 |       "simplified_null_return": true,
 5 |       "braces": {
 6 |           "position_after_anonymous_constructs": "same",
 7 |           "position_after_functions_and_oop_constructs": "same"
 8 |       },
 9 |       "new_with_braces": {
10 |           "anonymous_class": false,
11 |           "named_class": false
12 |       },
13 |       "curly_braces_position": {
14 |           "anonymous_classes_opening_brace": "same_line",
15 |           "functions_opening_brace": "same_line",
16 |           "allow_single_line_empty_anonymous_classes": true,
17 |           "allow_single_line_anonymous_functions": true
18 |       },
19 |       "phpdoc_types": {
20 |           "groups": [
21 |               "simple"
22 |           ]
23 |       },
24 |       "no_useless_else": true,
25 |       "not_operator_with_successor_space": false
26 |   }
27 | }
28 | 


--------------------------------------------------------------------------------
/publishable/config/translatable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | return [
 4 | 
 5 |     /**
 6 |      * The locales available in your project.
 7 |      */
 8 |     'locales' => ['es', 'en', 'it'],
 9 | 
10 |     /**
11 |      * The default locale in your project, it will be used if the requested locale is not available.
12 |      */
13 |     'fallback_locale' => 'en',
14 | 
15 |     /**
16 |      * Hide the default locale from the URL.
17 |      */
18 |     'hide_fallback_locale' => true,
19 | 
20 |     /**
21 |      * The translations' table suffix.
22 |      */
23 |     'table_suffix' => '_translations',
24 | ];
25 | 


--------------------------------------------------------------------------------
/src/Facades/Translatable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace SertxuDeveloper\Translatable\Facades;
 4 | 
 5 | use Illuminate\Support\Facades\Facade;
 6 | 
 7 | class Translatable extends Facade
 8 | {
 9 |     /**
10 |      * Get the registered name of the component.
11 |      *
12 |      * @return string
13 |      */
14 |     protected static function getFacadeAccessor() {
15 |         return 'translatable';
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Helpers/helpers.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | use SertxuDeveloper\Translatable\Facades\Translatable;
 4 | 
 5 | if (!function_exists('trans_route')) {
 6 |     function trans_route($name, $params = [], $absolute = false, $locale = null) {
 7 |         return Translatable::route($name, $params, $absolute, $locale);
 8 |     }
 9 | }
10 | 
11 | if (!function_exists('switch_to_locale')) {
12 |     function switch_to_locale($locale) {
13 |         return Translatable::switchToLocale($locale);
14 |     }
15 | }
16 | 
17 | if (!function_exists('is_route')) {
18 |     function is_route($patterns): bool {
19 |         $patterns = Arr::wrap($patterns);
20 | 
21 |         /** Check route without locales */
22 |         if (request()->routeIs($patterns)) {
23 |             return true;
24 |         }
25 | 
26 |         /** Check route with locales */
27 |         foreach (config('translatable.locales') as $locale) {
28 |             foreach ($patterns as $pattern) {
29 |                 if (request()->routeIs("$locale.$pattern")) {
30 |                     return true;
31 |                 }
32 |             }
33 |         }
34 | 
35 |         return false;
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Macros/TranslatableRoutesMacro.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace SertxuDeveloper\Translatable\Macros;
 4 | 
 5 | use Closure;
 6 | use Illuminate\Support\Facades\Route;
 7 | use SertxuDeveloper\Translatable\Middleware\TranslatableRoutesHandler;
 8 | 
 9 | class TranslatableRoutesMacro
10 | {
11 |     /**
12 |      * Register the macro.
13 |      *
14 |      * @return void
15 |      */
16 |     public static function register() {
17 |         if (!Route::hasMacro('localized')) {
18 |             function registerRoutes($locale, Closure $closure) {
19 |                 $fallbackLocale = config('translatable.fallback_locale');
20 |                 $hideFallbackLocale = config('translatable.hide_fallback_locale');
21 | 
22 |                 $attributes = [];
23 |                 $attributes['middleware'] = [TranslatableRoutesHandler::class];
24 | 
25 |                 $attributes['as'] = "$locale.";
26 |                 $attributes['prefix'] = $locale;
27 |                 Route::group($attributes, $closure);
28 | 
29 |                 if ($hideFallbackLocale && $locale === $fallbackLocale) {
30 |                     $attributes = [];
31 |                     $attributes['middleware'] = [TranslatableRoutesHandler::class];
32 |                     Route::group($attributes, $closure);
33 |                 }
34 |             }
35 | 
36 |             Route::macro('localized', function (Closure $closure) {
37 |                 $locales = config('translatable.locales');
38 |                 $fallbackLocale = config('translatable.fallback_locale');
39 | 
40 |                 foreach ($locales as $locale) {
41 |                     if ($fallbackLocale === $locale) {
42 |                         continue;
43 |                     }
44 |                     registerRoutes($locale, $closure);
45 |                 }
46 | 
47 |                 registerRoutes($fallbackLocale, $closure);
48 |             });
49 |         }
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/Middleware/TranslatableRoutesHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace SertxuDeveloper\Translatable\Middleware;
 4 | 
 5 | use Closure;
 6 | use Illuminate\Http\RedirectResponse;
 7 | use Illuminate\Http\Request;
 8 | use Illuminate\Support\Facades\App;
 9 | use Illuminate\Support\Facades\Route;
10 | use Illuminate\Support\Facades\Session;
11 | use SertxuDeveloper\Translatable\Facades\Translatable;
12 | 
13 | class TranslatableRoutesHandler
14 | {
15 |     /**
16 |      * Set language for localized route.
17 |      *
18 |      * @return mixed
19 |      */
20 |     public function handle(Request $request, Closure $next) {
21 |         $params = explode('/', $request->getPathInfo());
22 | 
23 |         // Dump the first element (empty string) as getPathInfo() always returns a leading slash
24 |         array_shift($params);
25 | 
26 |         if (count($params) > 0) {
27 |             $locale = $params[0];
28 | 
29 |             if (Translatable::checkLocaleInSupportedLocales($locale)) {
30 |                 App::setLocale($locale);
31 | 
32 |                 if (Translatable::isFallbackLocaleHidden() && Translatable::isFallbackLocale($locale)) {
33 |                     array_shift($params);
34 |                     $params = implode('/', $params);
35 |                     $url = $request->root()."/$params";
36 |                     $query = http_build_query($request->all());
37 |                     $url = ($query) ? "$url?$query" : $url;
38 | 
39 |                     Session::reflash();
40 | 
41 |                     return new RedirectResponse($url, 302, ['Vary' => 'Accept-Language']);
42 |                 }
43 |             }
44 |         }
45 | 
46 |         return $next($request);
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Traits/HasTranslations.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace SertxuDeveloper\Translatable\Traits;
 4 | 
 5 | use Illuminate\Support\Facades\App;
 6 | use Illuminate\Support\Facades\DB;
 7 | 
 8 | trait HasTranslations
 9 | {
10 |     /**
11 |      * Get the translated $attribute if not exist return the fallback translation
12 |      */
13 |     public function getTranslated(string $attribute, ?string $lang = null): ?string {
14 |         if (!$lang) {
15 |             $lang = App::getLocale();
16 |         }
17 | 
18 |         if (config('translatable.fallback_locale') === $lang) {
19 |             return $this[$attribute];
20 |         }
21 | 
22 |         $translation = DB::table($this->table.config('translatable.table_suffix'))
23 |             ->where([
24 |                 ['locale', $lang], [
25 |                     $this->getKeyName(), $this->getKey(),
26 |                 ],
27 |             ])->first();
28 | 
29 |         return (!isset($translation->$attribute)) ? $this[$attribute] : $translation->$attribute;
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Translatable.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | namespace SertxuDeveloper\Translatable;
  4 | 
  5 | use Illuminate\Support\Facades\Route;
  6 | use Illuminate\Support\Facades\URL;
  7 | 
  8 | use function count;
  9 | 
 10 | class Translatable
 11 | {
 12 |     /**
 13 |      * Check if the provided locale is within the supported locales.
 14 |      *
 15 |      * @param  string  $locale  The locale to check.
 16 |      */
 17 |     public function checkLocaleInSupportedLocales(string $locale): bool {
 18 |         $locales = config('translatable.locales');
 19 | 
 20 |         return in_array($locale, $locales);
 21 |     }
 22 | 
 23 |     /**
 24 |      * Get the locale from the URL.
 25 |      */
 26 |     public function getLocaleFromRequest(): string {
 27 |         $params = explode('/', request()->getPathInfo());
 28 | 
 29 |         // Dump the first element (empty string) as getPathInfo() always returns a leading slash
 30 |         array_shift($params);
 31 | 
 32 |         if (count($params) > 0) {
 33 |             $locale = $params[0];
 34 | 
 35 |             if ($this->checkLocaleInSupportedLocales($locale)) {
 36 |                 return $locale;
 37 |             }
 38 |         }
 39 | 
 40 |         return app()->getLocale() ?? config('translatable.fallback_locale');
 41 |     }
 42 | 
 43 |     /**
 44 |      * Check if the provided locale is the fallback locale.
 45 |      *
 46 |      * @param  string  $locale  The locale to check.
 47 |      */
 48 |     public function isFallbackLocale(string $locale): bool {
 49 |         return config('translatable.fallback_locale') === $locale;
 50 |     }
 51 | 
 52 |     /**
 53 |      * Get if the fallback locale should be hidden from the URL.
 54 |      */
 55 |     public function isFallbackLocaleHidden(): bool {
 56 |         return config('translatable.hide_fallback_locale');
 57 |     }
 58 | 
 59 |     /**
 60 |      * Given a route name or path, return it localized if possible.
 61 |      *
 62 |      * @param  string  $name  The route name or path to localize.
 63 |      * @param  mixed  $parameters  The route parameters.
 64 |      * @param  bool  $absolute  Whether to return an absolute URL.
 65 |      * @param  string|null  $locale  The locale to use.
 66 |      * @return string The localized route.
 67 |      */
 68 |     public function route(string $name, $parameters = [], bool $absolute = false, ?string $locale = null): string {
 69 |         $name = $this->stripLocaleFromRouteName($name);
 70 | 
 71 |         $currentLocale = $this->getLocaleFromRequest();
 72 |         $fallbackLocale = config('translatable.fallback_locale');
 73 |         $locale = $locale ?: $currentLocale;
 74 | 
 75 |         /** The provided $name is a route name */
 76 |         if (Route::has($name)) {
 77 |             if (!$this->isFallbackLocaleHidden() || $locale !== $fallbackLocale) {
 78 |                 $name = "$locale.$name";
 79 |             }
 80 | 
 81 |             return URL::route($name, $parameters, $absolute);
 82 |         }
 83 | 
 84 |         /** The provided $name is a route path */
 85 |         $params = explode('/', $name);
 86 |         if ($params[0] == null) {
 87 |             array_shift($params);
 88 |         }
 89 | 
 90 |         if (count($params) > 0) {
 91 |             if ($this->checkLocaleInSupportedLocales($params[0])) {
 92 |                 array_shift($params);
 93 |             }
 94 | 
 95 |             $params = implode('/', $params);
 96 | 
 97 |             if (!$this->isFallbackLocaleHidden() || !$this->isFallbackLocale($locale)) {
 98 |                 $params = "$locale/$params";
 99 |             }
100 | 
101 |             return URL::to($params);
102 |         }
103 | 
104 |         /** Fallback */
105 |         return URL::route($name, $parameters, $absolute);
106 |     }
107 | 
108 |     /**
109 |      * Get the current path localized with the provided locale.
110 |      *
111 |      * @param  string  $locale  The locale to use.
112 |      * @return string The localized path.
113 |      */
114 |     public function switchToLocale(string $locale): string {
115 |         $root = request()->root();
116 |         $params = explode('/', request()->getPathInfo());
117 | 
118 |         // Dump the first element (empty string) as getPathInfo() always returns a leading slash
119 |         array_shift($params);
120 | 
121 |         if (count($params) === 0) {
122 |             return "$root";
123 |         }
124 | 
125 |         if (!$this->checkLocaleInSupportedLocales($locale)) {
126 |             return "$root";
127 |         }
128 | 
129 |         if ($this->checkLocaleInSupportedLocales($params[0])) {
130 |             array_shift($params);
131 |         }
132 | 
133 |         $params = implode('/', $params);
134 | 
135 |         $url = ($this->isFallbackLocaleHidden() && $this->isFallbackLocale($locale))
136 |           ? $params : "$locale/$params";
137 | 
138 |         return "$root/$url";
139 |     }
140 | 
141 |     /**
142 |      * Strip the locale from the beginning of a route name.
143 |      *
144 |      * @param  string  $name  The route name to strip.
145 |      * @return string The stripped route name.
146 |      */
147 |     protected function stripLocaleFromRouteName(string $name): string {
148 |         $parts = explode('.', $name);
149 | 
150 |         /** If there is no dot in the route name, couldn't be a locale in the name. */
151 |         if (count($parts) === 1) {
152 |             return $name;
153 |         }
154 | 
155 |         /** Get the locales from the configuration file */
156 |         $locales = config('translatable.locales', []);
157 | 
158 |         /** If the first part of the route name is a valid locale, then remove it from the array. */
159 |         if (in_array($parts[0], $locales)) {
160 |             array_shift($parts);
161 |         }
162 | 
163 |         /** Rebuild the normalized route name. */
164 |         return implode('.', $parts);
165 |     }
166 | }
167 | 


--------------------------------------------------------------------------------
/src/TranslatableServiceProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace SertxuDeveloper\Translatable;
 4 | 
 5 | use Illuminate\Foundation\AliasLoader;
 6 | use Illuminate\Support\ServiceProvider;
 7 | use SertxuDeveloper\Translatable\Facades\Translatable as TranslatableFacade;
 8 | use SertxuDeveloper\Translatable\Macros\TranslatableRoutesMacro;
 9 | 
10 | class TranslatableServiceProvider extends ServiceProvider
11 | {
12 |     /**
13 |      * Bootstrap any application services.
14 |      *
15 |      * @return void
16 |      */
17 |     public function boot() {
18 |         $this->registerPublishableFiles();
19 |         $this->registerMacros();
20 |         $this->mergeConfig();
21 |     }
22 | 
23 |     /**
24 |      * Register any application services.
25 |      *
26 |      * @return void
27 |      */
28 |     public function register() {
29 |         $loader = AliasLoader::getInstance();
30 |         $loader->alias('Translatable', TranslatableFacade::class);
31 | 
32 |         $this->app->singleton('translatable', function () {
33 |             return new Translatable;
34 |         });
35 | 
36 |         $this->loadHelpers();
37 |     }
38 | 
39 |     /**
40 |      * Register macros.
41 |      *
42 |      * @return void
43 |      */
44 |     protected function registerMacros() {
45 |         TranslatableRoutesMacro::register();
46 |     }
47 | 
48 |     /**
49 |      * Register the publishable files.
50 |      *
51 |      * @return void
52 |      */
53 |     protected function registerPublishableFiles() {
54 |         $packagePath = dirname(__DIR__);
55 | 
56 |         $publishable = [
57 |             'trans-config' => [
58 |                 "$packagePath/publishable/config/translatable.php" => config_path('translatable.php'),
59 |             ],
60 |         ];
61 | 
62 |         foreach ($publishable as $group => $paths) {
63 |             $this->publishes($paths, $group);
64 |         }
65 |     }
66 | 
67 |     /**
68 |      * Merge published configuration file with
69 |      * the original package configuration file.
70 |      */
71 |     protected function mergeConfig() {
72 |         $this->mergeConfigFrom(dirname(__DIR__).'/publishable/config/translatable.php', 'translatable');
73 |     }
74 | 
75 |     /**
76 |      * Get dynamically the Helpers from the /src/Helpers directory and require_once each file.
77 |      */
78 |     protected function loadHelpers() {
79 |         foreach (glob(__DIR__.'/Helpers/*.php') as $filename) {
80 |             require_once $filename;
81 |         }
82 |     }
83 | }
84 | 


--------------------------------------------------------------------------------