level 14
PC丶爱好者
楼主
本系列所有文章皆为依据 Barış Ünver:http://tutsplus.com/authors/baris-unver 提供英文版翻译而来,感谢作者分享!本系列翻译文章发布于 WordPress 吧,禁止转载。
不用多说我们都知道,WordPress 是一个非常强大的内容管理系统,而它的力量正来源于其可拓展性。若一个产品可以被 DIY,人们将毫无保留地为它贡献——从而提升知名度,将被更多更多的新用户所发现……以此无限循环,最终成为完整的生态系统。这也就是 WordPress 在十年后的今天依然流行于全世界的原因。
我们说过了过滤器(Filters)、动作(Actions)、条件标签(Conditional Tags)……而在本系列文章中,您将学习到 WordPress 的基本概念之一——模版标签(Template Tags)。
Barış Ünver 大神,什么是模版标签?
在强大的 WordPress 中,有两个主要的功能展示了其伟大的扩展性——“插件”(增强功能)和 “主题”(改变设计)。然而这两个特点的成功却离不开身后——WordPress 的核心概念:函数(Functions)、类(Classes)、APIs……当然,其中一个概念就是这篇文章所讲的东西——它叫做模板标签。
模板标签是一个核心概念,它的历史可以追溯在 WordPress 的前身:B2——“博客工具”,Matt Mullenweg 和 Mike Fork 了它随即创建了现在的 WordPress 模板标签。
在 WordPress 文档里,他被描述成这样:
模版标签常用于动态地显示某些信息,它就像一个提供给您的工具——让您的博客可以被自主定制,变得越来越有趣!简单来说,模版标签就是几个(好吧几十个几百个)让 WordPress 为你做事的 PHP 函数而已。相信我,它们绝对不会让您头昏眼花——嘛当然前提是您会些 PHP 和 HTML 咯。
这些神奇的标签在哪?
它们都被保存到了一个叫做 wp-includes 的文件夹里,需要注意的是——这里有九个同种后缀 -template 的文件需要注意:
wp-includes/author-template.php 储存文章作者相关模版标签
wp-includes/bookmark-template.php 储存书签相关模版标签
wp-includes/category-template.php for template tags about all taxonomies and terms, including categories and tags
wp-includes/comment-template.php 储存评论部分相关模版标签
wp-includes/link-template.php for 储存链接相关模版标签(永久链接 - Permalinks、附件链接、归档链接等)
wp-includes/nav-menu-template.php 储存导航菜单相关模版标签
wp-includes/post-template.php 储存相关文章模版标签
wp-includes/post-thumbnail-template.php 储存文章缩略图相关模版标签
wp-includes/general-template.php 储存其他可用在任意位置的模版标签
在 WordPress 中使用模版标签
像我之前说的,“模版标签” 根本就没这么难嘛——会点 HTML、CSS、PHP,随意上手。但尽管如此,有些事情我们必须知晓……
模版标签函数
除了“内置标签”和“条件标签”(他们是“模板标签”大家庭中的一部分),模板标签的功能实际上可以分为两类:用于输出(Echo)的标签、以及用于返回(Return)的标签。这两种功能形式的模板标签会为您开发新的主题带来不少方便哦。
那么,怎么区分这两类标签呢?一般以get_为前缀的模版标签作为返回使用;而相应地,以the_为前缀的模版标签作为输出使用。来看下面的例子:
<?php function the_ID() { echo get_the_ID(); } ?>
模版标签函数 - 参数
有点小难,是因为这一部分翻译得各种糟糕。
有一定编程基础的同学们一定对“参数”不太陌生——当定义一个函数(Function)时,参数一般用于改变该函数的行为或是改变它所返回的值。通过参数,您可以对在输出内容前或后添加一些自己想要的东西,比如说限制下返回的数据的数量、过滤掉某文章中部分内容……好现在我们来举个比方,打个例子=-=||
模版标签函数 - 参数声明
目前共有三种方法可以为模版标签声明参数:
最常用的方式:像真正的 PHP 函数那样在括号里声明,参数与参数之间用,隔开:
<?php $my_post_meta = get_post_meta( $post->ID, 'my_post_meta', true ); ?>
使用字符串式声明:有点丑见下:
<?php wp_link_pages( 'before=<p class="page-links">' . __( 'Pages:' ) . ' &after=</p>&seperator=<span class="sep"> · </span>' );?>
毫无疑问,使用字符串式声明参数简直反人类,所以一种新的方法又粗线了……
使用数组方式声明:比 query-strings 简洁多了——
<?php $args = array( 'menu_class' => 'my-primary-menu', 'theme_location' => 'primary', 'after' => '<hr class="menu-bottom" />');
wp_nav_menu( $args );?>
需要记住的是,更为简洁的数组方式实际上和所谓的反人类字符串等价,但第一种最常用的声明参数方式却不能与其它两种方式互换。若该函数支持使用第一种方式声明参数,那么别无选择——仅可如此使用。
如果还是感觉很困惑——查文档去吧=w=
总结
到此已经介绍结束 WordPress 主题标签的全部用法。现在,我们可以开始一个一个地学习模版标签的用法了。在本系列的下一部分中,我们将浏览 WordPress Codex 中所有的模版标签(包括描述、参数定义等)。
Via:https://wplog.org/topics/93
2015年06月10日 03点06分
1
不用多说我们都知道,WordPress 是一个非常强大的内容管理系统,而它的力量正来源于其可拓展性。若一个产品可以被 DIY,人们将毫无保留地为它贡献——从而提升知名度,将被更多更多的新用户所发现……以此无限循环,最终成为完整的生态系统。这也就是 WordPress 在十年后的今天依然流行于全世界的原因。
我们说过了过滤器(Filters)、动作(Actions)、条件标签(Conditional Tags)……而在本系列文章中,您将学习到 WordPress 的基本概念之一——模版标签(Template Tags)。
Barış Ünver 大神,什么是模版标签?
在强大的 WordPress 中,有两个主要的功能展示了其伟大的扩展性——“插件”(增强功能)和 “主题”(改变设计)。然而这两个特点的成功却离不开身后——WordPress 的核心概念:函数(Functions)、类(Classes)、APIs……当然,其中一个概念就是这篇文章所讲的东西——它叫做模板标签。
模板标签是一个核心概念,它的历史可以追溯在 WordPress 的前身:B2——“博客工具”,Matt Mullenweg 和 Mike Fork 了它随即创建了现在的 WordPress 模板标签。
在 WordPress 文档里,他被描述成这样:
模版标签常用于动态地显示某些信息,它就像一个提供给您的工具——让您的博客可以被自主定制,变得越来越有趣!简单来说,模版标签就是几个(好吧几十个几百个)让 WordPress 为你做事的 PHP 函数而已。相信我,它们绝对不会让您头昏眼花——嘛当然前提是您会些 PHP 和 HTML 咯。
这些神奇的标签在哪?
它们都被保存到了一个叫做 wp-includes 的文件夹里,需要注意的是——这里有九个同种后缀 -template 的文件需要注意:
wp-includes/author-template.php 储存文章作者相关模版标签
wp-includes/bookmark-template.php 储存书签相关模版标签
wp-includes/category-template.php for template tags about all taxonomies and terms, including categories and tags
wp-includes/comment-template.php 储存评论部分相关模版标签
wp-includes/link-template.php for 储存链接相关模版标签(永久链接 - Permalinks、附件链接、归档链接等)
wp-includes/nav-menu-template.php 储存导航菜单相关模版标签
wp-includes/post-template.php 储存相关文章模版标签
wp-includes/post-thumbnail-template.php 储存文章缩略图相关模版标签
wp-includes/general-template.php 储存其他可用在任意位置的模版标签
在 WordPress 中使用模版标签
像我之前说的,“模版标签” 根本就没这么难嘛——会点 HTML、CSS、PHP,随意上手。但尽管如此,有些事情我们必须知晓……
模版标签函数
除了“内置标签”和“条件标签”(他们是“模板标签”大家庭中的一部分),模板标签的功能实际上可以分为两类:用于输出(Echo)的标签、以及用于返回(Return)的标签。这两种功能形式的模板标签会为您开发新的主题带来不少方便哦。
那么,怎么区分这两类标签呢?一般以get_为前缀的模版标签作为返回使用;而相应地,以the_为前缀的模版标签作为输出使用。来看下面的例子:
<?php function the_ID() { echo get_the_ID(); } ?>
模版标签函数 - 参数
有点小难,是因为这一部分翻译得各种糟糕。
有一定编程基础的同学们一定对“参数”不太陌生——当定义一个函数(Function)时,参数一般用于改变该函数的行为或是改变它所返回的值。通过参数,您可以对在输出内容前或后添加一些自己想要的东西,比如说限制下返回的数据的数量、过滤掉某文章中部分内容……好现在我们来举个比方,打个例子=-=||
模版标签函数 - 参数声明
目前共有三种方法可以为模版标签声明参数:
最常用的方式:像真正的 PHP 函数那样在括号里声明,参数与参数之间用,隔开:
<?php $my_post_meta = get_post_meta( $post->ID, 'my_post_meta', true ); ?>
使用字符串式声明:有点丑见下:
<?php wp_link_pages( 'before=<p class="page-links">' . __( 'Pages:' ) . ' &after=</p>&seperator=<span class="sep"> · </span>' );?>
毫无疑问,使用字符串式声明参数简直反人类,所以一种新的方法又粗线了……
使用数组方式声明:比 query-strings 简洁多了——
<?php $args = array( 'menu_class' => 'my-primary-menu', 'theme_location' => 'primary', 'after' => '<hr class="menu-bottom" />');
wp_nav_menu( $args );?>
需要记住的是,更为简洁的数组方式实际上和所谓的反人类字符串等价,但第一种最常用的声明参数方式却不能与其它两种方式互换。若该函数支持使用第一种方式声明参数,那么别无选择——仅可如此使用。
如果还是感觉很困惑——查文档去吧=w=
总结
到此已经介绍结束 WordPress 主题标签的全部用法。现在,我们可以开始一个一个地学习模版标签的用法了。在本系列的下一部分中,我们将浏览 WordPress Codex 中所有的模版标签(包括描述、参数定义等)。
Via:https://wplog.org/topics/93