locale.module 21.3 KB
Newer Older
Dries's avatar
 
Dries committed
1
<?php
2
// $Id$
Dries's avatar
 
Dries committed
3

Dries's avatar
 
Dries committed
4 5
/**
 * @file
6 7
 *   Add language handling functionality and enables the translation of the
 *   user interface to languages other than English.
Dries's avatar
 
Dries committed
8
 *
9 10 11 12
 *   When enabled, multiple languages can be set up. The site interface
 *   can be displayed in different languages, as well as nodes can have languages
 *   assigned. The setup of languages and translations is completely web based.
 *   Gettext portable object files are supported.
Dries's avatar
 
Dries committed
13 14
 */

15 16 17 18 19 20 21 22 23 24 25
/**
 * Language written left to right. Possible value of $language->direction.
 */
define('LANGUAGE_LTR', 0);

/**
 * Language written right to left. Possible value of $language->direction.
 */
define('LANGUAGE_RTL', 1);


Dries's avatar
 
Dries committed
26
// ---------------------------------------------------------------------------------
27
// Hook implementations
Dries's avatar
 
Dries committed
28

Dries's avatar
 
Dries committed
29 30 31
/**
 * Implementation of hook_help().
 */
32
function locale_help($section) {
Dries's avatar
 
Dries committed
33
  switch ($section) {
34
    case 'admin/help#locale':
35
      $output = '<p>'. t('The locale module allows you to present your Drupal site in a language other than the default English. You can use it to set up a multi-lingual website or replace given <em>built-in</em> text with text which has been customized for your site. Whenever the locale module encounters text which needs to be displayed, it tries to translate it into the currently selected language. If a translation is not available, then the string is remembered, so you can look up untranslated strings easily.') .'</p>';
36
      $output .= '<p>'. t('The locale module provides two options for providing translations. The first is the integrated web interface, via which you can search for untranslated strings, and specify their translations. An easier and less time-consuming method is to import existing translations for your language. These translations are available as <em>GNU gettext Portable Object files</em> (<em>.po</em> files for short). Translations for many languages are available for download from the translation page.') .'</p>';
37
      $output .= '<p>'. t("If an existing translation does not meet your needs, the <em>.po</em> files are easily edited with special editing tools. The locale module's import feature allows you to add strings from such files into your site's database. The export functionality enables you to share your translations with others, generating Portable Object files from your site strings.") .'</p>';
38
      $output .= '<p>'. t('For more information please read the configuration and customization handbook <a href="@locale">Locale page</a>.', array('@locale' => 'http://drupal.org/handbook/modules/locale/')) .'</p>';
39
      return $output;
40 41 42 43 44 45 46 47 48 49 50 51 52

    case 'admin/settings/language':
    case 'admin/settings/language/overview':
      return t("<p>Drupal provides support for the translation of its interface text into different languages. This page provides an overview of the installed languages. You can add a language on the <a href=\"@add-language\">add language page</a>, or directly by <a href=\"@import\">importing a translation</a>. If multiple languages are enabled, registered users will be able to set their preferred language. The site default will be used for anonymous visitors and for users without their own settings.</p><p>Drupal interface translations may be added or extended by several courses: by <a href=\"@import\">importing</a> an existing translation, by <a href=\"@search\">translating everything</a> from scratch, or by a combination of these approaches.</p>", array("@search" => url("admin/build/translate/search"), "@import" => url("admin/build/translate/import"), "@add-language" => url("admin/settings/language/add")));
    case 'admin/settings/language/add':
      return '<p>'. t("You need to add all languages in which you would like to display the site interface. If you can't find the desired language in the quick-add dropdown, then you will need to provide the proper language code yourself. The language code may be used to negotiate with browsers and to present flags, etc., so it is important to pick a code that is standardised for the desired language. You can also add a language by <a href=\"@import\">importing a translation</a>.", array("@import" => url("admin/build/translate/import"))) .'</p>';
    case 'admin/settings/language/configure':
      return '<p>'. t('The language used to display a web page is determined with a negotiation algorithm. You can choose how this algorithm should work. By default, there is no negotiation and the default language is used. You can use path prefixes (like "de" and "it" for German and Italian content) with different fallback options, so you can have web addresses like /de/contact and /it/contact. Alternatively you can use custom domains like de.example.com and it.example.com. Customize path prefixes and set domain names on the <a href="@languages">language editing pages</a>.', array('@languages' => url('admin/settings/language'))) .'</p>';

    case 'admin/build/translate':
    case 'admin/build/translate/overview':
      return '<p>'. t("This page provides an overview of interface translation on the site. Drupal groups all translatable strings in so called 'text groups'. Text groups are useful, because you can focus your translation efforts on the groups of text you care most about.  For example, a translation team could choose not to fully translate the text group that includes all the long help texts on the administration pages. Similarly, text groups are useful to ensure that certain aspects of the site are always fully translated.") . '</p>';
    case 'admin/build/translate/import':
53
      return '<p>'. t("This page allows you to import a translation provided in the gettext Portable Object (.po) format. The easiest way to get your site translated is to obtain an existing Drupal translation and to import it. You can find existing translations on the <a href=\"@url\">Drupal translation page</a>. Note that importing a translation file might take a while.", array('@url' => 'http://drupal.org/project/translations')) .'</p>';
54
    case 'admin/build/translate/export':
55
      return '<p>'. t("This page allows you to export Drupal strings. The first option is to export a translation so it can be shared. The second option generates a translation template, which contains all Drupal strings, but without their translations. You can use this template to start a new translation using various software packages designed for this task.") .'</p>';
56 57
    case 'admin/build/translate/search':
      return '<p>'. t("It is often convenient to get the strings from your setup on the <a href=\"@export\">export page</a>, and use a desktop Gettext translation editor to edit the translations. On this page you can search in the translated and untranslated strings, and the default English texts provided by Drupal.", array("@export" => url("admin/build/translate/export"))) .'</p>';
Dries's avatar
 
Dries committed
58
  }
Dries's avatar
 
Dries committed
59 60
}

