ИТ Блог. Администрирование серверов на основе Linux (Ubuntu, Debian, CentOS, openSUSE)

wp_enqueue_script

AndreyEx
wp_enqueue_script

wp_enqueue_script( string $handle, string $src = false, array $deps = array(),string|bool|null $ver = false, bool $in_footer = false )

Описание

Регистрирует скрипт, если $src при условии (не перезаписывает), и ставит в очередь.

Параметры

$handle

( Строка ) (обязательно) Имя сценария. Должно быть уникальным.

$src

( Строка ) (необязательная) Полный URL сценария, или путь сценария по отношению к корневой директории WordPress.

Значение по умолчанию: false

$deps

( Массив ) (Необязательно) Массив зарегистрированного сценария обрабатывает этот сценарий.

Значение по умолчанию: Array ()

$ver

( Строка | BOOL | NULL ) (необязательно) Строка, номер версии сценария, если он один, который добавляется к URL в виде строки запроса для целей очистки кэша. Если версия устанавливается на false, номер версии автоматически добавляется равной текущей установленной версии WordPress. Если установлено значение NULL, ни одна из версий не добавляется.

Значение по умолчанию: false

$in_footer

( BOOL ) (Необязательно) Следует ли сценарий перед </ body> , а не в <HEAD>. По умолчанию ‘false’.

Значение по умолчанию: false

Источник

Файл: wp-include/wp-scripts.php

function wp_enqueue_script( $handle, $src = false, $deps = array(), $ver = false, $in_footer = false ) {
    $wp_scripts = wp_scripts();
 
    _wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );
 
 
    if ( $src || $in_footer ) {
        $_handle = explode( '?', $handle );
 
        if ( $src ) {
            $wp_scripts->add( $_handle[0], $src, $deps, $ver );
        }
 
        if ( $in_footer ) {
            $wp_scripts->add_data( $_handle[0], 'group', 1 );
        }
    }
 
    $wp_scripts->enqueue( $handle );
}

Использование

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

 

Ссылка на файл сценария в соответствии с зависимостями сценария, если сценарий не был уже включен, и если все зависимости были зарегистрированы. Вы можете либо связать скрипт с handle ранее зарегистрированное с использованием функции wp_register_script(), или предоставить эту функцию со всеми параметрами, необходимыми для связывания сценария.

Это рекомендуемый метод связывания JavaScript для WordPress.

Примеры:

function mytheme_add_init(){

$file_dir=get_bloginfo(‘template_directory’);

wp_enqueue_style(“tab”, $file_dir.”/css/tab.css”, false, “1.0”, “all”);

wp_enqueue_script(“jquery1.8.3″, $file_dir.”/js/jquery1.8.3.js”, false, true);

wp_enqueue_script(“tab”, $file_dir.”/js/tab.js”, false, true);

}

add_action( ‘admin_init’, ‘mytheme_add_init’ );

 

Примечания

  • Функция должна быть вызвана с помощью wp_enqueue_scripts, если вы хотите вызвать ее на переднем участке кода, как в приведенных выше примерах. Чтобы вызвать ее на экранах администрирования, используйте admin_enqueue_scripts. Для экрана входа в систему , используйте login_enqueue_scripts. Вызвав его за пределами крюком действий может привести к проблемам, см билет # 11526 для деталей.
  • При попытке зарегистрировать или уникализировать уже зарегистрированную ручку с различными параметрами, новые параметры будут проигнорированы. Вместо этого используйте wp_deregister_script () и зарегистрировать сценарий снова с новыми параметрами.
  • JQuery UI эффектов не входит в комплект jquery-ui-core.
  • Эта функция основана на использовании wp_head () и wp_footer () активной темой. Это означает, что она не может работать с несколькими очень старыми темами, в которых не вызывались эти функции. Это полезно иметь в виду при отладке старых тем.
  • Использование: WWP_Scripts::add(), WP_Scripts::add_data() и WP_Scripts::enqueue().
  • Использует глобальные: (unknown type) $wp_scripts.

Сценарии по умолчанию Включено и Зарегистрировано в WordPress

По умолчанию, установка WordPress включает в себя множество популярных скриптов, обычно используемые веб-разработчиками, кроме сценариев, используемых самим WordPress.

Подробный список имен , которые могут быть использованы вместо параметра $handle см wp_register_script () .

Exit mobile version