Same name and namespace in other branches
  1. 10 core/lib/Drupal/Core/Render/theme.api.php \hook_theme_registry_alter()
  2. 7.x modules/system/system.api.php \hook_theme_registry_alter()
  3. 8.9.x core/lib/Drupal/Core/Render/theme.api.php \hook_theme_registry_alter()
  4. 9 core/lib/Drupal/Core/Render/theme.api.php \hook_theme_registry_alter()

Alter the theme registry information returned from hook_theme().

The theme registry stores information about all available theme hooks, including which callback functions those hooks will call when triggered, what template files are exposed by these hooks, and so on.

Note that this hook is only executed as the theme cache is re-built. Changes here will not be visible until the next cache clear.

The $theme_registry array is keyed by theme hook name, and contains the information returned from hook_theme(), as well as additional properties added by _theme_process_registry().

For example:

$theme_registry['user_profile'] = array(
  'arguments' => array(
    'account' => NULL,
  ),
  'template' => 'modules/user/user-profile',
  'file' => 'modules/user/user.pages.inc',
  'type' => 'module',
  'theme path' => 'modules/user',
  'theme paths' => array(
    0 => 'modules/user',
  ),
  'preprocess functions' => array(
    0 => 'template_preprocess',
    1 => 'template_preprocess_user_profile',
  ),
);

Parameters

$theme_registry: The entire cache of theme registry information, post-processing.

See also

hook_theme()

_theme_process_registry()

Related topics

1 invocation of hook_theme_registry_alter()
_theme_build_registry in includes/theme.inc
Rebuild the hook theme_registry cache.

File

developer/hooks/core.php, line 2258
These are the hooks that are invoked by the Drupal core.

Code

function hook_theme_registry_alter(&$theme_registry) {

  // Kill the next/previous forum topic navigation links.
  foreach ($theme_registry['forum_topic_navigation']['preprocess functions'] as $key => $value) {
    if ($value == 'template_preprocess_forum_topic_navigation') {
      unset($theme_registry['forum_topic_navigation']['preprocess functions'][$key]);
    }
  }
}