permalink_anchor( string $mode = 'id' )

Displays the permalink anchor for the current post.

Description

The permalink mode title will use the post title for the ‘a’ element ‘id’ attribute. The id mode uses ‘post-‘ with the post ID for the ‘id’ attribute.

Parameters

$mode

(string) (Optional) Permalink mode. Accepts 'title' or 'id'.

Default value: 'id'

More Information

Usage:
permalink_anchor( $type );

Source

File: wp-includes/link-template.php

function permalink_anchor( $mode = 'id' ) {
	$post = get_post();
	switch ( strtolower( $mode ) ) {
		case 'title':
			$title = sanitize_title( $post->post_title ) . '-' . $post->ID;
			echo '<a id="' . $title . '"></a>';
			break;
		case 'id':
		default:
			echo '<a id="post-' . $post->ID . '"></a>';
			break;
	}
}

Changelog

Version Description
0.71 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/permalink_anchor