551 lines
18 KiB
PHP
551 lines
18 KiB
PHP
<?php
|
|
|
|
/**
|
|
* @file
|
|
* Admin settings and update page.
|
|
*/
|
|
|
|
/**
|
|
* Project has a new release available.
|
|
*/
|
|
define('L10N_UPDATE_NOT_CURRENT', 4);
|
|
|
|
/**
|
|
* Project is up to date.
|
|
*/
|
|
define('L10N_UPDATE_CURRENT', 5);
|
|
|
|
/**
|
|
* Project's status cannot be checked.
|
|
*/
|
|
define('L10N_UPDATE_NOT_CHECKED', -1);
|
|
|
|
/**
|
|
* No available update data was found for project.
|
|
*/
|
|
define('L10N_UPDATE_UNKNOWN', -2);
|
|
|
|
/**
|
|
* There was a failure fetching available update data for this project.
|
|
*/
|
|
define('L10N_UPDATE_NOT_FETCHED', -3);
|
|
|
|
// Include l10n_update API
|
|
module_load_include('check.inc', 'l10n_update');
|
|
// And project api
|
|
module_load_include('project.inc', 'l10n_update');
|
|
|
|
/**
|
|
* Page callback: Admin overview page.
|
|
*/
|
|
function l10n_update_admin_overview() {
|
|
// For now we get package information provided by modules.
|
|
$projects = l10n_update_get_projects();
|
|
$languages = l10n_update_language_list('name');
|
|
|
|
$build = array();
|
|
if ($languages) {
|
|
$history = l10n_update_get_history();
|
|
$available = l10n_update_available_releases();
|
|
$updates = l10n_update_build_updates($history, $available);
|
|
$build['project_status'] = array(
|
|
'#theme' => 'l10n_update_project_status',
|
|
'#projects' => $projects,
|
|
'#languages' => $languages,
|
|
'#history' => $history,
|
|
'#available' => $available,
|
|
'#updates' => $updates,
|
|
);
|
|
$build['admin_import_form'] = drupal_get_form('l10n_update_admin_import_form', $projects, $updates);
|
|
}
|
|
else {
|
|
$build['no_projects'] = array('#markup' => t('No projects or languages to update.'));
|
|
}
|
|
return $build;
|
|
}
|
|
|
|
/**
|
|
* Translation update form.
|
|
*
|
|
* @todo selectable packages
|
|
* @todo check language support in server
|
|
* @todo check file update dates
|
|
*
|
|
* @param $form_state
|
|
* Form states array.
|
|
* @param $projects
|
|
* @todo $projects are not used in the form.
|
|
* @param $updates
|
|
* Updates to be displayed in the form.
|
|
*/
|
|
function l10n_update_admin_import_form($form, $form_state, $projects, $updates) {
|
|
//module_load_include('inc', 'l10n_update');
|
|
// For now we get package information provided by modules
|
|
$projects = l10n_update_get_projects();
|
|
$languages = l10n_update_language_list('name');
|
|
|
|
// Absence of projects is an error and only occurs if the database table
|
|
// was truncated. In this case we rebuild the project data.
|
|
if (!$projects) {
|
|
l10n_update_build_projects();
|
|
$projects = l10n_update_get_projects();
|
|
}
|
|
|
|
if ($projects && $languages) {
|
|
$form['updates'] = array(
|
|
'#type' => 'value',
|
|
'#value' => $updates,
|
|
);
|
|
// @todo Only show this language fieldset if we have more than 1 language.
|
|
$form['lang'] = array(
|
|
'#type' => 'fieldset',
|
|
'#title' => t('Languages'),
|
|
'#collapsible' => TRUE,
|
|
'#collapsed' => TRUE,
|
|
'#description' => t('Select one or more languages to download and update. If you select none, all of them will be updated.'),
|
|
);
|
|
$form['lang']['languages'] = array(
|
|
'#type' => 'checkboxes',
|
|
'#options' => $languages,
|
|
);
|
|
$form['mode'] = array(
|
|
'#type' => 'radios',
|
|
'#title' => t('Update mode'),
|
|
'#default_value' => variable_get('l10n_update_import_mode', LOCALE_IMPORT_KEEP),
|
|
'#options' => _l10n_update_admin_import_options(),
|
|
);
|
|
$form['buttons']['download'] = array(
|
|
'#type' => 'submit',
|
|
'#value' => t('Update translations'),
|
|
);
|
|
}
|
|
$form['buttons']['refresh'] = array(
|
|
'#type' => 'submit',
|
|
'#value' => t('Refresh information'),
|
|
);
|
|
return $form;
|
|
}
|
|
|
|
/**
|
|
* Submit handler for Update form.
|
|
*
|
|
* Handles both submit buttons to update translations and to update the
|
|
* form information.
|
|
*/
|
|
function l10n_update_admin_import_form_submit($form, $form_state) {
|
|
$op = isset($form_state['values']['op']) ? $form_state['values']['op'] : '';
|
|
$projects = l10n_update_get_projects();
|
|
|
|
if ($op == t('Update translations')) {
|
|
$languages = array_filter($form_state['values']['languages']);
|
|
$updates = $form_state['values']['updates'];
|
|
$mode = $form_state['values']['mode'];
|
|
if ($projects && $updates) {
|
|
module_load_include('batch.inc', 'l10n_update');
|
|
// Filter out updates in other languages. If no languages, all of them will be updated
|
|
$updates = _l10n_update_prepare_updates($updates, NULL, $languages);
|
|
$batch = l10n_update_batch_multiple($updates, $mode);
|
|
batch_set($batch);
|
|
}
|
|
else {
|
|
drupal_set_message(t('Cannot find any translation updates.'), 'error');
|
|
}
|
|
}
|
|
elseif ($op == t('Refresh information')) {
|
|
// Get current version of projects.
|
|
l10n_update_build_projects();
|
|
|
|
// Get available translation updates and update file history.
|
|
if ($available = l10n_update_available_releases(TRUE)) {
|
|
l10n_update_flag_history($available);
|
|
drupal_set_message(t('Fetched information about available updates from the server'));
|
|
}
|
|
else {
|
|
drupal_set_message(t('Failed to fetch information about available updates from the server.'), 'error');
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Page callback: Settings form.
|
|
*/
|
|
function l10n_update_admin_settings_form($form, &$form_state) {
|
|
$form['l10n_update_check_mode'] = array(
|
|
'#type' => 'radios',
|
|
'#title' => t('Update source'),
|
|
'#default_value' => variable_get('l10n_update_check_mode', L10N_UPDATE_CHECK_ALL),
|
|
'#options' => _l10n_update_admin_check_options(),
|
|
);
|
|
$form['l10n_update_import_mode'] = array(
|
|
'#type' => 'radios',
|
|
'#title' => t('Update mode'),
|
|
'#default_value' => variable_get('l10n_update_import_mode', LOCALE_IMPORT_KEEP),
|
|
'#options' => _l10n_update_admin_import_options(),
|
|
);
|
|
$form['l10n_update_check_frequency'] = array(
|
|
'#type' => 'radios',
|
|
'#title' => t('Check for updates'),
|
|
'#default_value' => variable_get('l10n_update_check_frequency', 0),
|
|
'#options' => array(
|
|
0 => t('Never (manually)'),
|
|
1 => t('Daily'),
|
|
7 => t('Weekly'),
|
|
),
|
|
'#description' => t('Select how frequently you want to automatically check for updated translations for installed modules and themes.'),
|
|
);
|
|
$form['l10n_update_check_disabled'] = array(
|
|
'#type' => 'checkbox',
|
|
'#title' => t('Check for updates of disabled modules and themes'),
|
|
'#default_value' => variable_get('l10n_update_check_disabled', 0),
|
|
'#description' => t('Note that this comes with a performance penalty, so it is not recommended.'),
|
|
);
|
|
$form['l10n_update_download_store'] = array(
|
|
'#title' => t('Store downloaded files'),
|
|
'#type' => 'textfield',
|
|
'#default_value' => variable_get('l10n_update_download_store', ''),
|
|
'#description' => t('A path relative to the Drupal installation directory where translation files will be stored, e.g. sites/all/translations. Saved translation files can be reused by other installations. If left empty the downloaded translation will not be saved.'),
|
|
);
|
|
return system_settings_form($form);
|
|
}
|
|
|
|
/**
|
|
* Additional validation handler for update settings.
|
|
*
|
|
* Check for existing files directory and creates one when required.
|
|
*/
|
|
function l10n_update_admin_settings_form_validate($form, &$form_state) {
|
|
$form_values = $form_state['values'];
|
|
if (!empty($form_values['l10n_update_download_store'])) {
|
|
if (!file_prepare_directory($form_values['l10n_update_download_store'], FILE_CREATE_DIRECTORY, 'l10n_update_download_store')) {
|
|
form_set_error('l10n_update_download_store', t('The directory %directory does not exist or is not writable.', array('%directory' => $form_values['l10n_update_download_store'])));
|
|
watchdog('file system', 'The directory %directory does not exist or is not writable.', array('%directory' => $form_values['l10n_update_download_store']), WATCHDOG_ERROR);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get array of import options.
|
|
*
|
|
* The import options of the Locale module are used but the UI text is altered
|
|
* to suit the Localization update cases.
|
|
*
|
|
* @return
|
|
* Keyed array of import options.
|
|
*/
|
|
function _l10n_update_admin_import_options() {
|
|
return array(
|
|
LOCALE_IMPORT_OVERWRITE => t('Translation updates replace existing ones, new ones are added'),
|
|
LOCALE_UPDATE_OVERRIDE_DEFAULT => t('Edited translations are kept, only previously imported ones are overwritten and new translations are added'),
|
|
LOCALE_IMPORT_KEEP => t('All existing translations are kept, only new translations are added.'),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get array of check options.
|
|
*
|
|
* @return
|
|
* Keyed array of source download options.
|
|
*/
|
|
function _l10n_update_admin_check_options() {
|
|
return array(
|
|
L10N_UPDATE_CHECK_ALL => t('Local files and remote server.'),
|
|
L10N_UPDATE_CHECK_LOCAL => t('Local files only.'),
|
|
L10N_UPDATE_CHECK_REMOTE => t('Remote server only.'),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Format project update status.
|
|
*
|
|
* @param $variables
|
|
* An associative array containing:
|
|
* - projects: An array containing all enabled projects.
|
|
* - languages: An array of all enabled languages.
|
|
* - history: An array of the current translations per project.
|
|
* - available: An array of translation sources per project.
|
|
* - updates: An array of available translation updates per project.
|
|
* Only recommended translations are listed.
|
|
*
|
|
* @return string
|
|
* HTML output.
|
|
*/
|
|
function theme_l10n_update_project_status($variables) {
|
|
$header = $rows = array();
|
|
|
|
// Get module and theme data for the project title.
|
|
$projects = system_rebuild_module_data();
|
|
$projects += system_rebuild_theme_data();
|
|
|
|
foreach ($variables['projects'] as $name => $project) {
|
|
if (isset($variables['history'][$name])) {
|
|
if (isset($variables['updates'][$name])) {
|
|
$project_status = 'updatable';
|
|
$project_class = 'warning';
|
|
}
|
|
else {
|
|
$project_status = 'uptodate';
|
|
$project_class = 'ok';
|
|
}
|
|
}
|
|
elseif (isset($variables['available'][$name])) {
|
|
$project_status = 'available';
|
|
$project_class = 'warning';
|
|
}
|
|
else {
|
|
// Remote information not checked
|
|
$project_status = 'unknown';
|
|
$project_class = 'unknown';
|
|
}
|
|
|
|
// Get the project title and module version.
|
|
$project->title = isset($projects[$name]->info['name']) ? $projects[$name]->info['name'] : '';
|
|
$project->module_version = isset($projects[$name]->info['version']) ? $projects[$name]->info['version'] : $project->version;
|
|
|
|
// Project with related language states.
|
|
$row = theme('l10n_update_single_project_wrapper', array(
|
|
'project' => $project,
|
|
'project_status' => $project_status,
|
|
'languages' => $variables['languages'],
|
|
'available' => $variables['available'],
|
|
'history' => $variables['history'],
|
|
'updates' => $variables['updates'],
|
|
));
|
|
|
|
$rows[$project->project_type][] = array(
|
|
'data' => array(
|
|
array(
|
|
'data' => $row,
|
|
'class' => 'l10n-update-wrapper collapsed',
|
|
),
|
|
),
|
|
'class' => array($project_class),
|
|
);
|
|
}
|
|
|
|
// Build tables of update states grouped by project type. Similar to the
|
|
// status report by the Update module.
|
|
$output = '';
|
|
$project_types = array(
|
|
'core' => t('Drupal core'),
|
|
'module' => t('Modules'),
|
|
'theme' => t('Themes'),
|
|
'module-disabled' => t('Disabled modules'),
|
|
'theme-disabled' => t('Disabled themes'),
|
|
);
|
|
foreach ($project_types as $type_name => $type_label) {
|
|
if (!empty($rows[$type_name])) {
|
|
ksort($rows[$type_name]);
|
|
$output .= "\n<h3>" . $type_label . "</h3>\n";
|
|
$output .= theme('table', array('header' => $header, 'rows' => $rows[$type_name], 'attributes' => array('class' => array('update l10n-update'))));
|
|
}
|
|
}
|
|
|
|
// We use the core update module CSS to re-use the color definitions.
|
|
// Plus add our own css and js.
|
|
drupal_add_css(drupal_get_path('module', 'update') . '/update.css');
|
|
drupal_add_css(drupal_get_path('module', 'l10n_update') . '/css/l10n_update.admin.css');
|
|
drupal_add_js(drupal_get_path('module', 'l10n_update') . '/js/l10n_update.js');
|
|
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Format project translation state with states per language.
|
|
*
|
|
* @param $variables
|
|
* An associative array containing:
|
|
* - project: Project data object
|
|
* - project_status: Project status
|
|
* - languages: Available languages.
|
|
* @return string
|
|
* HTML output.
|
|
*/
|
|
function theme_l10n_update_single_project_wrapper($variables) {
|
|
$project = $variables['project'];
|
|
$name = $project->name;
|
|
$project_status = $variables['project_status'];
|
|
$languages = $variables['languages'];
|
|
$history = $variables['history'];
|
|
$updates = $variables['updates'];
|
|
$availables = $variables['available'];
|
|
|
|
// Output project title and project summary status.
|
|
$output = theme('l10n_update_single_project_status', array(
|
|
'project' => $project,
|
|
'server' => l10n_update_server($project->l10n_server),
|
|
'status' => $project_status,
|
|
));
|
|
|
|
// Translation status per language is displayed in a table, one language per row.
|
|
// For each language the current translation is listed. And optionally the
|
|
// most recent update.
|
|
$rows = array();
|
|
foreach ($languages as $lang => $language) {
|
|
// Determine current translation status and update status.
|
|
$installed = isset($history[$name][$lang]) ? $history[$name][$lang] : NULL;
|
|
$update = isset($updates[$name][$lang]) ? $updates[$name][$lang] : NULL;
|
|
$available = isset($availables[$name][$lang]) ? $availables[$name][$lang] : NULL;
|
|
if ($installed) {
|
|
if ($update) {
|
|
$status = 'updatable';
|
|
$class = 'messages warning';
|
|
}
|
|
else {
|
|
$status = 'uptodate';
|
|
$class = 'ok';
|
|
}
|
|
}
|
|
elseif ($available) {
|
|
$status = 'available';
|
|
$class = 'warning';
|
|
}
|
|
else {
|
|
$status = 'unknown';
|
|
$class = 'unknown';
|
|
}
|
|
|
|
// The current translation version.
|
|
$row = theme('l10n_update_current_release', array('language' => $language, 'release' => $installed, 'status' => $status));
|
|
|
|
// If an update is available, add it.
|
|
if ($update) {
|
|
$row .= theme('l10n_update_available_release', array('release' => $update));
|
|
}
|
|
|
|
$rows[] = array(
|
|
'data' => array($row),
|
|
'class' => array($class),
|
|
);
|
|
}
|
|
|
|
// Output tables with translation status per language.
|
|
$output .= '<div class="fieldset-wrapper">' . "\n";
|
|
$output .= theme('table', array('header' => array(), 'rows' => $rows));
|
|
$output .= "</div>\n";
|
|
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Format a single project translation state.
|
|
*
|
|
* @param $variables
|
|
* An associative array containing:
|
|
* - project: project data object.
|
|
* - server: (optional) remote server data object.
|
|
* - status: project summary status.
|
|
* @return string
|
|
* HTML output.
|
|
*/
|
|
function theme_l10n_update_single_project_status($variables) {
|
|
$project = $variables['project'];
|
|
$server = $variables['server'];
|
|
$title = $project->title ? $project->title : $project->name;
|
|
|
|
$output = '<div class="project">';
|
|
$output .= '<span class="project-title">' . check_plain($title) . '</span>' . ' ' . check_plain($project->module_version) ;
|
|
if ($server = l10n_update_server($project->l10n_server)) {
|
|
$output .= '<span class="project-server">' . t('(translation source: !server)', array('!server' => l($server['name'], $server['link']))) . '</span>';
|
|
}
|
|
$output .= theme('l10n_update_version_status', array('status' => $variables['status']));
|
|
$output .= "</div>\n";
|
|
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Format current translation version.
|
|
*
|
|
* @param $variables
|
|
* An associative array containing:
|
|
* - language: Language name.
|
|
* - release: Current file data.
|
|
* - status: Release status.
|
|
* @return string
|
|
* HTML output.
|
|
*/
|
|
function theme_l10n_update_current_release($variables) {
|
|
if (isset($variables['release'])) {
|
|
$date = $variables['release']->timestamp;
|
|
$version = $variables['release']->version;
|
|
$text = t('@language: @version (!date)', array('@language' => $variables['language'], '@version' => $version, '!date' => format_date($date, 'custom', 'Y-M-d')));
|
|
}
|
|
else {
|
|
$text = t('@language: <em>No installed translation</em>', array('@language' => $variables['language']));
|
|
}
|
|
|
|
$output = '<div class="language">';
|
|
$output .= $text;
|
|
$output .= theme('l10n_update_version_status', $variables);
|
|
$output .= "</div>\n";
|
|
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Format current translation version.
|
|
*
|
|
* @param object $release
|
|
* Update file data.
|
|
* @return string
|
|
* HTML output.
|
|
*/
|
|
function theme_l10n_update_available_release($variables) {
|
|
$date = $variables['release']->timestamp;
|
|
$version = $variables['release']->version;
|
|
if (!empty($variables['release']->fileurl)) {
|
|
// Remote file, straight link
|
|
$link = l(t('Download'), $variables['release']->fileurl);
|
|
}
|
|
elseif (!empty($variables['release']->uri)) {
|
|
// Local file, try something
|
|
$link = l(t('Download'), $variables['release']->uri, array('absolute' => TRUE));
|
|
}
|
|
|
|
$output = '<div class="version version-recommended">';
|
|
$output .= t('Recommended version: @version (!date)', array('@version' => $version, '!date' => format_date($date, 'custom', 'Y-M-d')));
|
|
$output .= '<span class="version-links">' . $link . '</span>';
|
|
$output .= "</div>\n";
|
|
return $output;
|
|
}
|
|
|
|
/**
|
|
* Format version status with icon.
|
|
*
|
|
* @param string $status
|
|
* Version status: 'uptodate', 'updatable', 'available', 'unknown'.
|
|
* @param string $type
|
|
* Update type: 'download', 'localfile'.
|
|
*
|
|
* @return sting
|
|
* HTML output.
|
|
*/
|
|
function theme_l10n_update_version_status($variables) {
|
|
$icon = '';
|
|
$msg = '';
|
|
|
|
switch ($variables['status']) {
|
|
case 'uptodate':
|
|
$icon = theme('image', array('path' => 'misc/watchdog-ok.png', 'alt' => t('ok'), 'title' => t('ok')));
|
|
$msg = '<span class="current">' . t('Up to date') . '</span>';
|
|
break;
|
|
case 'updatable':
|
|
$icon = theme('image', array('path' => 'misc/watchdog-warning.png', 'alt' => t('warning'), 'title' => t('warning')));
|
|
$msg = '<span class="not-current">' . t('Update available') . '</span>';
|
|
break;
|
|
case 'available':
|
|
$icon = theme('image', array('path' => 'misc/watchdog-warning.png', 'alt' => t('warning'), 'title' => t('warning')));
|
|
$msg = '<span class="not-current">' . t('Uninstalled translation available') . '</span>';
|
|
break;
|
|
case 'unknown':
|
|
$icon = theme('image', array('path' => 'misc/watchdog-warning.png', 'alt' => t('warning'), 'title' => t('warning')));
|
|
$msg = '<span class="not-supported">' . t('No available translations found') . '</span>';
|
|
break;
|
|
}
|
|
$output = '<div class="version-status">';
|
|
$output .= $msg;
|
|
$output .= '<span class="icon">' . $icon . '</span>';
|
|
$output .= "</div>\n";
|
|
return $output;
|
|
}
|