README.txt 2.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  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 (https://www.drupal.org/project/i18n) package, allows the user to configure for which languages each block is visible.
  13. * For a full description of the module, visit https://www.drupal.org/node/1279698
  14. * To submit bug reports and feature suggestions, or to track changes visit https://www.drupal.org/project/issues/i18n
  15. REQUIREMENTS
  16. ------------
  17. This module requires the following modules:
  18. Internationalization - https://www.drupal.org/project/i18n
  19. RECOMMENDED MODULES
  20. -------------------
  21. * Internationalization Views - https://www.drupal.org/project/i18nviews
  22. * Language Icons - https://www.drupal.org/project/languageicons
  23. * Translation Overview - https://www.drupal.org/project/translation_overview
  24. * Localization Client - https://www.drupal.org/project/l10n_client
  25. * Internationalization contributions - https://www.drupal.org/project/i18n_contrib
  26. INSTALLATION
  27. ------------
  28. * 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/docs/7/extending-drupal-7/installing-contributed-modules-find-import-enable-configure-drupal-7 for further information.
  29. CONFIGURATION
  30. -------------
  31. The settings for visibility per language are provided under Visibility Settings via the Languages tab when configuring a block.
  32. 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.
  33. TROUBLESHOOTING
  34. ---------------
  35. Conflicts with Context
  36. 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
  37. String Errors
  38. The user must allow your used string format to be translated on admin/config/regional/i18n/strings or you are going to have a error message like "The string blocks:block:1:body for textgroup blocks is not allowed for translation because of its text format."
  39. MAINTAINERS
  40. -----------
  41. * Jose Reyero - https://www.drupal.org/u/jose-reyero
  42. * Florian Weber (webflo) - https://www.drupal.org/u/webflo
  43. * Peter Philipp - https://www.drupal.org/u/das-peter
  44. * Joseph Olstad - https://www.drupal.org/u/joseph.olstad
  45. * Nathaniel Catchpole - https://www.drupal.org/u/catch