Changeset 26241

Timestamp:

11/17/2013 03:20:38 AM (8 years ago)

Author:

SergeyBiryukov

Message:

PHPDoc and i18n fixes for dashboard widgets.

props dimadin for initial patch.
see #25824.

Location:

trunk/src/wp-admin

Files:

• includes/dashboard.php (modified) (6 diffs)
• post.php (modified) (1 diff)

trunk/src/wp-admin/includes/dashboard.php

@@ -281 +281 @@
 
 /**
- * The Quick Draft widget display and creation of drafts
- *
- *
+ * The Quick Draft widget display and creation of drafts.
  *
  * @since 3.8.0
  *
- */
-function wp_dashboard_quick_press( $error_msg=false ) {
+ * @param string $error_msg Error message.
+ */
+function wp_dashboard_quick_press( $error_msg = false ) {
     global $post_ID;
 
@@ -314 +313 @@
     <form name="post" action="<?php echo esc_url( admin_url( 'post.php' ) ); ?>" method="post" id="quick-press" class="initial-form">
 
-        <?php if ($error_msg) : ?>
-        <div class="error"><?php _e( $error_msg ); ?></div>
+        <?php if ( $error_msg ) : ?>
+        <div class="error"><?php echo $error_msg; ?></div>
         <?php endif; ?>
 
         <div class="input-text-wrap" id="title-wrap">
-            <label class="screen-reader-text prompt" for="title" id="title-prompt-text"><?php _e( "What's on your mind?" ); ?></label>
+            <label class="screen-reader-text prompt" for="title" id="title-prompt-text"><?php _e( 'What&#8217;s on your mind?' ); ?></label>
             <input type="text" name="post_title" id="title" autocomplete="off" />
         </div>
@@ -467 +466 @@
 
 /**
- * callback function for `Activity` widget
- *
- *
+ * Callback function for Activity widget.
  *
  * @since 3.8.0
- *
  */
 function wp_dashboard_activity() {
@@ -514 +510 @@
 
 /**
- * Generates `Publishing Soon` and `Recently Published` sections
- *
- *
+ * Generates Publishing Soon and Recently Published sections.
  *
  * @since 3.8.0
  *
+ * @param array $args
  */
 function dashboard_show_published_posts( $args ) {
@@ -574 +569 @@
 
 /**
- * Show `Comments` section
- *
- *
+ * Show Comments section.
  *
  * @since 3.8.0
  *
+ * @param int $total_items
  */
 function dashboard_comments( $total_items = 5 ) {
@@ -632 +626 @@
 
 /**
- * return relative date for given timestamp
- *
- *
+ * Return relative date for given timestamp.
  *
  * @since 3.8.0
  *
+ * @param int $time Unix $timestamp.
  */
 function dashboard_relative_date( $time ) {

trunk/src/wp-admin/post.php

@@ -100 +100 @@
     $error_msg = false;
     if ( ! wp_verify_nonce( $nonce, 'add-post' ) )
-        $error_msg = 'Unable to submit this form, please refresh and try again.';
+        $error_msg = __( 'Unable to submit this form, please refresh and try again.' );
 
     if ( ! current_user_can( 'edit_posts' ) )
-        $error_msg = "Oops, you don't have access to add new drafts.";
+        $error_msg = __( 'Oops, you don’t have access to add new drafts.' );
 
     if ( $error_msg )