Changeset 34982

Timestamp:

10/09/2015 04:33:16 AM (9 years ago)

Author:

SergeyBiryukov

Message:

Add $id parameter to the_permalink(), for consistency with get_permalink().

Props johnjamesjacoby, chriscct7.
Fixes #23882.

File:

• trunk/src/wp-includes/link-template.php (modified) (3 diffs)

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

@@ -11 +11 @@
  *
  * @since 1.2.0
- */
-function the_permalink() {
+ * @since 4.4.0 Added `$id` parameter.
+ *
+ * @param int|WP_Post $id Optional. Post ID or post object. Default current post.
+ */
+function the_permalink( $id = 0 ) {
     /**
      * Filter the display of the permalink for the current post.
@@ -20 +23 @@
      * @param string $permalink The permalink for the current post.
      */
-    echo esc_url( apply_filters( 'the_permalink', get_permalink() ) );
+    echo esc_url( apply_filters( 'the_permalink', get_permalink( $id ) ) );
 }
 
@@ -92 +95 @@
  * @see get_permalink()
  *
- * @param int|WP_Post $id        Optional. Post ID or post object. Default is the current post.
+ * @param int|WP_Post $id        Optional. Post ID or post object. Default current post.
  * @param bool        $leavename Optional. Whether to keep post name or page name. Default false.
  * @return string|false The permalink URL or false if post does not exist.