the_shortlink()WP 3.0.0

Displays the shortlink for a post.

Must be called from inside "The Loop"

Call like the_shortlink( __( 'Shortlinkage FTW' ) )

1 time — 0.001029 sec (very slow) | 50000 times — 4.65 sec (fast) | PHP 7.1.2, WP 4.7.3
Hooks from the function

Return

null. Nothing (null).

Usage

the_shortlink( $text, $title, $before, $after );
$text(string)
Optional The link text or HTML to be displayed.
Default: 'This is the short link.'
$title(string)
Optional The tooltip for the link. Must be sanitized.
Default: sanitized post title
$before(string)
Optional HTML to display before the link.
Default: ''
$after(string)
Optional HTML to display after the link.
Default: ''

Examples

1

#1 Display a short link with the text "This is the short link":

<?php the_shortlink(); ?>

We get it:

<a rel="shortlink" href="http://example.com/?p=1234" title="post title">This is the shortlink</a>
0

#2 Display the link inside the html tags

Tags will only appear when a short link is displayed:

<?php the_shortlink( 'shortlink', null, '<div class="shortlink">', '</div>'); ?

We get it:

<div class='shortlink'><a rel="shortlink" href="http://example.com/?p=1234" title="title posts">shortlink</a></div>

Changelog

Since 3.0.0 Introduced.

the_shortlink() code WP 6.4.3

function the_shortlink( $text = '', $title = '', $before = '', $after = '' ) {
	$post = get_post();

	if ( empty( $text ) ) {
		$text = __( 'This is the short link.' );
	}

	if ( empty( $title ) ) {
		$title = the_title_attribute( array( 'echo' => false ) );
	}

	$shortlink = wp_get_shortlink( $post->ID );

	if ( ! empty( $shortlink ) ) {
		$link = '<a rel="shortlink" href="' . esc_url( $shortlink ) . '" title="' . $title . '">' . $text . '</a>';

		/**
		 * Filters the short link anchor tag for a post.
		 *
		 * @since 3.0.0
		 *
		 * @param string $link      Shortlink anchor tag.
		 * @param string $shortlink Shortlink URL.
		 * @param string $text      Shortlink's text.
		 * @param string $title     Shortlink's title attribute.
		 */
		$link = apply_filters( 'the_shortlink', $link, $shortlink, $text, $title );
		echo $before, $link, $after;
	}
}