| [ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * WordPress Dashboard Widget Administration Screen API 4 * 5 * @package WordPress 6 * @subpackage Administration 7 */ 8 9 /** 10 * Registers dashboard widgets. 11 * 12 * Handles POST data, sets up filters. 13 * 14 * @since 2.5.0 15 * 16 * @global array $wp_registered_widgets 17 * @global array $wp_registered_widget_controls 18 * @global array $wp_dashboard_control_callbacks 19 */ 20 function wp_dashboard_setup() { 21 global $wp_registered_widgets, $wp_registered_widget_controls, $wp_dashboard_control_callbacks; 22 $wp_dashboard_control_callbacks = array(); 23 $screen = get_current_screen(); 24 25 /* Register Widgets and Controls */ 26 27 $response = wp_check_browser_version(); 28 29 if ( $response && $response['upgrade'] ) { 30 add_filter( 'postbox_classes_dashboard_dashboard_browser_nag', 'dashboard_browser_nag_class' ); 31 if ( $response['insecure'] ) { 32 wp_add_dashboard_widget( 'dashboard_browser_nag', __( 'You are using an insecure browser!' ), 'wp_dashboard_browser_nag' ); 33 } else { 34 wp_add_dashboard_widget( 'dashboard_browser_nag', __( 'Your browser is out of date!' ), 'wp_dashboard_browser_nag' ); 35 } 36 } 37 38 // PHP Version. 39 $response = wp_check_php_version(); 40 if ( $response && isset( $response['is_acceptable'] ) && ! $response['is_acceptable'] && current_user_can( 'update_php' ) ) { 41 add_filter( 'postbox_classes_dashboard_dashboard_php_nag', 'dashboard_php_nag_class' ); 42 wp_add_dashboard_widget( 'dashboard_php_nag', __( 'PHP Update Required' ), 'wp_dashboard_php_nag' ); 43 } 44 45 // Site Health. 46 if ( current_user_can( 'view_site_health_checks' ) && ! is_network_admin() ) { 47 if ( ! class_exists( 'WP_Site_Health' ) ) { 48 require_once ABSPATH . 'wp-admin/includes/class-wp-site-health.php'; 49 } 50 51 WP_Site_Health::get_instance(); 52 53 wp_enqueue_style( 'site-health' ); 54 wp_enqueue_script( 'site-health' ); 55 56 wp_add_dashboard_widget( 'dashboard_site_health', __( 'Site Health Status' ), 'wp_dashboard_site_health' ); 57 } 58 59 // Right Now. 60 if ( is_blog_admin() && current_user_can( 'edit_posts' ) ) { 61 wp_add_dashboard_widget( 'dashboard_right_now', __( 'At a Glance' ), 'wp_dashboard_right_now' ); 62 } 63 64 if ( is_network_admin() ) { 65 wp_add_dashboard_widget( 'network_dashboard_right_now', __( 'Right Now' ), 'wp_network_dashboard_right_now' ); 66 } 67 68 // Activity Widget. 69 if ( is_blog_admin() ) { 70 wp_add_dashboard_widget( 'dashboard_activity', __( 'Activity' ), 'wp_dashboard_site_activity' ); 71 } 72 73 // QuickPress Widget. 74 if ( is_blog_admin() && current_user_can( get_post_type_object( 'post' )->cap->create_posts ) ) { 75 $quick_draft_title = sprintf( '<span class="hide-if-no-js">%1$s</span> <span class="hide-if-js">%2$s</span>', __( 'Quick Draft' ), __( 'Your Recent Drafts' ) ); 76 wp_add_dashboard_widget( 'dashboard_quick_press', $quick_draft_title, 'wp_dashboard_quick_press' ); 77 } 78 79 // WordPress Events and News. 80 wp_add_dashboard_widget( 'dashboard_primary', __( 'WordPress Events and News' ), 'wp_dashboard_events_news' ); 81 82 if ( is_network_admin() ) { 83 84 /** 85 * Fires after core widgets for the Network Admin dashboard have been registered. 86 * 87 * @since 3.1.0 88 */ 89 do_action( 'wp_network_dashboard_setup' ); 90 91 /** 92 * Filters the list of widgets to load for the Network Admin dashboard. 93 * 94 * @since 3.1.0 95 * 96 * @param string[] $dashboard_widgets An array of dashboard widget IDs. 97 */ 98 $dashboard_widgets = apply_filters( 'wp_network_dashboard_widgets', array() ); 99 } elseif ( is_user_admin() ) { 100 101 /** 102 * Fires after core widgets for the User Admin dashboard have been registered. 103 * 104 * @since 3.1.0 105 */ 106 do_action( 'wp_user_dashboard_setup' ); 107 108 /** 109 * Filters the list of widgets to load for the User Admin dashboard. 110 * 111 * @since 3.1.0 112 * 113 * @param string[] $dashboard_widgets An array of dashboard widget IDs. 114 */ 115 $dashboard_widgets = apply_filters( 'wp_user_dashboard_widgets', array() ); 116 } else { 117 118 /** 119 * Fires after core widgets for the admin dashboard have been registered. 120 * 121 * @since 2.5.0 122 */ 123 do_action( 'wp_dashboard_setup' ); 124 125 /** 126 * Filters the list of widgets to load for the admin dashboard. 127 * 128 * @since 2.5.0 129 * 130 * @param string[] $dashboard_widgets An array of dashboard widget IDs. 131 */ 132 $dashboard_widgets = apply_filters( 'wp_dashboard_widgets', array() ); 133 } 134 135 foreach ( $dashboard_widgets as $widget_id ) { 136 $name = empty( $wp_registered_widgets[ $widget_id ]['all_link'] ) ? $wp_registered_widgets[ $widget_id ]['name'] : $wp_registered_widgets[ $widget_id ]['name'] . " <a href='{$wp_registered_widgets[$widget_id]['all_link']}' class='edit-box open-box'>" . __( 'View all' ) . '</a>'; 137 wp_add_dashboard_widget( $widget_id, $name, $wp_registered_widgets[ $widget_id ]['callback'], $wp_registered_widget_controls[ $widget_id ]['callback'] ); 138 } 139 140 if ( 'POST' == $_SERVER['REQUEST_METHOD'] && isset( $_POST['widget_id'] ) ) { 141 check_admin_referer( 'edit-dashboard-widget_' . $_POST['widget_id'], 'dashboard-widget-nonce' ); 142 ob_start(); // Hack - but the same hack wp-admin/widgets.php uses. 143 wp_dashboard_trigger_widget_control( $_POST['widget_id'] ); 144 ob_end_clean(); 145 wp_redirect( remove_query_arg( 'edit' ) ); 146 exit; 147 } 148 149 /** This action is documented in wp-admin/includes/meta-boxes.php */ 150 do_action( 'do_meta_boxes', $screen->id, 'normal', '' ); 151 152 /** This action is documented in wp-admin/includes/meta-boxes.php */ 153 do_action( 'do_meta_boxes', $screen->id, 'side', '' ); 154 } 155 156 /** 157 * Adds a new dashboard widget. 158 * 159 * @since 2.7.0 160 * 161 * @global array $wp_dashboard_control_callbacks 162 * 163 * @param string $widget_id Widget ID (used in the 'id' attribute for the widget). 164 * @param string $widget_name Title of the widget. 165 * @param callable $callback Function that fills the widget with the desired content. 166 * The function should echo its output. 167 * @param callable $control_callback Optional. Function that outputs controls for the widget. Default null. 168 * @param array $callback_args Optional. Data that should be set as the $args property of the widget array 169 * (which is the second parameter passed to your callback). Default null. 170 */ 171 function wp_add_dashboard_widget( $widget_id, $widget_name, $callback, $control_callback = null, $callback_args = null ) { 172 $screen = get_current_screen(); 173 global $wp_dashboard_control_callbacks; 174 175 $private_callback_args = array( '__widget_basename' => $widget_name ); 176 177 if ( is_null( $callback_args ) ) { 178 $callback_args = $private_callback_args; 179 } elseif ( is_array( $callback_args ) ) { 180 $callback_args = array_merge( $callback_args, $private_callback_args ); 181 } 182 183 if ( $control_callback && current_user_can( 'edit_dashboard' ) && is_callable( $control_callback ) ) { 184 $wp_dashboard_control_callbacks[ $widget_id ] = $control_callback; 185 if ( isset( $_GET['edit'] ) && $widget_id == $_GET['edit'] ) { 186 list($url) = explode( '#', add_query_arg( 'edit', false ), 2 ); 187 $widget_name .= ' <span class="postbox-title-action"><a href="' . esc_url( $url ) . '">' . __( 'Cancel' ) . '</a></span>'; 188 $callback = '_wp_dashboard_control_callback'; 189 } else { 190 list($url) = explode( '#', add_query_arg( 'edit', $widget_id ), 2 ); 191 $widget_name .= ' <span class="postbox-title-action"><a href="' . esc_url( "$url#$widget_id" ) . '" class="edit-box open-box">' . __( 'Configure' ) . '</a></span>'; 192 } 193 } 194 195 $side_widgets = array( 'dashboard_quick_press', 'dashboard_primary' ); 196 197 $location = 'normal'; 198 if ( in_array( $widget_id, $side_widgets, true ) ) { 199 $location = 'side'; 200 } 201 202 $high_priority_widgets = array( 'dashboard_browser_nag', 'dashboard_php_nag' ); 203 204 $priority = 'core'; 205 if ( in_array( $widget_id, $high_priority_widgets, true ) ) { 206 $priority = 'high'; 207 } 208 209 add_meta_box( $widget_id, $widget_name, $callback, $screen, $location, $priority, $callback_args ); 210 } 211 212 /** 213 * Outputs controls for the current dashboard widget. 214 * 215 * @access private 216 * @since 2.7.0 217 * 218 * @param mixed $dashboard 219 * @param array $meta_box 220 */ 221 function _wp_dashboard_control_callback( $dashboard, $meta_box ) { 222 echo '<form method="post" class="dashboard-widget-control-form wp-clearfix">'; 223 wp_dashboard_trigger_widget_control( $meta_box['id'] ); 224 wp_nonce_field( 'edit-dashboard-widget_' . $meta_box['id'], 'dashboard-widget-nonce' ); 225 echo '<input type="hidden" name="widget_id" value="' . esc_attr( $meta_box['id'] ) . '" />'; 226 submit_button( __( 'Submit' ) ); 227 echo '</form>'; 228 } 229 230 /** 231 * Displays the dashboard. 232 * 233 * @since 2.5.0 234 */ 235 function wp_dashboard() { 236 $screen = get_current_screen(); 237 $columns = absint( $screen->get_columns() ); 238 $columns_css = ''; 239 if ( $columns ) { 240 $columns_css = " columns-$columns"; 241 } 242 243 ?> 244 <div id="dashboard-widgets" class="metabox-holder<?php echo $columns_css; ?>"> 245 <div id="postbox-container-1" class="postbox-container"> 246 <?php do_meta_boxes( $screen->id, 'normal', '' ); ?> 247 </div> 248 <div id="postbox-container-2" class="postbox-container"> 249 <?php do_meta_boxes( $screen->id, 'side', '' ); ?> 250 </div> 251 <div id="postbox-container-3" class="postbox-container"> 252 <?php do_meta_boxes( $screen->id, 'column3', '' ); ?> 253 </div> 254 <div id="postbox-container-4" class="postbox-container"> 255 <?php do_meta_boxes( $screen->id, 'column4', '' ); ?> 256 </div> 257 </div> 258 259 <?php 260 wp_nonce_field( 'closedpostboxes', 'closedpostboxesnonce', false ); 261 wp_nonce_field( 'meta-box-order', 'meta-box-order-nonce', false ); 262 263 } 264 265 // 266 // Dashboard Widgets. 267 // 268 269 /** 270 * Dashboard widget that displays some basic stats about the site. 271 * 272 * Formerly 'Right Now'. A streamlined 'At a Glance' as of 3.8. 273 * 274 * @since 2.7.0 275 */ 276 function wp_dashboard_right_now() { 277 ?> 278 <div class="main"> 279 <ul> 280 <?php 281 // Posts and Pages. 282 foreach ( array( 'post', 'page' ) as $post_type ) { 283 $num_posts = wp_count_posts( $post_type ); 284 if ( $num_posts && $num_posts->publish ) { 285 if ( 'post' == $post_type ) { 286 /* translators: %s: Number of posts. */ 287 $text = _n( '%s Post', '%s Posts', $num_posts->publish ); 288 } else { 289 /* translators: %s: Number of pages. */ 290 $text = _n( '%s Page', '%s Pages', $num_posts->publish ); 291 } 292 $text = sprintf( $text, number_format_i18n( $num_posts->publish ) ); 293 $post_type_object = get_post_type_object( $post_type ); 294 if ( $post_type_object && current_user_can( $post_type_object->cap->edit_posts ) ) { 295 printf( '<li class="%1$s-count"><a href="edit.php?post_type=%1$s">%2$s</a></li>', $post_type, $text ); 296 } else { 297 printf( '<li class="%1$s-count"><span>%2$s</span></li>', $post_type, $text ); 298 } 299 } 300 } 301 // Comments. 302 $num_comm = wp_count_comments(); 303 if ( $num_comm && ( $num_comm->approved || $num_comm->moderated ) ) { 304 /* translators: %s: Number of comments. */ 305 $text = sprintf( _n( '%s Comment', '%s Comments', $num_comm->approved ), number_format_i18n( $num_comm->approved ) ); 306 ?> 307 <li class="comment-count"><a href="edit-comments.php"><?php echo $text; ?></a></li> 308 <?php 309 $moderated_comments_count_i18n = number_format_i18n( $num_comm->moderated ); 310 /* translators: %s: Number of comments. */ 311 $text = sprintf( _n( '%s Comment in moderation', '%s Comments in moderation', $num_comm->moderated ), $moderated_comments_count_i18n ); 312 ?> 313 <li class="comment-mod-count 314 <?php 315 if ( ! $num_comm->moderated ) { 316 echo ' hidden'; 317 } 318 ?> 319 "><a href="edit-comments.php?comment_status=moderated" class="comments-in-moderation-text"><?php echo $text; ?></a></li> 320 <?php 321 } 322 323 /** 324 * Filters the array of extra elements to list in the 'At a Glance' 325 * dashboard widget. 326 * 327 * Prior to 3.8.0, the widget was named 'Right Now'. Each element 328 * is wrapped in list-item tags on output. 329 * 330 * @since 3.8.0 331 * 332 * @param string[] $items Array of extra 'At a Glance' widget items. 333 */ 334 $elements = apply_filters( 'dashboard_glance_items', array() ); 335 336 if ( $elements ) { 337 echo '<li>' . implode( "</li>\n<li>", $elements ) . "</li>\n"; 338 } 339 340 ?> 341 </ul> 342 <?php 343 update_right_now_message(); 344 345 // Check if search engines are asked not to index this site. 346 if ( ! is_network_admin() && ! is_user_admin() && current_user_can( 'manage_options' ) && '0' == get_option( 'blog_public' ) ) { 347 348 /** 349 * Filters the link title attribute for the 'Search Engines Discouraged' 350 * message displayed in the 'At a Glance' dashboard widget. 351 * 352 * Prior to 3.8.0, the widget was named 'Right Now'. 353 * 354 * @since 3.0.0 355 * @since 4.5.0 The default for `$title` was updated to an empty string. 356 * 357 * @param string $title Default attribute text. 358 */ 359 $title = apply_filters( 'privacy_on_link_title', '' ); 360 361 /** 362 * Filters the link label for the 'Search Engines Discouraged' message 363 * displayed in the 'At a Glance' dashboard widget. 364 * 365 * Prior to 3.8.0, the widget was named 'Right Now'. 366 * 367 * @since 3.0.0 368 * 369 * @param string $content Default text. 370 */ 371 $content = apply_filters( 'privacy_on_link_text', __( 'Search Engines Discouraged' ) ); 372 $title_attr = '' === $title ? '' : " title='$title'"; 373 374 echo "<p><a href='options-reading.php'$title_attr>$content</a></p>"; 375 } 376 ?> 377 </div> 378 <?php 379 /* 380 * activity_box_end has a core action, but only prints content when multisite. 381 * Using an output buffer is the only way to really check if anything's displayed here. 382 */ 383 ob_start(); 384 385 /** 386 * Fires at the end of the 'At a Glance' dashboard widget. 387 * 388 * Prior to 3.8.0, the widget was named 'Right Now'. 389 * 390 * @since 2.5.0 391 */ 392 do_action( 'rightnow_end' ); 393 394 /** 395 * Fires at the end of the 'At a Glance' dashboard widget. 396 * 397 * Prior to 3.8.0, the widget was named 'Right Now'. 398 * 399 * @since 2.0.0 400 */ 401 do_action( 'activity_box_end' ); 402 403 $actions = ob_get_clean(); 404 405 if ( ! empty( $actions ) ) : 406 ?> 407 <div class="sub"> 408 <?php echo $actions; ?> 409 </div> 410 <?php 411 endif; 412 } 413 414 /** 415 * @since 3.1.0 416 */ 417 function wp_network_dashboard_right_now() { 418 $actions = array(); 419 if ( current_user_can( 'create_sites' ) ) { 420 $actions['create-site'] = '<a href="' . network_admin_url( 'site-new.php' ) . '">' . __( 'Create a New Site' ) . '</a>'; 421 } 422 if ( current_user_can( 'create_users' ) ) { 423 $actions['create-user'] = '<a href="' . network_admin_url( 'user-new.php' ) . '">' . __( 'Create a New User' ) . '</a>'; 424 } 425 426 $c_users = get_user_count(); 427 $c_blogs = get_blog_count(); 428 429 /* translators: %s: Number of users on the network. */ 430 $user_text = sprintf( _n( '%s user', '%s users', $c_users ), number_format_i18n( $c_users ) ); 431 /* translators: %s: Number of sites on the network. */ 432 $blog_text = sprintf( _n( '%s site', '%s sites', $c_blogs ), number_format_i18n( $c_blogs ) ); 433 434 /* translators: 1: Text indicating the number of sites on the network, 2: Text indicating the number of users on the network. */ 435 $sentence = sprintf( __( 'You have %1$s and %2$s.' ), $blog_text, $user_text ); 436 437 if ( $actions ) { 438 echo '<ul class="subsubsub">'; 439 foreach ( $actions as $class => $action ) { 440 $actions[ $class ] = "\t<li class='$class'>$action"; 441 } 442 echo implode( " |</li>\n", $actions ) . "</li>\n"; 443 echo '</ul>'; 444 } 445 ?> 446 <br class="clear" /> 447 448 <p class="youhave"><?php echo $sentence; ?></p> 449 450 451 <?php 452 /** 453 * Fires in the Network Admin 'Right Now' dashboard widget 454 * just before the user and site search form fields. 455 * 456 * @since MU (3.0.0) 457 */ 458 do_action( 'wpmuadminresult' ); 459 ?> 460 461 <form action="<?php echo network_admin_url( 'users.php' ); ?>" method="get"> 462 <p> 463 <label class="screen-reader-text" for="search-users"><?php _e( 'Search Users' ); ?></label> 464 <input type="search" name="s" value="" size="30" autocomplete="off" id="search-users"/> 465 <?php submit_button( __( 'Search Users' ), '', false, false, array( 'id' => 'submit_users' ) ); ?> 466 </p> 467 </form> 468 469 <form action="<?php echo network_admin_url( 'sites.php' ); ?>" method="get"> 470 <p> 471 <label class="screen-reader-text" for="search-sites"><?php _e( 'Search Sites' ); ?></label> 472 <input type="search" name="s" value="" size="30" autocomplete="off" id="search-sites"/> 473 <?php submit_button( __( 'Search Sites' ), '', false, false, array( 'id' => 'submit_sites' ) ); ?> 474 </p> 475 </form> 476 <?php 477 /** 478 * Fires at the end of the 'Right Now' widget in the Network Admin dashboard. 479 * 480 * @since MU (3.0.0) 481 */ 482 do_action( 'mu_rightnow_end' ); 483 484 /** 485 * Fires at the end of the 'Right Now' widget in the Network Admin dashboard. 486 * 487 * @since MU (3.0.0) 488 */ 489 do_action( 'mu_activity_box_end' ); 490 } 491 492 /** 493 * The Quick Draft widget display and creation of drafts. 494 * 495 * @since 3.8.0 496 * 497 * @global int $post_ID 498 * 499 * @param string $error_msg Optional. Error message. Default false. 500 */ 501 function wp_dashboard_quick_press( $error_msg = false ) { 502 global $post_ID; 503 504 if ( ! current_user_can( 'edit_posts' ) ) { 505 return; 506 } 507 508 /* Check if a new auto-draft (= no new post_ID) is needed or if the old can be used */ 509 $last_post_id = (int) get_user_option( 'dashboard_quick_press_last_post_id' ); // Get the last post_ID. 510 if ( $last_post_id ) { 511 $post = get_post( $last_post_id ); 512 if ( empty( $post ) || 'auto-draft' !== $post->post_status ) { // auto-draft doesn't exist anymore. 513 $post = get_default_post_to_edit( 'post', true ); 514 update_user_option( get_current_user_id(), 'dashboard_quick_press_last_post_id', (int) $post->ID ); // Save post_ID. 515 } else { 516 $post->post_title = ''; // Remove the auto draft title. 517 } 518 } else { 519 $post = get_default_post_to_edit( 'post', true ); 520 $user_id = get_current_user_id(); 521 // Don't create an option if this is a super admin who does not belong to this site. 522 if ( in_array( get_current_blog_id(), array_keys( get_blogs_of_user( $user_id ) ) ) ) { 523 update_user_option( $user_id, 'dashboard_quick_press_last_post_id', (int) $post->ID ); // Save post_ID. 524 } 525 } 526 527 $post_ID = (int) $post->ID; 528 ?> 529 530 <form name="post" action="<?php echo esc_url( admin_url( 'post.php' ) ); ?>" method="post" id="quick-press" class="initial-form hide-if-no-js"> 531 532 <?php if ( $error_msg ) : ?> 533 <div class="error"><?php echo $error_msg; ?></div> 534 <?php endif; ?> 535 536 <div class="input-text-wrap" id="title-wrap"> 537 <label for="title"> 538 <?php 539 /** This filter is documented in wp-admin/edit-form-advanced.php */ 540 echo apply_filters( 'enter_title_here', __( 'Title' ), $post ); 541 ?> 542 </label> 543 <input type="text" name="post_title" id="title" autocomplete="off" /> 544 </div> 545 546 <div class="textarea-wrap" id="description-wrap"> 547 <label for="content"><?php _e( 'Content' ); ?></label> 548 <textarea name="content" id="content" placeholder="<?php esc_attr_e( 'What’s on your mind?' ); ?>" class="mceEditor" rows="3" cols="15" autocomplete="off"></textarea> 549 </div> 550 551 <p class="submit"> 552 <input type="hidden" name="action" id="quickpost-action" value="post-quickdraft-save" /> 553 <input type="hidden" name="post_ID" value="<?php echo $post_ID; ?>" /> 554 <input type="hidden" name="post_type" value="post" /> 555 <?php wp_nonce_field( 'add-post' ); ?> 556 <?php submit_button( __( 'Save Draft' ), 'primary', 'save', false, array( 'id' => 'save-post' ) ); ?> 557 <br class="clear" /> 558 </p> 559 560 </form> 561 <?php 562 wp_dashboard_recent_drafts(); 563 } 564 565 /** 566 * Show recent drafts of the user on the dashboard. 567 * 568 * @since 2.7.0 569 * 570 * @param WP_Post[] $drafts Optional. Array of posts to display. Default false. 571 */ 572 function wp_dashboard_recent_drafts( $drafts = false ) { 573 if ( ! $drafts ) { 574 $query_args = array( 575 'post_type' => 'post', 576 'post_status' => 'draft', 577 'author' => get_current_user_id(), 578 'posts_per_page' => 4, 579 'orderby' => 'modified', 580 'order' => 'DESC', 581 ); 582 583 /** 584 * Filters the post query arguments for the 'Recent Drafts' dashboard widget. 585 * 586 * @since 4.4.0 587 * 588 * @param array $query_args The query arguments for the 'Recent Drafts' dashboard widget. 589 */ 590 $query_args = apply_filters( 'dashboard_recent_drafts_query_args', $query_args ); 591 592 $drafts = get_posts( $query_args ); 593 if ( ! $drafts ) { 594 return; 595 } 596 } 597 598 echo '<div class="drafts">'; 599 if ( count( $drafts ) > 3 ) { 600 printf( 601 '<p class="view-all"><a href="%s">%s</a></p>' . "\n", 602 esc_url( admin_url( 'edit.php?post_status=draft' ) ), 603 __( 'View all drafts' ) 604 ); 605 } 606 echo '<h2 class="hide-if-no-js">' . __( 'Your Recent Drafts' ) . "</h2>\n<ul>"; 607 608 /* translators: Maximum number of words used in a preview of a draft on the dashboard. */ 609 $draft_length = intval( _x( '10', 'draft_length' ) ); 610 611 $drafts = array_slice( $drafts, 0, 3 ); 612 foreach ( $drafts as $draft ) { 613 $url = get_edit_post_link( $draft->ID ); 614 $title = _draft_or_post_title( $draft->ID ); 615 echo "<li>\n"; 616 printf( 617 '<div class="draft-title"><a href="%s" aria-label="%s">%s</a><time datetime="%s">%s</time></div>', 618 esc_url( $url ), 619 /* translators: %s: Post title. */ 620 esc_attr( sprintf( __( 'Edit “%s”' ), $title ) ), 621 esc_html( $title ), 622 get_the_time( 'c', $draft ), 623 get_the_time( __( 'F j, Y' ), $draft ) 624 ); 625 $the_content = wp_trim_words( $draft->post_content, $draft_length ); 626 if ( $the_content ) { 627 echo '<p>' . $the_content . '</p>'; 628 } 629 echo "</li>\n"; 630 } 631 echo "</ul>\n</div>"; 632 } 633 634 /** 635 * Outputs a row for the Recent Comments widget. 636 * 637 * @access private 638 * @since 2.7.0 639 * 640 * @global WP_Comment $comment Global comment object. 641 * 642 * @param WP_Comment $comment The current comment. 643 * @param bool $show_date Optional. Whether to display the date. 644 */ 645 function _wp_dashboard_recent_comments_row( &$comment, $show_date = true ) { 646 $GLOBALS['comment'] = clone $comment; 647 648 if ( $comment->comment_post_ID > 0 ) { 649 650 $comment_post_title = _draft_or_post_title( $comment->comment_post_ID ); 651 $comment_post_url = get_the_permalink( $comment->comment_post_ID ); 652 $comment_post_link = "<a href='$comment_post_url'>$comment_post_title</a>"; 653 } else { 654 $comment_post_link = ''; 655 } 656 657 $actions_string = ''; 658 if ( current_user_can( 'edit_comment', $comment->comment_ID ) ) { 659 // Pre-order it: Approve | Reply | Edit | Spam | Trash. 660 $actions = array( 661 'approve' => '', 662 'unapprove' => '', 663 'reply' => '', 664 'edit' => '', 665 'spam' => '', 666 'trash' => '', 667 'delete' => '', 668 'view' => '', 669 ); 670 671 $del_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "delete-comment_$comment->comment_ID" ) ); 672 $approve_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "approve-comment_$comment->comment_ID" ) ); 673 674 $approve_url = esc_url( "comment.php?action=approvecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$approve_nonce" ); 675 $unapprove_url = esc_url( "comment.php?action=unapprovecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$approve_nonce" ); 676 $spam_url = esc_url( "comment.php?action=spamcomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" ); 677 $trash_url = esc_url( "comment.php?action=trashcomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" ); 678 $delete_url = esc_url( "comment.php?action=deletecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" ); 679 680 $actions['approve'] = sprintf( 681 '<a href="%s" data-wp-lists="%s" class="vim-a aria-button-if-js" aria-label="%s">%s</a>', 682 $approve_url, 683 "dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=approved", 684 esc_attr__( 'Approve this comment' ), 685 __( 'Approve' ) 686 ); 687 688 $actions['unapprove'] = sprintf( 689 '<a href="%s" data-wp-lists="%s" class="vim-u aria-button-if-js" aria-label="%s">%s</a>', 690 $unapprove_url, 691 "dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=unapproved", 692 esc_attr__( 'Unapprove this comment' ), 693 __( 'Unapprove' ) 694 ); 695 696 $actions['edit'] = sprintf( 697 '<a href="%s" aria-label="%s">%s</a>', 698 "comment.php?action=editcomment&c={$comment->comment_ID}", 699 esc_attr__( 'Edit this comment' ), 700 __( 'Edit' ) 701 ); 702 703 $actions['reply'] = sprintf( 704 '<button type="button" onclick="window.commentReply && commentReply.open(\'%s\',\'%s\');" class="vim-r button-link hide-if-no-js" aria-label="%s">%s</button>', 705 $comment->comment_ID, 706 $comment->comment_post_ID, 707 esc_attr__( 'Reply to this comment' ), 708 __( 'Reply' ) 709 ); 710 711 $actions['spam'] = sprintf( 712 '<a href="%s" data-wp-lists="%s" class="vim-s vim-destructive aria-button-if-js" aria-label="%s">%s</a>', 713 $spam_url, 714 "delete:the-comment-list:comment-{$comment->comment_ID}::spam=1", 715 esc_attr__( 'Mark this comment as spam' ), 716 /* translators: "Mark as spam" link. */ 717 _x( 'Spam', 'verb' ) 718 ); 719 720 if ( ! EMPTY_TRASH_DAYS ) { 721 $actions['delete'] = sprintf( 722 '<a href="%s" data-wp-lists="%s" class="delete vim-d vim-destructive aria-button-if-js" aria-label="%s">%s</a>', 723 $delete_url, 724 "delete:the-comment-list:comment-{$comment->comment_ID}::trash=1", 725 esc_attr__( 'Delete this comment permanently' ), 726 __( 'Delete Permanently' ) 727 ); 728 } else { 729 $actions['trash'] = sprintf( 730 '<a href="%s" data-wp-lists="%s" class="delete vim-d vim-destructive aria-button-if-js" aria-label="%s">%s</a>', 731 $trash_url, 732 "delete:the-comment-list:comment-{$comment->comment_ID}::trash=1", 733 esc_attr__( 'Move this comment to the Trash' ), 734 _x( 'Trash', 'verb' ) 735 ); 736 } 737 738 $actions['view'] = sprintf( 739 '<a class="comment-link" href="%s" aria-label="%s">%s</a>', 740 esc_url( get_comment_link( $comment ) ), 741 esc_attr__( 'View this comment' ), 742 __( 'View' ) 743 ); 744 745 /** 746 * Filters the action links displayed for each comment in the 'Recent Comments' 747 * dashboard widget. 748 * 749 * @since 2.6.0 750 * 751 * @param string[] $actions An array of comment actions. Default actions include: 752 * 'Approve', 'Unapprove', 'Edit', 'Reply', 'Spam', 753 * 'Delete', and 'Trash'. 754 * @param WP_Comment $comment The comment object. 755 */ 756 $actions = apply_filters( 'comment_row_actions', array_filter( $actions ), $comment ); 757 758 $i = 0; 759 foreach ( $actions as $action => $link ) { 760 ++$i; 761 ( ( ( 'approve' == $action || 'unapprove' == $action ) && 2 === $i ) || 1 === $i ) ? $sep = '' : $sep = ' | '; 762 763 // Reply and quickedit need a hide-if-no-js span. 764 if ( 'reply' == $action || 'quickedit' == $action ) { 765 $action .= ' hide-if-no-js'; 766 } 767 768 if ( 'view' === $action && '1' !== $comment->comment_approved ) { 769 $action .= ' hidden'; 770 } 771 $actions_string .= "<span class='$action'>$sep$link</span>"; 772 } 773 } 774 ?> 775 776 <li id="comment-<?php echo $comment->comment_ID; ?>" <?php comment_class( array( 'comment-item', wp_get_comment_status( $comment ) ), $comment ); ?>> 777 778 <?php 779 $comment_row_class = ''; 780 781 if ( get_option( 'show_avatars' ) ) { 782 echo get_avatar( $comment, 50, 'mystery' ); 783 $comment_row_class .= ' has-avatar'; 784 } 785 ?> 786 787 <?php if ( ! $comment->comment_type || 'comment' == $comment->comment_type ) : ?> 788 789 <div class="dashboard-comment-wrap has-row-actions <?php echo $comment_row_class; ?>"> 790 <p class="comment-meta"> 791 <?php 792 // Comments might not have a post they relate to, e.g. programmatically created ones. 793 if ( $comment_post_link ) { 794 printf( 795 /* translators: 1: Comment author, 2: Post link, 3: Notification if the comment is pending. */ 796 __( 'From %1$s on %2$s %3$s' ), 797 '<cite class="comment-author">' . get_comment_author_link( $comment ) . '</cite>', 798 $comment_post_link, 799 '<span class="approve">' . __( '[Pending]' ) . '</span>' 800 ); 801 } else { 802 printf( 803 /* translators: 1: Comment author, 2: Notification if the comment is pending. */ 804 __( 'From %1$s %2$s' ), 805 '<cite class="comment-author">' . get_comment_author_link( $comment ) . '</cite>', 806 '<span class="approve">' . __( '[Pending]' ) . '</span>' 807 ); 808 } 809 ?> 810 </p> 811 812 <?php 813 else : 814 switch ( $comment->comment_type ) { 815 case 'pingback': 816 $type = __( 'Pingback' ); 817 break; 818 case 'trackback': 819 $type = __( 'Trackback' ); 820 break; 821 default: 822 $type = ucwords( $comment->comment_type ); 823 } 824 $type = esc_html( $type ); 825 ?> 826 <div class="dashboard-comment-wrap has-row-actions"> 827 <p class="comment-meta"> 828 <?php 829 // Pingbacks, Trackbacks or custom comment types might not have a post they relate to, e.g. programmatically created ones. 830 if ( $comment_post_link ) { 831 printf( 832 /* translators: 1: Type of comment, 2: Post link, 3: Notification if the comment is pending. */ 833 _x( '%1$s on %2$s %3$s', 'dashboard' ), 834 "<strong>$type</strong>", 835 $comment_post_link, 836 '<span class="approve">' . __( '[Pending]' ) . '</span>' 837 ); 838 } else { 839 printf( 840 /* translators: 1: Type of comment, 2: Notification if the comment is pending. */ 841 _x( '%1$s %2$s', 'dashboard' ), 842 "<strong>$type</strong>", 843 '<span class="approve">' . __( '[Pending]' ) . '</span>' 844 ); 845 } 846 ?> 847 </p> 848 <p class="comment-author"><?php comment_author_link( $comment ); ?></p> 849 850 <?php endif; // comment_type ?> 851 <blockquote><p><?php comment_excerpt( $comment ); ?></p></blockquote> 852 <?php if ( $actions_string ) : ?> 853 <p class="row-actions"><?php echo $actions_string; ?></p> 854 <?php endif; ?> 855 </div> 856 </li> 857 <?php 858 $GLOBALS['comment'] = null; 859 } 860 861 /** 862 * Callback function for Activity widget. 863 * 864 * @since 3.8.0 865 */ 866 function wp_dashboard_site_activity() { 867 868 echo '<div id="activity-widget">'; 869 870 $future_posts = wp_dashboard_recent_posts( 871 array( 872 'max' => 5, 873 'status' => 'future', 874 'order' => 'ASC', 875 'title' => __( 'Publishing Soon' ), 876 'id' => 'future-posts', 877 ) 878 ); 879 $recent_posts = wp_dashboard_recent_posts( 880 array( 881 'max' => 5, 882 'status' => 'publish', 883 'order' => 'DESC', 884 'title' => __( 'Recently Published' ), 885 'id' => 'published-posts', 886 ) 887 ); 888 889 $recent_comments = wp_dashboard_recent_comments(); 890 891 if ( ! $future_posts && ! $recent_posts && ! $recent_comments ) { 892 echo '<div class="no-activity">'; 893 echo '<p class="smiley" aria-hidden="true"></p>'; 894 echo '<p>' . __( 'No activity yet!' ) . '</p>'; 895 echo '</div>'; 896 } 897 898 echo '</div>'; 899 } 900 901 /** 902 * Generates Publishing Soon and Recently Published sections. 903 * 904 * @since 3.8.0 905 * 906 * @param array $args { 907 * An array of query and display arguments. 908 * 909 * @type int $max Number of posts to display. 910 * @type string $status Post status. 911 * @type string $order Designates ascending ('ASC') or descending ('DESC') order. 912 * @type string $title Section title. 913 * @type string $id The container id. 914 * } 915 * @return bool False if no posts were found. True otherwise. 916 */ 917 function wp_dashboard_recent_posts( $args ) { 918 $query_args = array( 919 'post_type' => 'post', 920 'post_status' => $args['status'], 921 'orderby' => 'date', 922 'order' => $args['order'], 923 'posts_per_page' => intval( $args['max'] ), 924 'no_found_rows' => true, 925 'cache_results' => false, 926 'perm' => ( 'future' === $args['status'] ) ? 'editable' : 'readable', 927 ); 928 929 /** 930 * Filters the query arguments used for the Recent Posts widget. 931 * 932 * @since 4.2.0 933 * 934 * @param array $query_args The arguments passed to WP_Query to produce the list of posts. 935 */ 936 $query_args = apply_filters( 'dashboard_recent_posts_query_args', $query_args ); 937 $posts = new WP_Query( $query_args ); 938 939 if ( $posts->have_posts() ) { 940 941 echo '<div id="' . $args['id'] . '" class="activity-block">'; 942 943 echo '<h3>' . $args['title'] . '</h3>'; 944 945 echo '<ul>'; 946 947 $today = current_time( 'Y-m-d' ); 948 $tomorrow = current_datetime()->modify( '+1 day' )->format( 'Y-m-d' ); 949 $year = current_time( 'Y' ); 950 951 while ( $posts->have_posts() ) { 952 $posts->the_post(); 953 954 $time = get_the_time( 'U' ); 955 if ( gmdate( 'Y-m-d', $time ) == $today ) { 956 $relative = __( 'Today' ); 957 } elseif ( gmdate( 'Y-m-d', $time ) == $tomorrow ) { 958 $relative = __( 'Tomorrow' ); 959 } elseif ( gmdate( 'Y', $time ) !== $year ) { 960 /* translators: Date and time format for recent posts on the dashboard, from a different calendar year, see https://www.php.net/date */ 961 $relative = date_i18n( __( 'M jS Y' ), $time ); 962 } else { 963 /* translators: Date and time format for recent posts on the dashboard, see https://www.php.net/date */ 964 $relative = date_i18n( __( 'M jS' ), $time ); 965 } 966 967 // Use the post edit link for those who can edit, the permalink otherwise. 968 $recent_post_link = current_user_can( 'edit_post', get_the_ID() ) ? get_edit_post_link() : get_permalink(); 969 970 $draft_or_post_title = _draft_or_post_title(); 971 printf( 972 '<li><span>%1$s</span> <a href="%2$s" aria-label="%3$s">%4$s</a></li>', 973 /* translators: 1: Relative date, 2: Time. */ 974 sprintf( _x( '%1$s, %2$s', 'dashboard' ), $relative, get_the_time() ), 975 $recent_post_link, 976 /* translators: %s: Post title. */ 977 esc_attr( sprintf( __( 'Edit “%s”' ), $draft_or_post_title ) ), 978 $draft_or_post_title 979 ); 980 } 981 982 echo '</ul>'; 983 echo '</div>'; 984 985 } else { 986 return false; 987 } 988 989 wp_reset_postdata(); 990 991 return true; 992 } 993 994 /** 995 * Show Comments section. 996 * 997 * @since 3.8.0 998 * 999 * @param int $total_items Optional. Number of comments to query. Default 5. 1000 * @return bool False if no comments were found. True otherwise. 1001 */ 1002 function wp_dashboard_recent_comments( $total_items = 5 ) { 1003 // Select all comment types and filter out spam later for better query performance. 1004 $comments = array(); 1005 1006 $comments_query = array( 1007 'number' => $total_items * 5, 1008 'offset' => 0, 1009 ); 1010 if ( ! current_user_can( 'edit_posts' ) ) { 1011 $comments_query['status'] = 'approve'; 1012 } 1013 1014 while ( count( $comments ) < $total_items && $possible = get_comments( $comments_query ) ) { 1015 if ( ! is_array( $possible ) ) { 1016 break; 1017 } 1018 foreach ( $possible as $comment ) { 1019 if ( ! current_user_can( 'read_post', $comment->comment_post_ID ) ) { 1020 continue; 1021 } 1022 $comments[] = $comment; 1023 if ( count( $comments ) == $total_items ) { 1024 break 2; 1025 } 1026 } 1027 $comments_query['offset'] += $comments_query['number']; 1028 $comments_query['number'] = $total_items * 10; 1029 } 1030 1031 if ( $comments ) { 1032 echo '<div id="latest-comments" class="activity-block">'; 1033 echo '<h3>' . __( 'Recent Comments' ) . '</h3>'; 1034 1035 echo '<ul id="the-comment-list" data-wp-lists="list:comment">'; 1036 foreach ( $comments as $comment ) { 1037 _wp_dashboard_recent_comments_row( $comment ); 1038 } 1039 echo '</ul>'; 1040 1041 if ( current_user_can( 'edit_posts' ) ) { 1042 echo '<h3 class="screen-reader-text">' . __( 'View more comments' ) . '</h3>'; 1043 _get_list_table( 'WP_Comments_List_Table' )->views(); 1044 } 1045 1046 wp_comment_reply( -1, false, 'dashboard', false ); 1047 wp_comment_trashnotice(); 1048 1049 echo '</div>'; 1050 } else { 1051 return false; 1052 } 1053 return true; 1054 } 1055 1056 /** 1057 * Display generic dashboard RSS widget feed. 1058 * 1059 * @since 2.5.0 1060 * 1061 * @param string $widget_id 1062 */ 1063 function wp_dashboard_rss_output( $widget_id ) { 1064 $widgets = get_option( 'dashboard_widget_options' ); 1065 echo '<div class="rss-widget">'; 1066 wp_widget_rss_output( $widgets[ $widget_id ] ); 1067 echo '</div>'; 1068 } 1069 1070 /** 1071 * Checks to see if all of the feed url in $check_urls are cached. 1072 * 1073 * If $check_urls is empty, look for the rss feed url found in the dashboard 1074 * widget options of $widget_id. If cached, call $callback, a function that 1075 * echoes out output for this widget. If not cache, echo a "Loading..." stub 1076 * which is later replaced by Ajax call (see top of /wp-admin/index.php) 1077 * 1078 * @since 2.5.0 1079 * @since 5.3.0 Formalized the existing and already documented `...$args` parameter 1080 * by adding it to the function signature. 1081 * 1082 * @param string $widget_id The widget ID. 1083 * @param callable $callback The callback function used to display each feed. 1084 * @param array $check_urls RSS feeds. 1085 * @param mixed ...$args Optional additional parameters to pass to the callback function. 1086 * @return bool True on success, false on failure. 1087 */ 1088 function wp_dashboard_cached_rss_widget( $widget_id, $callback, $check_urls = array(), ...$args ) { 1089 $loading = '<p class="widget-loading hide-if-no-js">' . __( 'Loading…' ) . '</p><div class="hide-if-js notice notice-error inline"><p>' . __( 'This widget requires JavaScript.' ) . '</p></div>'; 1090 $doing_ajax = wp_doing_ajax(); 1091 1092 if ( empty( $check_urls ) ) { 1093 $widgets = get_option( 'dashboard_widget_options' ); 1094 if ( empty( $widgets[ $widget_id ]['url'] ) && ! $doing_ajax ) { 1095 echo $loading; 1096 return false; 1097 } 1098 $check_urls = array( $widgets[ $widget_id ]['url'] ); 1099 } 1100 1101 $locale = get_user_locale(); 1102 $cache_key = 'dash_v2_' . md5( $widget_id . '_' . $locale ); 1103 $output = get_transient( $cache_key ); 1104 if ( false !== $output ) { 1105 echo $output; 1106 return true; 1107 } 1108 1109 if ( ! $doing_ajax ) { 1110 echo $loading; 1111 return false; 1112 } 1113 1114 if ( $callback && is_callable( $callback ) ) { 1115 array_unshift( $args, $widget_id, $check_urls ); 1116 ob_start(); 1117 call_user_func_array( $callback, $args ); 1118 // Default lifetime in cache of 12 hours (same as the feeds). 1119 set_transient( $cache_key, ob_get_flush(), 12 * HOUR_IN_SECONDS ); 1120 } 1121 1122 return true; 1123 } 1124 1125 // 1126 // Dashboard Widgets Controls. 1127 // 1128 1129 /** 1130 * Calls widget control callback. 1131 * 1132 * @since 2.5.0 1133 * 1134 * @global array $wp_dashboard_control_callbacks 1135 * 1136 * @param int $widget_control_id Registered Widget ID. 1137 */ 1138 function wp_dashboard_trigger_widget_control( $widget_control_id = false ) { 1139 global $wp_dashboard_control_callbacks; 1140 1141 if ( is_scalar( $widget_control_id ) && $widget_control_id && isset( $wp_dashboard_control_callbacks[ $widget_control_id ] ) && is_callable( $wp_dashboard_control_callbacks[ $widget_control_id ] ) ) { 1142 call_user_func( 1143 $wp_dashboard_control_callbacks[ $widget_control_id ], 1144 '', 1145 array( 1146 'id' => $widget_control_id, 1147 'callback' => $wp_dashboard_control_callbacks[ $widget_control_id ], 1148 ) 1149 ); 1150 } 1151 } 1152 1153 /** 1154 * The RSS dashboard widget control. 1155 * 1156 * Sets up $args to be used as input to wp_widget_rss_form(). Handles POST data 1157 * from RSS-type widgets. 1158 * 1159 * @since 2.5.0 1160 * 1161 * @param string $widget_id 1162 * @param array $form_inputs 1163 */ 1164 function wp_dashboard_rss_control( $widget_id, $form_inputs = array() ) { 1165 $widget_options = get_option( 'dashboard_widget_options' ); 1166 if ( ! $widget_options ) { 1167 $widget_options = array(); 1168 } 1169 1170 if ( ! isset( $widget_options[ $widget_id ] ) ) { 1171 $widget_options[ $widget_id ] = array(); 1172 } 1173 1174 $number = 1; // Hack to use wp_widget_rss_form(). 1175 1176 $widget_options[ $widget_id ]['number'] = $number; 1177 1178 if ( 'POST' == $_SERVER['REQUEST_METHOD'] && isset( $_POST['widget-rss'][ $number ] ) ) { 1179 $_POST['widget-rss'][ $number ] = wp_unslash( $_POST['widget-rss'][ $number ] ); 1180 $widget_options[ $widget_id ] = wp_widget_rss_process( $_POST['widget-rss'][ $number ] ); 1181 $widget_options[ $widget_id ]['number'] = $number; 1182 1183 // Title is optional. If black, fill it if possible. 1184 if ( ! $widget_options[ $widget_id ]['title'] && isset( $_POST['widget-rss'][ $number ]['title'] ) ) { 1185 $rss = fetch_feed( $widget_options[ $widget_id ]['url'] ); 1186 if ( is_wp_error( $rss ) ) { 1187 $widget_options[ $widget_id ]['title'] = htmlentities( __( 'Unknown Feed' ) ); 1188 } else { 1189 $widget_options[ $widget_id ]['title'] = htmlentities( strip_tags( $rss->get_title() ) ); 1190 $rss->__destruct(); 1191 unset( $rss ); 1192 } 1193 } 1194 update_option( 'dashboard_widget_options', $widget_options ); 1195 $locale = get_user_locale(); 1196 $cache_key = 'dash_v2_' . md5( $widget_id . '_' . $locale ); 1197 delete_transient( $cache_key ); 1198 } 1199 1200 wp_widget_rss_form( $widget_options[ $widget_id ], $form_inputs ); 1201 } 1202 1203 1204 /** 1205 * Renders the Events and News dashboard widget. 1206 * 1207 * @since 4.8.0 1208 */ 1209 function wp_dashboard_events_news() { 1210 wp_print_community_events_markup(); 1211 1212 ?> 1213 1214 <div class="wordpress-news hide-if-no-js"> 1215 <?php wp_dashboard_primary(); ?> 1216 </div> 1217 1218 <p class="community-events-footer"> 1219 <?php 1220 printf( 1221 '<a href="%1$s" target="_blank">%2$s <span class="screen-reader-text">%3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>', 1222 'https://make.wordpress.org/community/meetups-landing-page', 1223 __( 'Meetups' ), 1224 /* translators: Accessibility text. */ 1225 __( '(opens in a new tab)' ) 1226 ); 1227 ?> 1228 1229 | 1230 1231 <?php 1232 printf( 1233 '<a href="%1$s" target="_blank">%2$s <span class="screen-reader-text">%3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>', 1234 'https://central.wordcamp.org/schedule/', 1235 __( 'WordCamps' ), 1236 /* translators: Accessibility text. */ 1237 __( '(opens in a new tab)' ) 1238 ); 1239 ?> 1240 1241 | 1242 1243 <?php 1244 printf( 1245 '<a href="%1$s" target="_blank">%2$s <span class="screen-reader-text">%3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>', 1246 /* translators: If a Rosetta site exists (e.g. https://es.wordpress.org/news/), then use that. Otherwise, leave untranslated. */ 1247 esc_url( _x( 'https://wordpress.org/news/', 'Events and News dashboard widget' ) ), 1248 __( 'News' ), 1249 /* translators: Accessibility text. */ 1250 __( '(opens in a new tab)' ) 1251 ); 1252 ?> 1253 </p> 1254 1255 <?php 1256 } 1257 1258 /** 1259 * Prints the markup for the Community Events section of the Events and News Dashboard widget. 1260 * 1261 * @since 4.8.0 1262 */ 1263 function wp_print_community_events_markup() { 1264 ?> 1265 1266 <div class="community-events-errors notice notice-error inline hide-if-js"> 1267 <p class="hide-if-js"> 1268 <?php _e( 'This widget requires JavaScript.' ); ?> 1269 </p> 1270 1271 <p class="community-events-error-occurred" aria-hidden="true"> 1272 <?php _e( 'An error occurred. Please try again.' ); ?> 1273 </p> 1274 1275 <p class="community-events-could-not-locate" aria-hidden="true"></p> 1276 </div> 1277 1278 <div class="community-events-loading hide-if-no-js"> 1279 <?php _e( 'Loading…' ); ?> 1280 </div> 1281 1282 <?php 1283 /* 1284 * Hide the main element when the page first loads, because the content 1285 * won't be ready until wp.communityEvents.renderEventsTemplate() has run. 1286 */ 1287 ?> 1288 <div id="community-events" class="community-events" aria-hidden="true"> 1289 <div class="activity-block"> 1290 <p> 1291 <span id="community-events-location-message"></span> 1292 1293 <button class="button-link community-events-toggle-location" aria-label="<?php esc_attr_e( 'Edit city' ); ?>" aria-expanded="false"> 1294 <span class="dashicons dashicons-edit"></span> 1295 </button> 1296 </p> 1297 1298 <form class="community-events-form" aria-hidden="true" action="<?php echo esc_url( admin_url( 'admin-ajax.php' ) ); ?>" method="post"> 1299 <label for="community-events-location"> 1300 <?php _e( 'City:' ); ?> 1301 </label> 1302 <?php 1303 /* translators: Replace with a city related to your locale. 1304 * Test that it matches the expected location and has upcoming 1305 * events before including it. If no cities related to your 1306 * locale have events, then use a city related to your locale 1307 * that would be recognizable to most users. Use only the city 1308 * name itself, without any region or country. Use the endonym 1309 * (native locale name) instead of the English name if possible. 1310 */ 1311 ?> 1312 <input id="community-events-location" class="regular-text" type="text" name="community-events-location" placeholder="<?php esc_attr_e( 'Cincinnati' ); ?>" /> 1313 1314 <?php submit_button( __( 'Submit' ), 'secondary', 'community-events-submit', false ); ?> 1315 1316 <button class="community-events-cancel button-link" type="button" aria-expanded="false"> 1317 <?php _e( 'Cancel' ); ?> 1318 </button> 1319 1320 <span class="spinner"></span> 1321 </form> 1322 </div> 1323 1324 <ul class="community-events-results activity-block last"></ul> 1325 </div> 1326 1327 <?php 1328 } 1329 1330 /** 1331 * Renders the events templates for the Event and News widget. 1332 * 1333 * @since 4.8.0 1334 */ 1335 function wp_print_community_events_templates() { 1336 ?> 1337 1338 <script id="tmpl-community-events-attend-event-near" type="text/template"> 1339 <?php 1340 printf( 1341 /* translators: %s: The name of a city. */ 1342 __( 'Attend an upcoming event near %s.' ), 1343 '<strong>{{ data.location.description }}</strong>' 1344 ); 1345 ?> 1346 </script> 1347 1348 <script id="tmpl-community-events-could-not-locate" type="text/template"> 1349 <?php 1350 printf( 1351 /* translators: %s is the name of the city we couldn't locate. 1352 * Replace the examples with cities in your locale, but test 1353 * that they match the expected location before including them. 1354 * Use endonyms (native locale names) whenever possible. 1355 */ 1356 __( 'We couldn’t locate %s. Please try another nearby city. For example: Kansas City; Springfield; Portland.' ), 1357 '<em>{{data.unknownCity}}</em>' 1358 ); 1359 ?> 1360 </script> 1361 1362 <script id="tmpl-community-events-event-list" type="text/template"> 1363 <# _.each( data.events, function( event ) { #> 1364 <li class="event event-{{ event.type }} wp-clearfix"> 1365 <div class="event-info"> 1366 <div class="dashicons event-icon" aria-hidden="true"></div> 1367 <div class="event-info-inner"> 1368 <a class="event-title" href="{{ event.url }}">{{ event.title }}</a> 1369 <span class="event-city">{{ event.location.location }}</span> 1370 </div> 1371 </div> 1372 1373 <div class="event-date-time"> 1374 <span class="event-date">{{ event.formatted_date }}</span> 1375 <# if ( 'meetup' === event.type ) { #> 1376 <span class="event-time">{{ event.formatted_time }}</span> 1377 <# } #> 1378 </div> 1379 </li> 1380 <# } ) #> 1381 </script> 1382 1383 <script id="tmpl-community-events-no-upcoming-events" type="text/template"> 1384 <li class="event-none"> 1385 <# if ( data.location.description ) { #> 1386 <?php 1387 printf( 1388 /* translators: 1: The city the user searched for, 2: Meetup organization documentation URL. */ 1389 __( 'There aren’t any events scheduled near %1$s at the moment. Would you like to <a href="%2$s">organize one</a>?' ), 1390 '{{ data.location.description }}', 1391 __( 'https://make.wordpress.org/community/handbook/meetup-organizer/welcome/' ) 1392 ); 1393 ?> 1394 1395 <# } else { #> 1396 <?php 1397 printf( 1398 /* translators: %s: Meetup organization documentation URL. */ 1399 __( 'There aren’t any events scheduled near you at the moment. Would you like to <a href="%s">organize one</a>?' ), 1400 __( 'https://make.wordpress.org/community/handbook/meetup-organizer/welcome/' ) 1401 ); 1402 ?> 1403 <# } #> 1404 </li> 1405 </script> 1406 <?php 1407 } 1408 1409 /** 1410 * 'WordPress Events and News' dashboard widget. 1411 * 1412 * @since 2.7.0 1413 * @since 4.8.0 Removed popular plugins feed. 1414 */ 1415 function wp_dashboard_primary() { 1416 $feeds = array( 1417 'news' => array( 1418 1419 /** 1420 * Filters the primary link URL for the 'WordPress Events and News' dashboard widget. 1421 * 1422 * @since 2.5.0 1423 * 1424 * @param string $link The widget's primary link URL. 1425 */ 1426 'link' => apply_filters( 'dashboard_primary_link', __( 'https://wordpress.org/news/' ) ), 1427 1428 /** 1429 * Filters the primary feed URL for the 'WordPress Events and News' dashboard widget. 1430 * 1431 * @since 2.3.0 1432 * 1433 * @param string $url The widget's primary feed URL. 1434 */ 1435 'url' => apply_filters( 'dashboard_primary_feed', __( 'https://wordpress.org/news/feed/' ) ), 1436 1437 /** 1438 * Filters the primary link title for the 'WordPress Events and News' dashboard widget. 1439 * 1440 * @since 2.3.0 1441 * 1442 * @param string $title Title attribute for the widget's primary link. 1443 */ 1444 'title' => apply_filters( 'dashboard_primary_title', __( 'WordPress Blog' ) ), 1445 'items' => 1, 1446 'show_summary' => 0, 1447 'show_author' => 0, 1448 'show_date' => 0, 1449 ), 1450 'planet' => array( 1451 1452 /** 1453 * Filters the secondary link URL for the 'WordPress Events and News' dashboard widget. 1454 * 1455 * @since 2.3.0 1456 * 1457 * @param string $link The widget's secondary link URL. 1458 */ 1459 'link' => apply_filters( 'dashboard_secondary_link', __( 'https://planet.wordpress.org/' ) ), 1460 1461 /** 1462 * Filters the secondary feed URL for the 'WordPress Events and News' dashboard widget. 1463 * 1464 * @since 2.3.0 1465 * 1466 * @param string $url The widget's secondary feed URL. 1467 */ 1468 'url' => apply_filters( 'dashboard_secondary_feed', __( 'https://planet.wordpress.org/feed/' ) ), 1469 1470 /** 1471 * Filters the secondary link title for the 'WordPress Events and News' dashboard widget. 1472 * 1473 * @since 2.3.0 1474 * 1475 * @param string $title Title attribute for the widget's secondary link. 1476 */ 1477 'title' => apply_filters( 'dashboard_secondary_title', __( 'Other WordPress News' ) ), 1478 1479 /** 1480 * Filters the number of secondary link items for the 'WordPress Events and News' dashboard widget. 1481 * 1482 * @since 4.4.0 1483 * 1484 * @param string $items How many items to show in the secondary feed. 1485 */ 1486 'items' => apply_filters( 'dashboard_secondary_items', 3 ), 1487 'show_summary' => 0, 1488 'show_author' => 0, 1489 'show_date' => 0, 1490 ), 1491 ); 1492 1493 wp_dashboard_cached_rss_widget( 'dashboard_primary', 'wp_dashboard_primary_output', $feeds ); 1494 } 1495 1496 /** 1497 * Displays the WordPress events and news feeds. 1498 * 1499 * @since 3.8.0 1500 * @since 4.8.0 Removed popular plugins feed. 1501 * 1502 * @param string $widget_id Widget ID. 1503 * @param array $feeds Array of RSS feeds. 1504 */ 1505 function wp_dashboard_primary_output( $widget_id, $feeds ) { 1506 foreach ( $feeds as $type => $args ) { 1507 $args['type'] = $type; 1508 echo '<div class="rss-widget">'; 1509 wp_widget_rss_output( $args['url'], $args ); 1510 echo '</div>'; 1511 } 1512 } 1513 1514 /** 1515 * Displays file upload quota on dashboard. 1516 * 1517 * Runs on the {@see 'activity_box_end'} hook in wp_dashboard_right_now(). 1518 * 1519 * @since 3.0.0 1520 * 1521 * @return bool|null True if not multisite, user can't upload files, or the space check option is disabled. 1522 */ 1523 function wp_dashboard_quota() { 1524 if ( ! is_multisite() || ! current_user_can( 'upload_files' ) || get_site_option( 'upload_space_check_disabled' ) ) { 1525 return true; 1526 } 1527 1528 $quota = get_space_allowed(); 1529 $used = get_space_used(); 1530 1531 if ( $used > $quota ) { 1532 $percentused = '100'; 1533 } else { 1534 $percentused = ( $used / $quota ) * 100; 1535 } 1536 $used_class = ( $percentused >= 70 ) ? ' warning' : ''; 1537 $used = round( $used, 2 ); 1538 $percentused = number_format( $percentused ); 1539 1540 ?> 1541 <h3 class="mu-storage"><?php _e( 'Storage Space' ); ?></h3> 1542 <div class="mu-storage"> 1543 <ul> 1544 <li class="storage-count"> 1545 <?php 1546 $text = sprintf( 1547 /* translators: %s: Number of megabytes. */ 1548 __( '%s MB Space Allowed' ), 1549 number_format_i18n( $quota ) 1550 ); 1551 printf( 1552 '<a href="%1$s">%2$s <span class="screen-reader-text">(%3$s)</span></a>', 1553 esc_url( admin_url( 'upload.php' ) ), 1554 $text, 1555 __( 'Manage Uploads' ) 1556 ); 1557 ?> 1558 </li><li class="storage-count <?php echo $used_class; ?>"> 1559 <?php 1560 $text = sprintf( 1561 /* translators: 1: Number of megabytes, 2: Percentage. */ 1562 __( '%1$s MB (%2$s%%) Space Used' ), 1563 number_format_i18n( $used, 2 ), 1564 $percentused 1565 ); 1566 printf( 1567 '<a href="%1$s" class="musublink">%2$s <span class="screen-reader-text">(%3$s)</span></a>', 1568 esc_url( admin_url( 'upload.php' ) ), 1569 $text, 1570 __( 'Manage Uploads' ) 1571 ); 1572 ?> 1573 </li> 1574 </ul> 1575 </div> 1576 <?php 1577 } 1578 1579 /** 1580 * Displays the browser update nag. 1581 * 1582 * @since 3.2.0 1583 */ 1584 function wp_dashboard_browser_nag() { 1585 $notice = ''; 1586 $response = wp_check_browser_version(); 1587 1588 if ( $response ) { 1589 if ( $response['insecure'] ) { 1590 $msg = sprintf( 1591 /* translators: %s: Browser name and link. */ 1592 __( "It looks like you're using an insecure version of %s. Using an outdated browser makes your computer unsafe. For the best WordPress experience, please update your browser." ), 1593 sprintf( '<a href="%s">%s</a>', esc_url( $response['update_url'] ), esc_html( $response['name'] ) ) 1594 ); 1595 } else { 1596 $msg = sprintf( 1597 /* translators: %s: Browser name and link. */ 1598 __( "It looks like you're using an old version of %s. For the best WordPress experience, please update your browser." ), 1599 sprintf( '<a href="%s">%s</a>', esc_url( $response['update_url'] ), esc_html( $response['name'] ) ) 1600 ); 1601 } 1602 1603 $browser_nag_class = ''; 1604 if ( ! empty( $response['img_src'] ) ) { 1605 $img_src = ( is_ssl() && ! empty( $response['img_src_ssl'] ) ) ? $response['img_src_ssl'] : $response['img_src']; 1606 1607 $notice .= '<div class="alignright browser-icon"><a href="' . esc_attr( $response['update_url'] ) . '"><img src="' . esc_attr( $img_src ) . '" alt="" /></a></div>'; 1608 $browser_nag_class = ' has-browser-icon'; 1609 } 1610 $notice .= "<p class='browser-update-nag{$browser_nag_class}'>{$msg}</p>"; 1611 1612 $browsehappy = 'https://browsehappy.com/'; 1613 $locale = get_user_locale(); 1614 if ( 'en_US' !== $locale ) { 1615 $browsehappy = add_query_arg( 'locale', $locale, $browsehappy ); 1616 } 1617 1618 $notice .= '<p>' . sprintf( 1619 /* translators: 1: Browser update URL, 2: Browser name, 3: Browse Happy URL. */ 1620 __( '<a href="%1$s" class="update-browser-link">Update %2$s</a> or learn how to <a href="%3$s" class="browse-happy-link">browse happy</a>' ), 1621 esc_attr( $response['update_url'] ), 1622 esc_html( $response['name'] ), 1623 esc_url( $browsehappy ) 1624 ) . '</p>'; 1625 $notice .= '<p class="hide-if-no-js"><a href="" class="dismiss" aria-label="' . esc_attr__( 'Dismiss the browser warning panel' ) . '">' . __( 'Dismiss' ) . '</a></p>'; 1626 $notice .= '<div class="clear"></div>'; 1627 } 1628 1629 /** 1630 * Filters the notice output for the 'Browse Happy' nag meta box. 1631 * 1632 * @since 3.2.0 1633 * 1634 * @param string $notice The notice content. 1635 * @param array $response An array containing web browser information. See `wp_check_browser_version()`. 1636 */ 1637 echo apply_filters( 'browse-happy-notice', $notice, $response ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores 1638 } 1639 1640 /** 1641 * Adds an additional class to the browser nag if the current version is insecure. 1642 * 1643 * @since 3.2.0 1644 * 1645 * @param string[] $classes Array of meta box classes. 1646 * @return string[] Modified array of meta box classes. 1647 */ 1648 function dashboard_browser_nag_class( $classes ) { 1649 $response = wp_check_browser_version(); 1650 1651 if ( $response && $response['insecure'] ) { 1652 $classes[] = 'browser-insecure'; 1653 } 1654 1655 return $classes; 1656 } 1657 1658 /** 1659 * Checks if the user needs a browser update. 1660 * 1661 * @since 3.2.0 1662 * 1663 * @return array|bool Array of browser data on success, false on failure. 1664 */ 1665 function wp_check_browser_version() { 1666 if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { 1667 return false; 1668 } 1669 1670 $key = md5( $_SERVER['HTTP_USER_AGENT'] ); 1671 1672 $response = get_site_transient( 'browser_' . $key ); 1673 if ( false === $response ) { 1674 // Include an unmodified $wp_version. 1675 require ABSPATH . WPINC . '/version.php'; 1676 1677 $url = 'http://api.wordpress.org/core/browse-happy/1.1/'; 1678 $options = array( 1679 'body' => array( 'useragent' => $_SERVER['HTTP_USER_AGENT'] ), 1680 'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url( '/' ), 1681 ); 1682 1683 if ( wp_http_supports( array( 'ssl' ) ) ) { 1684 $url = set_url_scheme( $url, 'https' ); 1685 } 1686 1687 $response = wp_remote_post( $url, $options ); 1688 1689 if ( is_wp_error( $response ) || 200 != wp_remote_retrieve_response_code( $response ) ) { 1690 return false; 1691 } 1692 1693 /** 1694 * Response should be an array with: 1695 * 'platform' - string - A user-friendly platform name, if it can be determined 1696 * 'name' - string - A user-friendly browser name 1697 * 'version' - string - The version of the browser the user is using 1698 * 'current_version' - string - The most recent version of the browser 1699 * 'upgrade' - boolean - Whether the browser needs an upgrade 1700 * 'insecure' - boolean - Whether the browser is deemed insecure 1701 * 'update_url' - string - The url to visit to upgrade 1702 * 'img_src' - string - An image representing the browser 1703 * 'img_src_ssl' - string - An image (over SSL) representing the browser 1704 */ 1705 $response = json_decode( wp_remote_retrieve_body( $response ), true ); 1706 1707 if ( ! is_array( $response ) ) { 1708 return false; 1709 } 1710 1711 set_site_transient( 'browser_' . $key, $response, WEEK_IN_SECONDS ); 1712 } 1713 1714 return $response; 1715 } 1716 1717 /** 1718 * Displays the PHP update nag. 1719 * 1720 * @since 5.1.0 1721 */ 1722 function wp_dashboard_php_nag() { 1723 $response = wp_check_php_version(); 1724 1725 if ( ! $response ) { 1726 return; 1727 } 1728 1729 if ( isset( $response['is_secure'] ) && ! $response['is_secure'] ) { 1730 $msg = __( 'WordPress has detected that your site is running on an insecure version of PHP.' ); 1731 } else { 1732 $msg = __( 'WordPress has detected that your site is running on an outdated version of PHP.' ); 1733 } 1734 1735 ?> 1736 <p><?php echo $msg; ?></p> 1737 1738 <h3><?php _e( 'What is PHP and how does it affect my site?' ); ?></h3> 1739 <p><?php _e( 'PHP is the programming language we use to build and maintain WordPress. Newer versions of PHP are both faster and more secure, so updating will have a positive effect on your site’s performance.' ); ?></p> 1740 1741 <p class="button-container"> 1742 <?php 1743 printf( 1744 '<a class="button button-primary" href="%1$s" target="_blank" rel="noopener noreferrer">%2$s <span class="screen-reader-text">%3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>', 1745 esc_url( wp_get_update_php_url() ), 1746 __( 'Learn more about updating PHP' ), 1747 /* translators: Accessibility text. */ 1748 __( '(opens in a new tab)' ) 1749 ); 1750 ?> 1751 </p> 1752 <?php 1753 1754 wp_update_php_annotation(); 1755 wp_direct_php_update_button(); 1756 } 1757 1758 /** 1759 * Adds an additional class to the PHP nag if the current version is insecure. 1760 * 1761 * @since 5.1.0 1762 * 1763 * @param string[] $classes Array of meta box classes. 1764 * @return string[] Modified array of meta box classes. 1765 */ 1766 function dashboard_php_nag_class( $classes ) { 1767 $response = wp_check_php_version(); 1768 1769 if ( $response && isset( $response['is_secure'] ) && ! $response['is_secure'] ) { 1770 $classes[] = 'php-insecure'; 1771 } 1772 1773 return $classes; 1774 } 1775 1776 /** 1777 * Displays the Site Health Status widget. 1778 * 1779 * @since 5.4.0 1780 */ 1781 function wp_dashboard_site_health() { 1782 $get_issues = get_transient( 'health-check-site-status-result' ); 1783 1784 $issue_counts = array(); 1785 1786 if ( false !== $get_issues ) { 1787 $issue_counts = json_decode( $get_issues, true ); 1788 } 1789 1790 if ( ! is_array( $issue_counts ) || ! $issue_counts ) { 1791 $issue_counts = array( 1792 'good' => 0, 1793 'recommended' => 0, 1794 'critical' => 0, 1795 ); 1796 } 1797 1798 $issues_total = $issue_counts['recommended'] + $issue_counts['critical']; 1799 ?> 1800 <div class="health-check-title-section site-health-progress-wrapper loading hide-if-no-js"> 1801 <div class="site-health-progress"> 1802 <svg role="img" aria-hidden="true" focusable="false" width="100%" height="100%" viewBox="0 0 200 200" version="1.1" xmlns="http://www.w3.org/2000/svg"> 1803 <circle r="90" cx="100" cy="100" fill="transparent" stroke-dasharray="565.48" stroke-dashoffset="0"></circle> 1804 <circle id="bar" r="90" cx="100" cy="100" fill="transparent" stroke-dasharray="565.48" stroke-dashoffset="0"></circle> 1805 </svg> 1806 </div> 1807 <div class="site-health-progress-label"> 1808 <?php if ( false === $get_issues ) : ?> 1809 <?php _e( 'No information yet…' ); ?> 1810 <?php else : ?> 1811 <?php _e( 'Results are still loading…' ); ?> 1812 <?php endif; ?> 1813 </div> 1814 </div> 1815 1816 <?php if ( false === $get_issues ) : ?> 1817 <p> 1818 <?php 1819 printf( 1820 /* translators: %s: URL to Site Health screen. */ 1821 __( 'Site health checks will automatically run periodically to gather information about your site. You can also <a href="%s">visit the Site Health screen</a> to gather information about your site now.' ), 1822 esc_url( admin_url( 'site-health.php' ) ) 1823 ); 1824 ?> 1825 </p> 1826 <?php else : ?> 1827 <p> 1828 <?php if ( $issue_counts['critical'] > 0 ) : ?> 1829 <?php _e( 'Your site has critical issues that should be addressed as soon as possible to improve its performance and security.' ); ?> 1830 <?php elseif ( $issues_total <= 0 ) : ?> 1831 <?php _e( 'Great job! Your site currently passes all site health checks.' ); ?> 1832 <?php else : ?> 1833 <?php _e( 'Your site’s health is looking good, but there are still some things you can do to improve its performance and security.' ); ?> 1834 <?php endif; ?> 1835 </p> 1836 <?php endif; ?> 1837 1838 <?php if ( $issues_total > 0 && false !== $get_issues ) : ?> 1839 <p> 1840 <?php 1841 printf( 1842 /* translators: 1: Number of issues. 2: URL to Site Health screen. */ 1843 _n( 1844 'Take a look at the <strong>%1$d item</strong> on the <a href="%2$s">Site Health screen</a>.', 1845 'Take a look at the <strong>%1$d items</strong> on the <a href="%2$s">Site Health screen</a>.', 1846 $issues_total 1847 ), 1848 $issues_total, 1849 esc_url( admin_url( 'site-health.php' ) ) 1850 ); 1851 ?> 1852 </p> 1853 <?php endif; ?> 1854 1855 <?php 1856 } 1857 1858 /** 1859 * Empty function usable by plugins to output empty dashboard widget (to be populated later by JS). 1860 * 1861 * @since 2.5.0 1862 */ 1863 function wp_dashboard_empty() {} 1864 1865 /** 1866 * Displays a welcome panel to introduce users to WordPress. 1867 * 1868 * @since 3.3.0 1869 */ 1870 function wp_welcome_panel() { 1871 ?> 1872 <div class="welcome-panel-content"> 1873 <h2><?php _e( 'Welcome to WordPress!' ); ?></h2> 1874 <p class="about-description"><?php _e( 'We’ve assembled some links to get you started:' ); ?></p> 1875 <div class="welcome-panel-column-container"> 1876 <div class="welcome-panel-column"> 1877 <?php if ( current_user_can( 'customize' ) ) : ?> 1878 <h3><?php _e( 'Get Started' ); ?></h3> 1879 <a class="button button-primary button-hero load-customize hide-if-no-customize" href="<?php echo wp_customize_url(); ?>"><?php _e( 'Customize Your Site' ); ?></a> 1880 <?php endif; ?> 1881 <a class="button button-primary button-hero hide-if-customize" href="<?php echo admin_url( 'themes.php' ); ?>"><?php _e( 'Customize Your Site' ); ?></a> 1882 <?php if ( current_user_can( 'install_themes' ) || ( current_user_can( 'switch_themes' ) && count( wp_get_themes( array( 'allowed' => true ) ) ) > 1 ) ) : ?> 1883 <?php $themes_link = current_user_can( 'customize' ) ? add_query_arg( 'autofocus[panel]', 'themes', admin_url( 'customize.php' ) ) : admin_url( 'themes.php' ); ?> 1884 <p class="hide-if-no-customize"> 1885 <?php 1886 /* translators: %s: URL to Themes panel in Customizer or Themes screen. */ 1887 printf( __( 'or, <a href="%s">change your theme completely</a>' ), $themes_link ); 1888 ?> 1889 </p> 1890 <?php endif; ?> 1891 </div> 1892 <div class="welcome-panel-column"> 1893 <h3><?php _e( 'Next Steps' ); ?></h3> 1894 <ul> 1895 <?php if ( 'page' == get_option( 'show_on_front' ) && ! get_option( 'page_for_posts' ) ) : ?> 1896 <li><?php printf( '<a href="%s" class="welcome-icon welcome-edit-page">' . __( 'Edit your front page' ) . '</a>', get_edit_post_link( get_option( 'page_on_front' ) ) ); ?></li> 1897 <li><?php printf( '<a href="%s" class="welcome-icon welcome-add-page">' . __( 'Add additional pages' ) . '</a>', admin_url( 'post-new.php?post_type=page' ) ); ?></li> 1898 <?php elseif ( 'page' == get_option( 'show_on_front' ) ) : ?> 1899 <li><?php printf( '<a href="%s" class="welcome-icon welcome-edit-page">' . __( 'Edit your front page' ) . '</a>', get_edit_post_link( get_option( 'page_on_front' ) ) ); ?></li> 1900 <li><?php printf( '<a href="%s" class="welcome-icon welcome-add-page">' . __( 'Add additional pages' ) . '</a>', admin_url( 'post-new.php?post_type=page' ) ); ?></li> 1901 <li><?php printf( '<a href="%s" class="welcome-icon welcome-write-blog">' . __( 'Add a blog post' ) . '</a>', admin_url( 'post-new.php' ) ); ?></li> 1902 <?php else : ?> 1903 <li><?php printf( '<a href="%s" class="welcome-icon welcome-write-blog">' . __( 'Write your first blog post' ) . '</a>', admin_url( 'post-new.php' ) ); ?></li> 1904 <li><?php printf( '<a href="%s" class="welcome-icon welcome-add-page">' . __( 'Add an About page' ) . '</a>', admin_url( 'post-new.php?post_type=page' ) ); ?></li> 1905 <li><?php printf( '<a href="%s" class="welcome-icon welcome-setup-home">' . __( 'Set up your homepage' ) . '</a>', current_user_can( 'customize' ) ? add_query_arg( 'autofocus[section]', 'static_front_page', admin_url( 'customize.php' ) ) : admin_url( 'options-reading.php' ) ); ?></li> 1906 <?php endif; ?> 1907 <li><?php printf( '<a href="%s" class="welcome-icon welcome-view-site">' . __( 'View your site' ) . '</a>', home_url( '/' ) ); ?></li> 1908 </ul> 1909 </div> 1910 <div class="welcome-panel-column welcome-panel-last"> 1911 <h3><?php _e( 'More Actions' ); ?></h3> 1912 <ul> 1913 <?php if ( current_theme_supports( 'widgets' ) ) : ?> 1914 <li><?php printf( '<a href="%s" class="welcome-icon welcome-widgets">' . __( 'Manage widgets' ) . '</a>', admin_url( 'widgets.php' ) ); ?></li> 1915 <?php endif; ?> 1916 <?php if ( current_theme_supports( 'menus' ) ) : ?> 1917 <li><?php printf( '<a href="%s" class="welcome-icon welcome-menus">' . __( 'Manage menus' ) . '</a>', admin_url( 'nav-menus.php' ) ); ?></li> 1918 <?php endif; ?> 1919 <?php if ( current_user_can( 'manage_options' ) ) : ?> 1920 <li><?php printf( '<a href="%s" class="welcome-icon welcome-comments">' . __( 'Turn comments on or off' ) . '</a>', admin_url( 'options-discussion.php' ) ); ?></li> 1921 <?php endif; ?> 1922 <li><?php printf( '<a href="%s" class="welcome-icon welcome-learn-more">' . __( 'Learn more about getting started' ) . '</a>', __( 'https://wordpress.org/support/article/first-steps-with-wordpress-b/' ) ); ?></li> 1923 </ul> 1924 </div> 1925 </div> 1926 </div> 1927 <?php 1928 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated : Wed Apr 8 08:20:02 2020 | Cross-referenced by PHPXref |