Правильное добавление Javascript в темы WordPress

Существует особый способ добавления Javascript в вашу тему WordPress, чтобы предотвратить любые конфликты с плагинами или родительскими темами WordPress. Проблема в том, что многие «разработчики» вызывают свои файлы javascript непосредственно в файле header.php или footer.php, что является неправильным способом сделать это.
В этом руководстве я покажу вам, как правильно вызывать файлы javascript с помощью файла functions.php, чтобы они загружались прямо в тег заголовка или нижнего колонтитула вашего сайта. Таким образом, если вы разрабатываете тему для распространения и ваш конечный пользователь хочет изменить скрипты с помощью дочерней темы, они могут это сделать, или если они используют минимизацию / кеширование или другие плагины оптимизации, они будут работать правильно. И если вы работаете с дочерней темой, ваши сценарии добавляются правильно, без копирования файлов header.php или footer.php в дочернюю тему, которые никогда не должны быть необходимы (при работе с хорошо закодированной темой)
Неправильный способ добавления Javascript в темы WordPress
Вызов javascript в вашем файле header.php или footer.php, как показано ниже, НЕ является правильным способом, и я настоятельно рекомендую его не использовать, часто это вызывает конфликты с другими плагинами, и выполнение действий вручную при работе с CMS никогда не хорошая идея.
Правильный способ добавления Javascript в темы WordPress
Лучше всего добавлять javascript в вашу тему WordPress через файл functions.php, используя wp_enqueue_script. Использование действия wp_enqueue_scripts для загрузки вашего javascript поможет уберечь вашу тему от проблем.
пример
wp_enqueue_script( 'my-script', get_template_directory_uri(). '/js/my-script.js', array(), true );
Приведенный выше код загрузит файл my-script.js на ваш сайт. Как видите, я включил только дескриптор $, но вы также можете добавить зависимости для вашего скрипта, номер версии и указать, загружать ли его в верхний или нижний колонтитул (по умолчанию – заголовок).
Функцию wp_enqueue_script() технически можно использовать в любом файле шаблона темы или плагина, но если вы загружаете глобальные скрипты, вы захотите разместить ее либо в файле function.php вашей темы, либо в отдельном файле, специально предназначенном для загрузки скриптов в сайт. Но если вы хотите загрузить скрипт только в определенный файл шаблона (например, в сообщения в галерее), вы можете разместить функцию прямо в файле шаблона, однако лично я рекомендую хранить все скрипты в одном месте и использовать условные выражения для загрузки. скрипты по мере необходимости.
Размещенные скрипты WordPress
Одна интересная вещь в WordPress заключается в том, что уже существует множество скриптов, размещенных и зарегистрированных, которые вы можете использовать при разработке своей темы. Например, jQuery, который используется почти в каждом проекте, должен ВСЕГДА загружаться из WordPress и никогда не размещаться на сторонних сайтах, таких как Google. Поэтому, прежде чем добавлять собственный сценарий в свой проект, проверьте список зарегистрированных сценариев, чтобы убедиться, что он еще не включен в WordPress, и если это так, вам следует загрузить его, а не регистрировать свой собственный.
Использование хука для постановки в очередь WordPress
Ранее мы упоминали функцию, необходимую для загрузки скрипта на ваш сайт, однако при работе с файлами, не являющимися шаблонами, такими как файл functions.php, вы должны добавлять эту функцию внутри другой функции, подключенной к соответствующим хукам WordPress, таким образом ваши скрипты получают зарегистрированы со всеми другими скриптами, зарегистрированными WordPress, сторонними плагинами и вашей родительской темой при использовании дочерней темы.
В WordPress есть два разных хука действий, которые вы можете использовать для вызова своих скриптов.
- wp_enqueue_scripts – действие, используемое для загрузки скриптов на интерфейсе
- admin_enqueue_scripts – действие, используемое для загрузки скриптов в админке WP
Вот пример (который будет добавлен в ваш файл functions.php) того, как создать функцию и затем использовать обработчик WordPress для вызова ваших скриптов.
/** * Enqueue a script */ function myprefix_enqueue_scripts() < wp_enqueue_script( 'my-script', get_template_directory_uri(). '/js/my-script.js', array(), true ); > add_action( 'wp_enqueue_scripts', 'myprefix_enqueue_scripts' );
Примечание. Посмотрите, как мы используем функцию «get_template_directory_uri» при определении местоположения вашего скрипта? Эта функция создает URL-адрес папки вашей темы. Если вы работаете с дочерней темой, вы захотите использовать вместо нее «get_stylesheet_directory_uri», чтобы она указывала на вашу дочернюю тему, а не на родительскую тему.
Добавление встроенного кода Javascript
Хотя вы можете легко вставить встроенный javascript в любой файл шаблона с помощью тега script, неплохо было бы также использовать обработчики WordPress для добавления вашего встроенного кода, особенно если это основной плагин или код темы. Ниже приведен пример добавления встроенных скриптов на ваш сайт:
function myprefix_add_inline_script() < wp_add_inline_script( 'my-script', 'alert("hello world");', 'after' ); > add_action( 'wp_enqueue_scripts', 'myprefix_add_inline_script' );
Что это будет делать, так это добавить ваш встроенный javascript после ранее зарегистрированного скрипта my-script. При использовании wp_add_inline_script вы можете добавлять только встроенный код до или после уже зарегистрированного сценария, поэтому, если вы пытаетесь изменить код определенного сценария, убедитесь, что он загружается после него, или если вам просто нужно добавить какой-то собственный код, вы можете подключить это в сценарий jquery, который обычно загружается большинством тем WordPress, и если нет, вы можете использовать wp_enqueue_script для загрузки версии jQuery, размещенной на WordPress.
Используя этот метод, люди могут легко удалить ваши встроенные скрипты с помощью дочерней темы или надстройки плагина, он сохраняет весь ваш пользовательский JavaScript в аккуратной организации и анализируется WordPress, что может быть безопаснее. А если вы используете дочернюю тему, вы можете загружать свои скрипты через файл functions.php вместо копирования файлов header.php или footer.php в свою дочернюю тему.
Тем не менее, если вы работаете с дочерней темой, вам не нужно этого делать, вы можете просто выгрузить свой код в заголовок, используя хуки wp_head или wp_footer, например, как в примере ниже:
Добавьте JavaScript в WordPress: как это сделать легко