Dries's avatar
 
Dries committed
61
/**
Dries's avatar
 
Dries committed
62
 * Implementation of hook_menu().
63 64 65
 *
 * Locale module only provides administrative menu items, so all
 * menu items are invoked through locale_inc_callback().
Dries's avatar
 
Dries committed
66
 */
67
function locale_menu() {
68 69
  // Manage languages
  $items['admin/settings/language'] = array(
70
    'title' => 'Languages',
71 72 73 74
    'description' => 'Configure languages for content and the user interface.',
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('drupal_get_form', 'locale_languages_overview_form'),
    'access arguments' => array('administer languages'),
75
  );
76
  $items['admin/settings/language/overview'] = array(
77
    'title' => 'List',
78 79 80
    'weight' => 0,
    'type' => MENU_DEFAULT_LOCAL_TASK,
  );
81
  $items['admin/settings/language/add'] = array(
82
    'title' => 'Add language',
83 84
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('locale_languages_add_screen'), // two forms concatenated
85 86 87
    'weight' => 5,
    'type' => MENU_LOCAL_TASK,
  );
88
  $items['admin/settings/language/configure'] = array(
89
    'title' => 'Configure',
90 91
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('drupal_get_form', 'locale_languages_configure_form'),
92 93 94
    'weight' => 10,
    'type' => MENU_LOCAL_TASK,
  );
95
  $items['admin/settings/language/edit/%'] = array(
96
    'title' => 'Edit language',
97 98 99 100 101 102 103 104
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('drupal_get_form', 'locale_languages_edit_form', 4),
    'type' => MENU_CALLBACK,
  );
  $items['admin/settings/language/delete/%'] = array(
    'title' => 'Confirm',
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('drupal_get_form', 'locale_languages_delete_form', 4),
105 106 107
    'type' => MENU_CALLBACK,
  );

108 109 110 111 112 113 114 115 116 117
  // Translation functionality
  $items['admin/build/translate'] = array(
    'title' => 'Translate interface',
    'description' => 'Translate the built in interface as well as menu items and taxonomies.',
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('locale_translate_overview_screen'), // not a form, just a table
    'access arguments' => array('translate interface'),
  );
  $items['admin/build/translate/overview'] = array(
    'title' => 'Overview',
118 119 120
    'weight' => 0,
    'type' => MENU_DEFAULT_LOCAL_TASK,
  );
121 122
  $items['admin/build/translate/search'] = array(
    'title' => 'Search',
123 124
    'weight' => 10,
    'type' => MENU_LOCAL_TASK,
125 126
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('locale_translate_seek_screen'), // search results and form concatenated
127
  );
128 129 130 131
  $items['admin/build/translate/import'] = array(
    'title' => 'Import',
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('drupal_get_form', 'locale_translate_import_form'),
132 133 134
    'weight' => 20,
    'type' => MENU_LOCAL_TASK,
  );
135 136 137 138 139 140
  $items['admin/build/translate/export'] = array(
    'title' => 'Export',
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('locale_translate_export_screen'), // possibly multiple forms concatenated
    'weight' => 30,
    'type' => MENU_LOCAL_TASK,
141
  );
142
  $items['admin/build/translate/edit/%'] = array(
143
    'title' => 'Edit string',
144 145
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('drupal_get_form', 'locale_translate_edit_form', 4),
146 147
    'type' => MENU_CALLBACK,
  );
148
  $items['admin/build/translate/delete/%'] = array(
149
    'title' => 'Delete string',
150 151
    'page callback' => 'locale_inc_callback',
    'page arguments' => array('locale_translate_delete', 4),  // directly deletes, no confirmation
152 153
    'type' => MENU_CALLBACK,
  );
Dries's avatar
 
Dries committed
154

Dries's avatar
 
Dries committed
155
  return $items;
Dries's avatar
 
Dries committed
156 157
}

