You are here

Home » API reference » Internationalization 7

README.txt in Internationalization 7

Same filename in this branch
  1. 7 README.txt
  2. 7 i18n_user/README.txt
  3. 7 i18n_path/README.txt
  4. 7 i18n_string/README.txt
  5. 7 i18n_block/README.txt
  6. 7 i18n_variable/README.txt
  7. 7 i18n_select/README.txt
  8. 7 i18n_contact/README.txt
  9. 7 i18n_forum/README.txt
  10. 7 i18n_field/README.txt
  11. 7 i18n_taxonomy/README.txt
  12. 7 i18n_redirect/README.txt
  13. 7 i18n_node/README.txt
  14. 7 i18n_sync/README.txt
  15. 7 i18n_translation/README.txt
  16. 7 i18n_menu/README.txt
CONTENTS OF THIS FILE
---------------------
  
* Introduction
* Requirements
* Recommended modules
* Installation
* Configuration
* Maintainers


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

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.


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

* To submit bug reports and feature suggestions, or to track changes:
  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
-------------

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.

1. The user 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.
2. To allow Filtered HTML, Full HTML or Plain text select the appropriate radio
   box(es) and Save configuration.
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 the user can select which text groups to
   translate and select the Refresh strings tab.


FAQ
---

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.


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_string/README.txt
View source 
  1. CONTENTS OF THIS FILE

  2. ---------------------

  3.   

  4. * Introduction

  5. * Requirements

  6. * Recommended modules

  7. * Installation

  8. * Configuration

  9. * Maintainers

  10. 

  11. 

  12. INTRODUCTION

  13. ------------

  14. 

  15. The String translation module, part of the Internationalization

  16. (https://www.drupal.org/project/i18n) package, provides support for other

  17. modules to translate user-defined strings. This is an API module that must be

  18. enabled only when required by other modules in the i18n package.

  19. 

  20. 

  21. * For a full description of the module, visit this page:

  22.   https://www.drupal.org/node/1279668

  23. 

  24. * To submit bug reports and feature suggestions, or to track changes:

  25.   https://www.drupal.org/project/issues/i18n

  26. 

  27. 

  28. REQUIREMENTS

  29. ------------

  30. 

  31. This module requires the following module:

  32. 

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

  34. 

  35. 

  36. RECOMMENDED MODULES

  37. -------------------

  38. 

  39. * Internationalization Views - https://www.drupal.org/project/i18nviews

  40. * Language Icons - https://www.drupal.org/project/languageicons

  41. * Translation Overview - https://www.drupal.org/project/translation_overview

  42. * Localization Client - https://www.drupal.org/project/l10n_client

  43. * Internationalization contributions -

  44.   https://www.drupal.org/project/i18n_contrib

  45. 

  46. 

  47. INSTALLATION

  48. ------------

  49. 

  50. This is a submodule of the Internationalization module. Install the

  51. Internationalization module as you would normally install a contributed Drupal

  52. module. Visit https://www.drupal.org/node/895232 for further information.

  53. 

  54. 

  55. CONFIGURATION

  56. -------------

  57. 

  58. Strings will be translated from the source languages. By default the source

  59. language is the site's default language, so changing the default language could

  60. break these translations.

  61. 

  62. 1. The user can set which language is used as the source language via

  63.    Administration > Configuration > Regional and language > Multilingual

  64.    settings > Strings. By default, only plain strings are enabled, so regular

  65.    blocks are not fully translatable.

  66. 2. To allow Filtered HTML, Full HTML or Plain text select the appropriate radio

  67.    box(es) and Save configuration.

  68. 3. To select the strings to be translated navigate to Administration >

  69.    Configuration > Regional and language > Translate interface and select on

  70.    Stings vertical tab. From here the user can select which text groups to

  71.    translate and select the Refresh strings tab.

  72. 

  73. 

  74. FAQ

  75. ---

  76. 

  77. The String translation module allows you to configure which text formats are

  78. translatable. Formats like PHP Filter and Full HTML are translated before they

  79. are processed, so allowing a translator to edit these can be a security risk.

  80. This is particularly problematic when importing translations in bulk from a CSV

  81. file, since the translator's access to the import formats isn't verified by

  82. Drupal. After updating this setting, be sure to refresh the strings via

  83. Administration > Configuration > Regional and language > Translate interface >

  84. Strings so that strings in forbidden formats are deleted.

  85. 

  86. 

  87. MAINTAINERS

  88. -----------

  89. 

  90. * Jose Reyero - https://www.drupal.org/u/jose-reyero

  91. * Florian Weber (webflo) - https://www.drupal.org/u/webflo

  92. * Peter Philipp - https://www.drupal.org/u/das-peter

  93. * Joseph Olstad - https://www.drupal.org/u/joseph.olstad

  94. * Nathaniel Catchpole - https://www.drupal.org/u/catch