117 lines
5.2 KiB
Markdown
117 lines
5.2 KiB
Markdown
# Translations
|
||
|
||
Your website is displayed in the language that matches your visitor’s browser. If the browser’s
|
||
language has not been installed and added to your website, the content is shown in the
|
||
{ref}`default language <translate/default-language>`. When additional languages are installed, users
|
||
can choose their preferred language using the {ref}`language selector <translate/language-selector>`.
|
||
|
||
The {ref}`Translate <translate/translate>` feature on your website allows automatic translation of
|
||
standard terms and provides a tool for manual content translation.
|
||
|
||
## Install languages
|
||
|
||
To allow translation of your website, you must first {doc}`install <../../../general/users/language>`
|
||
the required languages and add them to your website. To do so, go to {menuselection}`Website -->
|
||
Configuration --> Settings` and click {icon}`fa-arrow-right` {guilabel}`Install languages` in the
|
||
{guilabel}`Website Info` section. In the dialog box that opens, select the {guilabel}`Languages` you
|
||
want from the dropdown menu, tick the required {guilabel}`Websites to translate`, and
|
||
click {guilabel}`Add`.
|
||
|
||
To edit your website's languages, go to {menuselection}`Website -–> Configuration -–> Settings` and
|
||
add/remove the required languages in/from the {guilabel}`Languages` field in the
|
||
{guilabel}`Website info` section.
|
||
|
||
:::{tip}
|
||
Alternatively, once the languages have been installed, you can add them from the {ref}`language
|
||
selector <translate/language-selector>`. You might then need to refresh your page to see the new
|
||
language.
|
||
:::
|
||
|
||
(translate-default-language)=
|
||
|
||
### Default language
|
||
|
||
When multiple languages are available on your website, you can set a default language to be used if
|
||
the visitor’s browser language is not available. To do so, go to {menuselection}`Website –->
|
||
Configuration -–> Settings`, and select a language in the {guilabel}`Default` field.
|
||
|
||
:::{note}
|
||
This field is only visible if multiple languages have been installed and added to your website.
|
||
:::
|
||
|
||
(translate-language-selector)=
|
||
|
||
## Language selector
|
||
|
||
Your website’s visitors can switch languages using the language selector, available by default in
|
||
the {guilabel}`Copyright` section at the bottom of the page. To edit the language selector menu:
|
||
|
||
1. Go to your website and click {guilabel}`Edit`;
|
||
|
||
2. Click the language selector available in the {guilabel}`Copyright` block and go to the
|
||
{guilabel}`Copyright` section of the website builder;
|
||
|
||
3. Set the {guilabel}`Language Selector` field to either {guilabel}`Dropdown` or {guilabel}`Inline`.
|
||
Click {guilabel}`None` if you do not want to display the {guilabel}`Language selector`;
|
||
|
||
> ```{image} translate/language-selector.png
|
||
> :alt: Add a language selector menu.
|
||
> ```
|
||
|
||
4. Click {guilabel}`Save`.
|
||
|
||
:::{tip}
|
||
You can also add the {guilabel}`Language Selector` to the {guilabel}`Header` of your page. To do
|
||
so, click the {guilabel}`Header` block and go to the {guilabel}`Navbar` section to edit the
|
||
{guilabel}`Language Selector`.
|
||
:::
|
||
|
||
(translate-translate)=
|
||
|
||
## Translate your website
|
||
|
||
Select your desired language from the language selector to see your content in another language.
|
||
Then, click the {guilabel}`Translate` button in the top-right corner to manually activate the
|
||
translation mode so that you can translate what has not been translated automatically by Odoo.
|
||
|
||
Translated text strings are highlighted in green; text strings that were not translated
|
||
automatically are highlighted in yellow.
|
||
|
||
```{image} translate/translated-text.png
|
||
:alt: Entering the translation mode
|
||
```
|
||
|
||
In this mode, you can only translate text. To change the page's structure, you must edit the master
|
||
page, i.e., the page in the original language of the database. Any changes made to the master page
|
||
are automatically applied to all translated versions.
|
||
|
||
To replace the original text with the translation, click the block, edit its contents, and
|
||
{guilabel}`Save`.
|
||
|
||
:::{note}
|
||
When a website supports multiple languages, the core URL structure remains consistent across
|
||
languages, while specific elements like product names or categories are translated. For example,
|
||
`https://www.mywebsite.com/shop/product/my-product-1` is the English version of a product page,
|
||
while `https://www.mywebsite.com/fr/shop/product/mon-produit-1` is the French version of the same
|
||
page. The structure (/shop/product/) stays unchanged, but the translated elements (e.g., product
|
||
name) adapt to the selected language.
|
||
:::
|
||
|
||
:::{tip}
|
||
Once the desired language is installed, you can translate some items from the backend (e.g., the
|
||
product's name in the product form). To do so, click the language code (e.g., {guilabel}`EN`) next
|
||
to the text you want to translate and add the translation.
|
||
:::
|
||
|
||
### Content visibility by language
|
||
|
||
You can hide content (such as images or videos, for example) depending on the language. To do so:
|
||
|
||
1. Click {guilabel}`Edit` and select an element of your website;
|
||
2. Go to the {guilabel}`Text - Image` section and {guilabel}`Visibility`;
|
||
3. Click {guilabel}`No condition` and select {guilabel}`Conditionally` instead;
|
||
4. Go to {guilabel}`Languages` to configure the condition(s) to apply by selecting
|
||
{guilabel}`Visible for` or {guilabel}`Hidden for`, and click {guilabel}`Choose a record` to
|
||
decide which languages are impacted.
|
||
|