README.txt 3.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  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
  12. (https://www.drupal.org/project/i18n) package, provides support for other
  13. modules to translate user-defined strings. This is an API module that must be
  14. enabled only when required by other modules in the i18n package.
  15. * For a full description of the module, visit this page:
  16. https://www.drupal.org/node/1279668
  17. * To submit bug reports and feature suggestions, or to track changes:
  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. Strings will be translated from the source languages. By default the source
  39. language is the site's default language, so changing the default language could
  40. break these translations.
  41. 1. The user can set which language is used as the source language via
  42. Administration > Configuration > Regional and language > Multilingual
  43. settings > Strings. By default, only plain strings are enabled, so regular
  44. blocks are not fully translatable.
  45. 2. To allow Filtered HTML, Full HTML or Plain text select the appropriate radio
  46. box(es) and Save configuration.
  47. 3. To select the strings to be translated navigate to Administration >
  48. Configuration > Regional and language > Translate interface and select on
  49. Stings vertical tab. From here the user can select which text groups to
  50. translate and select the Refresh strings tab.
  51. FAQ
  52. ---
  53. The String translation module allows you to configure which text formats are
  54. translatable. Formats like PHP Filter and Full HTML are translated before they
  55. are processed, so allowing a translator to edit these can be a security risk.
  56. This is particularly problematic when importing translations in bulk from a CSV
  57. file, since the translator's access to the import formats isn't verified by
  58. Drupal. After updating this setting, be sure to refresh the strings via
  59. Administration > Configuration > Regional and language > Translate interface >
  60. Strings so that strings in forbidden formats are deleted.
  61. MAINTAINERS
  62. -----------
  63. * Jose Reyero - https://www.drupal.org/u/jose-reyero
  64. * Florian Weber (webflo) - https://www.drupal.org/u/webflo
  65. * Peter Philipp - https://www.drupal.org/u/das-peter
  66. * Joseph Olstad - https://www.drupal.org/u/joseph.olstad
  67. * Nathaniel Catchpole - https://www.drupal.org/u/catch