WordPress: Stepping Into Template Tags:修订间差异
无编辑摘要 |
无编辑摘要 |
||
(未显示2个用户的7个中间版本) | |||
第1行: | 第1行: | ||
<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>导航:</strong> [[WordPress:WordPress文档|上一级]] | [[WordPress]] | {{Template:WordPress导航}}</span> | |||
<div style="clear:both;"></div> | |||
你如果看看你的[[Wordpress:Using Themes|WordPress 主题]]上的<tt>header.php</tt> 模板文件,你就会注意到,在显示"我的博客名"的地方,不管它是什么,当你访问你的WordPress站点时,它在[[Wordpress:Stepping Into Templates|模板文件]]中不再显示"我的博客名"。事实上,它有一大堆的奇怪的箭头和括号和字母,都没有什么意思。 | 你如果看看你的[[Wordpress:Using Themes|WordPress 主题]]上的<tt>header.php</tt> 模板文件,你就会注意到,在显示"我的博客名"的地方,不管它是什么,当你访问你的WordPress站点时,它在[[Wordpress:Stepping Into Templates|模板文件]]中不再显示"我的博客名"。事实上,它有一大堆的奇怪的箭头和括号和字母,都没有什么意思。 | ||
这是一个[[Wordpress:Template Tags|模板标签]]的一个例子。 | |||
让我们在采取一些措施,更深地学习这些是什么,它们是如何运行的。 | |||
==一个模板标签是什么== | ==一个模板标签是什么== | ||
一个模板标签是一个代码来指示WordPress"去做" 或者 "得到"一些东西。对于你的WordPress站点名的<tt>header.php</tt>模板标签,它看起来是这样的: | 一个模板标签是一个代码来指示WordPress"去做" 或者 "得到"一些东西。对于你的WordPress站点名的<tt>header.php</tt>模板标签,它看起来是这样的: | ||
<pre><h1><?php bloginfo('name'); ?></h1></pre> | <pre><h1><?php bloginfo('name'); ?></h1></pre> | ||
模板标签 <tt><?php bloginfo(); ?></tt> 包在一个 '''H1''' 标题标签中, [[Wordpress:Template_Tags/bloginfo|bloginfo()]]标签从你的[[Wordpress:Administration Panels|管理面板]]中的 | 模板标签 <tt><?php bloginfo(); ?></tt> 包在一个 '''H1''' 标题标签中, [[Wordpress:Template_Tags/bloginfo|bloginfo()]]标签从你的[[Wordpress:Administration Panels|管理面板]]中的 | ||
[[Wordpress:Administration_Panels#Your_Profile|用户个人基本资料]] 和[[Wordpress:Administration_Panels#Options_-_Configuration_Settings|选项]] > [[Wordpress:Administration_Panels#General|一般]] ''得到'' 信息。 | [[Wordpress:Administration_Panels#Your_Profile|用户个人基本资料]] 和[[Wordpress:Administration_Panels#Options_-_Configuration_Settings|选项]] > [[Wordpress:Administration_Panels#General|一般]] ''得到'' 信息。 | ||
===模板标签参数=== | ===模板标签参数=== | ||
除了在<tt><?php bloginfo(); ?></tt>模板标签上的''名称'' 参数外,也可以显示其它的信息。然我们来看看这些参数中的其中的几个-在<tt>[[Wordpress:Template_Tags/bloginfo|bloginfo()]]</tt> Codex 页面上你可以找到更多的信息和例子。 | 除了在<tt><?php bloginfo(); ?></tt>模板标签上的''名称'' 参数外,也可以显示其它的信息。然我们来看看这些参数中的其中的几个-在<tt>[[Wordpress:Template_Tags/bloginfo|bloginfo()]]</tt> Codex 页面上你可以找到更多的信息和例子。 | ||
; 名称 <code><?php bloginfo('name'); ?></code>:如上面所提到的,它显示了站点的名称,并且由管理员在[[Wordpress:Administration_Panels#Options_-_Configuration_Settings|选项]] > [[Wordpress:Administration_Panels#General|一般]] 默认的子面板上设置。 | |||
; 名称 <code><?php bloginfo('name'); ?></code>: | |||
; 描述 <code><?php bloginfo('description'); ?></code>:这个称作你的博客的"标签行",这个通常是一些描述性的语句,显示"我的博客是关于...."。它由管理员在[[Wordpress:Administration_Panels#Options_-_Configuration_Settings|选项]] > [[Wordpress:Administration_Panels#General|一般]] 子面板中设置。 | ; 描述 <code><?php bloginfo('description'); ?></code>:这个称作你的博客的"标签行",这个通常是一些描述性的语句,显示"我的博客是关于...."。它由管理员在[[Wordpress:Administration_Panels#Options_-_Configuration_Settings|选项]] > [[Wordpress:Administration_Panels#General|一般]] 子面板中设置。 | ||
; url <code><?php bloginfo('url'); ?></code>:当你想为你的站点显示URL或者站点地址的时候,你可以使用URL,它就会显示出来。这也来自[[Wordpress:Administration_Panels#Options_-_Configuration_Settings|选项]] > [[Wordpress:Administration_Panels#General|一般]] 子面板。 | ; url <code><?php bloginfo('url'); ?></code>:当你想为你的站点显示URL或者站点地址的时候,你可以使用URL,它就会显示出来。这也来自[[Wordpress:Administration_Panels#Options_-_Configuration_Settings|选项]] > [[Wordpress:Administration_Panels#General|一般]] 子面板。 | ||
; 管理_邮件<code><?php bloginfo('admin_email'); ?></code>:如果你想显示管理员的邮件,你不用将它输进模板文件中。这样做,它可能对[[Wordpress:Protection_From_Harvesters|邮件 harvesters]]开放,他会使用复杂的软件来进入并且获得邮件地址用来发表垃圾信息。 通过使用<tt>bloginfo('admin_email')</tt>, 电子邮件在访客的页面上显示,但真正的地址被harvesters掩饰了。好, 哼? 管理员的电子邮件地址在 [[Wordpress:Administration_Panels#Options_-_Configuration_Settings|选项]] > [[Wordpress:Administration_Panels#General|一般]] 子面板中设置了。 | |||
;版本<code><?php bloginfo('version'); ?></code>: 有时你想显示一下你正在使用的WordPress是哪一个版本。默认的WordPress主题在页脚模板中包含了这个信息。它只是显示了你的博客使用的WordPress版本。 | ;版本<code><?php bloginfo('version'); ?></code>: 有时你想显示一下你正在使用的WordPress是哪一个版本。默认的WordPress主题在页脚模板中包含了这个信息。它只是显示了你的博客使用的WordPress版本。 | ||
显示WordPress版本,模板标签看起来像: | 显示WordPress版本,模板标签看起来像: | ||
第71行: | 第36行: | ||
<div style="border:1px solid blue; width:50%; margin: 10px; padding:20px">由 WordPress 版本支持 {{CurrentVersion}}</div> | <div style="border:1px solid blue; width:50%; margin: 10px; padding:20px">由 WordPress 版本支持 {{CurrentVersion}}</div> | ||
注意只有版本数字由''版本''参数产生,而不是单词"由WordPress 版本支持"。这些单词写在标签的前面,因此可以在网页上看见它们。 | 注意只有版本数字由''版本''参数产生,而不是单词"由WordPress 版本支持"。这些单词写在标签的前面,因此可以在网页上看见它们。 | ||
学习更多的关于模板标签参数,看看 [[Wordpress:Template_Tags/Anatomy_of_a_Template_Tag| 一个模板标签的解析]] 和[[Wordpress:Template_Tags/How_to_Pass_Tag_Parameters|怎样通过标签参数]]。 | 学习更多的关于模板标签参数,看看 [[Wordpress:Template_Tags/Anatomy_of_a_Template_Tag| 一个模板标签的解析]] 和[[Wordpress:Template_Tags/How_to_Pass_Tag_Parameters|怎样通过标签参数]]。 | ||
==你怎样使用模板标签?== | ==你怎样使用模板标签?== | ||
在Codex上[[Wordpress:Template Tags|模板标签]]菜单仔细看看不同的模板标签,你就会注意到它们中的许多非常的简单,像<tt>bloginfo()</tt> 模板标签,但许多看其来使用非常复杂。让我们来看一些例子,关于怎样使用它们来帮助你了解模板标签代码的"语言"。 | 在Codex上[[Wordpress:Template Tags|模板标签]]菜单仔细看看不同的模板标签,你就会注意到它们中的许多非常的简单,像<tt>bloginfo()</tt> 模板标签,但许多看其来使用非常复杂。让我们来看一些例子,关于怎样使用它们来帮助你了解模板标签代码的"语言"。 | ||
就如我们在<tt>bloginfo()</tt>模板标签中所见到的那样,它就用一个字来改变标签的产出。这个字叫做''参数'' 而且它指示模板标签来''做'' 或者 ''得到''一些东西。在这种情况下,指示说明是''得到名称''来显示站点的名称。 | 就如我们在<tt>bloginfo()</tt>模板标签中所见到的那样,它就用一个字来改变标签的产出。这个字叫做''参数'' 而且它指示模板标签来''做'' 或者 ''得到''一些东西。在这种情况下,指示说明是''得到名称''来显示站点的名称。 | ||
模板标签<tt>the_title()</tt>显示了[[Wordpress:Template_Tags/the_title|文章的标题]],通常在你的文章的上方。这个标签''得到''文章的标题并且显示了标题,默认情况下,它在参数中也有一个''do'',可以帮助你改变文章标题的外观和显示。 | |||
模板标签<tt>the_title()</tt>显示了[[Wordpress:Template_Tags/the_title|文章的标题]],通常在你的文章的上方。这个标签''得到'' | |||
默认情况下,标题看起来像这个: | 默认情况下,标题看起来像这个: | ||
<pre><?php the_title(); ?></pre> | <pre><?php the_title(); ?></pre> | ||
结果看起来像这个东西: | 结果看起来像这个东西: | ||
<div style="border:1px solid blue; width:70%; margin: 10px; padding:20px; font-size: 120%; color: navy">Using WordPress Makes Me Smile</div> | <div style="border:1px solid blue; width:70%; margin: 10px; padding:20px; font-size: 120%; color: navy">Using WordPress Makes Me Smile</div> | ||
如果你想加上一些参考来以某种方式突出标题,像一个图形或者[[Wordpress:Fun_Character_Entities|字符体]]像一个箭头符号或者bullet符号。让我们放进一个日元符号,&日元;,日本钱的标记,放到我们的标题的前面。 | 如果你想加上一些参考来以某种方式突出标题,像一个图形或者[[Wordpress:Fun_Character_Entities|字符体]]像一个箭头符号或者bullet符号。让我们放进一个日元符号,&日元;,日本钱的标记,放到我们的标题的前面。 | ||
如果你仔细看了标签<tt>the_title()</tt>的指示说明,你就会看到参数是: | 如果你仔细看了标签<tt>the_title()</tt>的指示说明,你就会看到参数是: | ||
第127行: | 第63行: | ||
<pre><?php the_title('before', 'after', display); ?> </pre> | <pre><?php the_title('before', 'after', display); ?> </pre> | ||
我们想将日元的标记放到标题的''前面'',在日元标记的后面和标题的前面都有一个空格,让我们把它添加到参数上: | |||
我们想将日元的标记放到标题的''前面'' | |||
<pre><?php the_title('&yen; '); ?> </pre> | <pre><?php the_title('&yen; '); ?> </pre> | ||
当网页产生了,这个看起来就像: | 当网页产生了,这个看起来就像: | ||
<div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 120%; color: navy">¥ Using WordPress Makes Me Smile</div> | <div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 120%; color: navy">¥ Using WordPress Makes Me Smile</div> | ||
现在,我们再深入地看看这个,并且在文章标题的后面再添加一些东西。加入你想鼓励人们阅读,那么我们添加一个小的激励的箭头( » ) 来激发他们。 | 现在,我们再深入地看看这个,并且在文章标题的后面再添加一些东西。加入你想鼓励人们阅读,那么我们添加一个小的激励的箭头( » ) 来激发他们。 | ||
<pre><?php the_title('&yen; ', ' &raquo;'); ?> </pre> | <pre><?php the_title('&yen; ', ' &raquo;'); ?> </pre> | ||
注意,我们在箭头标记的前面添加了一个空格,当网页可以浏览的时候,箭头标记与文章标题便分开了。 | |||
<div style="border:1px solid blue; width:70%; margin:10x; padding:20px; font-size: 120%; color: navy">¥ Using WordPress Makes Me Smile »</div> | <div style="border:1px solid blue; width:70%; margin:10x; padding:20px; font-size: 120%; color: navy">¥ Using WordPress Makes Me Smile »</div> | ||
你也可以使用许多不同的方式来设计你的标题。下面是使用标题标签的另一个例子。 | 你也可以使用许多不同的方式来设计你的标题。下面是使用标题标签的另一个例子。 | ||
<pre><h2><?php the_title('Post Title: '); ?></h2> </pre> | <pre><h2><?php the_title('Post Title: '); ?></h2> </pre> | ||
我们将整个文章的标题放到了一个[[Wordpress:Designing_Headings|H2标题]]中,并且在文章标题的开头添加短语"文章标题"。 | |||
我们将整个文章的标题放到了一个[[Wordpress:Designing_Headings|H2标题]]中,并且在文章标题的开头添加短语" | |||
<div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 130%; font-weight:bold; color: navy">Post Title: Using WordPress Makes Me Smile</div> | <div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 130%; font-weight:bold; color: navy">Post Title: Using WordPress Makes Me Smile</div> | ||
'''注: 虽然标题是这样的,并不是所有的 [[Wordpress:Template_Tags|模板标签]] 接受论据之前或者之后。查看抄本页面,找你正使用的特别的标签,看看它支持什么样的论据。''' | '''注: 虽然标题是这样的,并不是所有的 [[Wordpress:Template_Tags|模板标签]] 接受论据之前或者之后。查看抄本页面,找你正使用的特别的标签,看看它支持什么样的论据。''' | ||
===布尔书学体系的模板标签=== | ===布尔书学体系的模板标签=== | ||
以上的模板标签例子使用简单的参数,用引号和逗号将各自隔开。现在考虑一下[[Wordpress:Template_Tags/How_to_Pass_Tag_Parameters#Boolean|Boolean 模板标签]]的例子,使用布尔数学体系技术将不止一个的参数连接起来。一个常见的布尔数学体系表述使用"and (&)"逻辑来连接参数。 | 以上的模板标签例子使用简单的参数,用引号和逗号将各自隔开。现在考虑一下[[Wordpress:Template_Tags/How_to_Pass_Tag_Parameters#Boolean|Boolean 模板标签]]的例子,使用布尔数学体系技术将不止一个的参数连接起来。一个常见的布尔数学体系表述使用"and (&)"逻辑来连接参数。 | ||
模板标签[[Wordpress:Template_Tags/wp_list_cats|wp_list_cats()]]通常能在WordPress工具条或者菜单模板文件中找到。它列出了站点的[[Wordpress:Glossary#Category|类别]]。 | 模板标签[[Wordpress:Template_Tags/wp_list_cats|wp_list_cats()]]通常能在WordPress工具条或者菜单模板文件中找到。它列出了站点的[[Wordpress:Glossary#Category|类别]]。 | ||
<pre><?php wp_list_cats(); ?></pre> | <pre><?php wp_list_cats(); ?></pre> | ||
默认情况下,一些模板标签的参数是: | 默认情况下,一些模板标签的参数是: | ||
* ''所有的'' – 显示了所有的分类 | * ''所有的'' – 显示了所有的分类 | ||
* ''类别_专栏'' – 通过类别 ID的分类 | * ''类别_专栏'' – 通过类别 ID的分类 | ||
* ''类别_顺序'' – 以升序的分类 | * ''类别_顺序'' – 以升序的分类 | ||
* ''列表''-将类别设置在一个无顺序的列表上 | * ''列表''-将类别设置在一个无顺序的列表上 | ||
(<tt><ul><li></tt>) | (<tt><ul><li></tt>) | ||
* ''optioncount''-在每个分类中,没有显示文章的数目 | * ''optioncount''-在每个分类中,没有显示文章的数目 | ||
* ''隐藏_空的''-以前两个参数为基础(选择性的和所有的),不显示没有文章的分类 | * ''隐藏_空的''-以前两个参数为基础(选择性的和所有的),不显示没有文章的分类 | ||
* ''use_desc_for_title'' –使用类别描述作为链接的标题 | * ''use_desc_for_title'' –使用类别描述作为链接的标题 | ||
* ''孩子''-显示每个列出的类别的孩子(子类别) | * ''孩子''-显示每个列出的类别的孩子(子类别) | ||
An example of this category list might be: | An example of this category list might be: | ||
这个分类的一个例子可能是: | 这个分类的一个例子可能是: | ||
<div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 110%; font-weight:bold; color: navy"> | <div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 110%; font-weight:bold; color: navy"> | ||
*关于我的生活的故事 | *关于我的生活的故事 | ||
*关于我的家庭的故事 | *关于我的家庭的故事 | ||
*我想分享的东西 | *我想分享的东西 | ||
**关于WordPress | **关于WordPress | ||
**关于写作 | **关于写作 | ||
**关于讲故事 | **关于讲故事 | ||
*关于生活的事实和虚构小说</div> | *关于生活的事实和虚构小说</div> | ||
缩进的列表"关于 WordPress", "关于写", 和"关于讲故事" 是'''母''' 分类 "我想分享的事情"的'''孩子'''或者子类别。默认情况下,这些标题并不是类别的真正的标题,它们是你在[[Wordpress:Administration_Panels|管理]] > [[Wordpress:Administration_Panels#Categories|管理]] > [[Wordpress:Manage_Categories_SubPanel|类别]]面板上设置的类别的'''描述'''。 | 缩进的列表"关于 WordPress", "关于写", 和"关于讲故事" 是'''母''' 分类 "我想分享的事情"的'''孩子'''或者子类别。默认情况下,这些标题并不是类别的真正的标题,它们是你在[[Wordpress:Administration_Panels|管理]] > [[Wordpress:Administration_Panels#Categories|管理]] > [[Wordpress:Manage_Categories_SubPanel|类别]]面板上设置的类别的'''描述'''。 | ||
如果你想显示分类的真正的标题,而不是分类的描述,将模板标签改为: | 如果你想显示分类的真正的标题,而不是分类的描述,将模板标签改为: | ||
<pre><?php wp_list_cats('use_desc_for_title=0'); ?></pre> | <pre><?php wp_list_cats('use_desc_for_title=0'); ?></pre> | ||
零将参数设置为'''错误的''',取消将描述用作标题。现在类别标题会显示: | 零将参数设置为'''错误的''',取消将描述用作标题。现在类别标题会显示: | ||
<div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 110%; font-weight:bold; color: navy"> | <div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 110%; font-weight:bold; color: navy"> | ||
*我生活的故事 | *我生活的故事 | ||
*我的家庭 | *我的家庭 | ||
*分享 | *分享 | ||
**WordPress | **WordPress | ||
**写 | **写 | ||
** | **讲故事 | ||
*事实与虚构</div> | *事实与虚构</div> | ||
如果你不想"分享的"子列表出现在你的列表上,你添加的参数就不会显示子列表,显示的参数只显示标题而不是表述,用布尔数学体系"并且"使用&记号标记( <tt>&</tt> )。 | 如果你不想"分享的"子列表出现在你的列表上,你添加的参数就不会显示子列表,显示的参数只显示标题而不是表述,用布尔数学体系"并且"使用&记号标记( <tt>&</tt> )。 | ||
<pre><?php wp_list_cats('use_desc_for_title=0&children=0'); ?></pre> | <pre><?php wp_list_cats('use_desc_for_title=0&children=0'); ?></pre> | ||
注意在&记号标记的周围没有空格。所有的参数在一起运行,其中没有任何的空格或者引号,只是在整个参数周围有。现在类别标题显示是: | 注意在&记号标记的周围没有空格。所有的参数在一起运行,其中没有任何的空格或者引号,只是在整个参数周围有。现在类别标题显示是: | ||
<div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 110%; font-weight:bold; color: navy"> | <div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 110%; font-weight:bold; color: navy"> | ||
*我生活的故事 | *我生活的故事 | ||
*我的家庭 | *我的家庭 | ||
*分享 | *分享 | ||
*事实和虚构</div> | *事实和虚构</div> | ||
另一个例子,如果你想将类别链接显示为类别标题,将列表按名称的字母表顺序分类,显示每个类别中文章的数字,而且只显示类别ID数字3("分享")的''孩子''(子类别),模板标签看起来就像: | 另一个例子,如果你想将类别链接显示为类别标题,将列表按名称的字母表顺序分类,显示每个类别中文章的数字,而且只显示类别ID数字3("分享")的''孩子''(子类别),模板标签看起来就像: | ||
<pre><?php wp_list_cats('sort_column=name&sort_order=asc&optioncount=1&use_desc_for_title=0&child_of=3'); ?></pre> | <pre><?php wp_list_cats('sort_column=name&sort_order=asc&optioncount=1&use_desc_for_title=0&child_of=3'); ?></pre> | ||
<div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 110%; font-weight:bold; color: navy"> | <div style="border:1px solid blue; width:70%; margin:10px; padding:20px; font-size: 110%; font-weight:bold; color: navy"> | ||
*讲故事(21) | |||
*WordPress(23) | |||
*写(10)</div> | |||
===模板标签和Loop=== | ===模板标签和Loop=== | ||
许多的WordPress的模板标签在[[Wordpress:The_Loop|WordPress Loop]]中运行。这意味着,它们包含在[[Wordpress:Templates|模板文件]]里面,作为php "loop"的一部分,产生了网页,以Loop里面的指示为基础,访客可以看。 | |||
WordPress Loop的开头是: | WordPress Loop的开头是: | ||
<pre><?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?></pre> | <pre><?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?></pre> | ||
在Loop里面运行的模板标签,必须在这里的中间位置上,在下面的Loop的结尾部分之前: | 在Loop里面运行的模板标签,必须在这里的中间位置上,在下面的Loop的结尾部分之前: | ||
<pre><?php endwhile; else: ?> | <pre><?php endwhile; else: ?> | ||
第350行: | 第162行: | ||
<?php endif; ?></pre> | <?php endif; ?></pre> | ||
需要包含在loop里的模板标签包括<tt>[[Wordpress:Template Tags/the_content|内容()]]</tt>, <tt>[[Wordpress:Template Tags/the_excerpt|摘录()]], [[Wordpress:Template Tags/next_post|下一篇文章()]], 和 [[Wordpress:Template Tags/previous_post|上一篇文章()]]</tt>。如果你想使用的模板标签不需要在loop里面,像[[Wordpress:Template Tags/wp_list_cats|<tt>wp_list_cats()</tt>]] 和 [[Wordpress:Template Tags/wp_list_pages|<tt>wp_list_pages()</tt>]],你可以将它放在任何你喜欢的位置,例如在 [[Wordpress:Templates|模板文件]]工具条,标题上,或者页脚 。 | |||
==学习更多关于模板标签== | ==学习更多关于模板标签== | ||
这只是学习不同的强大的模板标签,WordPress用来制作你的站点的网页的微小的一步。在以下的文章和资源中,你可以学习更多的WordPress使用的不同的模板标签。 | 这只是学习不同的强大的模板标签,WordPress用来制作你的站点的网页的微小的一步。在以下的文章和资源中,你可以学习更多的WordPress使用的不同的模板标签。 | ||
* [[Wordpress:Template_Tags|WordPress 模板标签目录]] | * [[Wordpress:Template_Tags|WordPress 模板标签目录]] | ||
* [[Wordpress:Templates|模板]] | * [[Wordpress:Templates|模板]] | ||
* [[Wordpress:Stepping Into Template Tags|走进模板]] | * [[Wordpress:Stepping Into Template Tags|走进模板]] | ||
* [[Wordpress:Template Tags/Anatomy of a Template Tag|一个模板标签解析]] | * [[Wordpress:Template Tags/Anatomy of a Template Tag|一个模板标签解析]] | ||
* [[Wordpress:Template Tags/How to Pass Tag Parameters|怎样通过标签参数]] | * [[Wordpress:Template Tags/How to Pass Tag Parameters|怎样通过标签参数]] | ||
* [[Wordpress:The Loop|The Loop]] | * [[Wordpress:The Loop|The Loop]] | ||
* [[Wordpress:Include Tags|包含标签]] | * [[Wordpress:Include Tags|包含标签]] | ||
* [[Wordpress:Conditional Tags|引起条件反应的标签]] | * [[Wordpress:Conditional Tags|引起条件反应的标签]] | ||
===设计你的模板标签=== | ===设计你的模板标签=== | ||
* [[Wordpress:Styling Lists with CSS|CSS样式表]] | |||
* [[Wordpress:Styling Lists with CSS | |||
* [[Wordpress:Next_and_Previous_Links|课程:上一个和下一个链接]] | * [[Wordpress:Next_and_Previous_Links|课程:上一个和下一个链接]] | ||
* [[Wordpress:Separating_Categories|课程:单独分类]] | |||
* [[Wordpress:Separating_Categories|课程: | |||
* [[Wordpress:Styling_Page-Links|课程: 设计页面链接]] | * [[Wordpress:Styling_Page-Links|课程: 设计页面链接]] | ||
* [[Wordpress:Good_Navigation_Links|课程: 好的导航链接]] | * [[Wordpress:Good_Navigation_Links|课程: 好的导航链接]] | ||
* [[Wordpress:Formatting Date and Time|安排日期和时间的格式]] | * [[Wordpress:Formatting Date and Time|安排日期和时间的格式]] | ||
== 外部资源 == | == 外部资源 == | ||
* [[Wordpress:fr:Decouvrir_les_Marqueurs_de_Modele]] | * [[Wordpress:fr:Decouvrir_les_Marqueurs_de_Modele]] | ||
Template Tags and The Loop=== |
2008年5月27日 (二) 10:46的最新版本
导航: 上一级 | WordPress | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy
你如果看看你的WordPress 主题上的header.php 模板文件,你就会注意到,在显示"我的博客名"的地方,不管它是什么,当你访问你的WordPress站点时,它在模板文件中不再显示"我的博客名"。事实上,它有一大堆的奇怪的箭头和括号和字母,都没有什么意思。 这是一个模板标签的一个例子。
让我们在采取一些措施,更深地学习这些是什么,它们是如何运行的。
一个模板标签是什么[ ]
一个模板标签是一个代码来指示WordPress"去做" 或者 "得到"一些东西。对于你的WordPress站点名的header.php模板标签,它看起来是这样的:
<h1><?php bloginfo('name'); ?></h1>
模板标签 <?php bloginfo(); ?> 包在一个 H1 标题标签中, bloginfo()标签从你的管理面板中的
用户个人基本资料 和选项 > 一般 得到 信息。
模板标签参数[ ]
除了在<?php bloginfo(); ?>模板标签上的名称 参数外,也可以显示其它的信息。然我们来看看这些参数中的其中的几个-在bloginfo() Codex 页面上你可以找到更多的信息和例子。
- 描述
<?php bloginfo('description'); ?>
- 这个称作你的博客的"标签行",这个通常是一些描述性的语句,显示"我的博客是关于...."。它由管理员在选项 > 一般 子面板中设置。
- 管理_邮件
<?php bloginfo('admin_email'); ?>
- 如果你想显示管理员的邮件,你不用将它输进模板文件中。这样做,它可能对邮件 harvesters开放,他会使用复杂的软件来进入并且获得邮件地址用来发表垃圾信息。 通过使用bloginfo('admin_email'), 电子邮件在访客的页面上显示,但真正的地址被harvesters掩饰了。好, 哼? 管理员的电子邮件地址在 选项 > 一般 子面板中设置了。
- 版本
<?php bloginfo('version'); ?>
- 有时你想显示一下你正在使用的WordPress是哪一个版本。默认的WordPress主题在页脚模板中包含了这个信息。它只是显示了你的博客使用的WordPress版本。
显示WordPress版本,模板标签看起来像:
<p>由WordPress 版本支持 <?php bloginfo('version'); ?></p>
注意只有版本数字由版本参数产生,而不是单词"由WordPress 版本支持"。这些单词写在标签的前面,因此可以在网页上看见它们。
学习更多的关于模板标签参数,看看 一个模板标签的解析 和怎样通过标签参数。
你怎样使用模板标签?[ ]
在Codex上模板标签菜单仔细看看不同的模板标签,你就会注意到它们中的许多非常的简单,像bloginfo() 模板标签,但许多看其来使用非常复杂。让我们来看一些例子,关于怎样使用它们来帮助你了解模板标签代码的"语言"。
就如我们在bloginfo()模板标签中所见到的那样,它就用一个字来改变标签的产出。这个字叫做参数 而且它指示模板标签来做 或者 得到一些东西。在这种情况下,指示说明是得到名称来显示站点的名称。
模板标签the_title()显示了文章的标题,通常在你的文章的上方。这个标签得到文章的标题并且显示了标题,默认情况下,它在参数中也有一个do,可以帮助你改变文章标题的外观和显示。
默认情况下,标题看起来像这个:
<?php the_title(); ?>
结果看起来像这个东西:
如果你想加上一些参考来以某种方式突出标题,像一个图形或者字符体像一个箭头符号或者bullet符号。让我们放进一个日元符号,&日元;,日本钱的标记,放到我们的标题的前面。
如果你仔细看了标签the_title()的指示说明,你就会看到参数是:
<?php the_title('before', 'after', display); ?>
我们想将日元的标记放到标题的前面,在日元标记的后面和标题的前面都有一个空格,让我们把它添加到参数上:
<?php the_title('¥ '); ?>
当网页产生了,这个看起来就像:
现在,我们再深入地看看这个,并且在文章标题的后面再添加一些东西。加入你想鼓励人们阅读,那么我们添加一个小的激励的箭头( » ) 来激发他们。
<?php the_title('¥ ', ' »'); ?>
注意,我们在箭头标记的前面添加了一个空格,当网页可以浏览的时候,箭头标记与文章标题便分开了。
你也可以使用许多不同的方式来设计你的标题。下面是使用标题标签的另一个例子。
<h2><?php the_title('Post Title: '); ?></h2>
我们将整个文章的标题放到了一个H2标题中,并且在文章标题的开头添加短语"文章标题"。
注: 虽然标题是这样的,并不是所有的 模板标签 接受论据之前或者之后。查看抄本页面,找你正使用的特别的标签,看看它支持什么样的论据。
布尔书学体系的模板标签[ ]
以上的模板标签例子使用简单的参数,用引号和逗号将各自隔开。现在考虑一下Boolean 模板标签的例子,使用布尔数学体系技术将不止一个的参数连接起来。一个常见的布尔数学体系表述使用"and (&)"逻辑来连接参数。 模板标签wp_list_cats()通常能在WordPress工具条或者菜单模板文件中找到。它列出了站点的类别。
<?php wp_list_cats(); ?>
默认情况下,一些模板标签的参数是:
- 所有的 – 显示了所有的分类
- 类别_专栏 – 通过类别 ID的分类
- 类别_顺序 – 以升序的分类
- 列表-将类别设置在一个无顺序的列表上
(<ul><li>)
- optioncount-在每个分类中,没有显示文章的数目
- 隐藏_空的-以前两个参数为基础(选择性的和所有的),不显示没有文章的分类
- use_desc_for_title –使用类别描述作为链接的标题
- 孩子-显示每个列出的类别的孩子(子类别)
An example of this category list might be: 这个分类的一个例子可能是:
- 关于我的生活的故事
- 关于我的家庭的故事
- 我想分享的东西
- 关于WordPress
- 关于写作
- 关于讲故事
- 关于生活的事实和虚构小说
缩进的列表"关于 WordPress", "关于写", 和"关于讲故事" 是母 分类 "我想分享的事情"的孩子或者子类别。默认情况下,这些标题并不是类别的真正的标题,它们是你在管理 > 管理 > 类别面板上设置的类别的描述。
如果你想显示分类的真正的标题,而不是分类的描述,将模板标签改为:
<?php wp_list_cats('use_desc_for_title=0'); ?>
零将参数设置为错误的,取消将描述用作标题。现在类别标题会显示:
- 我生活的故事
- 我的家庭
- 分享
- WordPress
- 写
- 讲故事
- 事实与虚构
如果你不想"分享的"子列表出现在你的列表上,你添加的参数就不会显示子列表,显示的参数只显示标题而不是表述,用布尔数学体系"并且"使用&记号标记( & )。
<?php wp_list_cats('use_desc_for_title=0&children=0'); ?>
注意在&记号标记的周围没有空格。所有的参数在一起运行,其中没有任何的空格或者引号,只是在整个参数周围有。现在类别标题显示是:
- 我生活的故事
- 我的家庭
- 分享
- 事实和虚构
另一个例子,如果你想将类别链接显示为类别标题,将列表按名称的字母表顺序分类,显示每个类别中文章的数字,而且只显示类别ID数字3("分享")的孩子(子类别),模板标签看起来就像:
<?php wp_list_cats('sort_column=name&sort_order=asc&optioncount=1&use_desc_for_title=0&child_of=3'); ?>
- 讲故事(21)
- WordPress(23)
- 写(10)
模板标签和Loop[ ]
许多的WordPress的模板标签在WordPress Loop中运行。这意味着,它们包含在模板文件里面,作为php "loop"的一部分,产生了网页,以Loop里面的指示为基础,访客可以看。
WordPress Loop的开头是:
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
在Loop里面运行的模板标签,必须在这里的中间位置上,在下面的Loop的结尾部分之前:
<?php endwhile; else: ?> <p><?php _e('Sorry, no posts matched your criteria.'); ?></p> <?php endif; ?>
需要包含在loop里的模板标签包括内容(), 摘录(), 下一篇文章(), 和 上一篇文章()。如果你想使用的模板标签不需要在loop里面,像wp_list_cats() 和 wp_list_pages(),你可以将它放在任何你喜欢的位置,例如在 模板文件工具条,标题上,或者页脚 。
学习更多关于模板标签[ ]
这只是学习不同的强大的模板标签,WordPress用来制作你的站点的网页的微小的一步。在以下的文章和资源中,你可以学习更多的WordPress使用的不同的模板标签。
设计你的模板标签[ ]
外部资源[ ]
Template Tags and The Loop===