食品法典委员会

对函数、挂钩、类或方法感兴趣吗?查看新的WordPress代码参考!

如何传递标记参数

介绍

模板标记菲律宾比索您可以在WordPress页面模板中嵌入功能,以提供动态博客内容。与PHP函数一样,许多模板标记接受参数。模板标记参数是可用于更改标记输出或以某种方式修改其操作的变量。将参数视为允许您自定义模板标记工作方式的用户选项或设置。

关于参数,WordPress模板标签有三种“风格”。如下所述:

  1. 不带参数的标签
  2. 带有PHP函数样式参数的标记
  3. 带有查询字符串样式参数的标记

不带参数的标签

一些模板标记没有任何选项,因此没有可以传递给它们的参数。

模板标记作者名字()不接受任何参数。此标记仅显示文章作者的名字。没有参数的标记在标记函数的左括号和右括号(括号)之间应该没有任何内容:

<?php the_author_firstname();?>

带有PHP函数样式参数的标记

对于可以接受参数的模板标记,有些要求它们位于默认PHP样式。对于这些,通过将一个或多个值放在函数的括号或方括号内,将参数传递给标记函数。

这个博客信息()标记接受一个参数(称为显示参数),告诉它要显示的博客信息:

 <?php博客信息(“名称”); ?>

这个wp_title()标记最多接受三个参数:第一个是九月或分隔符参数,第二个回声或display参数,第三个是分隔符的位置,sep字符串是添加在选项>概述默认情况下的子面板:

 <?php wp_title(' - '真的“正确”); ?> 

第一个和最后一个参数用单引号括起来,但第二个参数并不是因为第一个和第二个是,而第二个a布尔值参数。(请参见参数的类型有关参数类型和如何使用它们的信息。)

PHP函数样式参数需要记住的要点:

  • 有些函数需要多个参数。
  • 多个参数用逗号分隔。
  • 参数的顺序很重要!

将参数传递给模板标记的函数时,请确保为所有参数指定值直到您要修改的最后一个,否则标签可能无法按预期工作。例如,模板标记获取存档()有六个参数:

 <?php获取架构(“类型”“限制”'格式'“之前”“之后”show_post_count(显示_成本_计数)); ?>  

要以您想要的方式显示存档列表,假设您只需要修改第三个(格式)和第五(之后)参数。为此,还需要确保为第一个、第二个和第四个参数输入默认值:

<?php get_archives('','','自定义','','<br/>');?>

注意使用单引号表示空的参数值,在本例中“”强制这些特定参数的默认值。请注意,传递空参数时,默认值可能会被覆盖,就像参数指定文本字符串一样,并且无法传递空布尔值。因此,请检查文档中参数的默认值,当指定了一个参数时,请将其用作参数值(另请参阅参数的类型有关参数类型的信息)。第六个参数被删除;这是因为WordPress对任何未指定的剩余参数使用默认值。

确保仔细遵循模板标记的文档,并按照模板函数期望的顺序放置参数。最后,要使用模板标记中所有参数的默认值,请使用未指定参数值的标记:

<?php获取存档(); ?>

带有查询字符串样式参数的标记

最后一种模板标记使用所谓的查询字符串样式将参数传递给标记。这些为使用PHP函数参数样式并且具有相对较多的参数。例如,模板标记wp_list_cats()是的包装列表_目录(),一个包含18个参数的标记!

如果要设置排除list_cats()中的

<?php list_cats(TRUE,'All','ID','asc','',TRUE,TRUE、TRUE和FALSE、“”、“”,FALSE,“”,“”、'',“10,11,12');?>

或者您可以使用wp_list_cats():

<?php wp_list_cats('exclude=10,11,12'); ?>

因此,querystring样式标记非常有用,因为它们允许您只更改所需参数的值,而无需为所有或几乎所有参数提供值。然而,并非所有PHP函数样式模板标记都具有等效的查询字符串样式。(还请注意,接受查询字符串样式参数的标记的名称通常以“wp_”前缀开头,例如wp_list_cats(),但请检查标记上的文档以验证其接受参数的方法(如果有)。)

标签wp_list_authors()有六个参数,我们在这里设置了三个:

<?php wp_list_authors('show_fullname=1&feed=rss&optioncount=1'); ?>

首先,所有参数都用单引号或双引号括起来。然后将每个参数输入参数=值格式,而这些字符用与号(&)分隔。分解后,如上所示的标签表示:

  • 参数显示全名(a)布尔值type参数)等于1(正确)。
  • 参数喂养(a)一串type参数)等于rss公司.
  • 参数选项计数(a)布尔值type参数)等于1(正确)。

