Follow these steps to translate Drupal into your language:
'; - $output .= '' . $directory . '
For more information on installing Drupal in different languages, visit the drupal.org handbook page.
'; - $output .= 'How should the installation continue?
'; - $output .= '' . st('Learn how to install Drupal in other languages') . '
', + '#markup' => 'Translations will be downloaded from the Drupal Translation website. ' . + 'If you do not want this, select English and continue the installation. For more information, see the online handbook.
', ); } $form['actions'] = array('#type' => 'actions'); @@ -1452,6 +1425,112 @@ function install_select_language_form($form, &$form_state, $files) { } /** + * Download a translation file for the selected langaguage. + * + * @param array $install_state + * An array of information about the current installation state. + * + * @return string + * A themed status report, or an exception if there are requirement errors. + * Upon successfull download the page is reloaded and no output is returned. + */ +function install_download_translation(&$install_state) { + // Check whether all conditions are met to download. Download the translation + // if possible. + $requirements = install_check_translations($install_state); + if ($output = install_display_requirements($install_state, $requirements)) { + return $output; + } + + // The download was successfull, reload the page in the new lanagage. + install_goto(install_redirect_url($install_state)); +} + +/** + * Attempts to get a file using drupal_http_request and to store it locally. + * + * @param string $uri + * The URI of the file to grab. + * @param string $destination + * Stream wrapper URI specifying where the file should be placed. If a + * directory path is provided, the file is saved into that directory under its + * original name. If the path contains a filename as well, that one will be + * used instead. + * + * @return boolean + * TRUE on success, FALSE on failure. + */ +function install_retrieve_file($uri, $destination) { + $parsed_url = parse_url($uri); + if (is_dir(drupal_realpath($destination))) { + // Prevent URIs with triple slashes when gluing parts together. + $path = str_replace('///', '//', "$destination/") . drupal_basename($parsed_url['path']); + } + else { + $path = $destination; + } + $result = drupal_http_request($uri); + if ($result->code != 200) { + return FALSE; + } + if (file_put_contents($path, $result->data) === FALSE) { + return FALSE; + } + return TRUE; +} + +/** + * Checks if the localization server can be contacted. + * + * @param string $uri + * The URI to contact. + * + * @return string + * URI of the server if the localization server was contacted successfully. + * FALSE if not. + */ +function install_check_localization_server($uri) { + $result = drupal_http_request($uri, array('method' => 'HEAD')); + return (!isset($result->error) && $result->code == 200); +} + +/** + * Gets the core release version for localization. + * + * In case core has a development version we fall back to the latest stable + * release. e.g. 8.2-dev falls back to 8.1. 8.0-dev falls back to 7.0. Fallback + * is required because the localization server only provides translation files + * for stable releases. + * + * @return array + * Associative array containing 'core' and 'version' of the release. + */ +function install_get_localization_release() { + if (strpos(VERSION, 'dev')) { + list($version, ) = explode('-', VERSION); + list($major, $minor) = explode('.', $version); + + // Calculate the major and minor release numbers to fall back to. + // E.g. 8.0-dev falls back to 7.0 and 8.2-dev falls back to 8.1. + if ($minor == 0) { + $major--; + } + else { + $minor--; + } + $release = "$major.$minor"; + } + else { + $release = VERSION; + } + + return array( + 'core' => "$major.x", + 'version' => $release, + ); +} + +/** * Indicates that there are no profiles available. */ function install_no_profile_error() { @@ -1565,10 +1644,10 @@ function install_profile_modules(&$install_state) { * The batch definition, if there are language files to import. */ function install_import_translations(&$install_state) { - include_once drupal_get_path('module', 'locale') . '/locale.bulk.inc'; - $langcode = $install_state['parameters']['langcode']; - + include_once DRUPAL_ROOT . '/core/modules/locale/locale.bulk.inc'; include_once DRUPAL_ROOT . '/core/includes/standard.inc'; + + $langcode = $install_state['parameters']['langcode']; $standard_languages = standard_language_list(); if (!isset($standard_languages[$langcode])) { // Drupal does not know about this language, so we prefill its values with @@ -1589,19 +1668,42 @@ function install_import_translations(&$install_state) { language_save($language); } - // If a non-english language was selected, remove English. + // If a non-English language was selected, remove English and import the + // translations. if ($langcode != 'en') { language_delete('en'); - } - // Collect files to import for this language. - $batch = locale_translate_batch_import_files(array('langcode' => $langcode)); - if (!empty($batch)) { - return $batch; + // Set up a batch to import translations for the newly added language. + _install_prepare_import(); + module_load_include('fetch.inc', 'locale'); + if ($batch = locale_translation_batch_fetch_build(array(), array($langcode))) { + return $batch; + } } } /** + * Tells the translation import process that Drupal core is installed. + */ +function _install_prepare_import() { + global $install_state; + + $release = install_get_localization_release(); + db_insert('locale_project') + ->fields(array( + 'name' => 'drupal', + 'project_type' => 'module', + 'core' => $release['core'], + 'version' => $release['version'], + 'server_pattern' => $install_state['server_pattern'], + 'status' => 1, + )) + ->execute(); + module_load_include('compare.inc', 'locale'); + locale_translation_check_projects_local(array('drupal'), array($install_state['parameters']['langcode'])); +} + +/** * Form constructor for a form to configure the new site. * * @param $install_state @@ -1651,20 +1753,29 @@ function install_configure_form($form, &$form_state, &$install_state) { /** * Finishes importing files at end of installation. * + * If other projects besides Drupal core have been installed, their translation + * will be imported here. + * * @param $install_state * An array of information about the current installation state. * * @return * The batch definition, if there are language files to import. - * - * @todo - * This currently does the same as the first import step. Need to revisit - * once we have l10n_update functionality integrated. See - * http://drupal.org/node/1191488. */ function install_import_translations_remaining(&$install_state) { - include_once drupal_get_path('module', 'locale') . '/locale.bulk.inc'; - return locale_translate_batch_import_files(array('langcode' => $install_state['parameters']['langcode'])); + module_load_include('fetch.inc', 'locale'); + module_load_include('compare.inc', 'locale'); + + // Build a fresh list of installed projects. When more projects than core are + // installed, their translations will be downloaded (if required) and imported + // using a batch. + $projects = locale_translation_build_projects(); + if (count($projects) > 1) { + $options = _locale_translation_default_update_options(); + if ($batch = locale_translation_batch_update_build(array(), array($install_state['parameters']['langcode']), $options)) { + return $batch; + } + } } /** @@ -1728,6 +1839,162 @@ function _install_profile_modules_finished($success, $results, $operations) { /** * Checks installation requirements and reports any errors. */ +function install_check_translations($install_state) { + include_once DRUPAL_ROOT . '/core/includes/standard.inc'; + $requirements = array(); + + $readable = FALSE; + $writable = FALSE; + $executable = FALSE; + $files_directory = variable_get('file_public_path', conf_path() . '/files'); + $translations_directory = variable_get('locale_translate_file_directory', conf_path() . '/files/translations'); + $translations_directory_exists = FALSE; + $online = FALSE; + $server_available = FALSE; + $translation_available = FALSE; + + // First attempt to create or make writable the files directory. + file_prepare_directory($files_directory, FILE_CREATE_DIRECTORY | FILE_MODIFY_PERMISSIONS); + // Then, attempt to create or make writable the translations directory. + file_prepare_directory($translations_directory, FILE_CREATE_DIRECTORY | FILE_MODIFY_PERMISSIONS); + + // Get values so the requirements errors can be specific. + if (drupal_verify_install_file($translations_directory, FILE_EXIST|FILE_WRITABLE, 'dir')) { + $readable = is_readable($translations_directory); + $writable = is_writable($translations_directory); + $executable = is_executable($translations_directory); + $translations_directory_exists = TRUE; + } + + // Build URLs for the translation file and the translation server. + $release = install_get_localization_release(); + $langcode = $install_state['parameters']['langcode']; + $variables = array( + '%project' => 'drupal', + '%version' => $release['version'], + '%core' => $release['core'], + '%language' => $langcode, + ); + $translation_url = strtr($install_state['server_pattern'], $variables); + $elements = parse_url($translation_url); + $server_url = $elements['scheme'] . '://' . $elements['host']; + + // Build the language name for display. + $languages = standard_language_list(); + $language = isset($languages[$langcode]) ? $languages[$langcode][0] : $langcode; + + // Check if the desirered translation file is available and if the translation + // server can be reached, or in other words if we have an internet connection. + if ($translation_available = install_check_localization_server($translation_url)) { + $online = TRUE; + $server_available = TRUE; + } + else { + if ($server_available = install_check_localization_server($server_url)) { + $online = TRUE; + } + } + + // If the translations directory does not exists, throw an error. + if (!$translations_directory_exists) { + $requirements['translations directory exists'] = array( + 'title' => st('Translations directory'), + 'value' => st('The translations directory does not exist.'), + 'severity' => REQUIREMENT_ERROR, + 'description' => st('The installer requires that you create a translations directory as part of the installation process. Create the directory %translations_directory . More details about installing Drupal are available in INSTALL.txt.', array('%translations_directory' => $translations_directory, '@install_txt' => base_path() . 'core/INSTALL.txt')), + ); + } + else { + $requirements['translations directory exists'] = array( + 'title' => st('Translations directory'), + 'value' => st('The diretory %translations_directory exists.', array('%translations_directory' => $translations_directory)), + ); + // If the translations directory is not readable, throw an error. + if (!$readable) { + $requirements['translations directory readable'] = array( + 'title' => st('Translations directory'), + 'value' => st('The translations directory is not readable.'), + 'severity' => REQUIREMENT_ERROR, + 'description' => st('The installer requires read permissions to %translations_directory at all times. If you are unsure how to grant file permissions, consult the online handbook.', array('%translations_directory' => $translations_directory, '@handbook_url' => 'http://drupal.org/server-permissions')), + ); + } + // If translations directory is not writable, throw an error. + if (!$writable) { + $requirements['translations directory writable'] = array( + 'title' => st('Translations directory'), + 'value' => st('The translations directory is not writable.'), + 'severity' => REQUIREMENT_ERROR, + 'description' => st('The installer requires write permissions to %translations_directory during the installation process. If you are unsure how to grant file permissions, consult the online handbook.', array('%translations_directory' => $translations_directory, '@handbook_url' => 'http://drupal.org/server-permissions')), + ); + } + else { + $requirements['translations directory writable'] = array( + 'title' => st('Translations directory'), + 'value' => st('The translations directory is writable.'), + ); + } + // If translations directory is not executable, throw an error. + if (!$executable) { + $requirements['translations directory executable'] = array( + 'title' => st('Translations directory'), + 'value' => st('The translations directory is not executable.'), + 'severity' => REQUIREMENT_ERROR, + 'description' => st('The installer requires execute permissions to %translations_directory during the installation process. If you are unsure how to grant file permissions, consult the online handbook.', array('%translations_directory' => $translations_directory, '@handbook_url' => 'http://drupal.org/server-permissions')), + ); + } + } + + // If the translations server can not be contacted, throw an error. + if (!$online) { + $requirements['online'] = array( + 'title' => st('Internet'), + 'value' => st('The translation server is offline.'), + 'severity' => REQUIREMENT_ERROR, + 'description' => st('The installer requires to contact the translation server to download a translation file. Check your internet connection and verify that your website can reach the translation server at !server_url.', array('!server_url' => $server_url)), + ); + } + else { + $requirements['online'] = array( + 'title' => st('Internet'), + 'value' => st('The translation server is online.'), + ); + // If translation file is not found at the translation server, throw an + // error. + if (!$translation_available) { + $requirements['translation available'] = array( + 'title' => st('Translation'), + 'value' => st('The %language translation is not available.', array('%language' => $language)), + 'severity' => REQUIREMENT_ERROR, + 'description' => st('The %language translation file is not available at the translation server. Choose a different language or select English and translate your website later.', array('%language' => $language, '!url' => check_url($_SERVER['SCRIPT_NAME']))), + ); + } + else { + $requirements['translation available'] = array( + 'title' => st('Translation'), + 'value' => st('The %language translation is available.', array('%language' => $language)), + ); + } + } + + if ($translations_directory_exists && $readable && $writable && $executable && $translation_available) { + $translation_downloaded = install_retrieve_file($translation_url, $translations_directory); + + if (!$translation_downloaded) { + $requirements['translation downloaded'] = array( + 'title' => st('Translation'), + 'value' => st('The %language translation could not be downloaded.', array('%language' => $language)), + 'severity' => REQUIREMENT_ERROR, + 'description' => st('The %language translation file could not be downloaded. Choose a different language or select English and translate your website later.', array('%language' => $language, '!url' => check_url($_SERVER['SCRIPT_NAME']))), + ); + } + } + + return $requirements; +} + +/** + * Checks installation requirements and reports any errors. + */ function install_check_requirements($install_state) { $profile = $install_state['parameters']['profile']; @@ -1863,6 +2130,56 @@ function install_check_requirements($install_state) { } /** + * Displays installation requirements. + * + * @param array $install_state + * An array of information about the current installation state. + * @param array $requirements + * An array of requirements, in the same format as is returned by + * hook_requirements(). + * + * @return + * A themed status report, or an exception if there are requirement errors. + * If there are only requirement warnings, a themed status report is shown + * initially, but the user is allowed to bypass it by providing 'continue=1' + * in the URL. Otherwise, no output is returned, so that the next task can be + * run in the same page request. + * + * @thows \Exception + */ +function install_display_requirements($install_state, $requirements) { + // Check the severity of the requirements reported. + $severity = drupal_requirements_severity($requirements); + + // If there are errors, always display them. If there are only warnings, skip + // them if the user has provided a URL parameter acknowledging the warnings + // and indicating a desire to continue anyway. See drupal_requirements_url(). + if ($severity == REQUIREMENT_ERROR || ($severity == REQUIREMENT_WARNING && empty($install_state['parameters']['continue']))) { + if ($install_state['interactive']) { + drupal_set_title(st('Requirements problem')); + $status_report = theme('status_report', array('requirements' => $requirements)); + $status_report .= st('Check the messages and try again.', array('!url' => check_url(drupal_requirements_url($severity)))); + return $status_report; + } + else { + // Throw an exception showing any unmet requirements. + $failures = array(); + foreach ($requirements as $requirement) { + // Skip warnings altogether for non-interactive installations; these + // proceed in a single request so there is no good opportunity (and no + // good method) to warn the user anyway. + if (isset($requirement['severity']) && $requirement['severity'] == REQUIREMENT_ERROR) { + $failures[] = $requirement['title'] . ': ' . $requirement['value'] . "\n\n" . $requirement['description']; + } + } + if (!empty($failures)) { + throw new \Exception(implode("\n\n", $failures)); + } + } + } +} + +/** * Form constructor for a site configuration form. * * @param $install_state