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