theme.maintenance.inc

Same filename in other branches
  1. 9 core/includes/theme.maintenance.inc
  2. 8.9.x core/includes/theme.maintenance.inc
  3. 10 core/includes/theme.maintenance.inc
  4. 11.x core/includes/theme.maintenance.inc

Theming for maintenance pages.

File

includes/theme.maintenance.inc

View source
<?php


/**
 * @file
 * Theming for maintenance pages.
 */

/**
 * Sets up the theming system for maintenance page.
 *
 * Used for site installs, updates and when the site is in maintenance mode.
 * It also applies when the database is unavailable or bootstrap was not
 * complete. Seven is always used for the initial install and update
 * operations. In other cases, Bartik is used, but this can be overridden by
 * setting a "maintenance_theme" key in the $conf variable in settings.php.
 */
function _drupal_maintenance_theme() {
    global $theme, $theme_key, $conf;
    // If $theme is already set, assume the others are set too, and do nothing.
    if (isset($theme)) {
        return;
    }
    require_once DRUPAL_ROOT . '/' . variable_get('path_inc', 'includes/path.inc');
    require_once DRUPAL_ROOT . '/includes/theme.inc';
    require_once DRUPAL_ROOT . '/includes/common.inc';
    require_once DRUPAL_ROOT . '/includes/unicode.inc';
    require_once DRUPAL_ROOT . '/includes/file.inc';
    require_once DRUPAL_ROOT . '/includes/module.inc';
    unicode_check();
    // Install and update pages are treated differently to prevent theming overrides.
    if (defined('MAINTENANCE_MODE') && (MAINTENANCE_MODE == 'install' || MAINTENANCE_MODE == 'update')) {
        $custom_theme = isset($conf['maintenance_theme']) ? $conf['maintenance_theme'] : 'seven';
    }
    else {
        // The bootstrap was not complete. So we are operating in a crippled
        // environment, we need to bootstrap just enough to allow hook invocations
        // to work. See _drupal_log_error().
        if (!class_exists('Database', FALSE)) {
            require_once DRUPAL_ROOT . '/includes/database/database.inc';
        }
        // We use the default theme as the maintenance theme. If a default theme
        // isn't specified in the database or in settings.php, we use Bartik.
        $custom_theme = variable_get('maintenance_theme', variable_get('theme_default', 'bartik'));
    }
    // Ensure that system.module is loaded.
    if (!function_exists('_system_rebuild_theme_data')) {
        $module_list['system']['filename'] = 'modules/system/system.module';
        module_list(TRUE, FALSE, FALSE, $module_list);
        drupal_load('module', 'system');
    }
    $themes = list_themes();
    // list_themes() triggers a drupal_alter() in maintenance mode, but we can't
    // let themes alter the .info data until we know a theme's base themes. So
    // don't set global $theme until after list_themes() builds its cache.
    $theme = $custom_theme;
    // Store the identifier for retrieving theme settings with.
    $theme_key = $theme;
    // Find all our ancestor themes and put them in an array.
    $base_theme = array();
    $ancestor = $theme;
    while ($ancestor && isset($themes[$ancestor]->base_theme)) {
        $base_theme[] = $new_base_theme = $themes[$themes[$ancestor]->base_theme];
        $ancestor = $themes[$ancestor]->base_theme;
    }
    _drupal_theme_initialize($themes[$theme], array_reverse($base_theme), '_theme_load_offline_registry');
    // These are usually added from system_init() -except maintenance.css.
    // When the database is inactive it's not called so we add it here.
    $path = drupal_get_path('module', 'system');
    drupal_add_css($path . '/system.base.css');
    drupal_add_css($path . '/system.admin.css');
    drupal_add_css($path . '/system.menus.css');
    drupal_add_css($path . '/system.messages.css');
    drupal_add_css($path . '/system.theme.css');
    drupal_add_css($path . '/system.maintenance.css');
}

/**
 * Builds the registry when the site needs to bypass any database calls.
 */
