includes_url()WP 2.6.0

Retrieves the URL to the wp-includes directory with the appropriate protocol: 'https' or 'http'.

The function adds https to the URL if is_ssl() returns true, in other cases it adds http.

It's better to use this function instead of the hardcoded path to wp-includes because WordPress can be moved to a subdirectory.

Uses WPINC constant.

1 time — 0.003941 sec (very slow) | 50000 times — 2.29 sec (fast) | PHP 7.2.16, WP 5.2
Hooks from the function

Return

String. Includes URL link with optional path appended.

Usage

includes_url( $path, $scheme );
$path(string)
Path relative to the includes URL.
Default: ''
$scheme(string|null)
Scheme to give the includes URL context. Accepts 'http', 'https', or 'relative'.
Default: null

Examples

0

#1 Basic usage

$url = includes_url();
echo $url;

// Output: http://wp-kama.com/wp-includes/

Changelog

Since 2.6.0 Introduced.

includes_url() code WP 6.4.3

function includes_url( $path = '', $scheme = null ) {
	$url = site_url( '/' . WPINC . '/', $scheme );

	if ( $path && is_string( $path ) ) {
		$url .= ltrim( $path, '/' );
	}

	/**
	 * Filters the URL to the includes directory.
	 *
	 * @since 2.8.0
	 * @since 5.8.0 The `$scheme` parameter was added.
	 *
	 * @param string      $url    The complete URL to the includes directory including scheme and path.
	 * @param string      $path   Path relative to the URL to the wp-includes directory. Blank string
	 *                            if no path is specified.
	 * @param string|null $scheme Scheme to give the includes URL context. Accepts
	 *                            'http', 'https', 'relative', or null. Default null.
	 */
	return apply_filters( 'includes_url', $url, $path, $scheme );
}