讲解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