wp_is_internal_link( string $link ): bool

Parameters

$linkstring

The URL to test.

Return

bool

Returns true for internal URLs and false for all other URLs.

Uses · 3

• 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_internal_hosts()Returns an array of URL hosts which are considered to be internal hosts.

Used by · 3

• _make_clickable_rel_attr()Helper function used to build the "rel" attribute for a URL when creating an anchor using make_clickable().
• get_comment_author_link()Retrieves the HTML link to the URL of the author of the current comment.
• wp_rel_callback()Callback to add a rel attribute to HTML A element.

Source

View on Trac ↗View on GitHub ↗

4847function wp_is_internal_link( $link ) {4848	$link = strtolower( $link );4849	if ( in_array( wp_parse_url( $link, PHP_URL_SCHEME ), wp_allowed_protocols(), true ) ) {4850		return in_array( wp_parse_url( $link, PHP_URL_HOST ), wp_internal_hosts(), true );4851	}4852	return false;4853}

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.7.7 tag, from src/wp-includes/link-template.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.