158 159 160 161 162 163 164 165 166 167
/**
 * Wrapper function to be able to set callbacks in locale.inc
 */
function locale_inc_callback() {
  $args = func_get_args();
  $function = array_shift($args);
  include_once './includes/locale.inc';
  return call_user_func_array($function, $args);
}

Dries's avatar
 
Dries committed
168
/**
Dries's avatar
 
Dries committed
169
 * Implementation of hook_perm().
Dries's avatar
 
Dries committed
170
 */
Dries's avatar
 
Dries committed
171
function locale_perm() {
172 173 174 175 176 177 178 179 180 181 182
  return array('administer languages', 'translate interface');
}

/**
 * Implementation of hook_locale().
 */
function locale_locale($op = 'groups') {
  switch ($op) {
    case 'groups':
      return array('default' => t('Built-in interface'));
  }
Dries's avatar
 
Dries committed
183 184 185 186 187 188
}

/**
 * Implementation of hook_user().
 */
function locale_user($type, $edit, &$user, $category = NULL) {
189 190 191
  if ($type == 'form' && $category == 'account' && variable_get('language_count', 1) > 1 && variable_get('language_negotiation', LANGUAGE_NEGOTIATION_NONE) == LANGUAGE_NEGOTIATION_PATH) {
    $languages = language_list('enabled');
    $languages = $languages['1'];
Dries's avatar
 
Dries committed
192
    if ($user->language == '') {
193
      $user->language = language_default('language');
194 195
    }
    $names = array();
196
    foreach ($languages as $langcode => $language) {
197
      $names[$langcode] = t($language->name) .' ('. $language->native .')';
Dries's avatar
 
Dries committed
198
    }
199 200 201 202 203 204 205
    $form['locale'] = array('#type' => 'fieldset',
      '#title' => t('Interface language settings'),
      '#weight' => 1,
    );
    $form['locale']['language'] = array('#type' => 'radios',
      '#title' => t('Language'),
      '#default_value' => $user->language,
206
      '#options' => $names,
207 208
      '#description' => t('Selecting a different locale will change the interface language of the site.'),
    );
209
    return $form;
Dries's avatar
 
Dries committed
210 211 212
  }
}