Люди, которые используют WordPress, должны узнать больше о JavaScript и о том, как он используется для веб-сайта. Чтобы добавить JavaScript в WordPress, вам нужно найти наиболее подходящий способ его реализации на вашем собственном веб-сайте.
Исследования имеют большое значение, так как неправильная реализация JavaScript может привести к последствиям, которые будет сложно исправить.
Что такое JavaScript для WordPress?
WordPress JavaScript — это способ добавить дополнительные функции на веб-сайт, не замедляя его работу. JavaScript представляет собой язык программирования, который работает в браузере пользователя. Этот тип программирования предлагает разработчикам возможность добавлять на свои сайты всевозможные функции, такие как встроенные видеоплееры, калькуляторы или другие услуги. Фрагмент кода JavaScript нужно просто скопировать и вставить в код веб-сайта.
Почему вы должны добавить собственный JavaScript в WordPress?

Есть несколько причин, по которым вам следует добавить JavaScript в WordPress, но для этого вы должны знать, как написан код веб-сайта. При кодировании веб-сайта WordPress есть три элемента, которые могут вам помочь:
Чтобы создать очень прочную основу для сайта WordPress, вы можете использовать HTML и CSS. Несмотря на то, что они отлично подходят для создания основы веб-сайта, они ограничены в плане изменения поведения сайта. Если вы хотите, чтобы ваш сайт работал определенным образом, вы можете использовать JavaScript для выполнения одного из следующих действий:
- Изменение, скрытие или отображение определенных элементов HTML на сайте
- Добавление значений к переменным CSS, а также выполнение более сложных операций (объединение переменных или создание интерактивного элемента по клику)
- Изменение макета темы WordPress путем добавления в нее еще одного блока кода.
- Изменение определенной функциональности плагина WordPress
- Дополнение веб-сайта динамическим контентом (анимация, видео и т. д.)
- Включение внешнего элемента в веб-сайт (сторонние API)
Все это и многое другое можно сделать с помощью JavaScript.
Использование вставки верхних и нижних колонтитулов для добавления JavaScript