(请参见参数的类型有关参数类型和如何使用它们的信息。)

查询字符串样式中的参数不必按特定顺序输入。唯一真正需要考虑的是确保参数名称拼写正确。如果易读性有问题,可以用空格分隔参数:

<?php wp_list_authors('show_fullname=1&feed=rss&optioncount=1'); ?>

您还可以将查询字符串分散在多行上(请注意,将每个参数/值对用单引号括起来,并在每一新行的开头加一个点的具体格式):

<?php wp_list_authors(php wp_list_authors)('显示全名=1'.'&feed=rss'.'&optioncount=1');?>

使用查询字符串样式标记时有一些限制,其中您不能传递某些字符,例如与号或引号(单引号或双引号)。在这些情况下,可以使用关联数组:

<?php$params=数组(“type”=>“postbypost”,“限制”=>5,“format”=>“custom”,“之前”=>“<li>&bull&nbsp;',“在‘=>’之后”);wp_get_archives($params); ?>

参数的类型

关于WordPress模板标记,您需要了解三种类型的参数:字符串、整数和布尔值。每种方法的处理方式都有所不同,如下所述。

字符串

字符串是一行文本,通常是从单个字符到几十个单词的任何内容。字符串参数通常是从两个或多个有效选项中选择的显示中的参数博客信息()。否则,字符串将用作要显示的文本,例如九月中的参数wp_title().

在使用PHP函数参数样式,字符串值应括在单(')或双(“)引号中。如果字符串的一部分需要单引号或双引号,请混合使用这些标记(如果参数值中存在单引号,请使用双引号将参数括起来),或使用PHP转义符(反斜杠:\),如下所示,为之前之后中的参数标题(_T):

<?php标题('\'','\''); ?>

整数

整数是一个整数(…,-2,-1,0,1,2,…)。整数参数通常用于基于日期和存档的信息,如的参数获取月链接()标记,或用于指定博客上某些内容的数值,如身份证件中的参数获取permalink().

当传递给PHP函数参数样式标记中,将正确处理引号内或引号外的整数值。因此,以下示例均有效:

<?php get_permalink('100'); ?>
<?php get_permink(100); ?>

布尔值

布尔参数提供简单的真/假评估。

例如日期(_date)标记具有回声参数,该参数接受真的错误的作为一种价值;将参数设置为真的在页面上显示日期,而错误的使标记“返回”日期作为一个值,然后可以在其他PHP代码中使用。

布尔参数可以表示为数值:1对于真的0对于错误的。对于中的布尔值PHP函数参数样式标签,这些都是等效的:

  • 1=真的=真实的
  • 0=错误的=

然而,确实如此不是将布尔值括在引号内。对于查询字符串样式标记,仅使用数字布尔值(10).

回拨

(字符串,数组)回调(或自PHP 5.4起“可调用”)可以是对类/对象中函数名或方法的引用。下面是回调函数的基本示例:

add_action('wp_head','myfuncprefix_add_meta_tag');//函数使用字符串函数myfuncprefix_add_meta_tag(){echo'<meta name=“description”content=“This is an example meta tag”/>';}

如果您在类/对象内部引用方法,则可以在对象内部或外部。该参数需要一个包含2项的数组,首先是对象(object),然后是方法(string)。以下是一些示例:

类Myclassprefix_Some_class{函数__construct(){add_action('wp_head',数组($this,'myfuncprefix_add_meta_tag');}函数myfuncprefix_add_meta_tag(){echo'<meta name=“description”content=“This is an example meta tag”/>';}}

另一种方法是课外活动:

类Myclassprefix_Some_class{函数myfuncprefix_add_meta_tag(){echo'<meta name=“description”content=“This is an example meta tag”/>';}}$some_class=新Myclassprefix_some_class();add_action('wp_head',数组($some_class,'myfuncprefix_add_meta_tag');

注意:永远不要将其他数组元素传递到回调中。它只接受2个元素。其他元素将导致回调不起作用。

另请参阅索引函数参考和的索引模板标签.