# php-google-translator
Php wrapper for google javascript translator website plugin. It will create a dropdown option for languages.


## Installation
Installation is super-easy via Composer:
```md
composer require peterujah/php-google-translator
```
# USAGES
Initalize with page languages
```php
use Peterujah\NanoBlock\GTranslator;
$translate = new GTranslator("en", "/assets/flags/");
```
Or without icon path
```php
use Peterujah\NanoBlock\GTranslator;
$translate = new GTranslator("en");
```
set selector design provider, you can choose between `DEFAULT`, `SELECT` or `BOOTSTRAP.`
The `DEFAULT` is the default provider
```php
$translate->setProvider(GTranslator::DEFAULT || GTranslator::SELECT || GTranslator::BOOTSTRAP);
```
Set languages icon path and icon type `GTranslator::PNG || GTranslator::SVG`.
`PNG` or `SVG` to use icons download country language flag icon and set the Relative or Absolute path
```php
$translate->setIconPath("https://foo.com/assets/flags/", GTranslator::PNG);
```
Or set individually by first setting path and then type to override the default type
```php
$translate->setIconPath("/assets/flags/")->setIconType(GTranslator::PNG);
```
Adding additional language to translator
```php
$translate->addLanguage("en", "English")->addLanguage("ig", "Igbo");
```
Or load your languages to override the default
```php
$translate->setLanguages([
"en" => "English",
"ig" => "Igbo"
])
```
Display select option for languages, it accepts optional width.
```php
$translate->button(optional width = "50%");
```
When your provider is `GTranslator::SELECT`, button will return a html select option.
```php
$translate->button();
```
To use image button, your provider must be `GTranslator::DEFAULT`
```php
$translate->imageButton();
```
Load translator javascript plugin
```php
$translate->load();
```
Sets dropdown contemner class name.
```php
$translate->setContainerClass("my-translator");
```
Sets dropdown items class name.
```php
$translate->setItemsClass("my-translator");
```
Set preferred language, this must be called after `$translate->load();`
```php
$translate->preferredLanguage("ms");
```
Automatically detect browser language, this must be called after `$translate->load();`
```php
$translate->autoTranslate();
```
Full usage on website to translate webpage
```php
PHP Google Translator
button();?>
We have a long history of service in the Bay Area
We were one of the first credit unions that operate world wide, founded in 1932 as City & County Employees' Credit Union.
Membership is now open to anyone who lives, works, or attends school in
Alameda, Contra Costa, San Joaquin, Solano, Stanislaus, or Kings counties in California.
We believe in banking locally and hope you will too.
load();$translate->preferredLanguage("ms");?>
```