WordPress中用于獲取搜索表單的PHP函數(shù)使用解析

更新時間：2016年01月05日 16:09:16 作者：稍息少年

這篇文章主要介紹了WordPress中用于獲取搜索表單的PHP函數(shù)使用解析,即get_search_form函數(shù)的基本用法,需要的朋友可以參考下

get_search_form 函數(shù)在 WordPress 中是用來提取預設的搜索表單或者默認的搜索表單的。因為官方這個函數(shù)沒有中文的，所以我就簡單寫了一下。

描述
get_search_form 函數(shù)在 WordPress 中是用來提取自定義搜索表單或者默認的搜索表單的。
顯示自定義表單還是顯示默認表單，完全取決于您的主題中是否有search.php文件，
如果有該文件，則自動調用該文件，如果沒有則顯示默認的搜索表單。

使用

<?php
  get_search_form($echo = true) 
?>

參數(shù)
$echo 布爾型，用來選擇顯示還是返回變量。
默認值：true

實例
沒你想象的復雜，其實就是這么簡單。

<?php
  get_search_form(); 
?>

這里提一下，如果你需要整合谷歌自定義搜索那些的話，
你只要在你的search.php 文件中將自定義的部分代碼放入即可嘍，當然你需要設定樣式。

函數(shù)源代碼

<?php
 /**
 * Display search form.
 *
 * Will first attempt to locate the searchform.php file in either the child or
 * the parent, then load it. If it doesn't exist, then the default search form
 * will be displayed. The default search form is HTML, which will be displayed.
 * There is a filter applied to the search form HTML in order to edit or replace
 * it. The filter is 'get_search_form'.
 *
 * This function is primarily used by themes which want to hardcode the search
 * form into the sidebar and also by the search widget in WordPress.
 *
 * There is also an action that is called whenever the function is run called,
 * 'get_search_form'. This can be useful for outputting JavaScript that the
 * search relies on or various formatting that applies to the beginning of the
 * search. To give a few examples of what it can be used for.
 *
 * @since 2.7.0
 * @param boolean $echo Default to echo and not return the form.
 */
function get_search_form($echo = true) {
 do_action( 'get_search_form' );
 
 $search_form_template = locate_template('searchform.php');
 if ( '' != $search_form_template ) {
 require($search_form_template);
 return;
 }
 
 $form = '<form role="search" method="get" id="searchform" action="' . esc_url( home_url( '/' ) ) . '" >
 <div><label class="screen-reader-text" for="s">' . __('Search for:') . '</label>
 <input type="text" value="' . get_search_query() . '" name="s" id="s" />
 <input type="submit" id="searchsubmit" value="'. esc_attr__('Search') .'" />
 </div>
 </form>';
 
 if ( $echo )
 echo apply_filters('get_search_form', $form);
 else
 return apply_filters('get_search_form', $form);
}
?>

您可能感興趣的文章: