讲解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 文件，则默认为下边的表单代码：





<form role="search" method="get" id="searchform" class="searchform" action="<?php esc_url( home_url( '/' )); ?>">

  <div>

    <label class="screen-reader-text" for="s"><?php _x( 'Search for:', 'label' ); ?></label>

    <input type="text" value="<?php get_search_query(); ?>" name="s" id="s" />

    <input type="submit" id="searchsubmit" value="<?php esc_attr_x( 'Search', 'submit button' ); ?>" />

  </div>

</form>





其它

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