the_permalink( int|WP_Post $post )
Displays the permalink for the current post.
Description Description
Parameters Parameters
- $post
-
(int|WP_Post) (Optional) Post ID or post object. Default is the global
$post.
Source Source
File: wp-includes/link-template.php
function the_permalink( $post = 0 ) {
/**
* Filters the display of the permalink for the current post.
*
* @since 1.5.0
* @since 4.4.0 Added the `$post` parameter.
*
* @param string $permalink The permalink for the current post.
* @param int|WP_Post $post Post ID, WP_Post object, or 0. Default 0.
*/
echo esc_url( apply_filters( 'the_permalink', get_permalink( $post ), $post ) );
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 4.4.0 | Added the $post parameter. |
| 1.2.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Used as Link With Title Tag
Creates a link for the permalink, with the post’s title as the link text. This is a common way to put the post’s title.
Display Post URL as Text
Displays the URL to the post, without creating a link:
As Link With Text
You can use whatever text you like as the link text, in this case, “permalink”.