213 214 215
/**
 * Implementation of hook_form_alter(). Adds language fields to forms.
 */
216
function locale_form_alter(&$form, $form_state, $form_id) {
217
  switch ($form_id) {
218 219

    // Language field for paths
220 221
    case 'path_admin_edit':
      $form['language'] = array(
222
        '#type' => 'select',
223 224
        '#title' => t('Language'),
        '#options' => array('' => t('All languages')) + locale_language_list('name'),
225 226 227
        '#default_value' => $form['language']['#value'],
        '#weight' => -10,
        '#description' => t('Path aliases added for languages take precedence over path aliases added for all languages for the same Drupal path.'),
228 229
      );
      break;
230 231 232 233 234 235 236 237 238

    // Language setting for content types
    case 'node_type_form':
      if (isset($form['identity']['type'])) {
        $form['workflow']['language'] = array(
          '#type' => 'radios',
          '#title' => t('Multilingual support'),
          '#default_value' => variable_get('language_'. $form['#node_type']->type, 0),
          '#options' => array(t('Disabled'), t('Enabled')),
239
          '#description' => t('Enable multilingual support for this content type. If enabled, a language selection field will be added to the editing form, allowing you to select from one of the <a href="!languages">enabled languages</a>. If disabled, new posts are saved with the default language. Existing content will not be affected by changing this option.', array('!languages' => url('admin/settings/language'))),
240 241 242 243 244 245 246
        );
      }
      break;

    // Language field for nodes
    default:
      if ($form['#id'] == 'node-form') {
247
        if (isset($form['#node']->type) && variable_get('language_' . $form['#node']->type, 0)) {
248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263
          $form['language'] = array(
            '#type' => 'select',
            '#title' => t('Language'),
            '#default_value' => (isset($form['#node']->language) ? $form['#node']->language : ''),
            '#options' => array('' => t('Language neutral')) + locale_language_list('name'),
          );
        }
        // Node type without language selector: assign the default for new nodes
        elseif (!isset($form['#node']->nid)) {
          $default = language_default();
          $form['language'] = array(
            '#type' => 'value',
            '#value' => $default->language
          );
        }
      }
264 265 266
  }
}

267 268 269 270 271 272 273 274 275 276
/**
 * Implementation of hook_theme()
 */
function locale_theme() {
  return array(
    'locale_languages_overview_form' => array(
      'arguments' => array('form' => array()),
    ),
  );
}
277

Dries's avatar
 
Dries committed
278
// ---------------------------------------------------------------------------------
279
// Locale core functionality
Dries's avatar
 
Dries committed
280

Dries's avatar
 
Dries committed
281
/**
282
 * Provides interface translation services.
Dries's avatar
 
Dries committed
283 284 285
 *
 * This function is called from t() to translate a string if needed.
 */
