Что такое сниппеты и как их использовать в WordPress

Сниппет — это небольшой фрагмент кода, пригодный для повторного использования. Применительно к WordPress, благодаря используемой системе хуков, — сниппеты довольно распространены и универсальны.

Сниппеты можно встретить в документации, на форумах поддержки и просто на просторах интернета.

Для наглядности рассмотрим пару примеров:

add_filter('the_title', 'dco_the_title');
function dco_the_title($title) {
    return 'denisco: ' . $title;
}

add_filter('the_title', 'dco_the_title');

function dco_the_title($title) {

return 'denisco: ' . $title;

}

Данный сниппет использует фильтр «the_title», который позволяет изменять выводимые заголовки записей и страниц, например, добавить произвольное слово.

function search_filter($query) {
  if ( ! is_admin() && $query->is_main_query() ) {
	if ($query->is_search) {
	  $query->set('post_type', 'post');
	}
  }
}

add_action( 'pre_get_posts', 'search_filter' );

function search_filter($query) {

if ( ! is_admin() && $query->is_main_query() ) {

if ($query->is_search) {

$query->set('post_type', 'post');

}

add_action( 'pre_get_posts', 'search_filter' );

А этот сниппет с помощью хука «pre_get_posts» указывает WordPress, что поиск нужно осуществлять только по записям сайта.

Способы использования сниппетов на сайте

Переходим к разбору способов использования сниппетов на сайте.

Для большинства способов понадобится установленный FTP-клиент FileZilla и текстовый редактор Notepad++. Данные для доступа к сайту по FTP нужно уточнить в поддержке Вашего хостинга.

Перед внесением изменений в код сайта — рекомендуется сделать его резервную копию, особенно для начинающих пользователей. Как это сделать, также можно уточнить у Вашего хостинг-провайдера.

Способ 1. Вставка кода в файл functions.php в разделе Внешний вид -> Редактор

Этот способ является, наверное, самым популярным и простым для начинающих пользователей, но в то же время и самым опасным. Вставляя или изменяя код через визуальный редактор, Вы рискуете получить неработающий сайт, в случае если допустите ошибку или код будет несовместим с Вашим сайтом или хостингом. Также, изменяя таким способом файлы сайта — у Вас не будет возможности отменить внесенные изменения, кроме как вручную по памяти восстановить его первоначальный вид.

Способ 2. Вставка кода в файл functions.php по FTP

Этот способ более надежен, т.к. FTP продолжит работать, даже если в коде была допущена ошибка, а текстовый редактор позволит отменить изменения.

Следует помнить, что при смене темы — весь код останется в старой теме и не будет исполняться. Поэтому в файл functions.php стоит помещать только тот код, который непосредственно связан с используемой темой и не затрагивает остальные части сайта.

Способ 3. Вставка кода в виде плагина

Данный способ похож на прошлый, но более универсален и скорее всего сложен для начинающих пользователей. Его смысл заключается в том, чтобы поместить код в отдельный файл в папку /wp-content/plugins, добавить необходимый заголовок и активировать в админ-панели в разделе «Плагины».

Для упрощения процедуры, файл с кодом можно поместить в папку /wp-content/mu-plugins, тогда добавление заголовка и активация не потребуется — плагин заработает автоматически.

Способ 4. Вставка кода с помощью специальных плагинов

Существует ряд плагинов, позволяющих относительно безопасно добавлять и управлять сниппетами в визуальном режиме через админ-панель. Мы рассмотрим один из них — Add Shortcodes Actions And Filters.

Переходим в раздел Плагины -> Добавить новый, вводим название плагина в поле поиска, жмем Установить и Активировать.

Управление сниппетами осуществляется в разделе Инструменты -> Shortcodes, Actions and Filters.

Для примера добавим и активируем произвольный сниппет. Если сниппет предназначен для админ-панели, то также необходимо отметить галочку «Также, выполнять на страницах админ-панели».

После сохранения, изменения сразу отобразятся на сайте.

Данный способ удобен тем, что не нужно обладать навыками работы с FTP-клиентом и текстовым редактором, каждый сниппет можно включить и отключить в любой момент и это не будет зависеть от используемой темы.

Также, в случае если в коде была допущена ошибка или возникла какая-та иная проблема — плагин отключит проблемный сниппет и выведет сообщение со ссылкой на его редактирование.

← Вернуться в блог