WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

_links_add_base()

_links_add_base( string $m ): string

In this article

Back to top

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Callback to add a base URL to relative links in passed content.

Parameters

$mstringrequired
The matched link.

Return

string The processed link.

Source

function _links_add_base( $m ) {
	global $_links_add_base;
	// 1 = attribute name  2 = quotation mark  3 = URL.
	return $m[1] . '=' . $m[2] .
		( preg_match( '#^(\w{1,20}):#', $m[3], $protocol ) && in_array( $protocol[1], wp_allowed_protocols(), true ) ?
			$m[3] :
			WP_Http::make_absolute_url( $m[3], $_links_add_base )
		)
		. $m[2];
}

View all references View on Trac View on GitHub

UsesDescription
WP_Http::make_absolute_url()wp-includes/class-wp-http.php

Converts a relative URL to an absolute URL relative to a given URL.

wp_allowed_protocols()wp-includes/functions.php

Retrieves a list of protocols to allow in HTML attributes.

Changelog

VersionDescription
2.7.0Introduced.

User Contributed Notes

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