You are here

README.txt in Internationalization 7

CONTENTS OF THIS FILE
---------------------

* Introduction
* Requirements
* Recommended modules
* Installation
* Configuration
* Troubleshooting
* Maintainers


INTRODUCTION
------------

The Block languages module, part of the Internationalization
(https://www.drupal.org/project/i18n) package, allows the user to configure
for which languages each block is visible.

* For a full description of the module,
  visit https://www.drupal.org/node/1279698.

* To submit bug reports and feature suggestions, or to track changes visit
  https://www.drupal.org/project/issues/i18n.


REQUIREMENTS
------------

This module requires the following module:

* Internationalization - https://www.drupal.org/project/i18n


RECOMMENDED MODULES
-------------------

* Internationalization Views - https://www.drupal.org/project/i18nviews
* Language Icons - https://www.drupal.org/project/languageicons
* Translation Overview - https://www.drupal.org/project/translation_overview
* Localization Client - https://www.drupal.org/project/l10n_client
* Internationalization contributions -
  https://www.drupal.org/project/i18n_contrib


INSTALLATION
------------

This is a submodule of the Internationalization module. Install the
Internationalization module as you would normally install a contributed Drupal
module. Visit https://www.drupal.org/node/895232 for further information.


CONFIGURATION
-------------

The settings for visibility per language are provided under Visibility
Settings via the Languages tab when configuring a block.

The Languages tab also provides a setting for whether the block is translatable.
For custom blocks, the block title and the block content will be translatable.
For blocks defined by modules, only the block title will be translatable. If
"Make this block translatable" is selected, a Translate tab will appear for that
block. This tab provides a UI for adding translations of the block in each
available language.


TROUBLESHOOTING
---------------

Conflicts with Context

The Block languages module conflicts with the Context module, which alters how
blocks are rendered. This issue can be tracked in the Internationalization
issue queue: http://drupal.org/node/1343044

String Errors

The user must allow your used string format to be translated on
admin/config/regional/i18n/strings or you are going to have an error message
like "The string blocks:block:1:body for textgroup blocks is not allowed for
translation because of its text format."


MAINTAINERS
-----------

* Jose Reyero - https://www.drupal.org/u/jose-reyero
* Florian Weber (webflo) - https://www.drupal.org/u/webflo
* Peter Philipp - https://www.drupal.org/u/das-peter
* Joseph Olstad - https://www.drupal.org/u/joseph.olstad
* Nathaniel Catchpole - https://www.drupal.org/u/catch

File

i18n_block/README.txt
View source
  1. CONTENTS OF THIS FILE
  2. ---------------------
  3. * Introduction
  4. * Requirements
  5. * Recommended modules
  6. * Installation
  7. * Configuration
  8. * Troubleshooting
  9. * Maintainers
  10. INTRODUCTION
  11. ------------
  12. The Block languages module, part of the Internationalization
  13. (https://www.drupal.org/project/i18n) package, allows the user to configure
  14. for which languages each block is visible.
  15. * For a full description of the module,
  16. visit https://www.drupal.org/node/1279698.
  17. * To submit bug reports and feature suggestions, or to track changes visit
  18. https://www.drupal.org/project/issues/i18n.
  19. REQUIREMENTS
  20. ------------
  21. This module requires the following module:
  22. * Internationalization - https://www.drupal.org/project/i18n
  23. RECOMMENDED MODULES
  24. -------------------
  25. * Internationalization Views - https://www.drupal.org/project/i18nviews
  26. * Language Icons - https://www.drupal.org/project/languageicons
  27. * Translation Overview - https://www.drupal.org/project/translation_overview
  28. * Localization Client - https://www.drupal.org/project/l10n_client
  29. * Internationalization contributions -
  30. https://www.drupal.org/project/i18n_contrib
  31. INSTALLATION
  32. ------------
  33. This is a submodule of the Internationalization module. Install the
  34. Internationalization module as you would normally install a contributed Drupal
  35. module. Visit https://www.drupal.org/node/895232 for further information.
  36. CONFIGURATION
  37. -------------
  38. The settings for visibility per language are provided under Visibility
  39. Settings via the Languages tab when configuring a block.
  40. The Languages tab also provides a setting for whether the block is translatable.
  41. For custom blocks, the block title and the block content will be translatable.
  42. For blocks defined by modules, only the block title will be translatable. If
  43. "Make this block translatable" is selected, a Translate tab will appear for that
  44. block. This tab provides a UI for adding translations of the block in each
  45. available language.
  46. TROUBLESHOOTING
  47. ---------------
  48. Conflicts with Context
  49. The Block languages module conflicts with the Context module, which alters how
  50. blocks are rendered. This issue can be tracked in the Internationalization
  51. issue queue: http://drupal.org/node/1343044
  52. String Errors
  53. The user must allow your used string format to be translated on
  54. admin/config/regional/i18n/strings or you are going to have an error message
  55. like "The string blocks:block:1:body for textgroup blocks is not allowed for
  56. translation because of its text format."
  57. MAINTAINERS
  58. -----------
  59. * Jose Reyero - https://www.drupal.org/u/jose-reyero
  60. * Florian Weber (webflo) - https://www.drupal.org/u/webflo
  61. * Peter Philipp - https://www.drupal.org/u/das-peter
  62. * Joseph Olstad - https://www.drupal.org/u/joseph.olstad
  63. * Nathaniel Catchpole - https://www.drupal.org/u/catch