При добавлении JavaScript в WordPress вам нужно просто скопировать и вставить блок кода JavaScript на сайт. Это простое действие добавляет на сайт сторонний инструмент, будь то видеоплеер или другой элемент. Эти фрагменты кода добавляются либо прямо под заголовком, либо прямо перед тегом в основном коде сайта. Это влияет на то, где будет размещен элемент. Чтобы активировать этот плагин, который называется «Вставить верхние и нижние колонтитулы», вы должны сначала установить его.
Чтобы активировать его после установки, вам просто нужно перейти в «Настройки», а затем на страницу «Вставить верхние и нижние колонтитулы». Есть два разных поля, которые вы можете отметить — одно для верхнего колонтитула, другое для нижнего колонтитула. После того, как вы активировали этот плагин, вы можете просто вставить фрагмент кода JavaScript и нажать «Сохранить». Поскольку плагин активирован, вставленный фрагмент кода будет автоматически загружаться для всех страниц вашего сайта. Это самые базовые знания, которые вам понадобятся для добавления JavaScript в WordPress.
Отключение фильтрации WordPress
При использовании JavaScript в WordPress вы также должны отключить блокировку тегов скрипта из JavaScript. Этот параметр можно найти в файле wp-config.php, который находится в корневом веб-каталоге. Чтобы включить пользовательские теги, добавьте туда эту строку кода:
define( ‘CUSTOM_TAGS’ , true );
Как только вы перейдете на страницу functions.php, скопируйте и вставьте этот фрагмент кода в свой базовый код:
function add_scriptfilter ( $string) < global $allowedtags;$allowedtags[ 'script' ] = array ( 'src' =>array () ); return $string;>add_filter( ‘pre_kses’ , ‘add_scriptfilter’ );
Дополнительный совет: использование этого метода означает, что вы отключаете функцию безопасности на своем веб-сайте для любого уровня разрешений пользователя. Используйте этот метод, только если вы глубоко доверяете своим авторам. Включение тега script иногда может быть рискованным.
Узнайте, как использовать плагин Script n Styles

Вы можете добавить JavaScript в WordPress с помощью плагина. Обычно вам нужно загружать JavaScript внутри тегов и. Для глобальной загрузки JavaScript можно использовать плагин. Отзывчивый — Script n Styles. Вы можете либо включить скрипты на весь веб-сайт, либо включить их на странице или даже на уровне публикации. Вы также можете изменить разрешения пользователей. Авторы могут публиковать сообщения и активировать JavaScript, а участники могут сохранять сообщения, фактически не публикуя их.
Используйте расширенные настраиваемые поля

Если вам интересно, как проще всего добавить JavaScript в WordPress, этот плагин может стать решением. После установки и активации плагина вы можете получить доступ к опции «Пользовательские поля» в административном меню. Затем вы можете нажать «Добавить новый». Цель состоит в том, чтобы добавить поле, к которому могут получить доступ администраторы и которое может вставлять исходный файл JavaScript или код JavaScript в теги.
- Первым шагом является присвоение имени группе полей. Это можно сделать, включив правило, отображающее этот параметр, если пользователь входит в систему как администратор. Это означает, что только администратор может добавить их на сайт.
- Поля должны отображаться под областью содержимого, что означает, что вы выбираете «Стандартный», когда дело доходит до выбора стиля группы полей. Установите форматирование поля на «Преобразовать HTML в теги». Это приведет к хорошему результату, в противном случае он может быть плохо переведен.
- Добавьте следующий код в header.php:
Это должно быть добавлено перед .
Это должно быть добавлено перед .
- Сохраните файлы шаблона, обновите страницу и нажмите Опубликовать.
Страница будет опубликована с добавленным JavaScript. Расширенные настраиваемые поля — это подходящий вариант, если вам нужны дополнительные функциональные возможности для пользователей, уже опубликованных страниц и т. д.
Эй, а вы знали, что данные тоже могут быть красивыми?
wpDataTables может сделать это таким образом. Есть веская причина, по которой это плагин WordPress №1 для создания адаптивных таблиц и диаграмм.

