'Devel Themer', 'description' => 'Display or hide the textual template log', 'page callback' => 'drupal_get_form', 'page arguments' => array('devel_themer_admin_settings'), 'access arguments' => array('administer site configuration'), 'type' => MENU_NORMAL_ITEM, ); $items['devel_themer/enable'] = array( 'title' => 'Devel Themer Enable', 'page callback' => 'devel_themer_toggle', 'page arguments' => array(1), 'access arguments' => array('access devel information'), 'type' => MENU_CALLBACK, ); $items['devel_themer/disable'] = array( 'title' => 'Theme Development Enable', 'page callback' => 'devel_themer_toggle', 'page arguments' => array(0), 'access arguments' => array('access devel information'), 'type' => MENU_CALLBACK, ); return $items; } /** * A menu callback. Usually called from the devel block. * * @return void */ function devel_themer_toggle($action) { $function = $action == 'enable' ? 'module_enable' : 'module_disable'; $$function('devel_themer'); drupal_set_message(t("Devel Themer module $action")); drupal_goto(); } function devel_themer_admin_settings() { $form['devel_themer_log'] = array('#type' => 'checkbox', '#title' => t('Display theme log'), '#default_value' => variable_get('devel_themer_log', FALSE), '#description' => t('Display the list of theme templates and theme functions which could have been be used for a given page. The one that was actually used is bolded. This is the same data as the represented in the popup, but all calls are listed in chronological order and can alternately be sorted by time.'), ); return system_settings_form($form); } function devel_themer_init() { if (user_access('access devel information')) { $path = drupal_get_path('module', 'devel_themer'); // we inject our HTML after page has loaded we have to add this manually. if (has_krumo()) { drupal_add_js($path. '/krumo/krumo.js'); drupal_add_css($path. '/krumo/skins/default/skin.css'); } drupal_add_css($path .'/devel_themer.css'); drupal_add_js($path .'/devel_themer.js'); // The order these last two are loaded is important. drupal_add_js($path .'/ui.mouse.js'); drupal_add_js($path .'/ui.draggable.js'); // This needs to happen after all the other CSS. drupal_set_html_head(''); devel_themer_popup(); if (!devel_silent() && variable_get('devel_themer_log', FALSE)) { register_shutdown_function('devel_themer_shutdown'); } } } function devel_themer_shutdown() { print devel_themer_log(); } /** * An implementation of hook_theme_registry_alter() * Iterate over theme registry, injecting our catch function into every theme call, including template calls. * The catch function logs theme calls and performs divine nastiness. * * @return void **/ function devel_themer_theme_registry_alter($theme_registry) { foreach ($theme_registry as $hook => $data) { if (isset($theme_registry[$hook]['function'])) { // If the hook is a function, store it so it can be run after it has been intercepted. // This does not apply to template calls. $theme_registry[$hook]['devel_function_intercept'] = $theme_registry[$hook]['function']; } // Add our catch function to intercept functions as well as templates. $theme_registry[$hook]['function'] = 'devel_themer_catch_function'; } } /** * Show all theme templates and functions that could have been used on this page. **/ function devel_themer_log() { if (isset($GLOBALS['devel_theme_calls'])) { foreach ($GLOBALS['devel_theme_calls'] as $counter => $call) { $id = "devel_theme_log_link_$counter"; $marker = "
\n"; $used = $call['used']; if ($call['type'] == 'func') { $name = $call['name']. '()'; foreach ($call['candidates'] as $candidate) { foreach ($candidate as $item) { if ($item == $used) { $items[] = "$used"; } else { $items[] = $item; } } } } else { $name = $call['name']; foreach ($call['candidates'] as $item) { if ($item == basename($used)) { $items[] = "$used"; } else { $items[] = $item; } } } $rows[] = array($call['duration'], $marker. $name, implode(', ', $items)); unset($items); } $header = array('Duration (ms)', 'Template/Function', "Candidate template files or function names"); $output = theme('table', $header, $rows); return $output; } } // Would be nice if theme() broke this into separate function so we don't copy logic here. this one is better - has cache function devel_themer_get_extension() { global $theme_engine; static $extension = NULL; if (!$extension) { $extension_function = $theme_engine .'_extension'; if (function_exists($extension_function)) { $extension = $extension_function(); } else { $extension = '.tpl.php'; } } return $extension; } /** * Intercepts all theme calls (including templates), adds to template log, and dispatches to original theme function. * This function gets injected into theme registry in devel_exit(). */ function devel_themer_catch_function() { $args = func_get_args(); // Get the function that is normally called. $trace = debug_backtrace(); $hook = $trace[2]['args'][0]; array_unshift($args, $hook); $counter = devel_counter(); $timer_name = "thmr_$counter"; timer_start($timer_name); // The twin of theme(). All rendering done through here. list($return, $meta) = call_user_func_array('devel_themer_theme_twin', $args); $time = timer_stop($timer_name); $skip = array('hidden', 'form_element', 'placeholder'); if (!empty($return) && !is_array($return) && !is_object($return) && user_access('access devel information')) { list($prefix, $suffix) = devel_theme_call_marker($hook, $counter, 'func'); $start_return = substr($return, 0, 31); $start_prefix = substr($prefix, 0, 31); if ($start_return != $start_prefix && !in_array($hook, $skip)) { $output = $prefix. "\n ". $return. $suffix. "\n"; if ($meta['type'] == 'func') { $name = $meta['used']; $used = $meta['used']; if (empty($meta['wildcards'])) { $meta['wildcards'][$hook] = ''; } $candidates = devel_themer_ancestry(array_reverse(array_keys($meta['wildcards']))); if (empty($meta['variables'])) { $variables = array(); } elseif (has_krumo()) { $variables = krumo_ob($meta['variables']); } else { $variables = devel_print_object($meta['variables'], NULL, FALSE); } } else { $name = $meta['used']. devel_themer_get_extension(); if (empty($suggestions)) { array_unshift($meta['suggestions'], $meta['used']); } $candidates = array_reverse(array_map('devel_themer_append_extension', $meta['suggestions'])); $used = $meta['template_file']; if (has_krumo()) { $variables = krumo_ob($meta['variables']); } else { $variables = devel_print_object($meta['variables'], '$', FALSE); } } $GLOBALS['devel_theme_calls']["thmr_$counter"] = array( 'name' => $name, 'type' => $meta['type'], 'duration' => $time['time'], 'used' => $used, 'candidates' => $candidates, 'args' => $variables, ); } else { $output = $return; } } return isset($output) ? $output : $return; } function devel_themer_append_extension($string) { return $string. devel_themer_get_extension(); } /** * For given theme *function* call, return the ancestry of function names which could have handled the call. * This mimics the way the theme registry is built. * * @param array * A list of theme calls. * @return array() * An array of function names. **/ function devel_themer_ancestry($calls) { global $theme, $theme_engine, $base_theme_info; static $prefixes; if (!isset($prefixes)) { $prefixes[] = 'theme'; if (isset($base_theme_info)) { foreach ($base_theme_info as $base) { $prefixes[] = $base->name; } } $prefixes[] = $theme_engine; $prefixes[] = $theme; $prefixes = array_filter($prefixes); } foreach ($calls as $call) { foreach ($prefixes as $prefix) { $candidates[] = $prefix. '_'. $call; } } return array_reverse($candidates); } /** * An unfortunate copy/paste of theme(). This one is called by the devel_themer_catch_function() * and processes all theme calls but gives us info about the candidates, timings, etc. Without this twin, * it was impossible to capture calls to module owned templates (e.g. user_profile) and awkward to determine * which template was finally called and how long it took. * * @return array * A two element array. First element contains the HTML from the theme call. The second contains * a metadata array about the call. * **/ function devel_themer_theme_twin() { $args = func_get_args(); $hook = array_shift($args); static $hooks = NULL; if (!isset($hooks)) { init_theme(); $hooks = theme_get_registry(); } // Gather all possible wildcard functions. $meta['wildcards'] = array(); if (is_array($hook)) { foreach ($hook as $candidate) { $meta['wildcards'][$candidate] = FALSE; if (isset($hooks[$candidate])) { $meta['wildcards'][$candidate] = TRUE; break; } } $hook = $candidate; } // This should not be needed but some users are getting errors. See http://drupal.org/node/209929 if (!isset($hooks[$hook])) { return array('', $meta); } $info = $hooks[$hook]; $meta['hook'] = $hook; $meta['path'] = $info['theme path']; // Include a file if the theme function or preprocess function is held elsewhere. if (!empty($info['file'])) { $include_file = $info['file']; if (isset($info['path'])) { $include_file = $info['path'] .'/'. $include_file; } include_once($include_file); } if (isset($info['devel_function_intercept'])) { // The theme call is a function. $output = call_user_func_array($info['devel_function_intercept'], $args); $meta['type'] = 'func'; $meta['used'] = $info['devel_function_intercept']; // Try to populate the keys of $args with variable names. Works on PHP5+. if (!empty($args) && class_exists('ReflectionFunction')) { $reflect = new ReflectionFunction($info['devel_function_intercept']); $params = $reflect->getParameters(); for ($i=0; $i < count($args); $i++) { $meta['variables'][$params[$i]->getName()] = $args[$i]; } } else { $meta['variables'] = $args; } } else { // The theme call is a template. $meta['type'] = 'tpl'; $meta['used'] = str_replace($info['theme path'] .'/', '', $info['template']); $variables = array( 'template_files' => array() ); if (!empty($info['arguments'])) { $count = 0; foreach ($info['arguments'] as $name => $default) { $variables[$name] = isset($args[$count]) ? $args[$count] : $default; $count++; } } // default render function and extension. $render_function = 'theme_render_template'; $extension = '.tpl.php'; // Run through the theme engine variables, if necessary global $theme_engine; if (isset($theme_engine)) { // If theme or theme engine is implementing this, it may have // a different extension and a different renderer. if ($info['type'] != 'module') { if (function_exists($theme_engine .'_render_template')) { $render_function = $theme_engine .'_render_template'; } $extension_function = $theme_engine .'_extension'; if (function_exists($extension_function)) { $extension = $extension_function(); } } } if (isset($info['preprocess functions']) && is_array($info['preprocess functions'])) { // This construct ensures that we can keep a reference through // call_user_func_array. $args = array(&$variables, $hook); foreach ($info['preprocess functions'] as $preprocess_function) { if (function_exists($preprocess_function)) { call_user_func_array($preprocess_function, $args); } } } // Get suggestions for alternate templates out of the variables // that were set. This lets us dynamically choose a template // from a list. The order is FILO, so this array is ordered from // least appropriate first to most appropriate last. $suggestions = array(); if (isset($variables['template_files'])) { $suggestions = $variables['template_files']; } if (isset($variables['template_file'])) { $suggestions[] = $variables['template_file']; } if ($suggestions) { $template_file = drupal_discover_template($info['theme paths'], $suggestions, $extension); } if (empty($template_file)) { $template_file = $info['template'] . $extension; if (isset($info['path'])) { $template_file = $info['path'] .'/'. $template_file; } } $output = $render_function($template_file, $variables); $meta['suggestions'] = $suggestions; $meta['template_file'] = $template_file; $meta['variables'] = $variables; } return array($output, $meta); } // we emit the huge js array here instead of hook_footer so we can catch theme('page') function devel_themer_exit() { if (!empty($GLOBALS['devel_theme_calls']) && $_SERVER['REQUEST_METHOD'] != 'POST') { print '\n"; } } function devel_theme_call_marker($name, $counter, $type) { $id = "thmr_". $counter; return array("", "\n"); } // just hand out next counter, or return current value function devel_counter($increment = TRUE) { static $counter = 0; if ($increment) { $counter++; } return $counter; } /** * Return the popup template * placed here for easy editing */ function devel_themer_popup() { $majorver = substr(VERSION, 0, strpos(VERSION, '.')); // add translatable strings drupal_add_js(array('thmrStrings' => array( 'themer_info' => t('Themer info'), 'toggle_throbber' => ' ', 'parents' => t('Parents: '), 'function_called' => t('Function called: '), 'template_called' => t('Template called: '), 'candidate_files' => t('Candidate template files: '), 'candidate_functions' => t('Candidate function names: '), 'drupal_api_docs' => t('link to Drupal API documentation'), 'source_link_title' => t('link to source code'), 'function_arguments' => t('Function Arguments'), 'template_variables' => t('Template Variables'), 'file_used' => t('File used: '), 'duration' => t('Duration: '), 'api_site' => variable_get('devel_api_site', 'http://api.drupal.org/'), 'drupal_version' => $majorver, 'source_link' => url('devel/source', array('query' => array('file' => ''))), )) , 'setting'); $title = t('Drupal Themer Information'); $intro = t('Click on any element to see information about the Drupal theme function or template that created it.'); $popup = <<
X $title
$intro
EOT; drupal_add_js(array('thmr_popup' => $popup), 'setting'); }