1 menu.inc menu_get_custom_theme($initialize = FALSE)

Gets the custom theme for the current page, if there is one.


$initialize: This parameter should only be used internally; it is set to TRUE in order to force the custom theme to be initialized for the current page request.

Return value

The machine-readable name of the custom theme, if there is one.:

See also


Related topics


core/includes/menu.inc, line 1939
API for the Backdrop menu system.


function menu_get_custom_theme($initialize = FALSE) {
  $custom_theme = &backdrop_static(__FUNCTION__);
  $site_config = config('system.core');

  // Offline mode checking does not allow for module overrides of the theme.
  $offline_mode = (_menu_site_status() === MENU_SITE_OFFLINE || defined('MAINTENANCE_MODE'));
  if ($offline_mode) {
    $custom_theme = settings_get('maintenance_theme');
    if (empty($custom_theme)) {
      $custom_theme = $site_config->get('maintenance_theme');
    if (empty($custom_theme)) {
      $custom_theme = $site_config->get('theme_default');
  elseif ($initialize) {
    // First allow modules to dynamically set a custom theme for the current
    // page. Since we can only have one, the last module to return a valid
    // theme takes precedence.
    $custom_themes = array_filter(module_invoke_all('custom_theme'), 'backdrop_theme_access');
    if (!empty($custom_themes)) {
      $custom_theme = array_pop($custom_themes);
    // If there is a theme callback function for the current page, execute it.
    // If this returns a valid theme, it will override any theme that was set
    // by a hook_custom_theme() implementation above.
    $router_item = menu_get_item();
    if (!empty($router_item['access']) && !empty($router_item['theme_callback'])) {
      $theme_name = call_user_func_array($router_item['theme_callback'], $router_item['theme_arguments']);
      if (backdrop_theme_access($theme_name)) {
        $custom_theme = $theme_name;
  return $custom_theme;