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|null)

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() includes url ^{WP 5.8.1}

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 );
}

Related Functions

Link (URL)

Admin Menu