plugins_url( string $path = '', string $plugin = '' )
Retrieves a URL within the plugins or mu-plugins directory.
Description Description
Defaults to the plugins directory URL if no arguments are supplied.
Parameters Parameters
- $path
-
(string) (Optional) Extra path appended to the end of the URL, including the relative directory if $plugin is supplied.
Default value: ''
- $plugin
-
(string) (Optional) A full path to a file inside a plugin or mu-plugin. The URL will be relative to its directory. Typically this is done by passing
__FILE__
as the argument.Default value: ''
Return Return
(string) Plugins URL link with optional paths appended.
Source Source
File: wp-includes/link-template.php
function plugins_url( $path = '', $plugin = '' ) { $path = wp_normalize_path( $path ); $plugin = wp_normalize_path( $plugin ); $mu_plugin_dir = wp_normalize_path( WPMU_PLUGIN_DIR ); if ( ! empty( $plugin ) && 0 === strpos( $plugin, $mu_plugin_dir ) ) { $url = WPMU_PLUGIN_URL; } else { $url = WP_PLUGIN_URL; } $url = set_url_scheme( $url ); if ( ! empty( $plugin ) && is_string( $plugin ) ) { $folder = dirname( plugin_basename( $plugin ) ); if ( '.' != $folder ) { $url .= '/' . ltrim( $folder, '/' ); } } if ( $path && is_string( $path ) ) { $url .= '/' . ltrim( $path, '/' ); } /** * Filters the URL to the plugins directory. * * @since 2.8.0 * * @param string $url The complete URL to the plugins directory including scheme and path. * @param string $path Path relative to the URL to the plugins directory. Blank string * if no path is specified. * @param string $plugin The plugin file path to be relative to. Blank string if no plugin * is specified. */ return apply_filters( 'plugins_url', $url, $path, $plugin ); }
Expand full source code Collapse full source code View on Trac
Changelog Changelog
Version | Description |
---|---|
2.6.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Common Usage
The
plugins_url()
function is commonly used in a plugin file. Passing the__FILE__
PHP magic constant in the place of the$plugin
parameter makes the$path
relative to the parent directory of that file:The above might output this HTML markup:
<img src="http://www.example.com/wp-content/plugins/my-plugin/images/wordpress.png">
.If you are using the
plugins_url()
function in a file that is nested inside a subdirectory of your plugin directory, you should use PHP’sdirname()
function:The above might output this HTML markup:
<img src="http://www.example.com/wp-content/plugins/images/wordpress.png">
.Default Usage
The
$plugins_url
variable will equal to the absolute URL to theplugins
ormu-plugins
directory, e.g. “http://www.example.com/wp-content/plugins”.