function _theme_load_offline_registry($theme, $base_theme = NULL, $theme_engine = NULL) {
    return _theme_build_registry($theme, $base_theme, $theme_engine);
}

/**
 * Returns HTML for a list of maintenance tasks to perform.
 *
 * @param $variables
 *   An associative array containing:
 *   - items: An associative array of maintenance tasks.
 *   - active: The key for the currently active maintenance task.
 *
 * @ingroup themeable
 */
function theme_task_list($variables) {
    $items = $variables['items'];
    $active = $variables['active'];
    $done = isset($items[$active]) || $active == NULL;
    $output = '<h2 class="element-invisible">Installation tasks</h2>';
    $output .= '<ol class="task-list">';
    foreach ($items as $k => $item) {
        if ($active == $k) {
            $class = 'active';
            $status = '(' . t('active') . ')';
            $done = FALSE;
        }
        else {
            $class = $done ? 'done' : '';
            $status = $done ? '(' . t('done') . ')' : '';
        }
        $output .= '<li';
        $output .= ($class ? ' class="' . $class . '"' : '') . '>';
        $output .= $item;
        $output .= $status ? '<span class="element-invisible">' . $status . '</span>' : '';
        $output .= '</li>';
    }
    $output .= '</ol>';
    return $output;
}

/**
 * Returns HTML for the installation page.
 *
 * Note: this function is not themeable.
 *
 * @param $variables
 *   An associative array containing:
 *   - content: The page content to show.
 */
function theme_install_page($variables) {
    drupal_add_http_header('Content-Type', 'text/html; charset=utf-8');
    return theme('maintenance_page', $variables);
}

/**
 * Returns HTML for the update page.
 *
 * Note: this function is not themeable.
 *
 * @param $variables
 *   An associative array containing:
 *   - content: The page content to show.
 *   - show_messages: Whether to output status and error messages.
 *     FALSE can be useful to postpone the messages to a subsequent page.
 */
function theme_update_page($variables) {
    drupal_add_http_header('Content-Type', 'text/html; charset=utf-8');
    return theme('maintenance_page', $variables);
}

/**
 * Returns HTML for a results report of an operation run by authorize.php.
 *
 * @param $variables
 *   An associative array containing:
 *   - messages: An array of result messages.
 *
 * @ingroup themeable
 */
function theme_authorize_report($variables) {
    $messages = $variables['messages'];
    $output = '';
    if (!empty($messages)) {
        $output .= '<div id="authorize-results">';
        foreach ($messages as $heading => $logs) {
            $items = array();
            foreach ($logs as $number => $log_message) {
                if ($number === '#abort') {
                    continue;
                }
                $items[] = theme('authorize_message', array(
                    'message' => $log_message['message'],
                    'success' => $log_message['success'],
                ));
            }
            $output .= theme('item_list', array(
                'items' => $items,
                'title' => $heading,
            ));
        }
        $output .= '</div>';
    }
    return $output;
}

/**
 * Returns HTML for a single log message from the authorize.php batch operation.
 *
 * @param $variables
 *   An associative array containing:
 *   - message: The log message.
 *   - success: A boolean indicating failure or success.
 *
 * @ingroup themeable
 */
function theme_authorize_message($variables) {
    $message = $variables['message'];
    $success = $variables['success'];
    if ($success) {
        $item = array(
            'data' => $message,
            'class' => array(
                'success',
            ),
        );
    }
    else {
        $item = array(
            'data' => '<strong>' . $message . '</strong>',
            'class' => array(
                'failure',
            ),
        );
    }
    return $item;
}

Functions

Title Deprecated Summary
theme_authorize_message Returns HTML for a single log message from the authorize.php batch operation.
theme_authorize_report Returns HTML for a results report of an operation run by authorize.php.
theme_install_page Returns HTML for the installation page.
theme_task_list Returns HTML for a list of maintenance tasks to perform.
theme_update_page Returns HTML for the update page.
_drupal_maintenance_theme Sets up the theming system for maintenance page.
_theme_load_offline_registry Builds the registry when the site needs to bypass any database calls.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.