Translate functionality

[kartikbhat]

What is the difference between

Code: Select all

$this->translate( 'admin', 'Basic' )

and

aitrans( 'Top', $params = [], $domain = 'client', $locale = null )

When to use which method?

TIA

[aimeos]

"aitrans()" is a helper method you can use in Blade templates to access Aimeos translations, "$this->translate()" is a view helper only available in Aimeos views.

[kartikbhat]

What to pass for the parameters of the aitrans() function

Code: Select all

aitrans( 'Top', $params = [], $domain = 'client', $locale = null )

$params...
$domain...
$locale...

can I get a information on what these parameters indicate and how to pass language key in this function call ?

TIA

[aimeos]

The documentation for aitrans() is available here:
https://aimeos.org/docs/latest/laravel/ ... anslations

The parameters are:
- $singular : Text to translate
- $params : Array of values if $singular contains sprintf() placeholders (e.g. %1$s)
- $domain : Translation domain (same as first parameter for $this->translate())
- $locale : Language code if different from the one for the page

For your example:

Code: Select all

aitrans('Top')

With placeholders:

Code: Select all

aitrans('%1$s results found', [10])

With different domain:

Code: Select all

aitrans('price:default', [], 'client/ext')

Output French translation in e.g. a page with English texts:

Code: Select all

aitrans('Top', [], 'client', 'fr)

[kartikbhat]

Thank you for the detailed explaination

I didn't got the value 'client' - a third parameter

is it a index present in shop.php ?

Code: Select all

'client' => [
  'en'=>[
      'header'=>[
          'key1'=>'value2',
          'key2'=>'value2',
        ],
      'footer'=>[
            'key3'=>'value3',
            'key4'=>'value4',
       ]
   ],
   'fr'=>[
      'header'=>[
          'key1'=>'value2',
          'key2'=>'value2',
        ],
      'footer'=>[
            'key3'=>'value3',
            'key4'=>'value4',
       ]
   ],
   'de'=>[
      'header'=>[
          'key1'=>'value2',
          'key2'=>'value2',
        ],
      'footer'=>[
            'key3'=>'value3',
            'key4'=>'value4',
       ]
   ]
]

how these values can be access from aitrans() function

Please let me know...

TIA

[aimeos]

Yes, the third parameter matches e.g. the

Code: Select all

'i18n' => ['client' => []]
// or
'i18n' => ['client/ext' => []]

key in your ./config/shop.php

[kartikbhat]

How to maintain separate files for multiple language keys, as I have huge set of translative sentences/words, as we do in Laravel, separate folder for each languages.
Is it possible in Aimeos ? how we can access from either $translate or aitrans() functions ?

[aimeos]

For a large list of translations, use the Gettext files instead where you have one file per language in an optimized binary format:
https://aimeos.org/docs/latest/developer/translations/