get_search_form 函數在 WordPress 中是用來提取預設的搜索表單或者默認的搜索表單的。因為官方這個函數沒有中文的,所以我就簡單寫了一下。
描述
get_search_form 函數在 WordPress 中是用來提取自定義搜索表單或者默認的搜索表單的。
顯示自定義表單還是顯示默認表單,完全取決於您的主題中是否有search.php文件,
如果有該文件,則自動調用該文件,如果沒有則顯示默認的搜索表單。
使用
<?php get_search_form($echo = true) ?>
參數
$echo 布爾型,用來選擇顯示還是返回變量。
默認值:true
實例
沒你想象的復雜,其實就是這麼簡單。
<?php get_search_form(); ?>
這裡提一下,如果你需要整合谷歌自定義搜索那些的話,
你只要在你的search.php 文件中將自定義的部分代碼放入即可喽,當然你需要設定樣式。
函數源代碼
<?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); } ?>