Changeset 40042

Timestamp:

02/05/2017 02:34:16 PM (8 years ago)

Author:

SergeyBiryukov

Message:

Docs: Clarify that has_excerpt() checks if the post has a custom excerpt, not some generated excerpt.

See #35487.

File:

• trunk/src/wp-includes/post-template.php (modified) (1 diff)

trunk/src/wp-includes/post-template.php

@@ -399 +399 @@
 
 /**
- * Whether post has excerpt.
+ * Whether the post has a custom excerpt.
  *
  * @since 2.3.0
  *
- * @param int|WP_Post $id Optional. Post ID or post object.
- * @return bool
- */
-function has_excerpt( $id = 0 ) {
-    $post = get_post( $id );
+ * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
+ * @return bool True if the post has a custom excerpt, false otherwise.
+ */
+function has_excerpt( $post = 0 ) {
+    $post = get_post( $post );
     return ( !empty( $post->post_excerpt ) );
 }