_make_clickable_rel_attr( string $url ): string

Parameters

$urlstring

The URL.

Return

string

The rel attribute for the anchor or an empty string if no rel attribute should be added.

Hooks fired · 1

One hook fires while _make_clickable_rel_attr() runs, in this order:

1. 1
   apply_filters( make_clickable_rel )filterline 3059 (+25 into the body)

   Filters the rel value that is added to URL matches converted to links.

Uses · 6

• wp_parse_url()A wrapper for PHP's parse_url() function that handles consistency in the return values across PHP versions.
• wp_allowed_protocols()Retrieves a list of protocols to allow in HTML attributes.
• wp_is_internal_link()Determines whether or not the specified URL is of a host included in the internal hosts list.
• current_filter()Retrieves the name of the current filter hook.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• esc_attr()Escaping for HTML attributes.

Used by · 2

• _make_url_clickable_cb()Callback to convert URI match to HTML A element.
• _make_web_ftp_clickable_cb()Callback to convert URL match to HTML A element.

Source

View on Trac ↗View on GitHub ↗

3034function _make_clickable_rel_attr( $url ) {3035	$rel_parts        = array();3036	$scheme           = strtolower( wp_parse_url( $url, PHP_URL_SCHEME ) );3037	$nofollow_schemes = array_intersect( wp_allowed_protocols(), array( 'https', 'http' ) );3038 3039	// Apply "nofollow" to external links with qualifying URL schemes (mailto:, tel:, etc... shouldn't be followed).3040	if ( ! wp_is_internal_link( $url ) && in_array( $scheme, $nofollow_schemes, true ) ) {3041		$rel_parts[] = 'nofollow';3042	}3043 3044	// Apply "ugc" when in comment context.3045	if ( 'comment_text' === current_filter() ) {3046		$rel_parts[] = 'ugc';3047	}3048 3049	$rel = implode( ' ', $rel_parts );3050 3051	/**3052	 * Filters the rel value that is added to URL matches converted to links.3053	 *3054	 * @since 5.3.03055	 *3056	 * @param string $rel The rel value.3057	 * @param string $url The matched URL being converted to a link tag.3058	 */3059	$rel = apply_filters( 'make_clickable_rel', $rel, $url );3060 3061	$rel_attr = $rel ? ' rel="' . esc_attr( $rel ) . '"' : '';3062 3063	return $rel_attr;3064}

History

Introduced in 6.2.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/formatting.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.