Download the PHP package paschal-customize-tracy/eloquent-translate without Composer

A package to translate Laravel eloquent Models easily

This package is customized from the package of Ezeugwu Paschal ([email protected]) https://github.com/paschaldev/eloquent-translate This package serves as the complete solution to handling translations in a laravel application for data stored in the database. Translations for every model are stored in a database table. By default, automatic translation is enabled. Automatic translation uses third party provider(s) to translate your database attributes, the default for now is Google Translate API. If you choose not to use a third party translation service, you can also manually set your translation for any model.

Installation

You can install easily via composer.

The package will automatically register itself for supported laravel versions, if not, you should add this to your providers array in config/app.php

Then after that you can publish

This will copy the configuration to your config path.

For Lumen, open your bootstrap/app.php and add this line to register a provider

And this line to setup configuration

Then run php artisan migrate to create the translations table. The default table name is translations but you can override this value in the configuration file.

Setup

In order to make a model translatable, you need to include the trait in your model and also set the translateAttributes property. This properties are the attributes you wish to translate in that particukar DB column.

Once you have this done on your model, any update or create action on your model will automatically create your translations if you have the auto_translate set to true in your configuration.

Resolving trait collisions

This package uses the getAttribute method in your model, you might already be using that or a library you have is using that. You'll start getting errors during translations because multiple packages are trying to set the same methods on a model.

If you don't have a package that uses the getAttribute property, you can skip this section.

In order to resolve this, you need to make use of the as keyword in your traits. For my own scenario, I had this library Metable that already uses the getAttribute method so here is how to resolve this issue.

As you can see, using the as, we can alias the getAttribute method of each individual package so that we can still have access to it. Lastly, you need to define a getAttribute method in your model if one does not exist and call the translation's method last and pass $attr as the second parameter. The $attr stands for the final resolved attribute from all library's after collusion. After that, you're good to go.

Usage

Setting Translation

Please see the configuration file eloquent-translate.php after publishing for all possible options.

Originally, this package registers an observer to listen to the created and updated event in your model then automatically translate the attributes if you have auto_translate set to true in your configuration using a third party provider, the default for now is Google Translate API.

If you're going to be using Google Translate API, you need to get a Google API Key from Google Console Cloud, make sure you enable translation API then copy and paste this key in your configuration file's google_api_key.

Automatic translation will likely slow down your app becuase it has to connect to Google and depending on the number of locales you set for it to translate to, your app will drag and might become unresponsive.

In order to fix this, make sure queue is set to true and you can optionally specify a queue_name to use. Please see Laravel's documentation on Queue if you don't understand how queues work.

Define your locales in the configuration file and when the package will translate your attributes to each of the locales defined.

If you prefer not to use automatic translation, you can manually set translations individually for your models. There are two methods available.

The attribute name, make sure it is defined in your $translateAttributes array in your model. The $locale you want to set and the translation.

The $force argument if set to true will make you add attribute even if the attributes are not defined in your model file.

You can also set all your translations for a model in multiple locales at a go.

Use it like this.

In the code above, we are setting translations for the name attribute on the model assuming the value is Good Morning to 3 locales at once: French, Igbo, Yoruba.

Fetching Translation

What did I customize?

• I change updateOrCreate function on class Translator to upsert function, think it will improve speed a little
• Add addGlobalScope to use eager loading, avoiding lazy load (old code)
• Override translation attributes, the idea is:
  • First, we have to add translation attributes to appends. $this->appends = array_merge($this->appends, $this->getTranslationAttributes());
  • Second, use __call to handle getxxxAtribute function because laravel will call getxxxAtribute as it appears on appends property
• Handle notranslate: add tag if it includes strings which we do not want to translate
• Change TranslateCommand

Important note

• I just add more manual translate, please set env MANUAL_TRANSLATE = false if you want to translate by google cloud automaticly