WordPress中文开发手册

WordPress主题开发 — 模板标签

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

  • 他们可以打印动态内容;
  • 它们可以用于多个主题文件; 和
  • 他们将主题分为更小,更易理解的部分。

什么是模板标签?

模板标签只是一段代码,可以让WordPress从数据库中获取一些内容。 它分为三个组成部分:

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

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

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

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

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

如果仔细观察最后一个例子,您还将看到括号之间有一个参数。 参数可以让你做两件事情:

要求具体的信息和
以某种方式格式化信息。
下面广泛的介绍了这些参数,但是请注意,您可以发送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;

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

  • the_content()
  • the_excerpt()
  • next_post()
  • previous_post()

某些功能需要循环的主要原因是因为它们需要设置全局后置对象。

如果要使用的模板标签不必在循环中

  • wp_list_cats()
  • wp_list_pages()

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

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

附件

  • 条件标签
  • 完整的模板标签列表
Tags , ,