function drupal_add_html_head_link

Adds a LINK tag with distinct attributes to the page's HEAD.

This function can be called as long the HTML header hasn't been sent, which on normal pages is up through the preprocess step of theme('html'). Adding a link will overwrite a prior link with the exact same 'rel', 'href' and 'hreflang' attributes.

Parameters

$attributes: Associative array of element attributes including 'href' and 'rel'.

$header: Optional flag to determine if a HTTP 'Link:' header should be sent.

File

includes/common.inc, line 3000

Code

function drupal_add_html_head_link($attributes, $header = FALSE) {
    $element = array(
        '#tag' => 'link',
        '#attributes' => $attributes,
    );
    $href = $attributes['href'];
    if ($header) {
        // Also add a HTTP header "Link:".
        $href = '<' . $attributes['href'] . '>;';
        unset($attributes['href']);
        $element['#attached']['drupal_add_http_header'][] = array(
            'Link',
            $href . drupal_http_header_attributes($attributes),
            TRUE,
        );
    }
    drupal_add_html_head($element, 'drupal_add_html_head_link:' . $attributes['rel'] . ':' . (isset($attributes['hreflang']) ? "{$attributes['hreflang']}:" : '') . $href);
}