Как правильно создать и использовать шорт код(Shortcode) в WordPress

Shortcode (короткий код) – это  небольшой кусочек кода, можно даже сказать, малая часть огромного PHP кода, который является более простым и понятным для нашего восприятия. Короткий код запускает привязанную к нему функцию в контенте сайтов.
Создание shortcode в WordPress

В различных CMS, в редакторах с контентом (записи “посты”, страницы) нельзя вставить PHP код.
Это сделано в целях разделения кода от контента, который  должен находиться отдельно от движка с его функционалом. Также такой запрет осуществлен в целях безопасности, так как все добавляет и редактирует обычный пользователь. Но после некоторых изменений  пользователем, контент (обычно текст, ссылки на фотографии или другие медиа файлы) попадает в базу данных, и любой PHP код может поломать сам движок (ядро CMS).
Поэтому если нам нужно вставить какую-нибудь функцию, то мы её описываем в файле,  где обычно и  хранятся все функции нашей темы. Для этого используем  файл «function.php» и задаем ему короткий код, который мы далее можем вызвать(активировать) на любой странице нашего сайта.

Чтобы WordPress понял, что этот код является ШОРТКОДОМ, его нужно поместить в квадратные скобки – [ myFunction ].

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

shortcode

Создаем свой Шорткод

В CMS WordPress, для того чтобы создать свой шорт код существует специальная  функция – «add_shortcode».

Чтобы продемонстрировать работу шорт кода, давайте создадим свою функцию и поместим её в файл functions.php
Функцию мы назовём – ‘mySampleCode’, а шорткоду мы дадим имя – ‘myCODE2’.

В этой конструкции стоит уделить внимания таким значениям:

add_shortcode – обозначение шорткода в WP.

myCODE2 – имя шорт кода. С помощью этого значения, вы и будете вызывать основную функцию в записи.

mySampleCode – имя самой функции, которую вы создаете.

Теперь вставляем в нужном нам месте, где нибудь в статье сайта [myCODE2] и получаем результат, вывод нашей обработанной функции.

В следующем примере мы добавляем ещё и аргументы со значением. Ну скажем, выведем на страницу заметки определённой категории:

И снова вставляем наш шорт код в страницу или запись [PagePHP] (только без пробелов!) Теперь получаем значение по номеру категории. У меня в примере это – 13.

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

Иногда возникает необходимость вставить шорт код не в запись, а в php файл. Это может быть файл постов – sisngle.php или категорий – category.php, ну в общем любой файл, где выполняется код PHP.
Мы пока знаем только шорт код функции, но тут обычная конструкция с квадратными скобками работать не будет! Чтобы работать с php файлами нужно сделать обратный процесс, так сказать, декодировать обратно шорткод в обычную функцию.

Для этих целей в Вордпрессе есть замечательная встроенная функция, под названием – «do_shortcode».

Вот пример этого преобразования:

В данном примере PagePHP – это ваш короткий код. Соответственно, мы запускаем функцию, привязанную к этому шорткоду.

shortcode

В WordPress есть и свои встроенные, уже готовые функции, но про них хорошо описал сам разработчик на сайте:
https://codex.wordpress.org/ru:Shortcode_API

1 Бал2 Бала3  Бала4  Бала5  Балов
loadingЗагрузка...

<<< >>>

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