Wordpress 3.5
[autoinstalls/wordpress.git] / wp-includes / admin-bar.php
1 <?php
2 /**
3  * Admin Bar
4  *
5  * This code handles the building and rendering of the press bar.
6  */
7
8 /**
9  * Instantiate the admin bar object and set it up as a global for access elsewhere.
10  *
11  * To hide the admin bar, you're looking in the wrong place. Unhooking this function will not
12  * properly remove the admin bar. For that, use show_admin_bar(false) or the show_admin_bar filter.
13  *
14  * @since 3.1.0
15  * @access private
16  * @return bool Whether the admin bar was successfully initialized.
17  */
18 function _wp_admin_bar_init() {
19         global $wp_admin_bar;
20
21         if ( ! is_admin_bar_showing() )
22                 return false;
23
24         /* Load the admin bar class code ready for instantiation */
25         require( ABSPATH . WPINC . '/class-wp-admin-bar.php' );
26
27         /* Instantiate the admin bar */
28         $admin_bar_class = apply_filters( 'wp_admin_bar_class', 'WP_Admin_Bar' );
29         if ( class_exists( $admin_bar_class ) )
30                 $wp_admin_bar = new $admin_bar_class;
31         else
32                 return false;
33
34         $wp_admin_bar->initialize();
35         $wp_admin_bar->add_menus();
36
37         return true;
38 }
39 add_action( 'init', '_wp_admin_bar_init' ); // Don't remove. Wrong way to disable.
40
41 /**
42  * Render the admin bar to the page based on the $wp_admin_bar->menu member var.
43  * This is called very late on the footer actions so that it will render after anything else being
44  * added to the footer.
45  *
46  * It includes the action "admin_bar_menu" which should be used to hook in and
47  * add new menus to the admin bar. That way you can be sure that you are adding at most optimal point,
48  * right before the admin bar is rendered. This also gives you access to the $post global, among others.
49  *
50  * @since 3.1.0
51  */
52 function wp_admin_bar_render() {
53         global $wp_admin_bar;
54
55         if ( ! is_admin_bar_showing() || ! is_object( $wp_admin_bar ) )
56                 return false;
57
58         do_action_ref_array( 'admin_bar_menu', array( &$wp_admin_bar ) );
59
60         do_action( 'wp_before_admin_bar_render' );
61
62         $wp_admin_bar->render();
63
64         do_action( 'wp_after_admin_bar_render' );
65 }
66 add_action( 'wp_footer', 'wp_admin_bar_render', 1000 );
67 add_action( 'in_admin_header', 'wp_admin_bar_render', 0 );
68
69 /**
70  * Add the WordPress logo menu.
71  *
72  * @since 3.3.0
73  */
74 function wp_admin_bar_wp_menu( $wp_admin_bar ) {
75         $wp_admin_bar->add_menu( array(
76                 'id'    => 'wp-logo',
77                 'title' => '<span class="ab-icon"></span>',
78                 'href'  => self_admin_url( 'about.php' ),
79                 'meta'  => array(
80                         'title' => __('About WordPress'),
81                 ),
82         ) );
83
84         if ( is_user_logged_in() ) {
85                 // Add "About WordPress" link
86                 $wp_admin_bar->add_menu( array(
87                         'parent' => 'wp-logo',
88                         'id'     => 'about',
89                         'title'  => __('About WordPress'),
90                         'href'  => self_admin_url( 'about.php' ),
91                 ) );
92         }
93
94         // Add WordPress.org link
95         $wp_admin_bar->add_menu( array(
96                 'parent'    => 'wp-logo-external',
97                 'id'        => 'wporg',
98                 'title'     => __('WordPress.org'),
99                 'href'      => __('http://wordpress.org/'),
100         ) );
101
102         // Add codex link
103         $wp_admin_bar->add_menu( array(
104                 'parent'    => 'wp-logo-external',
105                 'id'        => 'documentation',
106                 'title'     => __('Documentation'),
107                 'href'      => __('http://codex.wordpress.org/'),
108         ) );
109
110         // Add forums link
111         $wp_admin_bar->add_menu( array(
112                 'parent'    => 'wp-logo-external',
113                 'id'        => 'support-forums',
114                 'title'     => __('Support Forums'),
115                 'href'      => __('http://wordpress.org/support/'),
116         ) );
117
118         // Add feedback link
119         $wp_admin_bar->add_menu( array(
120                 'parent'    => 'wp-logo-external',
121                 'id'        => 'feedback',
122                 'title'     => __('Feedback'),
123                 'href'      => __('http://wordpress.org/support/forum/requests-and-feedback'),
124         ) );
125 }
126
127 /**
128  * Add the "My Account" item.
129  *
130  * @since 3.3.0
131  */
132 function wp_admin_bar_my_account_item( $wp_admin_bar ) {
133         $user_id      = get_current_user_id();
134         $current_user = wp_get_current_user();
135         $profile_url  = get_edit_profile_url( $user_id );
136
137         if ( ! $user_id )
138                 return;
139
140         $avatar = get_avatar( $user_id, 16 );
141         $howdy  = sprintf( __('Howdy, %1$s'), $current_user->display_name );
142         $class  = empty( $avatar ) ? '' : 'with-avatar';
143
144         $wp_admin_bar->add_menu( array(
145                 'id'        => 'my-account',
146                 'parent'    => 'top-secondary',
147                 'title'     => $howdy . $avatar,
148                 'href'      => $profile_url,
149                 'meta'      => array(
150                         'class'     => $class,
151                         'title'     => __('My Account'),
152                 ),
153         ) );
154 }
155
156 /**
157  * Add the "My Account" submenu items.
158  *
159  * @since 3.1.0
160  */
161 function wp_admin_bar_my_account_menu( $wp_admin_bar ) {
162         $user_id      = get_current_user_id();
163         $current_user = wp_get_current_user();
164         $profile_url  = get_edit_profile_url( $user_id );
165
166         if ( ! $user_id )
167                 return;
168
169         $wp_admin_bar->add_group( array(
170                 'parent' => 'my-account',
171                 'id'     => 'user-actions',
172         ) );
173
174         $user_info  = get_avatar( $user_id, 64 );
175         $user_info .= "<span class='display-name'>{$current_user->display_name}</span>";
176
177         if ( $current_user->display_name !== $current_user->user_nicename )
178                 $user_info .= "<span class='username'>{$current_user->user_nicename}</span>";
179
180         $wp_admin_bar->add_menu( array(
181                 'parent' => 'user-actions',
182                 'id'     => 'user-info',
183                 'title'  => $user_info,
184                 'href'   => $profile_url,
185                 'meta'   => array(
186                         'tabindex' => -1,
187                 ),
188         ) );
189         $wp_admin_bar->add_menu( array(
190                 'parent' => 'user-actions',
191                 'id'     => 'edit-profile',
192                 'title'  => __( 'Edit My Profile' ),
193                 'href' => $profile_url,
194         ) );
195         $wp_admin_bar->add_menu( array(
196                 'parent' => 'user-actions',
197                 'id'     => 'logout',
198                 'title'  => __( 'Log Out' ),
199                 'href'   => wp_logout_url(),
200         ) );
201 }
202
203 /**
204  * Add the "Site Name" menu.
205  *
206  * @since 3.3.0
207  */
208 function wp_admin_bar_site_menu( $wp_admin_bar ) {
209         global $current_site;
210
211         // Don't show for logged out users.
212         if ( ! is_user_logged_in() )
213                 return;
214
215         // Show only when the user is a member of this site, or they're a super admin.
216         if ( ! is_user_member_of_blog() && ! is_super_admin() )
217                 return;
218
219         $blogname = get_bloginfo('name');
220
221         if ( empty( $blogname ) )
222                 $blogname = preg_replace( '#^(https?://)?(www.)?#', '', get_home_url() );
223
224         if ( is_network_admin() ) {
225                 $blogname = sprintf( __('Network Admin: %s'), esc_html( $current_site->site_name ) );
226         } elseif ( is_user_admin() ) {
227                 $blogname = sprintf( __('Global Dashboard: %s'), esc_html( $current_site->site_name ) );
228         }
229
230         $title = wp_html_excerpt( $blogname, 40 );
231         if ( $title != $blogname )
232                 $title = trim( $title ) . '&hellip;';
233
234         $wp_admin_bar->add_menu( array(
235                 'id'    => 'site-name',
236                 'title' => $title,
237                 'href'  => is_admin() ? home_url( '/' ) : admin_url(),
238         ) );
239
240         // Create submenu items.
241
242         if ( is_admin() ) {
243                 // Add an option to visit the site.
244                 $wp_admin_bar->add_menu( array(
245                         'parent' => 'site-name',
246                         'id'     => 'view-site',
247                         'title'  => __( 'Visit Site' ),
248                         'href'   => home_url( '/' ),
249                 ) );
250
251                 if ( is_blog_admin() && is_multisite() && current_user_can( 'manage_sites' ) ) {
252                         $wp_admin_bar->add_menu( array(
253                                 'parent' => 'site-name',
254                                 'id'     => 'edit-site',
255                                 'title'  => __( 'Edit Site' ),
256                                 'href'   => network_admin_url( 'site-info.php?id=' . get_current_blog_id() ),
257                         ) );
258                 }
259
260         } else {
261                 // We're on the front end, link to the Dashboard.
262                 $wp_admin_bar->add_menu( array(
263                         'parent' => 'site-name',
264                         'id'     => 'dashboard',
265                         'title'  => __( 'Dashboard' ),
266                         'href'   => admin_url(),
267                 ) );
268
269                 // Add the appearance submenu items.
270                 wp_admin_bar_appearance_menu( $wp_admin_bar );
271         }
272 }
273
274 /**
275  * Add the "My Sites/[Site Name]" menu and all submenus.
276  *
277  * @since 3.1.0
278  */
279 function wp_admin_bar_my_sites_menu( $wp_admin_bar ) {
280         global $wpdb;
281
282         // Don't show for logged out users or single site mode.
283         if ( ! is_user_logged_in() || ! is_multisite() )
284                 return;
285
286         // Show only when the user has at least one site, or they're a super admin.
287         if ( count( $wp_admin_bar->user->blogs ) < 1 && ! is_super_admin() )
288                 return;
289
290         $wp_admin_bar->add_menu( array(
291                 'id'    => 'my-sites',
292                 'title' => __( 'My Sites' ),
293                 'href'  => admin_url( 'my-sites.php' ),
294         ) );
295
296         if ( is_super_admin() ) {
297                 $wp_admin_bar->add_group( array(
298                         'parent' => 'my-sites',
299                         'id'     => 'my-sites-super-admin',
300                 ) );
301
302                 $wp_admin_bar->add_menu( array(
303                         'parent' => 'my-sites-super-admin',
304                         'id'     => 'network-admin',
305                         'title'  => __('Network Admin'),
306                         'href'   => network_admin_url(),
307                 ) );
308
309                 $wp_admin_bar->add_menu( array(
310                         'parent' => 'network-admin',
311                         'id'     => 'network-admin-d',
312                         'title'  => __( 'Dashboard' ),
313                         'href'   => network_admin_url(),
314                 ) );
315                 $wp_admin_bar->add_menu( array(
316                         'parent' => 'network-admin',
317                         'id'     => 'network-admin-s',
318                         'title'  => __( 'Sites' ),
319                         'href'   => network_admin_url( 'sites.php' ),
320                 ) );
321                 $wp_admin_bar->add_menu( array(
322                         'parent' => 'network-admin',
323                         'id'     => 'network-admin-u',
324                         'title'  => __( 'Users' ),
325                         'href'   => network_admin_url( 'users.php' ),
326                 ) );
327                 $wp_admin_bar->add_menu( array(
328                         'parent' => 'network-admin',
329                         'id'     => 'network-admin-v',
330                         'title'  => __( 'Visit Network' ),
331                         'href'   => network_home_url(),
332                 ) );
333         }
334
335         // Add site links
336         $wp_admin_bar->add_group( array(
337                 'parent' => 'my-sites',
338                 'id'     => 'my-sites-list',
339                 'meta'   => array(
340                         'class' => is_super_admin() ? 'ab-sub-secondary' : '',
341                 ),
342         ) );
343
344         foreach ( (array) $wp_admin_bar->user->blogs as $blog ) {
345                 switch_to_blog( $blog->userblog_id );
346
347                 $blavatar = '<div class="blavatar"></div>';
348
349                 $blogname = empty( $blog->blogname ) ? $blog->domain : $blog->blogname;
350                 $menu_id  = 'blog-' . $blog->userblog_id;
351
352                 $wp_admin_bar->add_menu( array(
353                         'parent'    => 'my-sites-list',
354                         'id'        => $menu_id,
355                         'title'     => $blavatar . $blogname,
356                         'href'      => admin_url(),
357                 ) );
358
359                 $wp_admin_bar->add_menu( array(
360                         'parent' => $menu_id,
361                         'id'     => $menu_id . '-d',
362                         'title'  => __( 'Dashboard' ),
363                         'href'   => admin_url(),
364                 ) );
365
366                 if ( current_user_can( get_post_type_object( 'post' )->cap->create_posts ) ) {
367                         $wp_admin_bar->add_menu( array(
368                                 'parent' => $menu_id,
369                                 'id'     => $menu_id . '-n',
370                                 'title'  => __( 'New Post' ),
371                                 'href'   => admin_url( 'post-new.php' ),
372                         ) );
373                 }
374
375                 if ( current_user_can( 'edit_posts' ) ) {
376                         $wp_admin_bar->add_menu( array(
377                                 'parent' => $menu_id,
378                                 'id'     => $menu_id . '-c',
379                                 'title'  => __( 'Manage Comments' ),
380                                 'href'   => admin_url( 'edit-comments.php' ),
381                         ) );
382                 }
383
384                 $wp_admin_bar->add_menu( array(
385                         'parent' => $menu_id,
386                         'id'     => $menu_id . '-v',
387                         'title'  => __( 'Visit Site' ),
388                         'href'   => home_url( '/' ),
389                 ) );
390
391                 restore_current_blog();
392         }
393 }
394
395 /**
396  * Provide a shortlink.
397  *
398  * @since 3.1.0
399  */
400 function wp_admin_bar_shortlink_menu( $wp_admin_bar ) {
401         $short = wp_get_shortlink( 0, 'query' );
402         $id = 'get-shortlink';
403
404         if ( empty( $short ) )
405                 return;
406
407         $html = '<input class="shortlink-input" type="text" readonly="readonly" value="' . esc_attr( $short ) . '" />';
408
409         $wp_admin_bar->add_menu( array(
410                 'id' => $id,
411                 'title' => __( 'Shortlink' ),
412                 'href' => $short,
413                 'meta' => array( 'html' => $html ),
414         ) );
415 }
416
417 /**
418  * Provide an edit link for posts and terms.
419  *
420  * @since 3.1.0
421  */
422 function wp_admin_bar_edit_menu( $wp_admin_bar ) {
423         global $tag, $wp_the_query;
424
425         if ( is_admin() ) {
426                 $current_screen = get_current_screen();
427                 $post = get_post();
428
429                 if ( 'post' == $current_screen->base
430                         && 'add' != $current_screen->action
431                         && ( $post_type_object = get_post_type_object( $post->post_type ) )
432                         && current_user_can( $post_type_object->cap->read_post, $post->ID )
433                         && ( $post_type_object->public )
434                         && ( $post_type_object->show_in_admin_bar ) )
435                 {
436                         $wp_admin_bar->add_menu( array(
437                                 'id' => 'view',
438                                 'title' => $post_type_object->labels->view_item,
439                                 'href' => get_permalink( $post->ID )
440                         ) );
441                 } elseif ( 'edit-tags' == $current_screen->base
442                         && isset( $tag ) && is_object( $tag )
443                         && ( $tax = get_taxonomy( $tag->taxonomy ) )
444                         && $tax->public )
445                 {
446                         $wp_admin_bar->add_menu( array(
447                                 'id' => 'view',
448                                 'title' => $tax->labels->view_item,
449                                 'href' => get_term_link( $tag )
450                         ) );
451                 }
452         } else {
453                 $current_object = $wp_the_query->get_queried_object();
454
455                 if ( empty( $current_object ) )
456                         return;
457
458                 if ( ! empty( $current_object->post_type )
459                         && ( $post_type_object = get_post_type_object( $current_object->post_type ) )
460                         && current_user_can( $post_type_object->cap->edit_post, $current_object->ID )
461                         && $post_type_object->show_ui && $post_type_object->show_in_admin_bar )
462                 {
463                         $wp_admin_bar->add_menu( array(
464                                 'id' => 'edit',
465                                 'title' => $post_type_object->labels->edit_item,
466                                 'href' => get_edit_post_link( $current_object->ID )
467                         ) );
468                 } elseif ( ! empty( $current_object->taxonomy )
469                         && ( $tax = get_taxonomy( $current_object->taxonomy ) )
470                         && current_user_can( $tax->cap->edit_terms )
471                         && $tax->show_ui )
472                 {
473                         $wp_admin_bar->add_menu( array(
474                                 'id' => 'edit',
475                                 'title' => $tax->labels->edit_item,
476                                 'href' => get_edit_term_link( $current_object->term_id, $current_object->taxonomy )
477                         ) );
478                 }
479         }
480 }
481
482 /**
483  * Add "Add New" menu.
484  *
485  * @since 3.1.0
486  */
487 function wp_admin_bar_new_content_menu( $wp_admin_bar ) {
488         $actions = array();
489
490         $cpts = (array) get_post_types( array( 'show_in_admin_bar' => true ), 'objects' );
491
492         if ( isset( $cpts['post'] ) && current_user_can( $cpts['post']->cap->create_posts ) )
493                 $actions[ 'post-new.php' ] = array( $cpts['post']->labels->name_admin_bar, 'new-post' );
494
495         if ( isset( $cpts['attachment'] ) && current_user_can( 'upload_files' ) )
496                 $actions[ 'media-new.php' ] = array( $cpts['attachment']->labels->name_admin_bar, 'new-media' );
497
498         if ( current_user_can( 'manage_links' ) )
499                 $actions[ 'link-add.php' ] = array( _x( 'Link', 'add new from admin bar' ), 'new-link' );
500
501         if ( isset( $cpts['page'] ) && current_user_can( $cpts['page']->cap->create_posts ) )
502                 $actions[ 'post-new.php?post_type=page' ] = array( $cpts['page']->labels->name_admin_bar, 'new-page' );
503
504         unset( $cpts['post'], $cpts['page'], $cpts['attachment'] );
505
506         // Add any additional custom post types.
507         foreach ( $cpts as $cpt ) {
508                 if ( ! current_user_can( $cpt->cap->create_posts ) )
509                         continue;
510
511                 $key = 'post-new.php?post_type=' . $cpt->name;
512                 $actions[ $key ] = array( $cpt->labels->name_admin_bar, 'new-' . $cpt->name );
513         }
514         // Avoid clash with parent node and a 'content' post type.
515         if ( isset( $actions['post-new.php?post_type=content'] ) )
516                 $actions['post-new.php?post_type=content'][1] = 'add-new-content';
517
518         if ( current_user_can( 'create_users' ) || current_user_can( 'promote_users' ) )
519                 $actions[ 'user-new.php' ] = array( _x( 'User', 'add new from admin bar' ), 'new-user' );
520
521         if ( ! $actions )
522                 return;
523
524         $title = '<span class="ab-icon"></span><span class="ab-label">' . _x( 'New', 'admin bar menu group label' ) . '</span>';
525
526         $wp_admin_bar->add_menu( array(
527                 'id'    => 'new-content',
528                 'title' => $title,
529                 'href'  => admin_url( current( array_keys( $actions ) ) ),
530                 'meta'  => array(
531                         'title' => _x( 'Add New', 'admin bar menu group label' ),
532                 ),
533         ) );
534
535         foreach ( $actions as $link => $action ) {
536                 list( $title, $id ) = $action;
537
538                 $wp_admin_bar->add_menu( array(
539                         'parent'    => 'new-content',
540                         'id'        => $id,
541                         'title'     => $title,
542                         'href'      => admin_url( $link )
543                 ) );
544         }
545 }
546
547 /**
548  * Add edit comments link with awaiting moderation count bubble.
549  *
550  * @since 3.1.0
551  */
552 function wp_admin_bar_comments_menu( $wp_admin_bar ) {
553         if ( !current_user_can('edit_posts') )
554                 return;
555
556         $awaiting_mod = wp_count_comments();
557         $awaiting_mod = $awaiting_mod->moderated;
558         $awaiting_title = esc_attr( sprintf( _n( '%s comment awaiting moderation', '%s comments awaiting moderation', $awaiting_mod ), number_format_i18n( $awaiting_mod ) ) );
559
560         $icon  = '<span class="ab-icon"></span>';
561         $title = '<span id="ab-awaiting-mod" class="ab-label awaiting-mod pending-count count-' . $awaiting_mod . '">' . number_format_i18n( $awaiting_mod ) . '</span>';
562
563         $wp_admin_bar->add_menu( array(
564                 'id'    => 'comments',
565                 'title' => $icon . $title,
566                 'href'  => admin_url('edit-comments.php'),
567                 'meta'  => array( 'title' => $awaiting_title ),
568         ) );
569 }
570
571 /**
572  * Add appearance submenu items to the "Site Name" menu.
573  *
574  * @since 3.1.0
575  */
576 function wp_admin_bar_appearance_menu( $wp_admin_bar ) {
577         $wp_admin_bar->add_group( array( 'parent' => 'site-name', 'id' => 'appearance' ) );
578
579         if ( current_user_can( 'switch_themes' ) || current_user_can( 'edit_theme_options' ) )
580                 $wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'themes', 'title' => __('Themes'), 'href' => admin_url('themes.php') ) );
581
582         if ( ! current_user_can( 'edit_theme_options' ) )
583                 return;
584
585         $current_url = ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
586         $wp_admin_bar->add_menu( array(
587                 'parent' => 'appearance',
588                 'id'     => 'customize',
589                 'title'  => __('Customize'),
590                 'href'   => add_query_arg( 'url', urlencode( $current_url ), wp_customize_url() ),
591                 'meta'   => array(
592                         'class' => 'hide-if-no-customize',
593                 ),
594         ) );
595         add_action( 'wp_before_admin_bar_render', 'wp_customize_support_script' );
596
597         if ( current_theme_supports( 'widgets' )  )
598                 $wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'widgets', 'title' => __('Widgets'), 'href' => admin_url('widgets.php') ) );
599
600          if ( current_theme_supports( 'menus' ) || current_theme_supports( 'widgets' ) )
601                 $wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'menus', 'title' => __('Menus'), 'href' => admin_url('nav-menus.php') ) );
602
603         if ( current_theme_supports( 'custom-background' ) )
604                 $wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'background', 'title' => __('Background'), 'href' => admin_url('themes.php?page=custom-background') ) );
605
606         if ( current_theme_supports( 'custom-header' ) )
607                 $wp_admin_bar->add_menu( array( 'parent' => 'appearance', 'id' => 'header', 'title' => __('Header'), 'href' => admin_url('themes.php?page=custom-header') ) );
608 }
609
610 /**
611  * Provide an update link if theme/plugin/core updates are available.
612  *
613  * @since 3.1.0
614  */
615 function wp_admin_bar_updates_menu( $wp_admin_bar ) {
616
617         $update_data = wp_get_update_data();
618
619         if ( !$update_data['counts']['total'] )
620                 return;
621
622         $title = '<span class="ab-icon"></span><span class="ab-label">' . number_format_i18n( $update_data['counts']['total'] ) . '</span>';
623         $title .= '<span class="screen-reader-text">' . $update_data['title'] . '</span>';
624
625         $wp_admin_bar->add_menu( array(
626                 'id'    => 'updates',
627                 'title' => $title,
628                 'href'  => network_admin_url( 'update-core.php' ),
629                 'meta'  => array(
630                         'title' => $update_data['title'],
631                 ),
632         ) );
633 }
634
635 /**
636  * Add search form.
637  *
638  * @since 3.3.0
639  */
640 function wp_admin_bar_search_menu( $wp_admin_bar ) {
641         if ( is_admin() )
642                 return;
643
644         $form  = '<form action="' . esc_url( home_url( '/' ) ) . '" method="get" id="adminbarsearch">';
645         $form .= '<input class="adminbar-input" name="s" id="adminbar-search" type="text" value="" maxlength="150" />';
646         $form .= '<input type="submit" class="adminbar-button" value="' . __('Search') . '"/>';
647         $form .= '</form>';
648
649         $wp_admin_bar->add_menu( array(
650                 'parent' => 'top-secondary',
651                 'id'     => 'search',
652                 'title'  => $form,
653                 'meta'   => array(
654                         'class'    => 'admin-bar-search',
655                         'tabindex' => -1,
656                 )
657         ) );
658 }
659
660 /**
661  * Add secondary menus.
662  *
663  * @since 3.3.0
664  */
665 function wp_admin_bar_add_secondary_groups( $wp_admin_bar ) {
666         $wp_admin_bar->add_group( array(
667                 'id'     => 'top-secondary',
668                 'meta'   => array(
669                         'class' => 'ab-top-secondary',
670                 ),
671         ) );
672
673         $wp_admin_bar->add_group( array(
674                 'parent' => 'wp-logo',
675                 'id'     => 'wp-logo-external',
676                 'meta'   => array(
677                         'class' => 'ab-sub-secondary',
678                 ),
679         ) );
680 }
681
682 /**
683  * Style and scripts for the admin bar.
684  *
685  * @since 3.1.0
686  *
687  */
688 function wp_admin_bar_header() { ?>
689 <style type="text/css" media="print">#wpadminbar { display:none; }</style>
690 <?php
691 }
692
693 /**
694  * Default admin bar callback.
695  *
696  * @since 3.1.0
697  *
698  */
699 function _admin_bar_bump_cb() { ?>
700 <style type="text/css" media="screen">
701         html { margin-top: 28px !important; }
702         * html body { margin-top: 28px !important; }
703 </style>
704 <?php
705 }
706
707 /**
708  * Set the display status of the admin bar.
709  *
710  * This can be called immediately upon plugin load. It does not need to be called from a function hooked to the init action.
711  *
712  * @since 3.1.0
713  *
714  * @param bool $show Whether to allow the admin bar to show.
715  * @return void
716  */
717 function show_admin_bar( $show ) {
718         global $show_admin_bar;
719         $show_admin_bar = (bool) $show;
720 }
721
722 /**
723  * Determine whether the admin bar should be showing.
724  *
725  * @since 3.1.0
726  *
727  * @return bool Whether the admin bar should be showing.
728  */
729 function is_admin_bar_showing() {
730         global $show_admin_bar, $pagenow;
731
732         // For all these types of requests, we never want an admin bar.
733         if ( defined('XMLRPC_REQUEST') || defined('DOING_AJAX') || defined('IFRAME_REQUEST') )
734                 return false;
735
736         // Integrated into the admin.
737         if ( is_admin() )
738                 return true;
739
740         if ( ! isset( $show_admin_bar ) ) {
741                 if ( ! is_user_logged_in() || 'wp-login.php' == $pagenow ) {
742                         $show_admin_bar = false;
743                 } else {
744                         $show_admin_bar = _get_admin_bar_pref();
745                 }
746         }
747
748         $show_admin_bar = apply_filters( 'show_admin_bar', $show_admin_bar );
749
750         return $show_admin_bar;
751 }
752
753 /**
754  * Retrieve the admin bar display preference of a user.
755  *
756  * @since 3.1.0
757  * @access private
758  *
759  * @param string $context Context of this preference check. Defaults to 'front'. The 'admin'
760  *      preference is no longer used.
761  * @param int $user Optional. ID of the user to check, defaults to 0 for current user.
762  * @return bool Whether the admin bar should be showing for this user.
763  */
764 function _get_admin_bar_pref( $context = 'front', $user = 0 ) {
765         $pref = get_user_option( "show_admin_bar_{$context}", $user );
766         if ( false === $pref )
767                 return true;
768
769         return 'true' === $pref;
770 }