286
function locale($string, $langcode = NULL) {
287
  global $language;
Dries's avatar
 
Dries committed
288
  static $locale_t;
Dries's avatar
 
Dries committed
289

290 291
  $langcode = isset($langcode) ? $langcode : $language->language;

292
  // Store database cached translations in a static var.
293 294 295
  if (!isset($locale_t[$langcode])) {
    $locale_t[$langcode] = array();
    if (!($cache = cache_get('locale:'. $langcode, 'cache'))) {
Dries's avatar
 
Dries committed
296
      locale_refresh_cache();
297
      $cache = cache_get('locale:'. $langcode, 'cache');
Dries's avatar
 
Dries committed
298
    }
299
    if ($cache) {
300
      $locale_t[$langcode] = $cache->data;
301
    }
Dries's avatar
 
Dries committed
302 303
  }

Dries's avatar
 
Dries committed
304 305
  // We have the translation cached (if it is TRUE, then there is no
  // translation, so there is no point in checking the database)
306 307
  if (isset($locale_t[$langcode][$string])) {
    $string = ($locale_t[$langcode][$string] === TRUE ? $string : $locale_t[$langcode][$string]);
Dries's avatar
 
Dries committed
308
  }
Dries's avatar
 
Dries committed
309

310
  // We do not have this translation cached, so get it from the DB.
Dries's avatar
 
Dries committed
311
  else {
312
    $result = db_query("SELECT s.lid, t.translation FROM {locales_source} s INNER JOIN {locales_target} t ON s.lid = t.lid WHERE s.source = '%s' AND t.language = '%s' AND s.textgroup = 'default'", $string, $langcode);
Dries's avatar
 
Dries committed
313 314 315
    // Translation found
    if ($trans = db_fetch_object($result)) {
      if (!empty($trans->translation)) {
316
        $locale_t[$langcode][$string] = $trans->translation;
Dries's avatar
 
Dries committed
317
        $string = $trans->translation;
318
      }
Dries's avatar
 
Dries committed
319
    }
Dries's avatar
 
Dries committed
320

Dries's avatar
 
Dries committed
321 322
    // Either we have no such source string, or no translation
    else {
323
      $result = db_query("SELECT lid, source FROM {locales_source} WHERE source = '%s' AND textgroup = 'default'", $string);
Dries's avatar
 
Dries committed
324 325
      // We have no such translation
      if ($obj = db_fetch_object($result)) {
326 327
        if ($langcode) {
          db_query("INSERT INTO {locales_target} (lid, language, translation) VALUES (%d, '%s', '')", $obj->lid, $langcode);
Dries's avatar
 
Dries committed
328 329 330
        }
      }
      // We have no such source string
331
      else {
332
        db_query("INSERT INTO {locales_source} (location, source, textgroup) VALUES ('%s', '%s', 'default')", request_uri(), $string);
333
        if ($langcode) {
334
          $lid = db_fetch_object(db_query("SELECT lid FROM {locales_source} WHERE source = '%s' AND textgroup = 'default'", $string));
335
          db_query("INSERT INTO {locales_target} (lid, language, translation) VALUES (%d, '%s', '')", $lid->lid, $langcode);
Dries's avatar
 
Dries committed
336
        }
337
      }
Dries's avatar
 
Dries committed
338
      // Clear locale cache in DB
339
      cache_clear_all('locale:'. $langcode, 'cache');
Dries's avatar
 
Dries committed
340
    }
Dries's avatar
 
Dries committed
341 342
  }

Dries's avatar
 
Dries committed
343 344
  return $string;
}
Dries's avatar
 
Dries committed
345

Dries's avatar
 
Dries committed
346
/**
347
 * Refreshes database stored cache of translations.
Dries's avatar
 
Dries committed
348 349 350 351
 *
 * We only store short strings to improve performance and consume less memory.
 */
function locale_refresh_cache() {
352 353
  $languages = language_list('enabled');
  $languages = $languages['1'];
Dries's avatar
 
Dries committed
354

355
  foreach ($languages as $language) {
356
    $result = db_query("SELECT s.source, t.translation, t.language FROM {locales_source} s INNER JOIN {locales_target} t ON s.lid = t.lid WHERE t.language = '%s' AND s.textgroup = 'default' AND LENGTH(s.source) < 75", $language->language);
357
    $t = array();
Dries's avatar
 
Dries committed
358 359
    while ($data = db_fetch_object($result)) {
      $t[$data->source] = (empty($data->translation) ? TRUE : $data->translation);
Dries's avatar
 
Dries committed
360
    }
361
    cache_set('locale:'. $language->language, $t);
Dries's avatar
 
Dries committed
362 363 364
  }
}

Dries's avatar
 
Dries committed
365
/**
366
 * Returns plural form index for a specific number.
Dries's avatar
 
Dries committed
367
 *
368
 * The index is computed from the formula of this language.
369
 *
370 371 372 373 374
 * @param $count
 *   Number to return plural for.
 * @param $langcode
 *   Optional language code to translate to a language other than
 *   what is used to display the page.
Dries's avatar
 
Dries committed
375
 */
