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 Block languages module, part of the Internationalization
|
17
|
(https://www.drupal.org/project/i18n) package, allows the user to configure
|
18
|
for which languages each block is visible.
|
19
|
|
20
|
* For a full description of the module,
|
21
|
visit https://www.drupal.org/node/1279698.
|
22
|
|
23
|
* To submit bug reports and feature suggestions, or to track changes visit
|
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
|
|
46
|
INSTALLATION
|
47
|
------------
|
48
|
|
49
|
This is a submodule of the Internationalization module. Install the
|
50
|
Internationalization module as you would normally install a contributed Drupal
|
51
|
module. Visit https://www.drupal.org/node/895232 for further information.
|
52
|
|
53
|
|
54
|
CONFIGURATION
|
55
|
-------------
|
56
|
|
57
|
The settings for visibility per language are provided under Visibility
|
58
|
Settings via the Languages tab when configuring a block.
|
59
|
|
60
|
The Languages tab also provides a setting for whether the block is translatable.
|
61
|
For custom blocks, the block title and the block content will be translatable.
|
62
|
For blocks defined by modules, only the block title will be translatable. If
|
63
|
"Make this block translatable" is selected, a Translate tab will appear for that
|
64
|
block. This tab provides a UI for adding translations of the block in each
|
65
|
available language.
|
66
|
|
67
|
|
68
|
TROUBLESHOOTING
|
69
|
---------------
|
70
|
|
71
|
Conflicts with Context
|
72
|
|
73
|
The Block languages module conflicts with the Context module, which alters how
|
74
|
blocks are rendered. This issue can be tracked in the Internationalization
|
75
|
issue queue: http://drupal.org/node/1343044
|
76
|
|
77
|
String Errors
|
78
|
|
79
|
The user must allow your used string format to be translated on
|
80
|
admin/config/regional/i18n/strings or you are going to have an error message
|
81
|
like "The string blocks:block:1:body for textgroup blocks is not allowed for
|
82
|
translation because of its text format."
|
83
|
|
84
|
|
85
|
MAINTAINERS
|
86
|
-----------
|
87
|
|
88
|
* Jose Reyero - https://www.drupal.org/u/jose-reyero
|
89
|
* Florian Weber (webflo) - https://www.drupal.org/u/webflo
|
90
|
* Peter Philipp - https://www.drupal.org/u/das-peter
|
91
|
* Joseph Olstad - https://www.drupal.org/u/joseph.olstad
|
92
|
* Nathaniel Catchpole - https://www.drupal.org/u/catch
|