|
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 */ |
|
11 function 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 */ |
|
24 function 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 */ |
|
58 function 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 |