webmaster@1: <?php
webmaster@1: // $Id: help.admin.inc,v 1.5 2007/11/25 11:11:17 goba Exp $
webmaster@1: 
webmaster@1: /**
webmaster@1:  * @file
webmaster@1:  * Admin page callbacks for the help module.
webmaster@1:  */
webmaster@1: 
webmaster@1: /**
webmaster@1:  * Menu callback; prints a page listing a glossary of Drupal terminology.
webmaster@1:  */
webmaster@1: function help_main() {
webmaster@1:   // Add CSS
webmaster@1:   drupal_add_css(drupal_get_path('module', 'help') .'/help.css', 'module', 'all', FALSE);
webmaster@1:   $output = '<h2>'. t('Help topics') .'</h2><p>'. t('Help is available on the following items:') .'</p>'. help_links_as_list();
webmaster@1:   return $output;
webmaster@1: }
webmaster@1: 
webmaster@1: /**
webmaster@1:  * Menu callback; prints a page listing general help for a module.
webmaster@1:  */
webmaster@1: function help_page($name) {
webmaster@1:   $output = '';
webmaster@1:   if (module_hook($name, 'help')) {
webmaster@1:     $module = drupal_parse_info_file(drupal_get_path('module', $name) .'/'. $name .'.info');
webmaster@1:     drupal_set_title($module['name']);
webmaster@1: 
webmaster@1:     $temp = module_invoke($name, 'help', "admin/help#$name", drupal_help_arg());
webmaster@1:     if (empty($temp)) {
webmaster@1:       $output .= t("No help is available for module %module.", array('%module' => $module['name']));
webmaster@1:     }
webmaster@1:     else {
webmaster@1:       $output .= $temp;
webmaster@1:     }
webmaster@1: 
webmaster@1:     // Only print list of administration pages if the module in question has
webmaster@1:     // any such pages associated to it.
webmaster@1:     $admin_tasks = system_get_module_admin_tasks($name);
webmaster@1:     if (!empty($admin_tasks)) {
webmaster@1:       ksort($admin_tasks);
webmaster@1:       $output .= theme('item_list', $admin_tasks, t('@module administration pages', array('@module' => $module['name'])));
webmaster@1:     }
webmaster@1: 
webmaster@1:   }
webmaster@1:   return $output;
webmaster@1: }
webmaster@1: 
webmaster@1: function help_links_as_list() {
webmaster@1:   $empty_arg = drupal_help_arg();
webmaster@1:   $module_info = module_rebuild_cache();
webmaster@1: 
webmaster@1:   $modules = array();
webmaster@1:   foreach (module_implements('help', TRUE) as $module) {
webmaster@1:     if (module_invoke($module, 'help', "admin/help#$module", $empty_arg)) {
webmaster@1:       $modules[$module] = $module_info[$module]->info['name'];
webmaster@1:     }
webmaster@1:   }
webmaster@1:   asort($modules);
webmaster@1: 
webmaster@1:   // Output pretty four-column list
webmaster@1:   $count = count($modules);
webmaster@1:   $break = ceil($count / 4);
webmaster@1:   $output = '<div class="clear-block"><div class="help-items"><ul>';
webmaster@1:   $i = 0;
webmaster@1:   foreach ($modules as $module => $name) {
webmaster@1:     $output .= '<li>'. l($name, 'admin/help/'. $module) .'</li>';
webmaster@1:     if (($i + 1) % $break == 0 && ($i + 1) != $count) {
webmaster@1:       $output .= '</ul></div><div class="help-items'. ($i + 1 == $break * 3 ? ' help-items-last' : '') .'"><ul>';
webmaster@1:     }
webmaster@1:     $i++;
webmaster@1:   }
webmaster@1:   $output .= '</ul></div></div>';
webmaster@1: 
webmaster@1:   return $output;
webmaster@1: }
webmaster@1: