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