Localisation: C3P0 for Laravel. Take a look at contributing.md to see a to do list.

Via Composer run the following:

# Install the package.
$ composer require pwweb/localisation

# Publish config, migration, languages and controllers.
# Note: Individual publishing tags are available, see chapter Customizing.
$ php artisan vendor:publish --provider="PWWEB\Localisation\LocalisationServiceProvider"

# Run migrations
$ php artisan migrate

The package assumes a standard Laravel installation if the bundled default contollers for the entities are to be used. The bundled controllers extend from App\Http\Controllers\Controller. If other, custom base controllers are used as part of the installation, refer to Customizing.

The package provides the following tags for publishing individual components for customizing:

It is recommended to change your app.php to use both the ISO-639-1 ISO Language Code as well as the ISO-3166 ISO Country Code. This can be achieved by changing the following two variables:

<?php

return [
    ...
    'locale' => 'en-GB',
    'fallback_locale' => 'en-GB',
    ...
];

The package provides a trait HasAddresses which can be used to allow models to be associated with addresses.

<?php

namespace Path\To;

use Illuminate\Database\Eloquent\Model;
use PWWEB\Localisation\Traits\HasAddresses;

class MyModel extends Model
{
    use HasAddresses;
}

The localisation package provides a language switcher that can easily be added to blade templates as follows (note: the <div> is exemplary):

...
<div class="anyContainer">
    {{ Localisation::languageSelector() }}
</div>
...

The package provides a graphql.schema file for use within your parent project. This can be included in your primary schema file as follows:

#import ../vendor/pwweb/localisation/graphql/schema.graphql

Note: don't forget to update the vendor path should yours be in a different location, relative to your primary schema file.

During install via composer you get the following messages:

 ErrorException  : Trying to access array offset on value of type null

  at /var/www/vendor/pwweb/localisation/src/LocalisationServiceProvider.php:107
    103|     protected function registerModelBindings()
    104|     {
    105|         $config = $this->app->config['localisation.models'];
    106|
  > 107|         $this->app->bind(CountryContract::class, $config['country']);
    108|         $this->app->bind(LanguageContract::class, $config['language']);
    109|         $this->app->bind(CurrencyContract::class, $config['currency']);
    110|     }
    111|

  Exception trace:

  1   Illuminate\Foundation\Bootstrap\HandleExceptions::handleError("Trying to access array offset on value of type null", "/var/www/vendor/pwweb/localisation/src/LocalisationServiceProvider.php", [])
      /var/www/vendor/pwweb/localisation/src/LocalisationServiceProvider.php:107

  2   PWWeb\Localisation\LocalisationServiceProvider::registerModelBindings()
      /var/www/vendor/pwweb/localisation/src/LocalisationServiceProvider.php:81

  Please use the argument -v to see more details.

This is due to the command php artisan config:cache has been run. We suggest you delete the cache file bootstrap/cache/config.php and then run composer dump-autoload to be sure.

Please see the changelog for more information on what has changed recently.

Please see contributing.md for details and a todolist.

If you discover any security related issues, please use the issue tracker.

• PW*Websolutions
• All Contributors

Copyright © pw-websolutions.com. Please see the license file for more information.