README.txt 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. CONTENTS OF THIS FILE
  2. ---------------------
  3. * Introduction
  4. * Requirements
  5. * Recommended modules
  6. * Installation
  7. * Configuration
  8. * Maintainers
  9. INTRODUCTION
  10. ------------
  11. The String translation module, part of the Internationalization (https://www.drupal.org/project/i18n) package, provides support for other modules to translate user-defined strings. This is an API module that must be enabled only when required by other modules in the i18n package.
  12. * For a full description of the module, visit this page:
  13. https://www.drupal.org/node/1279668
  14. * To submit bug reports and feature suggestions, or to track changes:
  15. https://www.drupal.org/project/issues/i18n
  16. REQUIREMENTS
  17. ------------
  18. This module requires the following modules:
  19. Internationalization (https://www.drupal.org/project/i18n)
  20. RECOMMENDED MODULES
  21. -------------------
  22. * Internationalization Views (https://www.drupal.org/project/i18nviews)
  23. * Language Icons (https://www.drupal.org/project/languageicons)
  24. * Translation Overview (https://www.drupal.org/project/translation_overview)
  25. * Localization Client (https://www.drupal.org/project/l10n_client)
  26. * Internationalization contributions (https://www.drupal.org/project/i18n_contrib)
  27. INSTALLATION
  28. ------------
  29. * 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.
  30. CONFIGURATION
  31. -------------
  32. Strings will be translated from the source languages. By default the source language is the site's default language, so changing the default language could break these translations.
  33. 1. You can set which language is used as the source language via Administration > Configuration > Regional and language > Multilingual settings > Strings. By default, only plain strings are enabled, so regular blocks are not fully translatable.
  34. 2. To allow Filtered HTML, Full HTML or Plain text select the appropriate radio box(es) and Save configuration.
  35. 3. To select the strings to be translated navigate to Administration > Configuration > Regional and language > Translate interface and select on Stings vertical tab. From here you can select which text groups to translate and select the Refresh strings tab.
  36. FAQ
  37. ---
  38. The String translation module allows you to configure which text formats are translatable. Formats like PHP Filter and Full HTML are translated before they are processed, so allowing a translator to edit these can be a security risk. This is particularly problematic when importing translations in bulk from a CSV file, since the translator's access to the import formats isn't verified by Drupal. After updating this setting, be sure to refresh the strings via Administration > Configuration > Regional and language > Translate interface > Strings so that strings in forbidden formats are deleted.
  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