376
function locale_get_plural($count, $langcode = NULL) {
377
  global $language;
Dries's avatar
 
Dries committed
378 379
  static $locale_formula, $plurals = array();

380
  $langcode = $langcode ? $langcode : $language->language;
381

382
  if (!isset($plurals[$langcode][$count])) {
Dries's avatar
 
Dries committed
383
    if (!isset($locale_formula)) {
384 385
      $language_list = language_list();
      $locale_formula[$langcode] = $language_list[$langcode]->formula;
Dries's avatar
 
Dries committed
386
    }
387
    if ($locale_formula[$langcode]) {
Dries's avatar
 
Dries committed
388
      $n = $count;
389 390
      $plurals[$langcode][$count] = @eval('return intval('. $locale_formula[$langcode] .');');
      return $plurals[$langcode][$count];
Dries's avatar
 
Dries committed
391 392
    }
    else {
393
      $plurals[$langcode][$count] = -1;
Dries's avatar
 
Dries committed
394
      return -1;
395
    }
Dries's avatar
 
Dries committed
396
  }
397
  return $plurals[$langcode][$count];
398
}
Dries's avatar
 
Dries committed
399

400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417

/**
 * Returns a language name
 */
function locale_language_name($lang) {
  static $list = NULL;
  if (!isset($list)) {
    $list = locale_language_list();
  }
  return ($lang && isset($list[$lang])) ? $list[$lang] : t('All');
}

/**
 * Returns array of language names
 *
 * @param $field
 *   'name' => names in current language, localized
 *   'native' => native names
418 419
 * @param $all
 *   Boolean to return all languages or only enabled ones
420
 */
421 422 423 424 425 426 427 428
function locale_language_list($field = 'name', $all = FALSE) {
  if ($all) {
    $languages = language_list();
  }
  else {
    $languages = language_list('enabled');
    $languages = $languages[1];
  }
429
  $list = array();
430
  foreach ($languages as $language) {
431 432 433 434
    $list[$language->language] = ($field == 'name') ? t($language->name) : $language->$field;
  }
  return $list;
}
435 436 437 438 439 440 441 442 443 444 445 446 447

/**
 * Imports translations when new modules or themes are installed or enabled.
 *
 * This function will either import translation for the component change
 * right away, or start a batch if more files need to be imported.
 *
 * @param $components
 *   An array of component (theme and/or module) names to import
 *   translations for.
 */
function locale_system_update($components) {
  include_once 'includes/locale.inc';
448
  if ($batch = locale_batch_by_component($components)) {
449 450 451 452 453 454 455 456 457 458 459 460 461 462
    batch_set($batch);
  }
}

/**
 * Finished callback of system page locale import batch.
 * Inform the user of translation files imported.
 */
function _locale_batch_system_finished($success, $results) {
  if ($success) {
    drupal_set_message(format_plural(count($results), 'One translation file imported for the newly installed modules.', '@count translation files imported for the newly installed modules.'));
  }
}

463 464 465 466 467 468 469 470 471 472
/**
 * Finished callback of language addition locale import batch.
 * Inform the user of translation files imported.
 */
function _locale_batch_language_finished($success, $results) {
  if ($success) {
    drupal_set_message(format_plural(count($results), 'One translation file imported for the enabled modules.', '@count translation files imported for the enabled modules.'));
  }
}

473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490
/**
 * Perform interface translation import as a batch step.
 *
 * @param $filepath
 *   Path to a file to import.
 * @param $results
 *   Contains a list of files imported.
 */
function _locale_batch_import($filepath, &$context) {
  include_once 'includes/locale.inc';
  // The filename is either {langcode}.po or {prefix}.{langcode}.po, so
  // we can extract the language code to use for the import from the end.
  if (preg_match('!(/|\.)([^\.]+)\.po$!', $filepath, $langcode)) {
    $file = (object) array('filename' => basename($filepath), 'filepath' => $filepath);
    _locale_import_read_po('db-store', $file, 'keep', $langcode[2]);
    $context['results'][] = $filepath;
  }
}