讲解WordPress中用于获取评论模板和搜索表单的PHP函数

这篇文章主要介绍了WordPress中用于获取评论模板和搜索表单的PHP函数,需要的朋友可以参考下。

comments_template()（获取评论模板）

comments_template() 函数用来获取评论模板，一般只能用在文章或者页面上，如果不是文章或者页面将无法显示。

用法

comments_template( $file, $separate_comments );

参数

$file

（字符串）（可选）要评论模板文件。

默认值：/comments.php（当前主题根目录的 comments.php 文件）。

$separate_comments

（布尔）（可选）是否根据评论的类型区分评论。

默认值：False

返回值

此函数无返回值。

例子

默认引入当前主题根目录的 comments.php 文件。

<?php comments_template(); ?>

引入自定义文件：

<?php comments_template( '/short-comments.php' ); ?>

其它

此函数位于：wp-includes/comment-template.php

get_search_form()（获取搜索表单）

get_search_form() 函数用来获取搜索表单，搜索表单的代码位于当前主题根目录的 searchform.php 文件。

用法

get_search_form( $echo );

参数

$echo

（布尔）（可选）如果为真则直接打印搜索表单，如果不为真则返回搜索表单的代码。

默认值：True

返回值

（string）如果 $echo 参数为 False，则返回搜索表单的 Html 代码。

例子

如果主题根目录没有 searchform.php 文件，则默认为下边的表单代码：

1. <form role="search" method="get" id="searchform" class="searchform" action="<?php esc_url( home_url( '/' )); ?>"> 
2.   <div> 
3.     <label class="screen-reader-text" for="s"><?php _x( 'Search for:', 'label' ); ?></label> 
4.     <input type="text" value="<?php get_search_query(); ?>" name="s" id="s" /> 
5.     <input type="submit" id="searchsubmit" value="<?php esc_attr_x( 'Search', 'submit button' ); ?>" /> 
6.   </div> 
7. </form> 

其它

此函数位于：wp-includes/general-template.php