|
1
|
CONTENTS OF THIS FILE
|
|
2
|
---------------------
|
|
3
|
|
|
4
|
* Introduction
|
|
5
|
* Requirements
|
|
6
|
* Recommended modules
|
|
7
|
* Installation
|
|
8
|
* Configuration
|
|
9
|
* Troubleshooting
|
|
10
|
* Maintainers
|
|
11
|
|
|
12
|
|
|
13
|
INTRODUCTION
|
|
14
|
------------
|
|
15
|
|
|
16
|
The Menu translation module, part of the Internationalization
|
|
17
|
(https://www.drupal.org/project/i18n) package, allows users to select a
|
|
18
|
translation mode for each menu.
|
|
19
|
|
|
20
|
* For a full description of the module, visit this page:
|
|
21
|
https://www.drupal.org/node/1113982.
|
|
22
|
|
|
23
|
* To submit bug reports and feature suggestions, or to track changes:
|
|
24
|
https://www.drupal.org/project/issues/i18n.
|
|
25
|
|
|
26
|
|
|
27
|
REQUIREMENTS
|
|
28
|
------------
|
|
29
|
|
|
30
|
This module requires the following module:
|
|
31
|
|
|
32
|
* Internationalization - https://www.drupal.org/project/i18n
|
|
33
|
|
|
34
|
|
|
35
|
RECOMMENDED MODULES
|
|
36
|
-------------------
|
|
37
|
|
|
38
|
* Internationalization Views - https://www.drupal.org/project/i18nviews
|
|
39
|
* Language Icons - https://www.drupal.org/project/languageicons
|
|
40
|
* Translation Overview - https://www.drupal.org/project/translation_overview
|
|
41
|
* Localization Client - https://www.drupal.org/project/l10n_client
|
|
42
|
* Internationalization contributions -
|
|
43
|
https://www.drupal.org/project/i18n_contrib
|
|
44
|
|
|
45
|
To link menu item menus to nodes, it is useful to have the following modules:
|
|
46
|
|
|
47
|
* Entity translation i18n menu module, a submodule of Entity translation -
|
|
48
|
https://www.drupal.org/project/entity_translation
|
|
49
|
* Menu translation node module - https://www.drupal.org/project/i18n_menu_node
|
|
50
|
|
|
51
|
|
|
52
|
INSTALLATION
|
|
53
|
------------
|
|
54
|
|
|
55
|
This is a submodule of the Internationalization module. Install the
|
|
56
|
Internationalization module as you would normally install a contributed Drupal
|
|
57
|
module. Visit https://www.drupal.org/node/895232 for further information.
|
|
58
|
|
|
59
|
|
|
60
|
CONFIGURATION
|
|
61
|
-------------
|
|
62
|
|
|
63
|
Language-specific menus
|
|
64
|
1. To create or edit a menu, navigate to Structure > Menus > (menu to edit) >
|
|
65
|
Edit.
|
|
66
|
2. In the Translation mode section, choose Fixed Language and a Language field
|
|
67
|
will appear.
|
|
68
|
3. Select a language, select Save, and add or update the menu items as needed.
|
|
69
|
The menu block will only appear when viewing content in the same language.
|
|
70
|
|
|
71
|
There are three modes available: Translate and Localize, Fixed Language, and No
|
|
72
|
Multilingual Options.
|
|
73
|
|
|
74
|
Translate and Localize:
|
|
75
|
The user can create one menu for all languages, and translate or localize each
|
|
76
|
menu item. There are two ways that menu items will be translated.
|
|
77
|
1. The user can set a language when creating a custom menu item so that the menu
|
|
78
|
item will only show up for that language. Menu items that link to nodes in a
|
|
79
|
particular language will be treated this way.
|
|
80
|
2. The user can localize other custom menu items without a language
|
|
81
|
(for example, menu items linking to Views pages). Use the Translate tab to
|
|
82
|
translate the menu item title and description. Translators can also use the
|
|
83
|
"Translate interface" pages to translate these menu items.
|
|
84
|
|
|
85
|
Fixed Language:
|
|
86
|
If the user chooses Fixed Language, they'll have to set up a separate menu in
|
|
87
|
each language. This could become tedious if have a lot of languages enabled on
|
|
88
|
the site, but is useful if the content or menu structure is different for each
|
|
89
|
language.
|
|
90
|
|
|
91
|
No Multilingual Options:
|
|
92
|
Only the menu will be translatable.
|
|
93
|
|
|
94
|
TROUBLESHOOTING
|
|
95
|
---------------
|
|
96
|
|
|
97
|
A menu item linked to a node will be displayed only when the node language
|
|
98
|
matches the page language. This is due to how the menu system works and the
|
|
99
|
"Language selection" feature in i18n. Therefore, to get translated menus items
|
|
100
|
that link to nodes, you first need translated content. For more information
|
|
101
|
visit https://www.drupal.org/docs/7/multilingual/translating-content.
|
|
102
|
|
|
103
|
|
|
104
|
MAINTAINERS
|
|
105
|
-----------
|
|
106
|
|
|
107
|
* Jose Reyero - https://www.drupal.org/u/jose-reyero
|
|
108
|
* Florian Weber (webflo) - https://www.drupal.org/u/webflo
|
|
109
|
* Peter Philipp - https://www.drupal.org/u/das-peter
|
|
110
|
* Joseph Olstad - https://www.drupal.org/u/joseph.olstad
|
|
111
|
* Nathaniel Catchpole - https://www.drupal.org/u/catch
|
