README

##Configuration

Before using translate module methods, you must create configuration and enter your Google API Key for using Google Translate API

All you need is create configuration class which is working thanks to SamsonPHP module/service configuration:

class Google_TranslateConfig extends \samson\core\Config
{
    public $apiKey = 'Your_Google_API_Key';
}

Creating translate request

After creating configuration you can make request to Google Translate API. To create simple request you must define source language of you text and target language which you want to get. To identify languages you can use source($source) and target($target) methods.

For example you want to translate 'Hello World' to french:

/** @var \samson\google\Translate $trans Get SamsonPHP GoogleTranslate module */
$trans = m('google_translate');

// Source text
$helloWorld = 'Hello World';

// Translated text
$bonjourLeMonde = $trans->source('en')->target('fr')->trans($helloWorld);

Fixing translation errors

If you have some problems with API Key or you have make some errors in defining source or target locales, you will get error from Google Translate API. You can check status of your request using method lastRequestStatus():

/** @var \samson\google\Translate $trans Get SamsonPHP GoogleTranslate module */
$trans = m('google_translate');

// Source text
$helloWorld = 'Hello World';

// Translated text
$bonjourLeMonde = $trans->source('gb')->target('fr')->trans($helloWorld);
// Is false, because gb locale is not found in Google language codes.

// Will return 'Invalid value'
echo $trans->lastRequestStatus(); 

This module is working using Google Translate API