get_search_link() - WordPress 函数参考中文文档

返回介绍

get_search_link()

发布于 2017-09-11 字数2237 浏览 949 评论 0

get_search_link( string $query = '' )

Retrieves the permalink for a search.


描述


参数

$query

(string)
(Optional)
The query string to use. If empty the current query is used.

Default value: ”


返回值

(string) The search permalink.


源代码

File: wp-includes/link-template.php

function get_search_link( $query = '' ) {
	global $wp_rewrite;

	if ( empty($query) )
		$search = get_search_query( false );
	else
		$search = stripslashes($query);

	$permastruct = $wp_rewrite->get_search_permastruct();

	if ( empty( $permastruct ) ) {
		$link = home_url('?s=' . urlencode($search) );
	} else {
		$search = urlencode($search);
		$search = str_replace('%2F', '/', $search); // %2F(/) is not valid within a URL, send it un-encoded.
		$link = str_replace( '%search%', $search, $permastruct );
		$link = home_url( user_trailingslashit( $link, 'search' ) );
	}

	/**
	 * Filters the search permalink.
	 *
	 * @since 3.0.0
	 *
	 * @param string $link   Search permalink.
	 * @param string $search The URL-encoded search term.
	 */
	return apply_filters( 'search_link', $link, $search );
}

更新日志

Version 描述
3.0.0 Introduced.

相关函数

Uses

  • wp-includes/general-template.php:
    get_search_query()
  • wp-includes/link-template.php:
    home_url()
  • wp-includes/link-template.php:
    search_link
  • wp-includes/link-template.php:
    user_trailingslashit()
  • wp-includes/plugin.php:
    apply_filters()
  • wp-includes/class-wp-rewrite.php:
    WP_Rewrite::get_search_permastruct()
  • Show 1 more use
    Hide more uses


Used By

  • wp-includes/link-template.php:
    get_search_feed_link()

User Contributed Notes

上一篇:get_search_form()

下一篇:get_search_query()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!