描述
必须在“循环”内部调用
调用类似于 the_shortlink( __( ‘Shortlinkage FTW’ ) )
参数
- $text
-
(string) (可选) 要显示的链接文本或HTML，默认为“这是短链接”
默认值: ''
- $title
-
(string) (可选) 链接的工具提示，必须进行清理，默认为经过清理的文章标题。
默认值: ''
- $before
-
(string) (可选) 要在链接之前显示的HTML。
默认值: ''
- $after
-
(string) (可选) 链接后显示的HTML。
默认值: ''
说明
用于单个文章页面，显示当前文章的“URL短链接”。默认情况下，这意味着URL的格式为/?p=1234，并且仅在启用了固定链接时才会出现。
然而，此功能在设计上是有限的，目的是让那些可能提供不同格式、自定义格式、甚至由第三方URL短链接服务提供的格式的插件利用起来。如果你想要返回一篇文章的固定链接以便在PHP中使用，请参阅get_permalink()。
注意：此函数是输出文章完整的短链接，若要返回短链接请使用wp_get_shortlink()。
源码
更新日志
| 版本 | 描述 |
|---|---|
| 3.0.0 | 开始引入 |
使用示例
自定义文本显示指定文本的链接。
<?php the_shortlink( __( 'Shortlinkage FTW', 'textdomain' ) ); ?>
输出:
Shortlinkage FTW有条件HTML显示带有前缀和后缀HTML的链接，该链接仅在短链接URL可用时显示。
<?php the_shortlink( 'short link', null, '<ul><li>', '</li></ul>' ); ?> <a href="#" rel="nofollow">short link</a>