Фактический пример wpDataTables в дикой природе
И очень легко сделать что-то вроде этого:
- Вы предоставляете данные таблицы
- Настройте и настройте его
- Опубликовать в посте или на странице
И это не только красиво, но и практично. Вы можете создавать большие таблицы, содержащие до миллионов строк, или вы можете использовать расширенные фильтры и поиск, или вы можете сделать их редактируемыми.
«Да, но я просто слишком люблю Excel, а на веб-сайтах ничего подобного нет». Да, есть. Вы можете использовать условное форматирование, как в Excel или Google Sheets.
Я говорил вам, что вы тоже можете создавать диаграммы с вашими данными? И это только малая часть. Есть много других функций для вас.
Завершение мыслей о том, как добавить JavaScript в WordPress
Этих советов должно быть достаточно, чтобы научить вас добавлять JavaScript в WordPress простым способом, не сталкиваясь с какими-либо проблемами. После того, как вы сделаете это один раз, второй раз будет намного проще и займет меньше времени.
Если вам понравилось читать эту статью о том, как добавить JavaScript в WordPress, вы должны прочитать эту о том, как сбросить настройки WordPress.
wp_enqueue_script() │ WP 2.1.0
Правильно подключает скрипт (JavaScript файл) на страницу. Использовать эту функцию для подключения js файлов важно, потому что так вы в дальнейшем сможете без лишних проблем объединять JS файлы в один. Также в некоторых случаях избавитесь от конфликтов скриптов, когда зависимый скрипт подключается до основного (того от которого он зависит). Функция добавляет скрипт, только если он еще не был добавлен и другие скрипты от которых он зависит, зарегистрированы. Зависимые скрипты добавляются автоматически.
ВАЖНО! Это ошибка начинающих разработчиков. Функция ничего не выведет, если в теме не используется wp_head() или wp_footer(). Именно в момент вызова этих функций срабатывает хук, который добавляет скрипты. Также эта функция должна вызываться до wp_footer(), иначе скрипты вообще не будут подключены.
Если скрипт уже зарегистрирован с помощью wp_register_script(), то для его подключения в этой фукнции нужно указать только идентификатор скрипта (в первом параметре):
// jquery регистрируется в WP по умолчанию. // Поэтому для его подключения достаточно одной строки: wp_enqueue_script('jquery');
Если скрипт не зарегистрирован, то его можно зарегистрировать и подключить одновременно:
wp_enqueue_script( 'newscript', get_template_directory_uri() . '/js/custom_script.js');
С версии 3.3. wp_enqueue_script() можно вызывать во время генерации страницы. В этом случае вызываемый скрипт будет подключен в подвале, в момент срабатывания события wp_footer.
- wp_enqueue_scripts — для внешней части сайта;
- admin_enqueue_scripts — для админ-панели;
- login_enqueue_scripts — для страницы входа (wp-login.php).
- Используйте wp_script_add_data() — когда нужно подключить скрипт с условием, например,
Изменения
В версии 3.5 WordPress изменил положение о минимизации скриптов и CSS стилей. До этого минимизированные файлы имели расширения: .js и .css соответственно, а не минимизированные .dev.js и .dev.css . Теперь, минимизированные файлы имеют расширение: .min.js и .min.css , а обычные .js и .css .
Заметки
- Смотрите: WP_Dependencies::add()
- Смотрите: WP_Dependencies::add_data()
- Смотрите: WP_Dependencies::enqueue()
Список изменений
С версии 2.1.0 Введена. С версии 6.3.0 The $in_footer parameter of type boolean was overloaded to be an $args parameter of type array. Как на сайте WordPress быстро вставить любой скрипт в статью?
Часто бывает необходимо где-то на странице вставить HTML-теги ли какой-либо скрипт на языке JavaScript (например, рекламный блок или какой-нибудь информер). Конечно, переключив визуальный редактор в режим Текст, вставленный код будет без проблем выполнен. Но если один и тот же блок необходимо вставить в нескольких местах поста да еще и на сотне страницах, то в таком случае нужно искать более быстрое решение этой задачи.
Что такое JavaScript?
JavaScript — это скриптовый язык программирования, который работает не на вашем сервере, а в браузере пользователя. Это позволит, не замедляя работу сайта, добавлять много разных возможностей. Например, если необходимо встроить видеопроигрыватель, калькулятор или какую-либо другую стороннюю услугу, то для этого достаточно будет скопировать и вставить фрагмент кода JavaScript на ваш сайт.
Типичный фрагмент кода JavaScript может выглядеть следующим образом:
Теперь, если вы добавите фрагмент кода в контентную часть записи или страницы WordPress, он будет удален при сохранении.
Как быстро вставить любой скрипт в статью?
Каких либо стандартных инструментов для облегчения вставки кода в контент WordPress не предоставляет. Поэтому будем использовать сторонние решения. Рассмотрим наиболее простые способы.
Способ 1. Плагин Shortcoder
Для начала нам нужно добавить необходимый код и сохранить его для будущей вставки. Для этого нажимаем кнопку Create a new shortcode.

В поле Name следует указать имя сохраняемого кода, а в большом текстовом блоке собственно вставить сам код.

Настройка Disable this Shortcode for administrators позволяет запретить показ кода для администратора. Кроме того, в блоке Visibility Вы сможете указать, для каких устройств будет отображаться код. Доступны следующие варианты: только на мобильных (опция On mobile devices alone), только на десктопах (On desktops alone) и для всех устройств (On both desktop and mobile devices). Для сохранения следует нажать кнопку Create shortcode. Все, Ваш код сохранен. Теперь его можно вставлять в контент. Для этого необходимо открыть на редактирование запись или страницу и поставить курсор в то место, где ожидается вставка кода.

Теперь, чтобы вставить код, нужно нажать появившуюся на панели инструментов кнопку. Во всплывающем окне Вы увидите список сохраненных кодов (в нашем случае — это Clearfy banner). Для его вставки необходимо нажать кнопку Quick insert.

В итоге в тексте статьи появится специальный шорткод.

Читайте подробнее: Что такое шорткод и как его правильно использовать на сайте WordPress.
После обновления страницы или записи (кнопка Обновить), вставленный Вами код будет исполнен и отображен.

Отметим, что один и тот же код можно добавлять сколько угодно раз. Вы таким образом сможете добавить необходимое количество нужных кодов и вставлять их где это будет необходимо.
Способ 2. Плагин Insert Headers and Footers
Иногда вам будет необходимо скопировать и вставить фрагмент кода JavaScript на свой сайт, чтобы добавить сторонний инструмент. Эти скрипты обычно должны присутствовать в разделе заголовка или внизу перед тегом вашего сайта. Таким образом, код будет загружаться при каждом просмотре страницы. Например, код Google Analytics должен присутствовать на каждой странице вашего сайта, чтобы он мог отслеживать посетителей вашего сайта. Вы можете добавить его в файлы header.php или footer.php темы WordPress. Однако после ее обновления эти изменения могут быть перезаписаны. Для решения этой проблемы можно воспользоваться бесплатным плагином Insert Headers and Footers . После его установки и активации следует в админ-панели перейти в раздел Настройки -> Insert Headers and Footers. На странице настроек вы увидите две области для вставки кода. Первый отвечает на «шапку» сайта, а второй за «подвал».

Теперь вы можете вставить скопированный заранее код JavaScript в одно из этих полей, а затем следует нажать Save. После этого плагин будет автоматически загружать вставленный код на каждой странице вашего сайта.
Способ 3. Ручной режим
Этот способ предусматривает внесение кода в основной конфигурационный файл активной WordPress-темы — functions.php.
Если вы не знаете, как редактировать functions.php, то в этом случае Вам поможет плагин ProFunctions .
Во-первых, давайте посмотрим, как добавить код в заголовок сайта WordPress (wp_head). Для этого нужно будет добавить в указанный файл следующие строки:
function wpschool_javascript_in_header() < ?> add_action( 'wp_head', 'wpschool_javascript_in_header' );
Предположим, вам нужно загрузить JavaScript-код только на определенной записи WordPress. Для этого следует добавить условную логику в код.
function wpschool_javascript_in_header() < if ( is_single ( '16' ) ) < ?> > add_action( 'wp_head', 'wpschool_javascript_in_header' );
Если более подробно рассмотреть приведенный выше код, то можно заметить, что мы обернули код JavaScript вокруг условной логики, чтобы соответствовать конкретному идентификатору (ID) записи. Вы можете использовать это, заменив «16» своим собственным ID. Заметим, что этот код работает исключительно с записями, не включая страницы.
Рассмотрим другой пример, который подойдет для страниц.
function wpschool_javascript_in_header() < if ( is_page ( '10' ) ) < ?> > add_action( 'wp_head', 'wpschool_javascript_in_header' );
Мы можем использовать тот же код с небольшой модификацией, чтобы добавить JavaScript-код в раздел «подвала» вашего сайта.
function wpschool_javascript_in_footer() < ?> add_action( 'wp_footer', 'wpschool_javascript_in_footer' );
Вместо того, чтобы подключить нашу функцию к wp_head, мы теперь подключили ее к wp_footer. Вы также можете использовать его с условными тегами для добавления JavaScript в определенные записи или страницы.
Нажмите, пожалуйста, на одну из кнопок, чтобы узнать понравилась статья или нет.