Full ELMS Learning Network documentation
function t
Error message
User warning: The following module is missing from the file system: theme/theme. For information about how to fix this, see the documentation page. in _drupal_trigger_error_with_delayed_logging() (line 1156 of /var/www/html/elmsln_community/api.elmsln.org/includes/bootstrap.inc).cis7 bootstrap.inc | t($string, array $args = array(), array $options = array()) |
cle7 bootstrap.inc | t($string, array $args = array(), array $options = array()) |
elmsmedia7 bootstrap.inc | t($string, array $args = array(), array $options = array()) |
icor7 bootstrap.inc | t($string, array $args = array(), array $options = array()) |
meedjum_blog7 bootstrap.inc | t($string, array $args = array(), array $options = array()) |
mooc7 bootstrap.inc | t($string, array $args = array(), array $options = array()) |
Translates a string to the current language or to a given language.
The t() function serves two purposes. First, at run-time it translates user-visible text into the appropriate language. Second, various mechanisms that figure out what text needs to be translated work off t() -- the text inside t() calls is added to the database of strings to be translated. These strings are expected to be in English, so the first argument should always be in English. To enable a fully-translatable site, it is important that all human-readable text that will be displayed on the site or sent to a user is passed through the t() function, or a related function. See the Localization API pages for more information, including recommendations on how to break up or not break up strings for translation.
Translating Variables
You should never use t() to translate variables, such as calling
t($text);
, unless the text that the variable holds has been passed through t() elsewhere (e.g., $text is one of several translated literal strings in an array). It is especially important never to call
t($user_text);
, where $user_text is some text that a user entered - doing that can lead to cross-site scripting and other security problems. However, you can use variable substitution in your string, to put variable text such as user names or link URLs into translated text. Variable substitution looks like this:
$text = t("@name's blog", array('@name' => format_username($account)));
Basically, you can put variables like @name into your string, and t() will substitute their sanitized values at translation time. (See the Localization API pages referenced above and the documentation of format_string() for details about how to define variables in your string.) Translators can then rearrange the string as necessary for the language (e.g., in Spanish, it might be "blog de @name").
Use During Installation Phase
During the Drupal installation phase, some resources used by t() wil not be available to code that needs localization. See st() and get_t() for alternatives.
Parameters
$string: A string containing the English string to translate.
$args: An associative array of replacements to make after translation. Based on the first character of the key, the value is escaped and/or themed. See format_string() for details.
$options: An associative array of additional options, with the following elements:
- 'langcode' (defaults to the current language): The language code to translate to a language other than what is used to display the page.
- 'context' (defaults to the empty context): The context the source string belongs to.
Return value
The translated string.
See also
st()
get_t()
Related topics
- accessibility_admin_existing_tests in sites/
all/ modules/ ulmus/ accessibility/ accessibility.admin.inc - List existing accessibility tests. @todo - add a filter form
- accessibility_admin_filter_form in sites/
all/ modules/ ulmus/ accessibility/ accessibility.admin.inc - Form to filter accessibility tests.
- accessibility_admin_filter_form_submit in sites/
all/ modules/ ulmus/ accessibility/ accessibility.admin.inc - Form submit callback for filter form.
- accessibility_content_admin_form in sites/
all/ modules/ ulmus/ accessibility/ modules/ accessibility_content/ accessibility_content.admin.inc - accessibility_content_field_widget_form_alter in sites/
all/ modules/ ulmus/ accessibility/ modules/ accessibility_content/ accessibility_content.module - Implements field_widget_form_alter().
- accessibility_admin_existing_tests in sites/
all/ modules/ ulmus/ accessibility/ accessibility.admin.inc - List existing accessibility tests. @todo - add a filter form
- accessibility_get_active_tests in sites/
all/ modules/ ulmus/ accessibility/ accessibility.module - Helper function to return all active accessibiliy test entities.
- ckeditor_link_ckeditor_link_i18n_taxonomy_autocomplete in sites/
all/ modules/ ulmus/ ckeditor_link/ includes/ ckeditor_link.i18n_taxonomy.inc - Implementation of hook_ckeditor_link_TYPE_autocomplete().
- ckeditor_link_ckeditor_link_i18n_taxonomy_revert in sites/
all/ modules/ ulmus/ ckeditor_link/ includes/ ckeditor_link.i18n_taxonomy.inc - Implementation of hook_ckeditor_link_TYPE_revert().
- ckeditor_link_ckeditor_link_taxonomy_autocomplete in sites/
all/ modules/ ulmus/ ckeditor_link/ includes/ ckeditor_link.taxonomy.inc - Implementation of hook_ckeditor_link_TYPE_autocomplete().
File
- includes/
bootstrap.inc, line 1459 - Functions that need to be loaded on every Drupal request.
Code
function t($string, array $args = array(), array $options = array()) {
global $language;
static $custom_strings;
// Merge in default.
if (empty($options['langcode'])) {
$options['langcode'] = isset($language->language) ? $language->language : 'en';
}
if (empty($options['context'])) {
$options['context'] = '';
}
// First, check for an array of customized strings. If present, use the array
// *instead of* database lookups. This is a high performance way to provide a
// handful of string replacements. See settings.php for examples.
// Cache the $custom_strings variable to improve performance.
if (!isset($custom_strings[$options['langcode']])) {
$custom_strings[$options['langcode']] = variable_get('locale_custom_strings_' . $options['langcode'], array());
}
// Custom strings work for English too, even if locale module is disabled.
if (isset($custom_strings[$options['langcode']][$options['context']][$string])) {
$string = $custom_strings[$options['langcode']][$options['context']][$string];
}
// Translate with locale module if enabled.
elseif ($options['langcode'] != 'en' && function_exists('locale')) {
$string = locale($string, $options['context'], $options['langcode']);
}
if (empty($args)) {
return $string;
}
else {
return format_string($string, $args);
}
}