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.

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)

Scheme to give the includes URL context. Accepts 'http', 'https', or 'relative'.
Default: null

Examples

#1 Basic usage

$url = includes_url();
echo $url;

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

Changelog

Code of includes url: wp-includes/link-template.php ^{WP 5.2.4}

<?php
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
	 *
	 * @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.
	 */
	return apply_filters( 'includes_url', $url, $path );
}

Related Functions

From tag: Link (URL)

More from category: Admin Menu