yamsafer/name-translation

package to translate names with one of the two ways 1.Rosette 2.Google Translate

name-translation

Transliterate the names in your content, don’t translate., _(*1)

Getting Started

This package is constructed to allow users to translate names from a source language to a target language with two possible connections (Rosette ,Google Translate)., _(*2)

After downloading the package, you need to set your API KEYs for the previously mentioned connections in the configuration file (config/name-translation.php)., _(*3)

Also, you need to assign them in the test file (tests/NameTranslation/TranslatioTest) if you want to run the used tests in the package., _(*4)

By default,the translation will be held with the Rosette Connection from English to Arabic., _(*5)

You can use the main method translate($name, $source, $target), which take three parameters as $name => The given name that you want to translate (must be given) $source => The source language (optional _default = arabic); $target => The source language (optional _default = english)., _(*6)

Prerequisites

The requirements for this package are:, _(*7)

    php: ">=5.6.4",
    illuminate/support: "~5.0"

Also for the tests,you need to have the following in the require-dev:, _(*8)

    "phpunit/phpunit": "5.0.*"

Also, the test configuration includes the code coverage which can be enabled if you have Xdebug in your system. Xdebug can be installed via brew install:, _(*9)

brew install < php-version >-xdebug, _(*10)

eg., _(*11)

brew install php56-xdebug, _(*12)

Installing

Install the package via composer:, _(*13)

     composer require yamsafer/name-translation

Register the ServiceProvider in config/app.php, _(*14)

    'providers' => [
    // [...]
            NameTranslation\TranslationServiceProvider::class,
    ],

You may also register the NameTranslation Facade:, _(*15)

    'aliases' => [
    // [...]
            'NameTranslation' => NameTranslation\Facades\NameTranslationFacade::class,
    ],

Within your laravel project, when you execute Laravel's vendor:publish command, the configuration will be published., _(*16)

Run Tests

You can run the tests using the following command under the previously mentioned specifications:, _(*17)

  vendor/bin/phpunit tests/NameTranslation/TranslationTest.php

Within your project you must assign the right directory as:, _(*18)

  vendor/bin/phpunit yamsafer/name-translation/tests/NameTranslation/TranslationTest.php