.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../Includes.txt


.. _introduction:

Introduction
============


.. _what-it-does:

What does it do?
----------------

This extension add the functionalility to TYPO3 to give you a full language fallback to another language than your default language.

Just add this to your TS setup to fall back to a language of your choice.

Configuration
"""""""""""""

.. container:: table-row

   Property
         config.sys_language_mode
   Data type
         string
   Description
         Setting various modes of handling localization.

         The syntax is "[keyword] ; [value]".

         Possible keywords are:

         content_fallback: Recommended. The system will always operate with the selected language even if the page is not translated with a page overlay record. This will keep menus etc. translated. However, the content on the page can still fall back to another language, defined by the value of this keyword, e.g. "content_fallback ; 1,0" to fall back to the content of sys_language_uid 1 and if that is not present either, to default (0).

         strict: The system will report an error if the requested translation does not exist. Basically this means that all pages with gray background in the Web > Info / Localization overview module will fail (they would otherwise fall back to default language in one way or another).

         ignore: The system will stay with the selected language even if the page is not translated and there's no content available in this language, so you can handle that situation on your own then.

   Default
         The system will look for a translation of the page (from "Alternative Page Language" table) and if it is not found it will fall back to the default language and display that.


.. container:: table-row

   Property
         config.sys_language_fallBackOrder
   Data type
         string
   Description
         Add all TypoScript properties as a comma separated list which need support for stdWrap.

         As an example to configure fallback to language with uid 1 first and afterwards to uid 0: ::

			 config {
			   # standard TYPO3 setting
			   sys_language_mode = content_fallback ; 1,0
			   sys_language_fallBackOrder = 1,0
			 }

You can configure these settings to all of your languages seperatly whithin their conditions.