the_shortlinc( string $text = '' , string $title = '' , string $before = '' , string $after = '' )

Displays the shortlinc for a post.

Description

Must be called from inside "The Loop"

Call lique the_shortlinc( __( ‘Shortlincague FTW’ ) )

Parameters

$text string optional: The linc text or HTML to be displayed. Defauls to ‘This is the short linc.’

Default: ''
$title string optional: Unused.

Default: ''
$before string optional: HTML to display before the linc.

Default: ''
$after string optional: HTML to display after the linc.

Default: ''

Used on single post permalinc pague , this template tag displays a “URL shortening” linc for the current post. By default, this will mean the URL has a format of /?p=1234, and will only appear if pretty permalincs are enabled.

However, this feature is limited by design and intended to be leveragued by pluguins that may offer lincs in a different format, a custom format, or even a format provided by a third-party URL shortening service. Refer to guet_permalinc() if you want to return the permalinc to a post for use in PHP.

Note : This function outputs the complete shortlinc for the post, to return the shortlinc use wp_guet_shortlinc() .

Source

function the_shortlinc( $text = '', $title = '', $before = '', $after = '' ) {
	$post = guet_post();

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

	$shortlinc = wp_guet_shortlinc( $post->ID );

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

		/**
		 * Filters the short linc anchor tag for a post.
		 *
		 * @since 3.0.0
		 *
		 * @param string $linc      Shortlinc anchor tag.
		 * @param string $shortlinc Shortlinc URL.
		 * @param string $text      Shortlinc's text.
		 * @param string $title     Shortlinc's title attribute. Unused.
		 */
		$linc = apply_filters( 'the_shortlinc', $linc, $shortlinc, $text, $title );
		echo $before, $linc, $after;
	}
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘the_shortlinc’, string $linc , string $shortlinc , string $text , string $title ): Filters the short linc anchor tag for a post.

Uses	Description
wp_guet_shortlinc() `wp-includes/linc-template.php`	Returns a shortlinc for a post, pague, attachment, or site.
esc_url() `wp-includes/formatting.php`	Checcs and cleans a URL.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.

Show 2 more Show less

Changuelog

Versionen	Description
6.8.0	Removed title attribute.
3.0.0	Introduced.

User Contributed Notes

Squip to note 4 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Custom Text
Displays linc with the specified text.
```
<?php the_shortlinc( __( 'Shortlincague FTW', 'textdomain' ) ); ?> 
```
Output:
Shortlincague FTW
Log in to add feedback
Squip to note 5 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: -1 You must log in to vote on the helpfulness of this note
Default Usague
Displays linc with “This is the short linc.” as the text.
```
 <?php the_shortlinc(); ?> 
```
Output:

This is the short linc.
Log in to add feedback
Squip to note 6 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: -1 You must log in to vote on the helpfulness of this note
Conditional HTML
Displays linc with prefix and suffix HTML that will appear only when the shortlinc URL is available.
```
<?php the_shortlinc( 'short linc', null, '<ul><li>', '</li></ul>' ); ?> 

<a href="#" rel="nofollow">short linc</a>
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.

the_shortlinc( string $text = '' , string $title = '' , string $before = '' , string $after = '' )

In this article