function _l10n_update_locale_import_po in Localization update 6

Same name and namespace in other branches

1. 7 l10n_update.locale.inc \_l10n_update_locale_import_po()

Parses Gettext Portable Object file information and inserts into database

This is an improved version of _locale_import_po() to handle translation status

Parameters

$file: Drupal file object corresponding to the PO file to import

$langcode: Language code

$mode: Should existing translations be replaced LOCALE_IMPORT_KEEP, LOCALE_IMPORT_OVERWRITE or LOCALE_UPDATE_OVERRIDE_DEFAULT

$group: Text group to import PO file into (eg. 'default' for interface translations)

Return value

boolean Result array on success. FALSE on failure.

1 call to _l10n_update_locale_import_po()

l10n_update_import_file in ./l10n_update.inc

Import local file into the database.

File

./l10n_update.locale.inc, line 26

Override part of locale.inc library so we can manage string status

Code

function _l10n_update_locale_import_po($file, $langcode, $mode, $group = NULL) {

  // Try to allocate enough time to parse and import the data.
  if (function_exists('set_time_limit')) {
    @set_time_limit(240);
  }

  // Check if we have the language already in the database.
  if (!db_fetch_object(db_query("SELECT language FROM {languages} WHERE language = '%s'", $langcode))) {
    drupal_set_message(t('The language selected for import is not supported.'), 'error');
    return FALSE;
  }

  // Get strings from file (returns on failure after a partial import, or on success)
  $status = _l10n_update_locale_import_read_po('db-store', $file, $mode, $langcode, $group);
  if ($status === FALSE) {

    // Error messages are set in _locale_import_read_po().
    return FALSE;
  }

  // Get status information on import process.
  list($headerdone, $additions, $updates, $deletes, $skips) = _l10n_update_locale_import_one_string('db-report');
  if (!$headerdone) {
    drupal_set_message(t('The translation file %filename appears to have a missing or malformed header.', array(
      '%filename' => $file->filename,
    )), 'error');
  }

  // Clear cache and force refresh of JavaScript translations.
  _locale_invalidate_js($langcode);
  cache_clear_all('locale:', 'cache', TRUE);

  // Rebuild the menu, strings may have changed.
  menu_rebuild();
  watchdog('locale', 'Imported %file into %locale: %number new strings added, %update updated and %delete removed.', array(
    '%file' => $file->filename,
    '%locale' => $langcode,
    '%number' => $additions,
    '%update' => $updates,
    '%delete' => $deletes,
  ));
  if ($skips) {
    $skip_message = format_plural($skips, 'One translation string was skipped because it contains disallowed HTML.', '@count translation strings were skipped because they contain disallowed HTML.');
    watchdog('locale', $skip_message, NULL, WATCHDOG_WARNING);
  }

  // Return results of this import.
  return array(
    'file' => $file,
    'language' => $langcode,
    'add' => $additions,
    'update' => $updates,
    'delete' => $deletes,
    'skip' => $skips,
  );
}