当前浏览:首页 / WordPress函数 / the_shortlink()

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

显示文章的短链接

shortlink

themore...


描述

必须在“循环”内部调用

调用类似于 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开始引入

用户贡献的笔记

  • 贡献者:Codex

    自定义文本显示指定文本的链接。

    <?php the_shortlink( __( 'Shortlinkage FTW', 'textdomain' ) ); ?> 
    

    输出:
    Shortlinkage FTW

  • 贡献者:Codex

    默认用法显示带有“这是短链接”的链接文本。

     <?php the_shortlink(); ?> 
    

    输出:

    This is the short link.

  • 贡献者:Codex

    有条件HTML显示带有前缀和后缀HTML的链接,该链接仅在短链接URL可用时显示。

    <?php the_shortlink( 'short link', null, '<ul><li>', '</li></ul>' ); ?> 
    
    <a href="#" rel="nofollow">short link</a>