[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-admin/includes/ -> dashboard.php (source)

   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&#8217;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 &#8220;%s&#8221;' ), $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          $del_nonce     = esc_html( '_wpnonce=' . wp_create_nonce( "delete-comment_$comment->comment_ID" ) );
 730          $approve_nonce = esc_html( '_wpnonce=' . wp_create_nonce( "approve-comment_$comment->comment_ID" ) );
 731  
 732          $approve_url   = esc_url( "comment.php?action=approvecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$approve_nonce" );
 733          $unapprove_url = esc_url( "comment.php?action=unapprovecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$approve_nonce" );
 734          $spam_url      = esc_url( "comment.php?action=spamcomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" );
 735          $trash_url     = esc_url( "comment.php?action=trashcomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" );
 736          $delete_url    = esc_url( "comment.php?action=deletecomment&p=$comment->comment_post_ID&c=$comment->comment_ID&$del_nonce" );
 737  
 738          $actions['approve'] = sprintf(
 739              '<a href="%s" data-wp-lists="%s" class="vim-a aria-button-if-js" aria-label="%s">%s</a>',
 740              $approve_url,
 741              "dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=approved",
 742              esc_attr__( 'Approve this comment' ),
 743              __( 'Approve' )
 744          );
 745  
 746          $actions['unapprove'] = sprintf(
 747              '<a href="%s" data-wp-lists="%s" class="vim-u aria-button-if-js" aria-label="%s">%s</a>',
 748              $unapprove_url,
 749              "dim:the-comment-list:comment-{$comment->comment_ID}:unapproved:e7e7d3:e7e7d3:new=unapproved",
 750              esc_attr__( 'Unapprove this comment' ),
 751              __( 'Unapprove' )
 752          );
 753  
 754          $actions['edit'] = sprintf(
 755              '<a href="%s" aria-label="%s">%s</a>',
 756              "comment.php?action=editcomment&amp;c={$comment->comment_ID}",
 757              esc_attr__( 'Edit this comment' ),
 758              __( 'Edit' )
 759          );
 760  
 761          $actions['reply'] = sprintf(
 762              '<button type="button" onclick="window.commentReply && commentReply.open(\'%s\',\'%s\');" class="vim-r button-link hide-if-no-js" aria-label="%s">%s</button>',
 763              $comment->comment_ID,
 764              $comment->comment_post_ID,
 765              esc_attr__( 'Reply to this comment' ),
 766              __( 'Reply' )
 767          );
 768  
 769          $actions['spam'] = sprintf(
 770              '<a href="%s" data-wp-lists="%s" class="vim-s vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
 771              $spam_url,
 772              "delete:the-comment-list:comment-{$comment->comment_ID}::spam=1",
 773              esc_attr__( 'Mark this comment as spam' ),
 774              /* translators: "Mark as spam" link. */
 775              _x( 'Spam', 'verb' )
 776          );
 777  
 778          if ( ! EMPTY_TRASH_DAYS ) {
 779              $actions['delete'] = sprintf(
 780                  '<a href="%s" data-wp-lists="%s" class="delete vim-d vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
 781                  $delete_url,
 782                  "delete:the-comment-list:comment-{$comment->comment_ID}::trash=1",
 783                  esc_attr__( 'Delete this comment permanently' ),
 784                  __( 'Delete Permanently' )
 785              );
 786          } else {
 787              $actions['trash'] = sprintf(
 788                  '<a href="%s" data-wp-lists="%s" class="delete vim-d vim-destructive aria-button-if-js" aria-label="%s">%s</a>',
 789                  $trash_url,
 790                  "delete:the-comment-list:comment-{$comment->comment_ID}::trash=1",
 791                  esc_attr__( 'Move this comment to the Trash' ),
 792                  _x( 'Trash', 'verb' )
 793              );
 794          }
 795  
 796          $actions['view'] = sprintf(
 797              '<a class="comment-link" href="%s" aria-label="%s">%s</a>',
 798              esc_url( get_comment_link( $comment ) ),
 799              esc_attr__( 'View this comment' ),
 800              __( 'View' )
 801          );
 802  
 803          /**
 804           * Filters the action links displayed for each comment in the 'Recent Comments'
 805           * dashboard widget.
 806           *
 807           * @since 2.6.0
 808           *
 809           * @param string[]   $actions An array of comment actions. Default actions include:
 810           *                            'Approve', 'Unapprove', 'Edit', 'Reply', 'Spam',
 811           *                            'Delete', and 'Trash'.
 812           * @param WP_Comment $comment The comment object.
 813           */
 814          $actions = apply_filters( 'comment_row_actions', array_filter( $actions ), $comment );
 815  
 816          $i = 0;
 817  
 818          foreach ( $actions as $action => $link ) {
 819              ++$i;
 820  
 821              if ( ( ( 'approve' === $action || 'unapprove' === $action ) && 2 === $i )
 822                  || 1 === $i
 823              ) {
 824                  $separator = '';
 825              } else {
 826                  $separator = ' | ';
 827              }
 828  
 829              // Reply and quickedit need a hide-if-no-js span.
 830              if ( 'reply' === $action || 'quickedit' === $action ) {
 831                  $action .= ' hide-if-no-js';
 832              }
 833  
 834              if ( 'view' === $action && '1' !== $comment->comment_approved ) {
 835                  $action .= ' hidden';
 836              }
 837  
 838              $actions_string .= "<span class='$action'>{$separator}{$link}</span>";
 839          }
 840      }
 841      ?>
 842  
 843          <li id="comment-<?php echo $comment->comment_ID; ?>" <?php comment_class( array( 'comment-item', wp_get_comment_status( $comment ) ), $comment ); ?>>
 844  
 845              <?php
 846              $comment_row_class = '';
 847  
 848              if ( get_option( 'show_avatars' ) ) {
 849                  echo get_avatar( $comment, 50, 'mystery' );
 850                  $comment_row_class .= ' has-avatar';
 851              }
 852              ?>
 853  
 854              <?php if ( ! $comment->comment_type || 'comment' === $comment->comment_type ) : ?>
 855  
 856              <div class="dashboard-comment-wrap has-row-actions <?php echo $comment_row_class; ?>">
 857              <p class="comment-meta">
 858                  <?php
 859                  // Comments might not have a post they relate to, e.g. programmatically created ones.
 860                  if ( $comment_post_link ) {
 861                      printf(
 862                          /* translators: 1: Comment author, 2: Post link, 3: Notification if the comment is pending. */
 863                          __( 'From %1$s on %2$s %3$s' ),
 864                          '<cite class="comment-author">' . get_comment_author_link( $comment ) . '</cite>',
 865                          $comment_post_link,
 866                          '<span class="approve">' . __( '[Pending]' ) . '</span>'
 867                      );
 868                  } else {
 869                      printf(
 870                          /* translators: 1: Comment author, 2: Notification if the comment is pending. */
 871                          __( 'From %1$s %2$s' ),
 872                          '<cite class="comment-author">' . get_comment_author_link( $comment ) . '</cite>',
 873                          '<span class="approve">' . __( '[Pending]' ) . '</span>'
 874                      );
 875                  }
 876                  ?>
 877              </p>
 878  
 879                  <?php
 880              else :
 881                  switch ( $comment->comment_type ) {
 882                      case 'pingback':
 883                          $type = __( 'Pingback' );
 884                          break;
 885                      case 'trackback':
 886                          $type = __( 'Trackback' );
 887                          break;
 888                      default:
 889                          $type = ucwords( $comment->comment_type );
 890                  }
 891                  $type = esc_html( $type );
 892                  ?>
 893              <div class="dashboard-comment-wrap has-row-actions">
 894              <p class="comment-meta">
 895                  <?php
 896                  // Pingbacks, Trackbacks or custom comment types might not have a post they relate to, e.g. programmatically created ones.
 897                  if ( $comment_post_link ) {
 898                      printf(
 899                          /* translators: 1: Type of comment, 2: Post link, 3: Notification if the comment is pending. */
 900                          _x( '%1$s on %2$s %3$s', 'dashboard' ),
 901                          "<strong>$type</strong>",
 902                          $comment_post_link,
 903                          '<span class="approve">' . __( '[Pending]' ) . '</span>'
 904                      );
 905                  } else {
 906                      printf(
 907                          /* translators: 1: Type of comment, 2: Notification if the comment is pending. */
 908                          _x( '%1$s %2$s', 'dashboard' ),
 909                          "<strong>$type</strong>",
 910                          '<span class="approve">' . __( '[Pending]' ) . '</span>'
 911                      );
 912                  }
 913                  ?>
 914              </p>
 915              <p class="comment-author"><?php comment_author_link( $comment ); ?></p>
 916  
 917              <?php endif; // comment_type ?>
 918              <blockquote><p><?php comment_excerpt( $comment ); ?></p></blockquote>
 919              <?php if ( $actions_string ) : ?>
 920              <p class="row-actions"><?php echo $actions_string; ?></p>
 921              <?php endif; ?>
 922              </div>
 923          </li>
 924      <?php
 925      $GLOBALS['comment'] = null;
 926  }
 927  
 928  /**
 929   * Outputs the Activity widget.
 930   *
 931   * Callback function for {@see 'dashboard_activity'}.
 932   *
 933   * @since 3.8.0
 934   */
 935  function wp_dashboard_site_activity() {
 936  
 937      echo '<div id="activity-widget">';
 938  
 939      $future_posts = wp_dashboard_recent_posts(
 940          array(
 941              'max'    => 5,
 942              'status' => 'future',
 943              'order'  => 'ASC',
 944              'title'  => __( 'Publishing Soon' ),
 945              'id'     => 'future-posts',
 946          )
 947      );
 948      $recent_posts = wp_dashboard_recent_posts(
 949          array(
 950              'max'    => 5,
 951              'status' => 'publish',
 952              'order'  => 'DESC',
 953              'title'  => __( 'Recently Published' ),
 954              'id'     => 'published-posts',
 955          )
 956      );
 957  
 958      $recent_comments = wp_dashboard_recent_comments();
 959  
 960      if ( ! $future_posts && ! $recent_posts && ! $recent_comments ) {
 961          echo '<div class="no-activity">';
 962          echo '<p>' . __( 'No activity yet!' ) . '</p>';
 963          echo '</div>';
 964      }
 965  
 966      echo '</div>';
 967  }
 968  
 969  /**
 970   * Generates Publishing Soon and Recently Published sections.
 971   *
 972   * @since 3.8.0
 973   *
 974   * @param array $args {
 975   *     An array of query and display arguments.
 976   *
 977   *     @type int    $max     Number of posts to display.
 978   *     @type string $status  Post status.
 979   *     @type string $order   Designates ascending ('ASC') or descending ('DESC') order.
 980   *     @type string $title   Section title.
 981   *     @type string $id      The container id.
 982   * }
 983   * @return bool False if no posts were found. True otherwise.
 984   */
 985  function wp_dashboard_recent_posts( $args ) {
 986      $query_args = array(
 987          'post_type'      => 'post',
 988          'post_status'    => $args['status'],
 989          'orderby'        => 'date',
 990          'order'          => $args['order'],
 991          'posts_per_page' => (int) $args['max'],
 992          'no_found_rows'  => true,
 993          'cache_results'  => true,
 994          'perm'           => ( 'future' === $args['status'] ) ? 'editable' : 'readable',
 995      );
 996  
 997      /**
 998       * Filters the query arguments used for the Recent Posts widget.
 999       *
1000       * @since 4.2.0
1001       *
1002       * @param array $query_args The arguments passed to WP_Query to produce the list of posts.
1003       */
1004      $query_args = apply_filters( 'dashboard_recent_posts_query_args', $query_args );
1005  
1006      $posts = new WP_Query( $query_args );
1007  
1008      if ( $posts->have_posts() ) {
1009  
1010          echo '<div id="' . $args['id'] . '" class="activity-block">';
1011  
1012          echo '<h3>' . $args['title'] . '</h3>';
1013  
1014          echo '<ul>';
1015  
1016          $today    = current_time( 'Y-m-d' );
1017          $tomorrow = current_datetime()->modify( '+1 day' )->format( 'Y-m-d' );
1018          $year     = current_time( 'Y' );
1019  
1020          while ( $posts->have_posts() ) {
1021              $posts->the_post();
1022  
1023              $time = get_the_time( 'U' );
1024  
1025              if ( gmdate( 'Y-m-d', $time ) === $today ) {
1026                  $relative = __( 'Today' );
1027              } elseif ( gmdate( 'Y-m-d', $time ) === $tomorrow ) {
1028                  $relative = __( 'Tomorrow' );
1029              } elseif ( gmdate( 'Y', $time ) !== $year ) {
1030                  /* 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 */
1031                  $relative = date_i18n( __( 'M jS Y' ), $time );
1032              } else {
1033                  /* translators: Date and time format for recent posts on the dashboard, see https://www.php.net/manual/datetime.format.php */
1034                  $relative = date_i18n( __( 'M jS' ), $time );
1035              }
1036  
1037              // Use the post edit link for those who can edit, the permalink otherwise.
1038              $recent_post_link = current_user_can( 'edit_post', get_the_ID() ) ? get_edit_post_link() : get_permalink();
1039  
1040              $draft_or_post_title = _draft_or_post_title();
1041              printf(
1042                  '<li><span>%1$s</span> <a href="%2$s" aria-label="%3$s">%4$s</a></li>',
1043                  /* translators: 1: Relative date, 2: Time. */
1044                  sprintf( _x( '%1$s, %2$s', 'dashboard' ), $relative, get_the_time() ),
1045                  $recent_post_link,
1046                  /* translators: %s: Post title. */
1047                  esc_attr( sprintf( __( 'Edit &#8220;%s&#8221;' ), $draft_or_post_title ) ),
1048                  $draft_or_post_title
1049              );
1050          }
1051  
1052          echo '</ul>';
1053          echo '</div>';
1054  
1055      } else {
1056          return false;
1057      }
1058  
1059      wp_reset_postdata();
1060  
1061      return true;
1062  }
1063  
1064  /**
1065   * Show Comments section.
1066   *
1067   * @since 3.8.0
1068   *
1069   * @param int $total_items Optional. Number of comments to query. Default 5.
1070   * @return bool False if no comments were found. True otherwise.
1071   */
1072  function wp_dashboard_recent_comments( $total_items = 5 ) {
1073      // Select all comment types and filter out spam later for better query performance.
1074      $comments = array();
1075  
1076      $comments_query = array(
1077          'number' => $total_items * 5,
1078          'offset' => 0,
1079      );
1080  
1081      if ( ! current_user_can( 'edit_posts' ) ) {
1082          $comments_query['status'] = 'approve';
1083      }
1084  
1085      while ( count( $comments ) < $total_items && $possible = get_comments( $comments_query ) ) {
1086          if ( ! is_array( $possible ) ) {
1087              break;
1088          }
1089  
1090          foreach ( $possible as $comment ) {
1091              if ( ! current_user_can( 'edit_post', $comment->comment_post_ID )
1092                  && ( post_password_required( $comment->comment_post_ID )
1093                      || ! current_user_can( 'read_post', $comment->comment_post_ID ) )
1094              ) {
1095                  // The user has no access to the post and thus cannot see the comments.
1096                  continue;
1097              }
1098  
1099              $comments[] = $comment;
1100  
1101              if ( count( $comments ) === $total_items ) {
1102                  break 2;
1103              }
1104          }
1105  
1106          $comments_query['offset'] += $comments_query['number'];
1107          $comments_query['number']  = $total_items * 10;
1108      }
1109  
1110      if ( $comments ) {
1111          echo '<div id="latest-comments" class="activity-block table-view-list">';
1112          echo '<h3>' . __( 'Recent Comments' ) . '</h3>';
1113  
1114          echo '<ul id="the-comment-list" data-wp-lists="list:comment">';
1115          foreach ( $comments as $comment ) {
1116              _wp_dashboard_recent_comments_row( $comment );
1117          }
1118          echo '</ul>';
1119  
1120          if ( current_user_can( 'edit_posts' ) ) {
1121              echo '<h3 class="screen-reader-text">' .
1122                  /* translators: Hidden accessibility text. */
1123                  __( 'View more comments' ) .
1124              '</h3>';
1125              _get_list_table( 'WP_Comments_List_Table' )->views();
1126          }
1127  
1128          wp_comment_reply( -1, false, 'dashboard', false );
1129          wp_comment_trashnotice();
1130  
1131          echo '</div>';
1132      } else {
1133          return false;
1134      }
1135      return true;
1136  }
1137  
1138  /**
1139   * Display generic dashboard RSS widget feed.
1140   *
1141   * @since 2.5.0
1142   *
1143   * @param string $widget_id
1144   */
1145  function wp_dashboard_rss_output( $widget_id ) {
1146      $widgets = get_option( 'dashboard_widget_options' );
1147      echo '<div class="rss-widget">';
1148      wp_widget_rss_output( $widgets[ $widget_id ] );
1149      echo '</div>';
1150  }
1151  
1152  /**
1153   * Checks to see if all of the feed url in $check_urls are cached.
1154   *
1155   * If $check_urls is empty, look for the rss feed url found in the dashboard
1156   * widget options of $widget_id. If cached, call $callback, a function that
1157   * echoes out output for this widget. If not cache, echo a "Loading..." stub
1158   * which is later replaced by Ajax call (see top of /wp-admin/index.php)
1159   *
1160   * @since 2.5.0
1161   * @since 5.3.0 Formalized the existing and already documented `...$args` parameter
1162   *              by adding it to the function signature.
1163   *
1164   * @param string   $widget_id  The widget ID.
1165   * @param callable $callback   The callback function used to display each feed.
1166   * @param array    $check_urls RSS feeds.
1167   * @param mixed    ...$args    Optional additional parameters to pass to the callback function.
1168   * @return bool True on success, false on failure.
1169   */
1170  function wp_dashboard_cached_rss_widget( $widget_id, $callback, $check_urls = array(), ...$args ) {
1171      $doing_ajax = wp_doing_ajax();
1172      $loading    = '<p class="widget-loading hide-if-no-js">' . __( 'Loading&hellip;' ) . '</p>';
1173      $loading   .= wp_get_admin_notice(
1174          __( 'This widget requires JavaScript.' ),
1175          array(
1176              'type'               => 'error',
1177              'additional_classes' => array( 'inline', 'hide-if-js' ),
1178          )
1179      );
1180  
1181      if ( empty( $check_urls ) ) {
1182          $widgets = get_option( 'dashboard_widget_options' );
1183  
1184          if ( empty( $widgets[ $widget_id ]['url'] ) && ! $doing_ajax ) {
1185              echo $loading;
1186              return false;
1187          }
1188  
1189          $check_urls = array( $widgets[ $widget_id ]['url'] );
1190      }
1191  
1192      $locale    = get_user_locale();
1193      $cache_key = 'dash_v2_' . md5( $widget_id . '_' . $locale );
1194      $output    = get_transient( $cache_key );
1195  
1196      if ( false !== $output ) {
1197          echo $output;
1198          return true;
1199      }
1200  
1201      if ( ! $doing_ajax ) {
1202          echo $loading;
1203          return false;
1204      }
1205  
1206      if ( $callback && is_callable( $callback ) ) {
1207          array_unshift( $args, $widget_id, $check_urls );
1208          ob_start();
1209          call_user_func_array( $callback, $args );
1210          // Default lifetime in cache of 12 hours (same as the feeds).
1211          set_transient( $cache_key, ob_get_flush(), 12 * HOUR_IN_SECONDS );
1212      }
1213  
1214      return true;
1215  }
1216  
1217  //
1218  // Dashboard Widgets Controls.
1219  //
1220  
1221  /**
1222   * Calls widget control callback.
1223   *
1224   * @since 2.5.0
1225   *
1226   * @global callable[] $wp_dashboard_control_callbacks
1227   *
1228   * @param int|false $widget_control_id Optional. Registered widget ID. Default false.
1229   */
1230  function wp_dashboard_trigger_widget_control( $widget_control_id = false ) {
1231      global $wp_dashboard_control_callbacks;
1232  
1233      if ( is_scalar( $widget_control_id ) && $widget_control_id
1234          && isset( $wp_dashboard_control_callbacks[ $widget_control_id ] )
1235          && is_callable( $wp_dashboard_control_callbacks[ $widget_control_id ] )
1236      ) {
1237          call_user_func(
1238              $wp_dashboard_control_callbacks[ $widget_control_id ],
1239              '',
1240              array(
1241                  'id'       => $widget_control_id,
1242                  'callback' => $wp_dashboard_control_callbacks[ $widget_control_id ],
1243              )
1244          );
1245      }
1246  }
1247  
1248  /**
1249   * Sets up the RSS dashboard widget control and $args to be used as input to wp_widget_rss_form().
1250   *
1251   * Handles POST data from RSS-type widgets.
1252   *
1253   * @since 2.5.0
1254   *
1255   * @param string $widget_id
1256   * @param array  $form_inputs
1257   */
1258  function wp_dashboard_rss_control( $widget_id, $form_inputs = array() ) {
1259      $widget_options = get_option( 'dashboard_widget_options' );
1260  
1261      if ( ! $widget_options ) {
1262          $widget_options = array();
1263      }
1264  
1265      if ( ! isset( $widget_options[ $widget_id ] ) ) {
1266          $widget_options[ $widget_id ] = array();
1267      }
1268  
1269      $number = 1; // Hack to use wp_widget_rss_form().
1270  
1271      $widget_options[ $widget_id ]['number'] = $number;
1272  
1273      if ( 'POST' === $_SERVER['REQUEST_METHOD'] && isset( $_POST['widget-rss'][ $number ] ) ) {
1274          $_POST['widget-rss'][ $number ]         = wp_unslash( $_POST['widget-rss'][ $number ] );
1275          $widget_options[ $widget_id ]           = wp_widget_rss_process( $_POST['widget-rss'][ $number ] );
1276          $widget_options[ $widget_id ]['number'] = $number;
1277  
1278          // Title is optional. If black, fill it if possible.
1279          if ( ! $widget_options[ $widget_id ]['title'] && isset( $_POST['widget-rss'][ $number ]['title'] ) ) {
1280              $rss = fetch_feed( $widget_options[ $widget_id ]['url'] );
1281              if ( is_wp_error( $rss ) ) {
1282                  $widget_options[ $widget_id ]['title'] = htmlentities( __( 'Unknown Feed' ) );
1283              } else {
1284                  $widget_options[ $widget_id ]['title'] = htmlentities( strip_tags( $rss->get_title() ) );
1285                  $rss->__destruct();
1286                  unset( $rss );
1287              }
1288          }
1289  
1290          update_option( 'dashboard_widget_options', $widget_options );
1291  
1292          $locale    = get_user_locale();
1293          $cache_key = 'dash_v2_' . md5( $widget_id . '_' . $locale );
1294          delete_transient( $cache_key );
1295      }
1296  
1297      wp_widget_rss_form( $widget_options[ $widget_id ], $form_inputs );
1298  }
1299  
1300  
1301  /**
1302   * Renders the Events and News dashboard widget.
1303   *
1304   * @since 4.8.0
1305   */
1306  function wp_dashboard_events_news() {
1307      wp_print_community_events_markup();
1308  
1309      ?>
1310  
1311      <div class="wordpress-news hide-if-no-js">
1312          <?php wp_dashboard_primary(); ?>
1313      </div>
1314  
1315      <p class="community-events-footer">
1316          <?php
1317              printf(
1318                  '<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>',
1319                  'https://make.wordpress.org/community/meetups-landing-page',
1320                  __( 'Meetups' ),
1321                  /* translators: Hidden accessibility text. */
1322                  __( '(opens in a new tab)' )
1323              );
1324          ?>
1325  
1326          |
1327  
1328          <?php
1329              printf(
1330                  '<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>',
1331                  'https://central.wordcamp.org/schedule/',
1332                  __( 'WordCamps' ),
1333                  /* translators: Hidden accessibility text. */
1334                  __( '(opens in a new tab)' )
1335              );
1336          ?>
1337  
1338          |
1339  
1340          <?php
1341              printf(
1342                  '<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>',
1343                  /* translators: If a Rosetta site exists (e.g. https://es.wordpress.org/news/), then use that. Otherwise, leave untranslated. */
1344                  esc_url( _x( 'https://wordpress.org/news/', 'Events and News dashboard widget' ) ),
1345                  __( 'News' ),
1346                  /* translators: Hidden accessibility text. */
1347                  __( '(opens in a new tab)' )
1348              );
1349          ?>
1350      </p>
1351  
1352      <?php
1353  }
1354  
1355  /**
1356   * Prints the markup for the Community Events section of the Events and News Dashboard widget.
1357   *
1358   * @since 4.8.0
1359   */
1360  function wp_print_community_events_markup() {
1361      $community_events_notice  = '<p class="hide-if-js">' . ( 'This widget requires JavaScript.' ) . '</p>';
1362      $community_events_notice .= '<p class="community-events-error-occurred" aria-hidden="true">' . __( 'An error occurred. Please try again.' ) . '</p>';
1363      $community_events_notice .= '<p class="community-events-could-not-locate" aria-hidden="true"></p>';
1364  
1365      wp_admin_notice(
1366          $community_events_notice,
1367          array(
1368              'type'               => 'error',
1369              'additional_classes' => array( 'community-events-errors', 'inline', 'hide-if-js' ),
1370              'paragraph_wrap'     => false,
1371          )
1372      );
1373  
1374      /*
1375       * Hide the main element when the page first loads, because the content
1376       * won't be ready until wp.communityEvents.renderEventsTemplate() has run.
1377       */
1378      ?>
1379      <div id="community-events" class="community-events" aria-hidden="true">
1380          <div class="activity-block">
1381              <p>
1382                  <span id="community-events-location-message"></span>
1383  
1384                  <button class="button-link community-events-toggle-location" aria-expanded="false">
1385                      <span class="dashicons dashicons-location" aria-hidden="true"></span>
1386                      <span class="community-events-location-edit"><?php _e( 'Select location' ); ?></span>
1387                  </button>
1388              </p>
1389  
1390              <form class="community-events-form" aria-hidden="true" action="<?php echo esc_url( admin_url( 'admin-ajax.php' ) ); ?>" method="post">
1391                  <label for="community-events-location">
1392                      <?php _e( 'City:' ); ?>
1393                  </label>
1394                  <?php
1395                  /* translators: Replace with a city related to your locale.
1396                   * Test that it matches the expected location and has upcoming
1397                   * events before including it. If no cities related to your
1398                   * locale have events, then use a city related to your locale
1399                   * that would be recognizable to most users. Use only the city
1400                   * name itself, without any region or country. Use the endonym
1401                   * (native locale name) instead of the English name if possible.
1402                   */
1403                  ?>
1404                  <input id="community-events-location" class="regular-text" type="text" name="community-events-location" placeholder="<?php esc_attr_e( 'Cincinnati' ); ?>" />
1405  
1406                  <?php submit_button( __( 'Submit' ), 'secondary', 'community-events-submit', false ); ?>
1407  
1408                  <button class="community-events-cancel button-link" type="button" aria-expanded="false">
1409                      <?php _e( 'Cancel' ); ?>
1410                  </button>
1411  
1412                  <span class="spinner"></span>
1413              </form>
1414          </div>
1415  
1416          <ul class="community-events-results activity-block last"></ul>
1417      </div>
1418  
1419      <?php
1420  }
1421  
1422  /**
1423   * Renders the events templates for the Event and News widget.
1424   *
1425   * @since 4.8.0
1426   */
1427  function wp_print_community_events_templates() {
1428      ?>
1429  
1430      <script id="tmpl-community-events-attend-event-near" type="text/template">
1431          <?php
1432          printf(
1433              /* translators: %s: The name of a city. */
1434              __( 'Attend an upcoming event near %s.' ),
1435              '<strong>{{ data.location.description }}</strong>'
1436          );
1437          ?>
1438      </script>
1439  
1440      <script id="tmpl-community-events-could-not-locate" type="text/template">
1441          <?php
1442          printf(
1443              /* translators: %s is the name of the city we couldn't locate.
1444               * Replace the examples with cities in your locale, but test
1445               * that they match the expected location before including them.
1446               * Use endonyms (native locale names) whenever possible.
1447               */
1448              __( '%s could not be located. Please try another nearby city. For example: Kansas City; Springfield; Portland.' ),
1449              '<em>{{data.unknownCity}}</em>'
1450          );
1451          ?>
1452      </script>
1453  
1454      <script id="tmpl-community-events-event-list" type="text/template">
1455          <# _.each( data.events, function( event ) { #>
1456              <li class="event event-{{ event.type }} wp-clearfix">
1457                  <div class="event-info">
1458                      <div class="dashicons event-icon" aria-hidden="true"></div>
1459                      <div class="event-info-inner">
1460                          <a class="event-title" href="{{ event.url }}">{{ event.title }}</a>
1461                          <# if ( event.type ) {
1462                              const titleCaseEventType = event.type.replace(
1463                                  /\w\S*/g,
1464                                  function ( type ) { return type.charAt(0).toUpperCase() + type.substr(1).toLowerCase(); }
1465                              );
1466                          #>
1467                              {{ 'wordcamp' === event.type ? 'WordCamp' : titleCaseEventType }}
1468                              <span class="ce-separator"></span>
1469                          <# } #>
1470                          <span class="event-city">{{ event.location.location }}</span>
1471                      </div>
1472                  </div>
1473  
1474                  <div class="event-date-time">
1475                      <span class="event-date">{{ event.user_formatted_date }}</span>
1476                      <# if ( 'meetup' === event.type ) { #>
1477                          <span class="event-time">
1478                              {{ event.user_formatted_time }} {{ event.timeZoneAbbreviation }}
1479                          </span>
1480                      <# } #>
1481                  </div>
1482              </li>
1483          <# } ) #>
1484  
1485          <# if ( data.events.length <= 2 ) { #>
1486              <li class="event-none">
1487                  <?php
1488                  printf(
1489                      /* translators: %s: Localized meetup organization documentation URL. */
1490                      __( 'Want more events? <a href="%s">Help organize the next one</a>!' ),
1491                      __( 'https://make.wordpress.org/community/organize-event-landing-page/' )
1492                  );
1493                  ?>
1494              </li>
1495          <# } #>
1496  
1497      </script>
1498  
1499      <script id="tmpl-community-events-no-upcoming-events" type="text/template">
1500          <li class="event-none">
1501              <# if ( data.location.description ) { #>
1502                  <?php
1503                  printf(
1504                      /* translators: 1: The city the user searched for, 2: Meetup organization documentation URL. */
1505                      __( 'There are no events scheduled near %1$s at the moment. Would you like to <a href="%2$s">organize a WordPress event</a>?' ),
1506                      '{{ data.location.description }}',
1507                      __( 'https://make.wordpress.org/community/handbook/meetup-organizer/welcome/' )
1508                  );
1509                  ?>
1510  
1511              <# } else { #>
1512                  <?php
1513                  printf(
1514                      /* translators: %s: Meetup organization documentation URL. */
1515                      __( 'There are no events scheduled near you at the moment. Would you like to <a href="%s">organize a WordPress event</a>?' ),
1516                      __( 'https://make.wordpress.org/community/handbook/meetup-organizer/welcome/' )
1517                  );
1518                  ?>
1519              <# } #>
1520          </li>
1521      </script>
1522      <?php
1523  }
1524  
1525  /**
1526   * 'WordPress Events and News' dashboard widget.
1527   *
1528   * @since 2.7.0
1529   * @since 4.8.0 Removed popular plugins feed.
1530   */
1531  function wp_dashboard_primary() {
1532      $feeds = array(
1533          'news'   => array(
1534  
1535              /**
1536               * Filters the primary link URL for the 'WordPress Events and News' dashboard widget.
1537               *
1538               * @since 2.5.0
1539               *
1540               * @param string $link The widget's primary link URL.
1541               */
1542              'link'         => apply_filters( 'dashboard_primary_link', __( 'https://wordpress.org/news/' ) ),
1543  
1544              /**
1545               * Filters the primary feed URL for the 'WordPress Events and News' dashboard widget.
1546               *
1547               * @since 2.3.0
1548               *
1549               * @param string $url The widget's primary feed URL.
1550               */
1551              'url'          => apply_filters( 'dashboard_primary_feed', __( 'https://wordpress.org/news/feed/' ) ),
1552  
1553              /**
1554               * Filters the primary link title for the 'WordPress Events and News' dashboard widget.
1555               *
1556               * @since 2.3.0
1557               *
1558               * @param string $title Title attribute for the widget's primary link.
1559               */
1560              'title'        => apply_filters( 'dashboard_primary_title', __( 'WordPress Blog' ) ),
1561              'items'        => 2,
1562              'show_summary' => 0,
1563              'show_author'  => 0,
1564              'show_date'    => 0,
1565          ),
1566          'planet' => array(
1567  
1568              /**
1569               * Filters the secondary link URL for the 'WordPress Events and News' dashboard widget.
1570               *
1571               * @since 2.3.0
1572               *
1573               * @param string $link The widget's secondary link URL.
1574               */
1575              'link'         => apply_filters(
1576                  'dashboard_secondary_link',
1577                  /* translators: Link to the Planet website of the locale. */
1578                  __( 'https://planet.wordpress.org/' )
1579              ),
1580  
1581              /**
1582               * Filters the secondary feed URL for the 'WordPress Events and News' dashboard widget.
1583               *
1584               * @since 2.3.0
1585               *
1586               * @param string $url The widget's secondary feed URL.
1587               */
1588              'url'          => apply_filters(
1589                  'dashboard_secondary_feed',
1590                  /* translators: Link to the Planet feed of the locale. */
1591                  __( 'https://planet.wordpress.org/feed/' )
1592              ),
1593  
1594              /**
1595               * Filters the secondary link title for the 'WordPress Events and News' dashboard widget.
1596               *
1597               * @since 2.3.0
1598               *
1599               * @param string $title Title attribute for the widget's secondary link.
1600               */
1601              'title'        => apply_filters( 'dashboard_secondary_title', __( 'Other WordPress News' ) ),
1602  
1603              /**
1604               * Filters the number of secondary link items for the 'WordPress Events and News' dashboard widget.
1605               *
1606               * @since 4.4.0
1607               *
1608               * @param string $items How many items to show in the secondary feed.
1609               */
1610              'items'        => apply_filters( 'dashboard_secondary_items', 3 ),
1611              'show_summary' => 0,
1612              'show_author'  => 0,
1613              'show_date'    => 0,
1614          ),
1615      );
1616  
1617      wp_dashboard_cached_rss_widget( 'dashboard_primary', 'wp_dashboard_primary_output', $feeds );
1618  }
1619  
1620  /**
1621   * Displays the WordPress events and news feeds.
1622   *
1623   * @since 3.8.0
1624   * @since 4.8.0 Removed popular plugins feed.
1625   *
1626   * @param string $widget_id Widget ID.
1627   * @param array  $feeds     Array of RSS feeds.
1628   */
1629  function wp_dashboard_primary_output( $widget_id, $feeds ) {
1630      foreach ( $feeds as $type => $args ) {
1631          $args['type'] = $type;
1632          echo '<div class="rss-widget">';
1633              wp_widget_rss_output( $args['url'], $args );
1634          echo '</div>';
1635      }
1636  }
1637  
1638  /**
1639   * Displays file upload quota on dashboard.
1640   *
1641   * Runs on the {@see 'activity_box_end'} hook in wp_dashboard_right_now().
1642   *
1643   * @since 3.0.0
1644   *
1645   * @return true|void True if not multisite, user can't upload files, or the space check option is disabled.
1646   */
1647  function wp_dashboard_quota() {
1648      if ( ! is_multisite() || ! current_user_can( 'upload_files' )
1649          || get_site_option( 'upload_space_check_disabled' )
1650      ) {
1651          return true;
1652      }
1653  
1654      $quota = get_space_allowed();
1655      $used  = get_space_used();
1656  
1657      if ( $used > $quota ) {
1658          $percentused = '100';
1659      } else {
1660          $percentused = ( $used / $quota ) * 100;
1661      }
1662  
1663      $used_class  = ( $percentused >= 70 ) ? ' warning' : '';
1664      $used        = round( $used, 2 );
1665      $percentused = number_format( $percentused );
1666  
1667      ?>
1668      <h3 class="mu-storage"><?php _e( 'Storage Space' ); ?></h3>
1669      <div class="mu-storage">
1670      <ul>
1671          <li class="storage-count">
1672              <?php
1673              $text = sprintf(
1674                  /* translators: %s: Number of megabytes. */
1675                  __( '%s MB Space Allowed' ),
1676                  number_format_i18n( $quota )
1677              );
1678              printf(
1679                  '<a href="%1$s">%2$s<span class="screen-reader-text"> (%3$s)</span></a>',
1680                  esc_url( admin_url( 'upload.php' ) ),
1681                  $text,
1682                  /* translators: Hidden accessibility text. */
1683                  __( 'Manage Uploads' )
1684              );
1685              ?>
1686          </li><li class="storage-count <?php echo $used_class; ?>">
1687              <?php
1688              $text = sprintf(
1689                  /* translators: 1: Number of megabytes, 2: Percentage. */
1690                  __( '%1$s MB (%2$s%%) Space Used' ),
1691                  number_format_i18n( $used, 2 ),
1692                  $percentused
1693              );
1694              printf(
1695                  '<a href="%1$s" class="musublink">%2$s<span class="screen-reader-text"> (%3$s)</span></a>',
1696                  esc_url( admin_url( 'upload.php' ) ),
1697                  $text,
1698                  /* translators: Hidden accessibility text. */
1699                  __( 'Manage Uploads' )
1700              );
1701              ?>
1702          </li>
1703      </ul>
1704      </div>
1705      <?php
1706  }
1707  
1708  /**
1709   * Displays the browser update nag.
1710   *
1711   * @since 3.2.0
1712   * @since 5.8.0 Added a special message for Internet Explorer users.
1713   *
1714   * @global bool $is_IE
1715   */
1716  function wp_dashboard_browser_nag() {
1717      global $is_IE;
1718  
1719      $notice   = '';
1720      $response = wp_check_browser_version();
1721  
1722      if ( $response ) {
1723          if ( $is_IE ) {
1724              $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.' );
1725          } elseif ( $response['insecure'] ) {
1726              $msg = sprintf(
1727                  /* translators: %s: Browser name and link. */
1728                  __( "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." ),
1729                  sprintf( '<a href="%s">%s</a>', esc_url( $response['update_url'] ), esc_html( $response['name'] ) )
1730              );
1731          } else {
1732              $msg = sprintf(
1733                  /* translators: %s: Browser name and link. */
1734                  __( "It looks like you're using an old version of %s. For the best WordPress experience, please update your browser." ),
1735                  sprintf( '<a href="%s">%s</a>', esc_url( $response['update_url'] ), esc_html( $response['name'] ) )
1736              );
1737          }
1738  
1739          $browser_nag_class = '';
1740          if ( ! empty( $response['img_src'] ) ) {
1741              $img_src = ( is_ssl() && ! empty( $response['img_src_ssl'] ) ) ? $response['img_src_ssl'] : $response['img_src'];
1742  
1743              $notice           .= '<div class="alignright browser-icon"><img src="' . esc_url( $img_src ) . '" alt="" /></div>';
1744              $browser_nag_class = ' has-browser-icon';
1745          }
1746          $notice .= "<p class='browser-update-nag{$browser_nag_class}'>{$msg}</p>";
1747  
1748          $browsehappy = 'https://browsehappy.com/';
1749          $locale      = get_user_locale();
1750          if ( 'en_US' !== $locale ) {
1751              $browsehappy = add_query_arg( 'locale', $locale, $browsehappy );
1752          }
1753  
1754          if ( $is_IE ) {
1755              $msg_browsehappy = sprintf(
1756                  /* translators: %s: Browse Happy URL. */
1757                  __( 'Learn how to <a href="%s" class="update-browser-link">browse happy</a>' ),
1758                  esc_url( $browsehappy )
1759              );
1760          } else {
1761              $msg_browsehappy = sprintf(
1762                  /* translators: 1: Browser update URL, 2: Browser name, 3: Browse Happy URL. */
1763                  __( '<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>' ),
1764                  esc_attr( $response['update_url'] ),
1765                  esc_html( $response['name'] ),
1766                  esc_url( $browsehappy )
1767              );
1768          }
1769  
1770          $notice .= '<p>' . $msg_browsehappy . '</p>';
1771          $notice .= '<p class="hide-if-no-js"><a href="" class="dismiss" aria-label="' . esc_attr__( 'Dismiss the browser warning panel' ) . '">' . __( 'Dismiss' ) . '</a></p>';
1772          $notice .= '<div class="clear"></div>';
1773      }
1774  
1775      /**
1776       * Filters the notice output for the 'Browse Happy' nag meta box.
1777       *
1778       * @since 3.2.0
1779       *
1780       * @param string      $notice   The notice content.
1781       * @param array|false $response An array containing web browser information, or
1782       *                              false on failure. See wp_check_browser_version().
1783       */
1784      echo apply_filters( 'browse-happy-notice', $notice, $response ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
1785  }
1786  
1787  /**
1788   * Adds an additional class to the browser nag if the current version is insecure.
1789   *
1790   * @since 3.2.0
1791   *
1792   * @param string[] $classes Array of meta box classes.
1793   * @return string[] Modified array of meta box classes.
1794   */
1795  function dashboard_browser_nag_class( $classes ) {
1796      $response = wp_check_browser_version();
1797  
1798      if ( $response && $response['insecure'] ) {
1799          $classes[] = 'browser-insecure';
1800      }
1801  
1802      return $classes;
1803  }
1804  
1805  /**
1806   * Checks if the user needs a browser update.
1807   *
1808   * @since 3.2.0
1809   *
1810   * @return array|false Array of browser data on success, false on failure.
1811   */
1812  function wp_check_browser_version() {
1813      if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) {
1814          return false;
1815      }
1816  
1817      $key = md5( $_SERVER['HTTP_USER_AGENT'] );
1818  
1819      $response = get_site_transient( 'browser_' . $key );
1820  
1821      if ( false === $response ) {
1822          // Include an unmodified $wp_version.
1823          require  ABSPATH . WPINC . '/version.php';
1824  
1825          $url     = 'http://api.wordpress.org/core/browse-happy/1.1/';
1826          $options = array(
1827              'body'       => array( 'useragent' => $_SERVER['HTTP_USER_AGENT'] ),
1828              'user-agent' => 'WordPress/' . $wp_version . '; ' . home_url( '/' ),
1829          );
1830  
1831          if ( wp_http_supports( array( 'ssl' ) ) ) {
1832              $url = set_url_scheme( $url, 'https' );
1833          }
1834  
1835          $response = wp_remote_post( $url, $options );
1836  
1837          if ( is_wp_error( $response ) || 200 !== wp_remote_retrieve_response_code( $response ) ) {
1838              return false;
1839          }
1840  
1841          /**
1842           * Response should be an array with:
1843           *  'platform' - string - A user-friendly platform name, if it can be determined
1844           *  'name' - string - A user-friendly browser name
1845           *  'version' - string - The version of the browser the user is using
1846           *  'current_version' - string - The most recent version of the browser
1847           *  'upgrade' - boolean - Whether the browser needs an upgrade
1848           *  'insecure' - boolean - Whether the browser is deemed insecure
1849           *  'update_url' - string - The url to visit to upgrade
1850           *  'img_src' - string - An image representing the browser
1851           *  'img_src_ssl' - string - An image (over SSL) representing the browser
1852           */
1853          $response = json_decode( wp_remote_retrieve_body( $response ), true );
1854  
1855          if ( ! is_array( $response ) ) {
1856              return false;
1857          }
1858  
1859          set_site_transient( 'browser_' . $key, $response, WEEK_IN_SECONDS );
1860      }
1861  
1862      return $response;
1863  }
1864  
1865  /**
1866   * Displays the PHP update nag.
1867   *
1868   * @since 5.1.0
1869   */
1870  function wp_dashboard_php_nag() {
1871      $response = wp_check_php_version();
1872  
1873      if ( ! $response ) {
1874          return;
1875      }
1876  
1877      if ( isset( $response['is_secure'] ) && ! $response['is_secure'] ) {
1878          // The `is_secure` array key name doesn't actually imply this is a secure version of PHP. It only means it receives security updates.
1879  
1880          if ( $response['is_lower_than_future_minimum'] ) {
1881              $message = sprintf(
1882                  /* translators: %s: The server PHP version. */
1883                  __( '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.' ),
1884                  PHP_VERSION
1885              );
1886          } else {
1887              $message = sprintf(
1888                  /* translators: %s: The server PHP version. */
1889                  __( 'Your site is running on an outdated version of PHP (%s), which does not receive security updates. It should be updated.' ),
1890                  PHP_VERSION
1891              );
1892          }
1893      } elseif ( $response['is_lower_than_future_minimum'] ) {
1894          $message = sprintf(
1895              /* translators: %s: The server PHP version. */
1896              __( '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.' ),
1897              PHP_VERSION
1898          );
1899      } else {
1900          $message = sprintf(
1901              /* translators: %s: The server PHP version. */
1902              __( 'Your site is running on an outdated version of PHP (%s), which should be updated.' ),
1903              PHP_VERSION
1904          );
1905      }
1906      ?>
1907      <p class="bigger-bolder-text"><?php echo $message; ?></p>
1908  
1909      <p><?php _e( 'What is PHP and how does it affect my site?' ); ?></p>
1910      <p>
1911          <?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&#8217;s performance.' ); ?>
1912          <?php
1913          if ( ! empty( $response['recommended_version'] ) ) {
1914              printf(
1915                  /* translators: %s: The minimum recommended PHP version. */
1916                  __( 'The minimum recommended version of PHP is %s.' ),
1917                  $response['recommended_version']
1918              );
1919          }
1920          ?>
1921      </p>
1922  
1923      <p class="button-container">
1924          <?php
1925          printf(
1926              '<a class="button button-primary" href="%1$s" target="_blank" rel="noopener">%2$s<span class="screen-reader-text"> %3$s</span><span aria-hidden="true" class="dashicons dashicons-external"></span></a>',
1927              esc_url( wp_get_update_php_url() ),
1928              __( 'Learn more about updating PHP' ),
1929              /* translators: Hidden accessibility text. */
1930              __( '(opens in a new tab)' )
1931          );
1932          ?>
1933      </p>
1934      <?php
1935  
1936      wp_update_php_annotation();
1937      wp_direct_php_update_button();
1938  }
1939  
1940  /**
1941   * Adds an additional class to the PHP nag if the current version is insecure.
1942   *
1943   * @since 5.1.0
1944   *
1945   * @param string[] $classes Array of meta box classes.
1946   * @return string[] Modified array of meta box classes.
1947   */
1948  function dashboard_php_nag_class( $classes ) {
1949      $response = wp_check_php_version();
1950  
1951      if ( ! $response ) {
1952          return $classes;
1953      }
1954  
1955      if ( isset( $response['is_secure'] ) && ! $response['is_secure'] ) {
1956          $classes[] = 'php-no-security-updates';
1957      } elseif ( $response['is_lower_than_future_minimum'] ) {
1958          $classes[] = 'php-version-lower-than-future-minimum';
1959      }
1960  
1961      return $classes;
1962  }
1963  
1964  /**
1965   * Displays the Site Health Status widget.
1966   *
1967   * @since 5.4.0
1968   */
1969  function wp_dashboard_site_health() {
1970      $get_issues = get_transient( 'health-check-site-status-result' );
1971  
1972      $issue_counts = array();
1973  
1974      if ( false !== $get_issues ) {
1975          $issue_counts = json_decode( $get_issues, true );
1976      }
1977  
1978      if ( ! is_array( $issue_counts ) || ! $issue_counts ) {
1979          $issue_counts = array(
1980              'good'        => 0,
1981              'recommended' => 0,
1982              'critical'    => 0,
1983          );
1984      }
1985  
1986      $issues_total = $issue_counts['recommended'] + $issue_counts['critical'];
1987      ?>
1988      <div class="health-check-widget">
1989          <div class="health-check-widget-title-section site-health-progress-wrapper loading hide-if-no-js">
1990              <div class="site-health-progress">
1991                  <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">
1992                      <circle r="90" cx="100" cy="100" fill="transparent" stroke-dasharray="565.48" stroke-dashoffset="0"></circle>
1993                      <circle id="bar" r="90" cx="100" cy="100" fill="transparent" stroke-dasharray="565.48" stroke-dashoffset="0"></circle>
1994                  </svg>
1995              </div>
1996              <div class="site-health-progress-label">
1997                  <?php if ( false === $get_issues ) : ?>
1998                      <?php _e( 'No information yet&hellip;' ); ?>
1999                  <?php else : ?>
2000                      <?php _e( 'Results are still loading&hellip;' ); ?>
2001                  <?php endif; ?>
2002              </div>
2003          </div>
2004  
2005          <div class="site-health-details">
2006              <?php if ( false === $get_issues ) : ?>
2007                  <p>
2008                      <?php
2009                      printf(
2010                          /* translators: %s: URL to Site Health screen. */
2011                          __( '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.' ),
2012                          esc_url( admin_url( 'site-health.php' ) )
2013                      );
2014                      ?>
2015                  </p>
2016              <?php else : ?>
2017                  <p>
2018                      <?php if ( $issues_total <= 0 ) : ?>
2019                          <?php _e( 'Great job! Your site currently passes all site health checks.' ); ?>
2020                      <?php elseif ( 1 === (int) $issue_counts['critical'] ) : ?>
2021                          <?php _e( 'Your site has a critical issue that should be addressed as soon as possible to improve its performance and security.' ); ?>
2022                      <?php elseif ( $issue_counts['critical'] > 1 ) : ?>
2023                          <?php _e( 'Your site has critical issues that should be addressed as soon as possible to improve its performance and security.' ); ?>
2024                      <?php elseif ( 1 === (int) $issue_counts['recommended'] ) : ?>
2025                          <?php _e( 'Your site&#8217;s health is looking good, but there is still one thing you can do to improve its performance and security.' ); ?>
2026                      <?php else : ?>
2027                          <?php _e( 'Your site&#8217;s health is looking good, but there are still some things you can do to improve its performance and security.' ); ?>
2028                      <?php endif; ?>
2029                  </p>
2030              <?php endif; ?>
2031  
2032              <?php if ( $issues_total > 0 && false !== $get_issues ) : ?>
2033                  <p>
2034                      <?php
2035                      printf(
2036                          /* translators: 1: Number of issues. 2: URL to Site Health screen. */
2037                          _n(
2038                              'Take a look at the <strong>%1$d item</strong> on the <a href="%2$s">Site Health screen</a>.',
2039                              'Take a look at the <strong>%1$d items</strong> on the <a href="%2$s">Site Health screen</a>.',
2040                              $issues_total
2041                          ),
2042                          $issues_total,
2043                          esc_url( admin_url( 'site-health.php' ) )
2044                      );
2045                      ?>
2046                  </p>
2047              <?php endif; ?>
2048          </div>
2049      </div>
2050  
2051      <?php
2052  }
2053  
2054  /**
2055   * Outputs empty dashboard widget to be populated by JS later.
2056   *
2057   * Usable by plugins.
2058   *
2059   * @since 2.5.0
2060   */
2061  function wp_dashboard_empty() {}
2062  
2063  /**
2064   * Displays a welcome panel to introduce users to WordPress.
2065   *
2066   * @since 3.3.0
2067   * @since 5.9.0 Send users to the Site Editor if the active theme is block-based.
2068   */
2069  function wp_welcome_panel() {
2070      list( $display_version ) = explode( '-', get_bloginfo( 'version' ) );
2071      $can_customize           = current_user_can( 'customize' );
2072      $is_block_theme          = wp_is_block_theme();
2073      ?>
2074      <div class="welcome-panel-content">
2075      <div class="welcome-panel-header">
2076          <div class="welcome-panel-header-image">
2077              <?php echo file_get_contents( dirname( __DIR__ ) . '/images/dashboard-background.svg' ); ?>
2078          </div>
2079          <h2><?php _e( 'Welcome to WordPress!' ); ?></h2>
2080          <p>
2081              <a href="<?php echo esc_url( admin_url( 'about.php' ) ); ?>">
2082              <?php
2083                  /* translators: %s: Current WordPress version. */
2084                  printf( __( 'Learn more about the %s version.' ), $display_version );
2085              ?>
2086              </a>
2087          </p>
2088      </div>
2089      <div class="welcome-panel-column-container">
2090          <div class="welcome-panel-column">
2091              <svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
2092                  <rect width="48" height="48" rx="4" fill="#1E1E1E"/>
2093                  <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"/>
2094              </svg>
2095              <div class="welcome-panel-column-content">
2096                  <h3><?php _e( 'Author rich content with blocks and patterns' ); ?></h3>
2097                  <p><?php _e( 'Block patterns are pre-configured block layouts. Use them to get inspired or create new pages in a flash.' ); ?></p>
2098                  <a href="<?php echo esc_url( admin_url( 'post-new.php?post_type=page' ) ); ?>"><?php _e( 'Add a new page' ); ?></a>
2099              </div>
2100          </div>
2101          <div class="welcome-panel-column">
2102              <svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
2103                  <rect width="48" height="48" rx="4" fill="#1E1E1E"/>
2104                  <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"/>
2105              </svg>
2106              <div class="welcome-panel-column-content">
2107              <?php if ( $is_block_theme ) : ?>
2108                  <h3><?php _e( 'Customize your entire site with block themes' ); ?></h3>
2109                  <p><?php _e( 'Design everything on your site &#8212; from the header down to the footer, all using blocks and patterns.' ); ?></p>
2110                  <a href="<?php echo esc_url( admin_url( 'site-editor.php' ) ); ?>"><?php _e( 'Open site editor' ); ?></a>
2111              <?php else : ?>
2112                  <h3><?php _e( 'Start Customizing' ); ?></h3>
2113                  <p><?php _e( 'Configure your site&#8217;s logo, header, menus, and more in the Customizer.' ); ?></p>
2114                  <?php if ( $can_customize ) : ?>
2115                      <a class="load-customize hide-if-no-customize" href="<?php echo wp_customize_url(); ?>"><?php _e( 'Open the Customizer' ); ?></a>
2116                  <?php endif; ?>
2117              <?php endif; ?>
2118              </div>
2119          </div>
2120          <div class="welcome-panel-column">
2121              <svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
2122                  <rect width="48" height="48" rx="4" fill="#1E1E1E"/>
2123                  <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"/>
2124              </svg>
2125              <div class="welcome-panel-column-content">
2126              <?php if ( $is_block_theme ) : ?>
2127                  <h3><?php _e( 'Switch up your site&#8217;s look & feel with Styles' ); ?></h3>
2128                  <p><?php _e( 'Tweak your site, or give it a whole new look! Get creative &#8212; how about a new color palette or font?' ); ?></p>
2129                  <a href="<?php echo esc_url( admin_url( '/site-editor.php?path=%2Fwp_global_styles' ) ); ?>"><?php _e( 'Edit styles' ); ?></a>
2130              <?php else : ?>
2131                  <h3><?php _e( 'Discover a new way to build your site.' ); ?></h3>
2132                  <p><?php _e( 'There is a new kind of WordPress theme, called a block theme, that lets you build the site you&#8217;ve always wanted &#8212; with blocks and styles.' ); ?></p>
2133                  <a href="<?php echo esc_url( __( 'https://wordpress.org/documentation/article/block-themes/' ) ); ?>"><?php _e( 'Learn about block themes' ); ?></a>
2134              <?php endif; ?>
2135              </div>
2136          </div>
2137      </div>
2138      </div>
2139      <?php
2140  }


Generated : Tue Mar 19 08:20:01 2024 Cross-referenced by PHPXref