WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_is_internal_link()

wp_is_internal_link( string $link ): bool

In this article

Back to top

Determines whether or not the specified URL is of a host included in the internal hosts list.

Description

See also

Parameters

$linkstringrequired
The URL to test.

Return

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

Source

function wp_is_internal_link( $link ) {
	$link = strtolower( $link );
	if ( in_array( wp_parse_url( $link, PHP_URL_SCHEME ), wp_allowed_protocols(), true ) ) {
		return in_array( wp_parse_url( $link, PHP_URL_HOST ), wp_internal_hosts(), true );
	}
	return false;
}

View all references View on Trac View on GitHub

UsesDescription
wp_internal_hosts()wp-includes/link-template.php

Returns an array of URL hosts which are considered to be internal hosts.

wp_parse_url()wp-includes/http.php

A wrapper for PHP’s parse_url() function that handles consistency in the return values across PHP versions.

wp_allowed_protocols()wp-includes/functions.php

Retrieves a list of protocols to allow in HTML attributes.

Used byDescription
_make_clickable_rel_attr()wp-includes/formatting.php

Helper function used to build the “rel” attribute for a URL when creating an anchor using make_clickable() .

wp_rel_callback()wp-includes/formatting.php

Callback to add a rel attribute to HTML A element.

get_comment_author_link()wp-includes/comment-template.php

Retrieves the HTML link to the URL of the author of the current comment.

Changelog

VersionDescription
6.2.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.