Ticket #10758: 10758-admin-post.patch

wp-admin/includes/post.php

@@ -915 +915 @@
  *
  * @since unknown
  *
- * @param unknown_type $id
- * @param unknown_type $title
- * @param unknown_type $name
- * @return unknown
+ * @param int|object $id    Post ID or post object.
+ * @param string $title (optional) Title
+ * @param string $name (optional) Name
+ * @return array With two entries of type string
  */
 function get_sample_permalink($id, $title=null, $name = null) {
         $post = &get_post($id);
@@ -941 +941 @@
         // If the user wants to set a new name -- override the current one
         // Note: if empty name is supplied -- use the title instead, see #6072
         if (!is_null($name)) {
-                $post->post_name = sanitize_title($name? $name : $title, $post->ID);
+                $post->post_name = sanitize_title($name ? $name : $title, $post->ID);
         }
 
         $post->filter = 'sample';
@@ -969 +969 @@
 }
 
 /**
- * {@internal Missing Short Description}}
+ * sample permalink html
  *
  * @since unknown
  *
- * @param unknown_type $id
- * @param unknown_type $new_title
- * @param unknown_type $new_slug
- * @return unknown
+ * @param int|object $id Post ID or post object.
+ * @param string $new_title (optional) New title 
+ * @param string $new_slug (optional) New slug
+ * @return string intended to be used for the inplace editor of the permalink post slug on in the post (and page?) editor.
  */
-function get_sample_permalink_html( $id, $new_title = null, $new_slug = null ) {
+function get_sample_permalink_html( $id, $new_title = null, $new_slug = null ) {        
         $post = &get_post($id);
-        list($permalink, $post_name) = get_sample_permalink($post->ID, $new_title, $new_slug);
+        list($permalink, $post_name) = get_sample_permalink($post->ID, $new_title, $new_slug);  
         if ( 'publish' == $post->post_status )
                 $view_post = 'post' == $post->post_type ? __('View Post') : __('View Page');