wp_enqueue_script() │ WP 2.1.0

Допустимо, ви хочете замість бібліотеки jQuery зі складу WordPress підключити її CDN-копію. Додати цей код до файлу functions.php активної теми:

add_action( 'wp_enqueue_scripts', 'my_scripts_method', 11);
function my_scripts_method() {
	wp_deregister_script('jquery');
	wp_register_script( 'jquery', 'http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js');
	wp_enqueue_script('jquery');
}

Щоб змінити файл, URL файлу відрізнявся і він завантажився в браузер як новий, а не брався з кешу, можна вказати версію файлу динамічно на основі часу зміни файлу:

add_action('wp_enqueue_scripts', 'my_scripts_method');
function my_scripts_method() {
	wp_enqueue_script('custom-script',
		get_template_directory_uri() . '/js/custom_script.js',
		array('jquery'),
		filemtime( get_theme_file_path('js/custom_script.js') )
	);
}

Продуктивність filemtime() дуже висока – на SSD диску 0,5 с на 50к ітерацій – це дуже швидко!

// На зовнішній частині сайту (у темі оформлення)
add_action( 'wp_enqueue_scripts', 'my_scripts_method' );
function my_scripts_method() {
	wp_enqueue_script('scriptaculous');
}

Зареєструємо та додамо новий скрипт, який залежить від jquery (це також викликає завантаження jquery на сторінці):

add_action( 'wp_enqueue_scripts', 'my_scripts_method' );
function my_scripts_method() {
	$script_url = plugins_url( '/js/newscript.js', __FILE__ );
	wp_enqueue_script('custom-script', $script_url, array('jquery') );
}

Допустимо нам потрібно використовувати умовні теги, щоб підвантажити свій скрипт scriptaculous. Тоді ми можемо підключитися на хук wp , в момент його спрацьовування ми вже можемо використовувати умовні теги, тому через нього ми можемо визначити для яких типів сторінок підключити скрипт, а для яких немає:

add_action('wp', 'add_my_script_where_it_necessery');
function add_my_script_where_it_necessery(){
	if( is_single() )
		add_action( 'wp_enqueue_scripts', 'my_scripts_method' );
}
function my_scripts_method() {
	$script_url = plugins_url( '/js/newscript.js', __FILE__ );
	wp_enqueue_script('newscript', $script_url, array('scriptaculous'));
}

Часто потрібно, щоб перед JavaScript-файлами, що постачаються з темою оформлення, був завантажений інший JavaScript-файл. WordPress надає API, що дозволяє під час реєстрації скрипта вказати його залежності. Наприклад, тема з наведеним нижче кодом вимагає, щоб перед скриптом custom_script.js була завантажена бібліотека jQuery:

add_action('wp_enqueue_scripts', 'my_scripts_method');
function my_scripts_method() {
	wp_enqueue_script('custom-script',
		get_template_directory_uri() . '/js/custom_script.js',
		array('jquery')
	);
}

add_action( 'admin_menu', 'my_plugin_admin_menu');
function my_plugin_admin_menu() {
	// Реєструємо сторінку плагіна
	$page = add_submenu_page(
		'edit.php', // Батьківська сторінка меню
		__( 'Мій плагін', 'myPlugin' ), // Назва пункту меню
		__( 'Мій плагін', 'myPlugin' ), // Заголовок сторінки
		'manage_options' // Можливість, що визначає рівень доступу до пункту
		'my_plugin-options', // Ярлик (частина адреси) сторінки плагіна
		'my_plugin_manage_menu' // Функція, яка виводить сторінку
	);

	// Використовуємо зареєстровану сторінку для завантаження скрипту
	add_action( 'load-' . $page, 'my_plugin_admin_scripts' );
}

## Ця функція буде викликана тільки на сторінці плагіна, підключаємо скрипт
function my_plugin_admin_scripts() {
	wp_enqueue_script( 'my-plugin-script', plugins_url('/script.js', __FILE__) );
}

function my_plugin_manage_menu() {
	// Виводимо сторінку плагіна
}

Читайте в окремій статті .

При реєстрації скрипта йому вказується версія (поточна версія вордпресу, за замовчуванням): /wp-includes/css/dashicons.min.css?ver=4.9 . Таку версію можна вирізати із посилання на скрипт або файл стилів:

Видалення всіх версій у всіх скриптів (і стилів):

// Видаляємо версію скриптів
add_filter( 'script_loader_src', '_remove_script_version' );
// Видаляємо версію стилів
add_filter( 'style_loader_src', '_remove_script_version' );
function _remove_script_version( $src ){
	$parts = explode('?', $src);
	return $parts[0];
}

Видалення лише версій WordPress:

## видаляє версію WP з відданого URL у скриптів та стилів
add_filter( 'script_loader_src', 'hb_remove_wp_version_from_src');
add_filter( 'style_loader_src', 'hb_remove_wp_version_from_src');
function hb_remove_wp_version_from_src( $src ) {
	 Global $wp_version;
	 parse_str (parse_url ($ src, PHP_URL_QUERY), $ query);
	 if ( ! empty($query['ver']) && $query['ver'] === $wp_version ) {
		  $src = remove_query_arg('ver', $src);
	 }
	 return $src;
}