WordPress函数the_tags获取文章标签使用详解

WordPress有一个tag标签功能，利用好这个标签功能有助于SEO。WordPress官方也提供了一个获取标签的函数the_tags，the_tags可以获取到文章设置的所有标签，并按照你想要的形式输出。在文章页面输出标签有助于内链布局，提升SEO效果。

函数原型

the_tags函数位于wp-includes/category-template.php文件中：

/**
 * Retrieve the tags for a post.
 *
 * @since 2.3.0
 *
 * @param string $before Optional. Before list.
 * @param string $sep Optional. Separate items using this.
 * @param string $after Optional. After list.
 */
function the_tags( $before = null, $sep = ', ', $after = '' ) {
	if ( null === $before )
		$before = __('Tags: ');

	$the_tags = get_the_tag_list( $before, $sep, $after );

	if ( ! is_wp_error( $the_tags ) ) {
		echo $the_tags;
	}
}

可以看到the_tags函数是通过调用get_the_tag_list取得数据。

the_tags描述

在模板中显示标签名并链接到该标签中，如果当前页中无标签就不显示，这个函数必须使用在WordPress主循环中。就是能获取到全局变量post的地方，一般用于文章页与文章列表页。

函数用法及参数

<?php the_tags( $before, $sep, $after ); ?>

$before
在显示之前输出的内容，一般是标签链接所处容器HTML标签。
$sep
用来分隔的内容，你可以为空，具体效果看下面的图。
$after
显示在标签之后的内容，一般是标签链接所处容器HTML标签。

the_tags使用实例

默认用法

<?php the_tags(); ?>

输出：

标签：XXX, XXXX

第一种用法

<?php the_tags( 'Tags: ', ', ', '<br />' ); ?>

输出：

Tags: 测试, 测试标签

第二种用法

<?php the_tags( 'Social tagging: ',' > ' ); ?>

输出：

Social tagging: 测试 > 测试标签

第三种用法

<?php the_tags( 'Tagged with: ', ' • ', '<br />' ); ?>

输出：

https://googleads.g.doubleclick.net/pagead/ads?client=ca-pub-5411032561867523&output=html&h=200&slotname=3203366152&adk=3937868952&adf=234258853&pi=t.ma~as.3203366152&w=810&fwrn=4&lmt=1687604951&rafmt=11&format=810×200&url=https%3A%2F%2Fwww.daimadog.com%2F3369.html&wgl=1&uach=WyJXaW5kb3dzIiwiMTAuMC4wIiwieDg2IiwiIiwiMTE0LjAuMTgyMy41OCIsW10sMCxudWxsLCI2NCIsW1siTm90LkEvQnJhbmQiLCI4LjAuMC4wIl0sWyJDaHJvbWl1bSIsIjExNC4wLjU3MzUuMTM0Il0sWyJNaWNyb3NvZnQgRWRnZSIsIjExNC4wLjE4MjMuNTgiXV0sMF0.&dt=1688230364334&bpp=5&bdt=2689&idt=468&shv=r20230627&mjsv=m202306270101&ptt=9&saldr=aa&abxe=1&cookie=ID%3Da9b2eb6aa841a901-224e1ae5d3e100c6%3AT%3D1687638121%3ART%3D1688230364%3AS%3DALNI_MYrAQg5GjNJJNxyogjbjJZyHSLZ_A&gpic=UID%3D00000c679aa6eb16%3AT%3D1687638121%3ART%3D1688230364%3AS%3DALNI_MZsVEO3FQF55j3M2D4wfSkRktirJw&prev_fmts=0x0&nras=1&correlator=2105966561201&rume=1&frm=20&pv=1&ga_vid=328922043.1688230365&ga_sid=1688230365&ga_hid=447922751&ga_fc=0&rplot=4&u_tz=480&u_his=1&u_h=1440&u_w=2560&u_ah=1400&u_aw=2560&u_cd=24&u_sd=1&dmc=8&adx=670&ady=2490&biw=2490&bih=1297&scr_x=0&scr_y=972&eid=44759875%2C44759926%2C44759842%2C31075721%2C44788442%2C31061691%2C31061693&oid=2&pvsid=1080207769428680&tmod=1362770317&wsm=1&uas=0&nvt=3&ref=https%3A%2F%2Fcn.bing.com%2F&fc=896&brdim=0%2C103%2C0%2C103%2C2560%2C0%2C2505%2C1297%2C2505%2C1297&vis=1&rsz=%7C%7CeEbr%7C&abl=CS&pfx=0&fu=128&bc=31&ifi=1&uci=a!1&btvi=1&fsb=1&xpc=DDPw3HmIqM&p=https%3A//www.daimadog.com&dtd=1238

Tagged with: 测试 • 测试标签

第四种用法

<?php the_tags( '<ul><li>', '</li><li>', '</li></ul>' ); ?>

输出：

测试
测试标签

这四种使用方法都是第四种的变形，我们常用的也就是第四种，具体效果如下图所示：

Do good job