функция
since 2.6.0
plugins_url()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
plugins_url( string $path = '', string $plugin = '' ): string
Описание
По умолчанию возвращает URL каталога plugins, если аргументы не переданы.
Оригинал (английский)
Defaults to the plugins directory URL if no arguments are supplied.
Параметры
$path
string
необязательный
= ''
Дополнительный путь, добавляемый в конец URL, включая относительный каталог, если передан $plugin.
$plugin
string
необязательный
= ''
Полный путь к файлу внутри плагина или mu-плагина.
URL будет относительным по отношению к его каталогу.
Обычно это делается передачей __FILE__ в качестве аргумента.
Возвращаемое значение
string
Исходный код
wp-includes/link-template.php:3684
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 ) && str_starts_with( $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 );
}
История изменений
| Версия | Описание |
|---|---|
| 2.6.0 | Introduced. |

