url.php

Go to the documentation of this file.

<?php
$excerpt_length = elgg_extract('excerpt_length', $vars, 100);
unset($vars['excerpt_length']);

if (!empty($vars['confirm']) && !isset($vars['is_action'])) {
    $vars['is_action'] = true;
}

if (!empty($vars['confirm'])) {
    $vars['data-confirm'] = elgg_extract('confirm', $vars);
    
    // if (bool) true use defaults
    if ($vars['data-confirm'] === true) {
        $vars['data-confirm'] = elgg_echo('question:areyousure');
    }
}

unset($vars['confirm']);

$allowed_schemes = elgg_extract('allowed_schemes', $vars, ['http', 'https', 'ftp', 'sftp', 'ssh', 'file', 'mailto', 'tel']);
if ($allowed_schemes !== false && !is_array($allowed_schemes)) {
    $allowed_schemes = (array) $allowed_schemes;
}

unset($vars['allowed_schemes']);

$url = elgg_extract('href', $vars);
if ($url === false) {
    $url = 'javascript:void(0);';
    $allowed_schemes = false;
}

if (!$url && isset($vars['value'])) {
    $url = trim($vars['value']);
    unset($vars['value']);
}

if (elgg_is_empty($url)) {
    return;
}

if (isset($vars['text'])) {
    if (elgg_extract('encode_text', $vars, false)) {
        $text = htmlspecialchars((string) $vars['text'], ENT_QUOTES, 'UTF-8', false);
    } else {
        $text = elgg_extract('text', $vars);
    }
    
    unset($vars['text']);
} else {
    $text = htmlspecialchars(elgg_get_excerpt((string) $url, $excerpt_length), ENT_QUOTES, 'UTF-8', false);
}

unset($vars['encode_text']);

if ($url) {
    $url = elgg_normalize_url($url);
    
    // make sure the scheme of the URL is allowed
    $scheme = parse_url($url, PHP_URL_SCHEME);
    if (!empty($scheme) && $allowed_schemes !== false && !in_array($scheme, $allowed_schemes)) {
        $url = "denied:{$url}";
    }

    if (elgg_extract('is_action', $vars, false)) {
        $url = elgg_add_action_tokens_to_url($url, false);
    }

    $is_trusted = elgg_extract('is_trusted', $vars);
    if (!$is_trusted) {
        $url = strip_tags($url);
        if (!isset($vars['rel'])) {
            if ($is_trusted === null) {
                $url_host = parse_url($url, PHP_URL_HOST);
                $site_url = elgg_get_site_url();
                $site_url_host = parse_url($site_url, PHP_URL_HOST);
                $is_trusted = $url_host == $site_url_host;
            }
            
            if ($is_trusted === false) {
                // this is an external URL, which we do not want to be indexed by crawlers
                $vars['rel'] = 'nofollow';
            }
        }
    }

    $vars['href'] = $url;
}

if (!isset($vars['title']) && isset($vars['data-confirm'])) {
    $vars['title'] = elgg_extract('data-confirm', $vars);
}

unset($vars['is_action']);
unset($vars['is_trusted']);

$vars['class'] = elgg_extract_class($vars, 'elgg-anchor');

if (!isset($vars['aria-label']) && !isset($vars['aria-labelledby']) && !isset($vars['title']) && empty(elgg_strip_tags((string) $text))) {
    elgg_log('An output/url should have a discernible text (text, title, aria-label or aria-labelledby)', 'NOTICE');
}

if (!elgg_is_empty($text)) {
    $text = elgg_format_element('span', [
        'class' => 'elgg-anchor-label',
    ], $text);
}

$icon = elgg_extract('icon', $vars, '');
unset($vars['icon']);

if ($icon && !str_starts_with($icon, '<')) {
    $icon = elgg_view_icon($icon, [
        'class' => 'elgg-anchor-icon',
    ]);
}

$icon_alt = elgg_extract('icon_alt', $vars, '');
unset($vars['icon_alt']);

if ($icon_alt && !str_starts_with($icon_alt, '<')) {
    $icon_alt = elgg_view_icon($icon_alt, [
        'class' => 'elgg-anchor-icon-alt',
    ]);
}

$badge = elgg_extract('badge', $vars);
unset($vars['badge']);

if (!is_null($badge)) {
    $badge = elgg_format_element('span', ['class' => 'elgg-badge'], $badge);
}

$classes = elgg_extract_class($vars);
if (in_array('elgg-popup', $classes)) {
    elgg_require_js('elgg/popup');
}

if (in_array('elgg-toggle', $classes)) {
    elgg_require_js('elgg/toggle');
}

echo elgg_format_element('a', $vars, $icon . $text . $icon_alt . $badge);