Ticket #11310: 11310.patch

post-image-template.php

@@ -9 +9 @@
  * @subpackage Template
  */
 
+/**
+ * Check if post has an image attached.
+ * 
+ * @since 2.9.0
+ *
+ * @param int $post_id Optional. Post ID.
+ * @return bool Whether post has an image attached (true) or not (false).
+ */
 function has_post_image( $post_id = NULL ) {
         global $id;
         $post_id = ( NULL === $post_id ) ? $id : $post_id;
         return !! get_post_image_id( $post_id );
 }
 
+/**
+ * Retrieve Post Image ID.
+ * 
+ * @since 2.9.0
+ *
+ * @param int $post_id Optional. Post ID.
+ * @return int
+ */
 function get_post_image_id( $post_id = NULL ) {
         global $id;
         $post_id = ( NULL === $post_id ) ? $id : $post_id;
         return get_post_meta( $post_id, '_thumbnail_id', true );
 }
 
+/**
+ * Display Post Image.
+ * 
+ * @since 2.9.0
+ *
+ * @param int $size Optional. Image size.  Defaults to 'thumbnail'.
+ * @param int $attr Optional.
+ */
 function the_post_image( $size = 'thumbnail', $attr = '' ) {
         echo get_the_post_image( NULL, $size, $attr );
 }
 
+/**
+ * Retrieve Post Image.
+ * 
+ * @since 2.9.0
+ *
+ * @param int $post_id Optional. Post ID.
+ * @param string $size Optional. Image size.  Defaults to 'thumbnail'.
+ * @param int $attr Optional.
+  */
 function get_the_post_image( $post_id = NULL, $size = 'thumbnail', $attr = '' ) {
         global $id;
         $post_id = ( NULL === $post_id ) ? $id : $post_id;