README.txt 2.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  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