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

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

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

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

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

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

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

Пример:

add_shortcode(‘text’, ‘addText’);

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

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

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

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

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

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

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

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

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

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

Комментариев: 3
  1. Павел

    Шорткод отличная вещь! Мне правда их настраивали на блоге — сам я их не создавал, и вряд ли буду smile

    1. Михаил (автор)

      Спасибо тебе за комментарий, кстати. Я же сменил шаблон и теперь пример с шорткодом не работает. потому что он был сделан для старого шаблона. Надо поправить. Если бы ты комментарий не оставил, эта статья бы мне нескоро на глаза попалась. laugh

  2. Валерий

    Да Михаил, шорткоды очень удобная штука. Тоже пользуюсь на своем блоге. Спасибо за информативную и полезную статью!

Добавить комментарий

;-) :| :x :twisted: :smile: :shock: :sad: :roll: :razz: :oops: :o :mrgreen: :lol: :idea: :grin: :evil: :cry: :cool: :arrow: :???: :?: :!: