get_search_comments_feed_link

The timeline below displays how wordpress function get_search_comments_feed_link has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.3

/**
 * Retrieves the permalink for the search results comments feed.
 *
 * @since 2.5.0
 *
 * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
 *
 * @param string $search_query Optional. Search query. Default empty.
 * @param string $feed         Optional. Feed type. Possible values include 'rss2', 'atom'.
 *                             Default is the value of get_default_feed().
 * @return string The comments feed search results permalink.
 */
function get_search_comments_feed_link($search_query = '', $feed = '')
{
    global $wp_rewrite;
    if (empty($feed)) {
        $feed = get_default_feed();
    }
    $link = get_search_feed_link($search_query, $feed);
    $permastruct = $wp_rewrite->get_search_permastruct();
    if (empty($permastruct)) {
        $link = add_query_arg('feed', 'comments-' . $feed, $link);
    } else {
        $link = add_query_arg('withcomments', 1, $link);
    }
    /** This filter is documented in wp-includes/link-template.php */
    return apply_filters('search_feed_link', $link, $feed, 'comments');
}

WordPress Version: 4.6

/**
 * Retrieves the permalink for the search results comments feed.
 *
 * @since 2.5.0
 *
 * @global WP_Rewrite $wp_rewrite
 *
 * @param string $search_query Optional. Search query. Default empty.
 * @param string $feed         Optional. Feed type. Default empty.
 * @return string The comments feed search results permalink.
 */
function get_search_comments_feed_link($search_query = '', $feed = '')
{
    global $wp_rewrite;
    if (empty($feed)) {
        $feed = get_default_feed();
    }
    $link = get_search_feed_link($search_query, $feed);
    $permastruct = $wp_rewrite->get_search_permastruct();
    if (empty($permastruct)) {
        $link = add_query_arg('feed', 'comments-' . $feed, $link);
    } else {
        $link = add_query_arg('withcomments', 1, $link);
    }
    /** This filter is documented in wp-includes/link-template.php */
    return apply_filters('search_feed_link', $link, $feed, 'comments');
}

WordPress Version: 4.3

/**
 * Retrieve the permalink for the comments feed of the search results.
 *
 * @since 2.5.0
 *
 * @global WP_Rewrite $wp_rewrite
 *
 * @param string $search_query Optional. Search query.
 * @param string $feed         Optional. Feed type.
 * @return string The comments feed search results permalink.
 */
function get_search_comments_feed_link($search_query = '', $feed = '')
{
    global $wp_rewrite;
    if (empty($feed)) {
        $feed = get_default_feed();
    }
    $link = get_search_feed_link($search_query, $feed);
    $permastruct = $wp_rewrite->get_search_permastruct();
    if (empty($permastruct)) {
        $link = add_query_arg('feed', 'comments-' . $feed, $link);
    } else {
        $link = add_query_arg('withcomments', 1, $link);
    }
    /** This filter is documented in wp-includes/link-template.php */
    return apply_filters('search_feed_link', $link, $feed, 'comments');
}

WordPress Version: 4.1

/**
 * Retrieve the permalink for the comments feed of the search results.
 *
 * @since 2.5.0
 *
 * @param string $search_query Optional. Search query.
 * @param string $feed Optional. Feed type.
 * @return string The comments feed search results permalink.
 */
function get_search_comments_feed_link($search_query = '', $feed = '')
{
    global $wp_rewrite;
    if (empty($feed)) {
        $feed = get_default_feed();
    }
    $link = get_search_feed_link($search_query, $feed);
    $permastruct = $wp_rewrite->get_search_permastruct();
    if (empty($permastruct)) {
        $link = add_query_arg('feed', 'comments-' . $feed, $link);
    } else {
        $link = add_query_arg('withcomments', 1, $link);
    }
    /** This filter is documented in wp-includes/link-template.php */
    $link = apply_filters('search_feed_link', $link, $feed, 'comments');
    return $link;
}

WordPress Version: 3.9

/**
 * Retrieve the permalink for the comments feed of the search results.
 *
 * @since 2.5.0
 *
 * @param string $search_query Optional. Search query.
 * @param string $feed Optional. Feed type.
 * @return string
 */
function get_search_comments_feed_link($search_query = '', $feed = '')
{
    global $wp_rewrite;
    if (empty($feed)) {
        $feed = get_default_feed();
    }
    $link = get_search_feed_link($search_query, $feed);
    $permastruct = $wp_rewrite->get_search_permastruct();
    if (empty($permastruct)) {
        $link = add_query_arg('feed', 'comments-' . $feed, $link);
    } else {
        $link = add_query_arg('withcomments', 1, $link);
    }
    /** This filter is documented in wp-includes/link-template.php */
    $link = apply_filters('search_feed_link', $link, $feed, 'comments');
    return $link;
}

WordPress Version: 3.7

/**
 * Retrieve the permalink for the comments feed of the search results.
 *
 * @since 2.5.0
 *
 * @param string $search_query Optional. Search query.
 * @param string $feed Optional. Feed type.
 * @return string
 */
function get_search_comments_feed_link($search_query = '', $feed = '')
{
    global $wp_rewrite;
    if (empty($feed)) {
        $feed = get_default_feed();
    }
    $link = get_search_feed_link($search_query, $feed);
    $permastruct = $wp_rewrite->get_search_permastruct();
    if (empty($permastruct)) {
        $link = add_query_arg('feed', 'comments-' . $feed, $link);
    } else {
        $link = add_query_arg('withcomments', 1, $link);
    }
    $link = apply_filters('search_feed_link', $link, $feed, 'comments');
    return $link;
}