1<?php
2
3/**
4 * @file
5 * Admin page callbacks for the help module.
6 */
7
8/**
9 * Menu callback; prints a page listing a glossary of Drupal terminology.
10 */
11function help_main() {
12  // Add CSS
13  drupal_add_css(drupal_get_path('module', 'help') . '/help.css');
14  $output = '<h2>' . t('Help topics') . '</h2><p>' . t('Help is available on the following items:') . '</p>' . help_links_as_list();
15  return $output;
16}
17
18/**
19 * Menu callback; prints a page listing general help for a module.
20 *
21 * @param $name
22 *   A module name to display a help page for.
23 */
24function help_page($name) {
25  $output = '';
26  if (module_hook($name, 'help')) {
27    $info = system_get_info('module');
28    drupal_set_title($info[$name]['name']);
29
30    $temp = module_invoke($name, 'help', "admin/help#$name", drupal_help_arg());
31    if (empty($temp)) {
32      $output .= t("No help is available for module %module.", array('%module' => $info[$name]['name']));
33    }
34    else {
35      $output .= $temp;
36    }
37
38    // Only print list of administration pages if the module in question has
39    // any such pages associated to it.
40    $admin_tasks = system_get_module_admin_tasks($name, $info[$name]);
41    if (!empty($admin_tasks)) {
42      $links = array();
43      foreach ($admin_tasks as $task) {
44        $links[] = l($task['title'], $task['link_path'], $task['localized_options']);
45      }
46      $output .= theme('item_list', array('items' => $links, 'title' => t('@module administration pages', array('@module' => $info[$name]['name']))));
47    }
48  }
49  return $output;
50}
51
52/**
53 * Provides a formatted list of available help topics.
54 *
55 * @return
56 *   A string containing the formatted list.
57 */
58function help_links_as_list() {
59  $empty_arg = drupal_help_arg();
60  $module_info = system_rebuild_module_data();
61
62  $modules = array();
63  foreach (module_implements('help', TRUE) as $module) {
64    if (module_invoke($module, 'help', "admin/help#$module", $empty_arg)) {
65      $modules[$module] = $module_info[$module]->info['name'];
66    }
67  }
68  asort($modules);
69
70  // Output pretty four-column list.
71  $count = count($modules);
72  $break = ceil($count / 4);
73  $output = '<div class="clearfix"><div class="help-items"><ul>';
74  $i = 0;
75  foreach ($modules as $module => $name) {
76    $output .= '<li>' . l($name, 'admin/help/' . $module) . '</li>';
77    if (($i + 1) % $break == 0 && ($i + 1) != $count) {
78      $output .= '</ul></div><div class="help-items' . ($i + 1 == $break * 3 ? ' help-items-last' : '') . '"><ul>';
79    }
80    $i++;
81  }
82  $output .= '</ul></div></div>';
83
84  return $output;
85}
86
87