模板标签

模板标签是在主题中用来从数据库中检索内容的。这些内容可以是任何东西,从一个博客标题到一个完整的侧边栏。模板标签是将内容拉入主题的首选方法,因为:

  • 他们可以打印动态内容;
  • 可以在多个主题文件中使用;
  • 它们将主题分成更小、更容易理解的部分。

什么是模板标签

模板标签是简单的一段代码,它告诉WordPress从数据库中获取一些东西,它被分解成三个部分:

  • PHP代码标签
  • WordPress函数
  • 可选参数

你可以使用模板标签来调用另一个主题文件或数据库中的一些信息。

例如,模板标签get_header()告诉WordPress获得header.php文件并将其包含在当前主题文件中。同样地,get_footer()告诉WordPress获得footer.php文件。

还有其他种类的模板标签:

  • the_title() – 告诉WordPress从数据库中获取页面或文章的标题并将其包括在内
  • bloginfo( 'name' ) – 告诉WordPress从数据库中获取博客标题,并将其包含在模板文件中

如果你仔细观察最后一个例子,还会发现在括号之间有一个参数,参数可以让你做两件事:

  1. 要求提供具体的信息
  2. 以某种方式格式化信息

下面详细介绍了参数,但请注意,您可以发送WordPress特定的说明,说明如何显示数据。

 

为什么使用模板标签

通过封装特定内容的所有代码,模板标签使得在主题文件中包含模板的各个部分以及维护主题变得非常容易。

创建一个header.php文件,让你所有的主题模板如single.php、page.php、front-page.php等使用get_header()引用这个主题文件,比在每个主题文件中复制和粘贴代码要容易得多。这也使维护变得更容易。每当你在header.php文件中做了一个改动,这个改动就会自动转入你所有的其他主题文件。

使用模板标签的另一个原因是显示动态数据,即来自数据库的数据。在标题中,你可以手动包含标题标签,像这样:

<title>My Personal Website</title>

然而,这样做意味着当你想改变网站标题时,都要手动编辑你的主题。相反,包含bloginfo( 'name' )模板标签更容易,它可以自动从数据库中获取网站标题。现在,你可以在WordPress中改变网站的标题,而不是硬编码你的主题模板。

 

如何使用模板标签

使用模板标签是非常简单的。在任何模板文件中,你可以使用模板标签,只需打印一行php代码来调用模板标签。打印header.php文件就是这么简单:

get_header();

 

参数

有些模板标签允许你传递参数,参数是额外的信息,决定了从数据库中检索的内容。

例如,bloginfo()模板标签允许你给它一个参数,告诉WordPress你想要的具体信息。要打印博客的名字,你只需传递参数 "name",像这样

bloginfo( 'name' );

要打印博客所运行的WordPress版本,你将传递一个"version"参数:

bloginfo( 'version' );

对于每个模板标签,参数是不同的。这些参数的列表和它们的作用可以在位于整个代码参考中的特定模板标签页面上找到。

 

在循环内使用模板标签

许多模板标签在WordPress的循环中工作,这意味着它们被包含在模板文件中,作为php"循环"的一部分,根据循环中的指令生成用户看到的页面。

WordPress循环以这样开始:

if ( have_posts() ) :
    while ( have_posts() ) :
        the_post();

在循环内工作的模板标签必须在中间区域,在下面循环的结束部分之前:

    endwhile;
else :
    _e( 'Sorry, no posts matched your criteria.', 'devhub' );
endif;

一些需要在循环内的模板标签包括:

一些函数需要循环的主要原因是它们需要设置全局的post对象。

如果你要使用的模板标签不必位于循环内

那么你可以把它放在你想放的任何文件中,例如放在侧边栏、页眉或页脚模板文件中。

这些是通常不需要全局post对象的函数。