get_search_form 获取搜索表单 默认搜索框修改

admin

引入 searchform.php 文件来显示搜索表单。

用法

1. <?php get_search_form( $echo ); ?>

复制代码

参数

$echo : (布尔值) (可选) 如果是 true 则输出表单； false 则返回表单的字符串。默认: true

返回值
(字符串string)，如果参数 $echo 设置为 false，就返回表单的HTML代码。

例子
如果你的主题没有 searchform.php， WordPress 将使用其内置的搜索表单：

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

复制代码

如果你的主题没有 searchform.php ，将自动使用上面的代码替代。请记住，搜索表单需要一个 Get 方式（method="get" ）到你博客的首页，而且文本输入框应该被命名为 s （name="s"），此外，还必须向上面的例子一样包含标题 。

一个自定义的 searchform.php 例子：

1. <form action="/" method="get">
   
2.     <fieldset>
   
3.         <label for="search">Search in <?php echo home_url( '/' ); ?></label>
   
4.         <input type="text" name="s" id="search" value="<?php the_search_query(); ?>" />
   
5.         <input type="image" alt="Search" src="<?php bloginfo( 'template_url' ); ?>/images/search.png" />
   
6.     </fieldset>
   
7. </form>

复制代码

最后一个选项是写一个自定义的函数（在你的 functions.php 文件中）并挂载这个函数到 get_search_form 钩子。

1. 
   
2. function my_search_form( $form ) {
   
3. 
   
4.     $form = '<form role="search" method="get" id="searchform" action="' . home_url( '/' ) . '" >
   
5.     <div><label class="screen-reader-text" for="s">' . __('Search for:') . '</label>
   
6.     <input type="text" value="' . get_search_query() . '" name="s" id="s" />
   
7.     <input type="submit" id="searchsubmit" value="'. esc_attr__('Search') .'" />
   
8.     </div>
   
9.     </form>';
   
10. 
    
11.     return $form;
    
12. }
    
13. 
    
14. add_filter( 'get_search_form', 'my_search_form' );

复制代码

注释
searchform.php 存在时，$echo 参数将被忽略。一个解决办法是使用 get_search_form 过滤钩子来确保通过 get_search_form() 获取搜索表单。

所在文件
get_search_form() 包含在 wp-includes/general-template.php.