Download the PHP package yak0d3/mirza_yandex_translator without Composer

Mirza Yandex Translator For Laravel

Mirza Translator gives you the ability to easily translate and manipulate text using the Yandex.Translate API.

Table Of Contents

1. Quick Start
2. Quick Usage Guide
3. Documentation
4. Methods
5. Blade Directives
6. Issues & Suggestions
7. License

Let's set this up real quick in just three mere steps!

• Navigate to your Laravel installation folder via the terminal/cmd and run composer require yak0d3/Mirza_Yandex_Translator or add "yak0d3/Mirza_Yandex_Translator": "^1.0.0" manually to your composer.json.

• Publish the configuration file using one of the following methods:

  1. Run php artisan vendor:publish --provider="yak0d3\Mirza_Yandex_TranslatorT\MirzaServiceProvider"
     2. Run php artisan vendor:publish and type the number behind yak0d3\Mirza_Yandex_TranslatorT\MirzaServiceProvider then press Enter
• Add environment variable to your .env file with the name YANDEX_API and set its value to your own Yandex.Translate API Key. (e.g. YANDEX_API=MY_YANDEX_API_KEY)

Note: You can get your FREE API Key from the Yandex.Translate Developers Dashboard

Quick Usage Guide

The quick usage guide is only meant to explain the basic usage of this package, for the list of methods and its relative information (Parameters, Return Type etc..) jump to the directives sections to view the list of available blade directives.

• Detect Language:
  Mirza::detectLanguage('Welcome');
  Output: en

• Translate text:
  Mirza::translate('Hello','es');
  Output: "Hola"

• Translate to Multiple Languages:
  Mirza::translateTo('Hello World!',['es', 'tr', 'fr']')
  
  Output:

Note: You can decode this string by using the json_decode function.

• Translate an Array of Text:
  $textArray = ['Hello','My Dear','Friend'];
Mirza::translateArray($textArray,'fr');
  Output:

Note: You can decode this string by using the json_decode function.

Still not getting it? Take a look at the Documentation below and the confusion will go away!

Let's admin it, not everyone in here will find it easy to start using this package, so let's try to understand what's happening together. This section will cover the usage of each and every method provided by Mirza Yandex Translator, here is the table of contents:

1. The translate method
   2. The translateArray method
      1. Using sequential arrays
      2. Using associative arrays
   3. The translateTo method
   4. The detectLanguage method
      1. Return language code
      2. Return language name
   5. The getSupportedLanguages method
   6. The translateToAll method
   7. Blade directives
      1. @translate directive
      2. @yandex_rights directive
      3. @languages_select directive
         1. The translate method

         As you have already expected, for sure there is a translate method for a translator package, this method takes two parameters; the text and the ISO code of the target language.

Example:

Note that all json strings needs to be decoded using the PHP json_decode function. Tip: To return a PHP array set the second argument of json_decode to true (e.g. json_decode($jsonString, true); ).
If you prefer manipulating json objects, leave the second argument empty or set it to false.

Mirza::translateArray(['Hello', 'My Dear', 'Friend'],'fr'); this method translates a given array of text into which is in our case this array ['Hello', 'My Dear', 'Friend'] and translates it to a given language which is French in our example.
This function returns a json encoded string like the following:

As you can see, the output json string is in the same order of the input array, now we can access each of these elements by decoding the string like so:

Easy, right? But it could get easier if you set the the $assoc parameter to true so you are able to access your string translations by their index names (that you have set manually). No body is getting confused in here, here is an example:

Note: If you set $assoc to true and provide a sequential array an exception will be thrown.

This method is (maybe) the reverse version of the previous function, instead of taking an array of strings, this method takes one string and translates it to an array of languages. Example:

The above example will return json string with the following structure:

You may have noticed that some of the characters are in Unicode format, no worries if you echo it later on it will be displayed correctly.

Now we can easily decode this json string and access our data like so:

You sometimes need to detect in which language a text is written, the detectLanguage method is made just for this matter! As mentioned in the methods table, this method takes one required parameter and one optional. The optional parameter (boolean $name) lets us switch between returning the language ISO code or the language name.

Example:

• Return language code:
• Return language name:

This method takes no parameters (it should, but that will be added in a later version) and if executed it returns the list of all the supported languages.

Example:

I didn't want to include the whole output because it is so long, but if you are still curious about it, i was prepared for this! Here is a screenshot:

Let's decode this json string and play a little bit!

Let's say we have a language code, but we don't know to what language it refers, this line would help us a lot in such a case:

Now supposing that we have a language name, but we doesn't know the ISO code, EASY PEASY! We can do it with the PHP array_flip function

I don't know what you might use this method for, but i thought it would be nice to include such a feature. As mentioned in the method name, this method translates a given string to all of the supported languages.

Example:

• @translate: Allows you to translate a given text to a given language on the go

  Example:

• @yandex_rights: If you have read the Yandex.Translate requirements for the use of translation results you'd know that this directive will be very useful.
  You have to specify the color as the first argument and the font-size as the second one.

  Example:

  • @languages_select: Generates an HTML <select> with the list of all supported languages.

  Example:

Everything in Mirza is meant to be easy and readable, just by taking a look at the source code you will understand what's happening in no time. But don't worry, i have saved you the struggle and made a table containing the the list of methods that Mirza Translator provides.

Mirza has been tested by only one person (obviously me 😃), which means that problems might occur with others, if something went wrong with your Mirza installation or you think something is still missing, please let me know by submitting a new issue.