WordPress 3.0 beta 1 documentation kindly provided to you by Hay Kranen
WordPress 3.0 beta 1 documentation kindly provided to you by Hay Kranen
| [ Index ] |
PHP Cross Reference of WordPress 3.0 beta 1 |
|
| [ Index ] [ Variables ] [ Functions ] [ Classes ] [ Constants ] [ Statistics ] | ||
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Build Administration Menu. 4 * 5 * @package WordPress 6 * @subpackage Administration 7 */ 8 9 /** 10 * Constructs the admin menu bar. 11 * 12 * The elements in the array are : 13 * 0: Menu item name 14 * 1: Minimum level or capability required. 15 * 2: The URL of the item's file 16 * 3: Class 17 * 4: ID 18 * 5: Icon for top level menu 19 * 20 * @global array $menu 21 * @name $menu 22 * @var array 23 */ 24 25 $awaiting_mod = wp_count_comments(); 26 $awaiting_mod = $awaiting_mod->moderated; 27 28 if ( is_multisite() && is_super_admin() ) { 29 /* translators: Network menu item */ 30 $menu[0] = array(__('Super Admin'), 'manage_network', 'ms-admin.php', '', 'menu-top menu-top-first menu-icon-site', 'menu-site', 'div'); 31 $submenu[ 'ms-admin.php' ][1] = array( __('Admin'), 'manage_network', 'ms-admin.php' ); 32 /* translators: Sites menu item */ 33 $submenu[ 'ms-admin.php' ][5] = array( __('Sites'), 'manage_sites', 'ms-sites.php' ); 34 $submenu[ 'ms-admin.php' ][10] = array( __('Users'), 'manage_network_users', 'ms-users.php' ); 35 $submenu[ 'ms-admin.php' ][20] = array( __('Themes'), 'manage_network_themes', 'ms-themes.php' ); 36 $submenu[ 'ms-admin.php' ][25] = array( __('Options'), 'manage_network_options', 'ms-options.php' ); 37 $submenu[ 'ms-admin.php' ][30] = array( __('Update'), 'manage_network', 'ms-upgrade-network.php' ); 38 39 $menu[1] = array( '', 'read', 'separator1', '', 'wp-menu-separator' ); 40 41 $menu[2] = array( __('Dashboard'), 'read', 'index.php', '', 'menu-top menu-icon-dashboard', 'menu-dashboard', 'div' ); 42 } else { 43 $menu[2] = array( __('Dashboard'), 'read', 'index.php', '', 'menu-top menu-top-first menu-icon-dashboard', 'menu-dashboard', 'div' ); 44 } 45 46 if ( is_multisite() || is_super_admin() ) { 47 $submenu[ 'index.php' ][0] = array( __('Dashboard'), 'read', 'index.php' ); 48 49 if ( is_multisite() ) 50 $submenu[ 'index.php' ][5] = array( __('My Sites'), 'read', 'my-sites.php' ); 51 52 if ( is_super_admin() ) { 53 $plugin_update_count = $theme_update_count = $wordpress_update_count = 0; 54 $update_plugins = get_site_transient( 'update_plugins' ); 55 if ( !empty($update_plugins->response) ) 56 $plugin_update_count = count( $update_plugins->response ); 57 $update_themes = get_site_transient( 'update_themes' ); 58 if ( !empty($update_themes->response) ) 59 $theme_update_count = count( $update_themes->response ); 60 $update_wordpress = get_core_updates( array('dismissed' => false) ); 61 if ( !empty($update_wordpress) && !in_array( $update_wordpress[0]->response, array('development', 'latest') ) ) 62 $wordpress_update_count = 1; 63 64 $update_count = $plugin_update_count + $theme_update_count + $wordpress_update_count; 65 $update_title = array(); 66 if ( $wordpress_update_count ) 67 $update_title[] = sprintf(__('%d WordPress Update'), $wordpress_update_count); 68 if ( $plugin_update_count ) 69 $update_title[] = sprintf(_n('%d Plugin Update', '%d Plugin Updates', $plugin_update_count), $plugin_update_count); 70 if ( $theme_update_count ) 71 $update_title[] = sprintf(_n('%d Theme Update', '%d Themes Updates', $theme_update_count), $theme_update_count); 72 73 $update_title = !empty($update_title) ? esc_attr(implode(', ', $update_title)) : ''; 74 75 $submenu[ 'index.php' ][10] = array( sprintf( __('Updates %s'), "<span class='update-plugins count-$update_count' title='$update_title'><span class='update-count'>" . number_format_i18n($update_count) . "</span></span>" ), 'install_plugins', 'update-core.php'); 76 unset($plugin_update_count, $theme_update_count, $wordpress_update_count, $update_count, $update_title); 77 } 78 } 79 80 $menu[4] = array( '', 'read', 'separator1', '', 'wp-menu-separator' ); 81 82 $menu[5] = array( __('Posts'), 'edit_posts', 'edit.php', '', 'open-if-no-js menu-top menu-icon-posts', 'menu-posts', 'div' ); 83 $submenu['edit.php'][5] = array( __('Edit'), 'edit_posts', 'edit.php' ); 84 /* translators: add new post */ 85 $submenu['edit.php'][10] = array( _x('Add New', 'post'), 'edit_posts', 'post-new.php' ); 86 87 $i = 15; 88 foreach ( $wp_taxonomies as $tax ) { 89 if ( ! $tax->show_ui || ! in_array('post', (array) $tax->object_type, true) ) 90 continue; 91 92 $submenu['edit.php'][$i++] = array( esc_attr($tax->label), $tax->manage_cap, 'edit-tags.php?taxonomy=' . $tax->name ); 93 } 94 unset($tax); 95 96 $menu[10] = array( __('Media'), 'upload_files', 'upload.php', '', 'menu-top menu-icon-media', 'menu-media', 'div' ); 97 $submenu['upload.php'][5] = array( __('Library'), 'upload_files', 'upload.php'); 98 /* translators: add new file */ 99 $submenu['upload.php'][10] = array( _x('Add New', 'file'), 'upload_files', 'media-new.php'); 100 101 $menu[15] = array( __('Links'), 'manage_links', 'link-manager.php', '', 'menu-top menu-icon-links', 'menu-links', 'div' ); 102 $submenu['link-manager.php'][5] = array( __('Edit'), 'manage_links', 'link-manager.php' ); 103 /* translators: add new links */ 104 $submenu['link-manager.php'][10] = array( _x('Add New', 'link'), 'manage_links', 'link-add.php' ); 105 $submenu['link-manager.php'][15] = array( __('Link Categories'), 'manage_categories', 'edit-link-categories.php' ); 106 107 $menu[20] = array( __('Pages'), 'edit_pages', 'edit.php?post_type=page', '', 'menu-top menu-icon-pages', 'menu-pages', 'div' ); 108 $submenu['edit.php?post_type=page'][5] = array( __('Edit'), 'edit_pages', 'edit.php?post_type=page' ); 109 /* translators: add new page */ 110 $submenu['edit.php?post_type=page'][10] = array( _x('Add New', 'page'), 'edit_pages', 'post-new.php?post_type=page' ); 111 112 $menu[25] = array( sprintf( __('Comments %s'), "<span id='awaiting-mod' class='count-$awaiting_mod'><span class='pending-count'>" . number_format_i18n($awaiting_mod) . "</span></span>" ), 'edit_posts', 'edit-comments.php', '', 'menu-top menu-icon-comments', 'menu-comments', 'div' ); 113 114 $_wp_last_object_menu = 25; // The index of the last top-level menu in the object menu group 115 116 foreach ( (array) get_post_types( array('show_ui' => true) ) as $ptype ) { 117 $_wp_last_object_menu++; 118 $ptype_obj = get_post_type_object($ptype); 119 120 $menu[$_wp_last_object_menu] = array(esc_attr($ptype_obj->label), $ptype_obj->edit_type_cap, "edit.php?post_type=$ptype", '', 'menu-top menu-icon-posts', 'menu-' . sanitize_html_class($ptype), 'div'); 121 $submenu["edit.php?post_type=$ptype"][5] = array( __('Edit'), $ptype_obj->edit_type_cap, "edit.php?post_type=$ptype"); 122 /* translators: add new custom post type */ 123 $submenu["edit.php?post_type=$ptype"][10] = array( _x('Add New', 'post'), $ptype_obj->edit_type_cap, "post-new.php?post_type=$ptype" ); 124 125 $i = 15; 126 foreach ( $wp_taxonomies as $tax ) { 127 if ( ! $tax->show_ui || ! in_array($ptype, (array) $tax->object_type, true) ) 128 continue; 129 130 $submenu["edit.php?post_type=$ptype"][$i++] = array( esc_attr($tax->label), $tax->manage_cap, "edit-tags.php?taxonomy=$tax->name&post_type=$ptype" ); 131 } 132 } 133 unset($ptype, $ptype_obj); 134 135 $menu[59] = array( '', 'read', 'separator2', '', 'wp-menu-separator' ); 136 137 $menu[60] = array( __('Appearance'), 'switch_themes', 'themes.php', '', 'menu-top menu-icon-appearance', 'menu-appearance', 'div' ); 138 $submenu['themes.php'][5] = array(__('Themes'), 'switch_themes', 'themes.php'); 139 $submenu['themes.php'][10] = array(__('Menus'), 'switch_themes', 'nav-menus.php'); 140 141 // Add 'Editor' to the bottom of the Appearence menu. 142 add_action('admin_menu', '_add_themes_utility_last', 101); 143 function _add_themes_utility_last() { 144 // Must use API on the admin_menu hook, direct modification is only possible on/before the _admin_menu hook 145 add_submenu_page('themes.php', _x('Editor', 'theme editor'), _x('Editor', 'theme editor'), 'edit_themes', 'theme-editor.php'); 146 } 147 148 $update_plugins = get_site_transient( 'update_plugins' ); 149 $update_count = 0; 150 if ( !empty($update_plugins->response) ) 151 $update_count = count( $update_plugins->response ); 152 153 $menu_perms = get_site_option('menu_items', array()); 154 if ( is_super_admin() || ( is_multisite() && isset($menu_perms['plugins']) && $menu_perms['plugins'] ) ) { 155 $menu[65] = array( sprintf( __('Plugins %s'), "<span class='update-plugins count-$update_count'><span class='plugin-count'>" . number_format_i18n($update_count) . "</span></span>" ), 'activate_plugins', 'plugins.php', '', 'menu-top menu-icon-plugins', 'menu-plugins', 'div' ); 156 $submenu['plugins.php'][5] = array( __('Installed'), 'activate_plugins', 'plugins.php' ); 157 /* translators: add new plugin */ 158 $submenu['plugins.php'][10] = array(_x('Add New', 'plugin'), 'install_plugins', 'plugin-install.php'); 159 $submenu['plugins.php'][15] = array( _x('Editor', 'plugin editor'), 'edit_plugins', 'plugin-editor.php' ); 160 } 161 unset($menu_perms, $update_plugins, $update_count); 162 163 if ( current_user_can('edit_users') ) 164 $menu[70] = array( __('Users'), 'edit_users', 'users.php', '', 'menu-top menu-icon-users', 'menu-users', 'div' ); 165 else 166 $menu[70] = array( __('Profile'), 'read', 'profile.php', '', 'menu-top menu-icon-users', 'menu-users', 'div' ); 167 168 if ( current_user_can('edit_users') ) { 169 $_wp_real_parent_file['profile.php'] = 'users.php'; // Back-compat for plugins adding submenus to profile.php. 170 $submenu['users.php'][5] = array(__('Authors & Users'), 'edit_users', 'users.php'); 171 $submenu['users.php'][10] = array(_x('Add New', 'user'), 'create_users', 'user-new.php'); 172 173 $submenu['users.php'][15] = array(__('Your Profile'), 'read', 'profile.php'); 174 } else { 175 $_wp_real_parent_file['users.php'] = 'profile.php'; 176 $submenu['profile.php'][5] = array(__('Your Profile'), 'read', 'profile.php'); 177 } 178 179 $menu[75] = array( __('Tools'), 'read', 'tools.php', '', 'menu-top menu-icon-tools', 'menu-tools', 'div' ); 180 $submenu['tools.php'][5] = array( __('Tools'), 'read', 'tools.php' ); 181 $submenu['tools.php'][10] = array( __('Import'), 'import', 'import.php' ); 182 $submenu['tools.php'][15] = array( __('Export'), 'import', 'export.php' ); 183 if ( is_multisite() && !is_main_site() ) 184 $submenu['tools.php'][25] = array( __('Delete Site'), 'manage_options', 'ms-delete-site.php' ); 185 if ( ( ! is_multisite() || defined( 'MULTISITE' ) ) && defined('WP_ALLOW_MULTISITE') && WP_ALLOW_MULTISITE && is_super_admin() ) 186 $submenu['tools.php'][50] = array(__('Network'), 'manage_options', 'network.php'); 187 188 $menu[80] = array( __('Settings'), 'manage_options', 'options-general.php', '', 'menu-top menu-icon-settings', 'menu-settings', 'div' ); 189 $submenu['options-general.php'][10] = array(_x('General', 'settings screen'), 'manage_options', 'options-general.php'); 190 $submenu['options-general.php'][15] = array(__('Writing'), 'manage_options', 'options-writing.php'); 191 $submenu['options-general.php'][20] = array(__('Reading'), 'manage_options', 'options-reading.php'); 192 $submenu['options-general.php'][25] = array(__('Discussion'), 'manage_options', 'options-discussion.php'); 193 $submenu['options-general.php'][30] = array(__('Media'), 'manage_options', 'options-media.php'); 194 $submenu['options-general.php'][35] = array(__('Privacy'), 'manage_options', 'options-privacy.php'); 195 $submenu['options-general.php'][40] = array(__('Permalinks'), 'manage_options', 'options-permalink.php'); 196 197 $_wp_last_utility_menu = 80; // The index of the last top-level menu in the utility menu group 198 199 $menu[99] = array( '', 'read', 'separator-last', '', 'wp-menu-separator-last' ); 200 201 // Back-compat for old top-levels 202 $_wp_real_parent_file['post.php'] = 'edit.php'; 203 $_wp_real_parent_file['post-new.php'] = 'edit.php'; 204 $_wp_real_parent_file['edit-pages.php'] = 'edit.php?post_type=page'; 205 $_wp_real_parent_file['page-new.php'] = 'edit.php?post_type=page'; 206 $_wp_real_parent_file['wpmu-admin.php'] = 'ms-admin.php'; 207 208 do_action('_admin_menu'); 209 210 // Create list of page plugin hook names. 211 foreach ($menu as $menu_page) { 212 if ( false !== $pos = strpos($menu_page[2], '?') ) { 213 // Handle post_type=post|page|foo pages. 214 $hook_name = substr($menu_page[2], 0, $pos); 215 $hook_args = substr($menu_page[2], $pos + 1); 216 wp_parse_str($hook_args, $hook_args); 217 // Set the hook name to be the post type. 218 if ( isset($hook_args['post_type']) ) 219 $hook_name = $hook_args['post_type']; 220 else 221 $hook_name = basename($hook_name, '.php'); 222 unset($hook_args); 223 } else { 224 $hook_name = basename($menu_page[2], '.php'); 225 } 226 $hook_name = sanitize_title($hook_name); 227 228 // ensure we're backwards compatible 229 $compat = array( 230 'index' => 'dashboard', 231 'edit' => 'posts', 232 'post' => 'posts', 233 'upload' => 'media', 234 'link-manager' => 'links', 235 'edit-pages' => 'pages', 236 'page' => 'pages', 237 'edit-comments' => 'comments', 238 'options-general' => 'settings', 239 'themes' => 'appearance', 240 ); 241 242 if ( isset($compat[$hook_name]) ) 243 $hook_name = $compat[$hook_name]; 244 elseif ( !$hook_name ) 245 continue; 246 247 $admin_page_hooks[$menu_page[2]] = $hook_name; 248 } 249 unset($menu_page); 250 251 $_wp_submenu_nopriv = array(); 252 $_wp_menu_nopriv = array(); 253 // Loop over submenus and remove pages for which the user does not have privs. 254 foreach ( array( 'submenu' ) as $sub_loop ) { 255 foreach ($$sub_loop as $parent => $sub) { 256 foreach ($sub as $index => $data) { 257 if ( ! current_user_can($data[1]) ) { 258 unset(${$sub_loop}[$parent][$index]); 259 $_wp_submenu_nopriv[$parent][$data[2]] = true; 260 } 261 } 262 unset($index, $data); 263 264 if ( empty(${$sub_loop}[$parent]) ) 265 unset(${$sub_loop}[$parent]); 266 } 267 unset($sub, $parent); 268 } 269 unset($sub_loop); 270 271 // Loop over the top-level menu. 272 // Menus for which the original parent is not acessible due to lack of privs will have the next 273 // submenu in line be assigned as the new menu parent. 274 foreach ( $menu as $id => $data ) { 275 if ( empty($submenu[$data[2]]) ) 276 continue; 277 $subs = $submenu[$data[2]]; 278 $first_sub = array_shift($subs); 279 $old_parent = $data[2]; 280 $new_parent = $first_sub[2]; 281 // If the first submenu is not the same as the assigned parent, 282 // make the first submenu the new parent. 283 if ( $new_parent != $old_parent ) { 284 $_wp_real_parent_file[$old_parent] = $new_parent; 285 $menu[$id][2] = $new_parent; 286 287 foreach ($submenu[$old_parent] as $index => $data) { 288 $submenu[$new_parent][$index] = $submenu[$old_parent][$index]; 289 unset($submenu[$old_parent][$index]); 290 } 291 unset($submenu[$old_parent], $index); 292 293 if ( isset($_wp_submenu_nopriv[$old_parent]) ) 294 $_wp_submenu_nopriv[$new_parent] = $_wp_submenu_nopriv[$old_parent]; 295 } 296 } 297 unset($id, $data, $subs, $first_sub, $old_parent, $new_parent); 298 299 do_action('admin_menu', ''); 300 301 // Remove menus that have no accessible submenus and require privs that the user does not have. 302 // Run re-parent loop again. 303 foreach ( $menu as $id => $data ) { 304 if ( ! current_user_can($data[1]) ) 305 $_wp_menu_nopriv[$data[2]] = true; 306 307 // If submenu is empty... 308 if ( empty($submenu[$data[2]]) ) { 309 // And user doesn't have privs, remove menu. 310 if ( isset( $_wp_menu_nopriv[$data[2]] ) ) { 311 unset($menu[$id]); 312 } 313 } 314 } 315 unset($id, $data); 316 317 // Remove any duplicated seperators 318 $seperator_found = false; 319 foreach ( $menu as $id => $data ) { 320 if ( 0 == strcmp('wp-menu-separator', $data[4] ) ) { 321 if (false == $seperator_found) { 322 $seperator_found = true; 323 } else { 324 unset($menu[$id]); 325 $seperator_found = false; 326 } 327 } else { 328 $seperator_found = false; 329 } 330 } 331 unset($id, $data); 332 333 function add_cssclass($add, $class) { 334 $class = empty($class) ? $add : $class .= ' ' . $add; 335 return $class; 336 } 337 338 function add_menu_classes($menu) { 339 340 $first = $lastorder = false; 341 $i = 0; 342 $mc = count($menu); 343 foreach ( $menu as $order => $top ) { 344 $i++; 345 346 if ( 0 == $order ) { // dashboard is always shown/single 347 $menu[0][4] = add_cssclass('menu-top-first', $top[4]); 348 $lastorder = 0; 349 continue; 350 } 351 352 if ( 0 === strpos($top[2], 'separator') ) { // if separator 353 $first = true; 354 $c = $menu[$lastorder][4]; 355 $menu[$lastorder][4] = add_cssclass('menu-top-last', $c); 356 continue; 357 } 358 359 if ( $first ) { 360 $c = $menu[$order][4]; 361 $menu[$order][4] = add_cssclass('menu-top-first', $c); 362 $first = false; 363 } 364 365 if ( $mc == $i ) { // last item 366 $c = $menu[$order][4]; 367 $menu[$order][4] = add_cssclass('menu-top-last', $c); 368 } 369 370 $lastorder = $order; 371 } 372 373 return apply_filters( 'add_menu_classes', $menu ); 374 } 375 376 uksort($menu, "strnatcasecmp"); // make it all pretty 377 378 if ( apply_filters('custom_menu_order', false) ) { 379 $menu_order = array(); 380 foreach ( $menu as $menu_item ) { 381 $menu_order[] = $menu_item[2]; 382 } 383 unset($menu_item); 384 $default_menu_order = $menu_order; 385 $menu_order = apply_filters('menu_order', $menu_order); 386 $menu_order = array_flip($menu_order); 387 $default_menu_order = array_flip($default_menu_order); 388 389 function sort_menu($a, $b) { 390 global $menu_order, $default_menu_order; 391 $a = $a[2]; 392 $b = $b[2]; 393 if ( isset($menu_order[$a]) && !isset($menu_order[$b]) ) { 394 return -1; 395 } elseif ( !isset($menu_order[$a]) && isset($menu_order[$b]) ) { 396 return 1; 397 } elseif ( isset($menu_order[$a]) && isset($menu_order[$b]) ) { 398 if ( $menu_order[$a] == $menu_order[$b] ) 399 return 0; 400 return ($menu_order[$a] < $menu_order[$b]) ? -1 : 1; 401 } else { 402 return ($default_menu_order[$a] <= $default_menu_order[$b]) ? -1 : 1; 403 } 404 } 405 406 usort($menu, 'sort_menu'); 407 unset($menu_order, $default_menu_order); 408 } 409 410 $menu = add_menu_classes($menu); 411 412 if (! user_can_access_admin_page()) { 413 do_action('admin_page_access_denied'); 414 wp_die( __('You do not have sufficient permissions to access this page.') ); 415 } 416 417 ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Mon Apr 5 14:26:09 2010 | Cross-referenced by PHPXref 0.7 |
