.. _Nng\Nnhelpers\ViewHelpers\TranslateViewHelper:

=======================================
translate
=======================================

Description
---------------------------------------

<nnt3:translate />
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Translate a text, including optional translation via Deep-L.

See also the ``TranslationHelper`` documentation for integration via PHP or a controller.

.. code-block:: php

	// Translation via locallang.xlf
	{mytext->nnt3:translate(id:'LLL:EXT:nnaddress/Resources/Private/Language/locallang_db.xlf:my-ll-id')}
	{mytext->nnt3:translate(id:'my-ll-id', extensionName:'nnaddress')}

.. code-block:: php

	// translation via Deep-L
	{nnt3:translate(id:'my-ll-id', text:'The text', extensionName:'nnaddress', enableApi:1, translate:1, targetLang:'EN', maxTranslations:2)}
	{mytext->nnt3:translate(id:'my-ll-id', extensionName:'nnaddress', enableApi:1, translate:1, targetLang:'EN', maxTranslations:2)}
	{mytext->nnt3:translate(id:'my-ll-id', enableApi:1, translate:1, targetLang:'EN', cacheFolder:'EXT:nnsite/path/to/somewhere/')}
	{mytext->nnt3:translate(id:'my-ll-id', enableApi:1, translate:1, targetLang:'EN', cacheFolder:'typo3conf/l10n/demo/')}

.. code-block:: php

	// Translate a block in the Fluid template
	
	  I will be translated automatically, including all HTML tags!