Как работают в wordpress шорткоды? Добавить свой шорткод

Приветствую вас. Решил я тут разобраться с тем, как работают в wordpress шорткоды и как добавить свой. Сегодня я поделюсь с вами тем, что узнал об этом сам, а также расскажу, почему полезно использовать их в своей теме.

Что такое шорткод?

Прямо говоря, это короткий код, какое-то слово, которое заключается в квадратные скобки. Например, вот – [shortcode]. Но сейчас вы видите просто английское слово в скобках. Все потому, что я не задал для этого ключа никаких действий, иными словами, такого шорткода просто не существует.

Как в wordpress создать шорткод?

Это не так уж и сложно, для этого нужно проследовать в файл functions.php, который находится среди прочих в вашей активной теме. Туда нужно добавить специальную функцию:

add_shortcode(‘имя шорткода’, ‘функция, которая будет выполняться там, где он вставлен’);

Пример:

add_shortcode(‘text’, ‘addText’);

Теперь там, где вы вставите [text], вместо этого будет вставлен результат работы функции addText. Соответственно, задать add_shortcode – это только пол дела, нужно еще и описать функцию, которая будет выполняться.

Реальный пример использования

Прямо сейчас я создам на своем сайте шорткод и внедрю его в эту статью. Итак, я написал в functions.php такой код, смотрите на скриншот:

Код обрезан из-за длинных url-адресов, но основную суть вы можете увидеть.

Итак, я создал шорткод с названием posts и назначил для него выполнение функции sampleposts. Сразу же после этого я описал эту простейшую функцию – она возвращает список из трех статей, которые я считаю наиболее достойными внимания на своем блоге. Прямо сейчас я их выведу тут, заключив слово posts в фигурные скобки:

Как видите все работает безотказно!

В чем удобство шорткода?

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

Как вставить шорткод в файл шаблона?

Но мы с вами рассмотрели лишь то, как пользоваться им в статьях, в php-файл вы таким образом не вставите шорткод. Можете попробовать, но вы получите оповещение об ошибке. Собственно, нужно использовать функцию do_shortcode, вот и все. На картинке я показал, как правильно вставить шорткод в php-файл и как неправильно.

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