wp_register_script() │ WP 2.1.0

Реєструє файл скрипта, щоб надалі підключати його, використовуючи функцію wp_enqueue_script() .

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

При написанні плагіна або теми рекомендується підключати скрипти через цю функцію або її аналог wp_enqueue_script() .

Хуків немає.

Повертає

true|false. 3 вертає true/false. До цього нічого не повертала.

Використання

wp_register_script($handle, $src, $deps, $ver, $in_footer);

$handle
(рядок) (обов’язковий)

Назва скрипта. Має бути унікальним, оскільки воно буде використовуватися для виклику надалі функції
wp_enqueue_script() .

$src
(рядок) (обов’язковий)

URL, шлях до скрипту, наприклад,
http://example.com/wp-content/themes/my-theme/my-theme-script.js . Ніколи не пишіть URL безпосередньо, якщо він лежить у файлах движка або плагіні, використовуйте спеціальні функції шляхів:
plugins_url() для плагінів та
get_template_directory_uri() для тем. Видалені скрипти вказуйте без протоколу так:
//otherdomain.com/js/their-script.js .

$deps
(масив)

Масив назв усіх зареєстрованих скриптів, від яких цей. Зазначені тут скрипти будуть завантажені перед поточним. Вкажіть false, якщо немає залежних сценаріїв.


За замовчуванням: array()

$ver
(рядок)

Версія скрипта, яка буде додана в кінець шляху до файлу як аргумент (?ver=1.1). Якщо версії немає вкажіть
false, тоді WordPress додасть до кінця поточну версію WP. Якщо вказати
null, жодна версія не буде додана.Цей параметр потрібен, щоб коректна версія скрипта була завантажена користувачами, в обхід кешу.


Типово: false

$in_footer
(логічний)

Де виводити скрипт: у head чи footer. Зазвичай скрипти розташовуються у head частині. Якщо цей параметр дорівнюватиме true скрипт буде додано в кінець body тега, для цього тема повинна містити функцію
wp_footer() перед закриваючим тегом
</body>.


Типово: false

Приклади

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, ['jquery'], '1.0', true);
}

add_action( 'init', 'register_remote_scripts' );
add_action( 'wp_enqueue_scripts', 'add_remote_scripts' );

function register_remote_scripts(){

	wp_register_script( 'someScript-js', 'https://domain.com/someScript.js' , '', '', true );
}

function add_remote_scripts(){

	wp_enqueue_script( 'someScript-js');
}

add_action( 'wp_enqueue_scripts', 'add_remote_scripts' );

function add_remote_scripts(){

	wp_enqueue_script( 'someScript-js', 'https://domain.com/someScript.js' , '', '', true );
}

add_action( 'init', 'register_myscripts');
add_action( 'wp_enqueue_scripts', 'add_myscripts');

// реєструємо скрипт
function register_myscripts(){

	$url = get_template_directory_uri() .'/myscript.js';

	wp_register_script( 'myfirstscript', $url, [ 'jquery', 'jquery-ui' ], 'v2.0', true );
}

// Підключаємо скрипти (ставимо в чергу на виведення в HTML)
function add_myscripts() {

	wp_enqueue_script( 'myfirstscript');
}

Додати свій приклад

Скрипти зареєстровані WordPress

WordPress реєструє багато популярних скрипти по дефолту і щоб додати такий скрипт на сторінку потрібно просто додати його до висновку функцією wp_enqueue_script( $handle ) , де $handle вказати один з наступних ключів (актуально для WP 3.8+).