torann/localization

Simple subdomain localization for Laravel.

Laravel Localization - Simplified

, _(*1)

Simplified localization for Laravel based on the application's subdomain., _(*2)

Table of Contents

• Installation
  • Composer
  • Laravel
• Methods
• Helpers
• Determining Locale
• License
• Localization on Packagist
• Localization on GitHub

Installation

Composer

From the command line run:, _(*3)

$ composer require torann/localization

Laravel

Once installed you need to register the service provider with the application. Open up config/app.php and find the providers key., _(*4)

``` php 'providers' => [, <sub>(*5)</sub>

\Torann\Localization\LocalizationServiceProvider::class,

], <sub>(*6)</sub>

### Publish the configurations

Run this on the command line from the root of your project:

```bash
php artisan vendor:publish --provider="Torann\Localization\LocalizationServiceProvider"

A configuration file will be publish to config/localization.php., <sub>(*7)</sub>

Methods

The following methods are available:, <sub>(*8)</sub>

Torann\Localization\LocaleManager

• getNonLocalizedURL($url = null)
• getDefaultLocale()
• setLocale($locale = null)
• localizeURL($locale = null, $url = null)
• getLocalizedURL($locale = null, $url = null, $attributes = [])
• getSupportedLocales()
• getCurrentLocale()
• getCurrentLocaleDirection()
• getCurrentLocaleName()
• getCurrentLocaleNative()
• getCurrentLocaleScript()
• getCurrentLocaleNativeReading()
• getSupportedLanguagesKeys()
• checkLocaleInSupportedLocales($locale)
• getConfig($key, $default = null)

Helpers

Laravel Localization comes with a few helper methods, <sub>(*9)</sub>

localization()

Returns the Torann\Localization\LocaleManager instance., <sub>(*10)</sub>

localize_url($locale = null, $url = null, $attributes = [])

Returns the given URL adapted to provided locale., <sub>(*11)</sub>

Determining Locale

By Subdomain

For this to work the subdomain needs to match an enabled supported locale key., <sub>(*12)</sub>

By Host

When the given subdomain is determined to not be valid the system can then set the locale depending on the current host. You'll need to set a map of your application's locales to hosts using the hosts configuration option., <sub>(*13)</sub>

License

Localization is open-sourced software licensed under the BSD 2-Clause License., <sub>(*14)</sub>