Я люблю шорткоды. Если есть время отказаться от детской шутки: «Тогда почему бы тебе не жениться на ней?» — сейчас самое подходящее время. Вот насколько я люблю шорткоды в WordPress.
Самая большая сила WordPress также может быть его самой большой слабостью. Хотя в нем есть все виды мощных инструментов и встроенных средств безопасности, создание пользовательских функций и функций может быть огромной болью.
Но вот тут-то и появляются шорткоды. Как только вы освоитесь с созданием шорткода, вы сможете создать пользовательские функции за считанные минуты — ваше воображение — единственный предел.
Резюме для будущей ссылки
Я надеюсь, что вы добавите эту страницу в закладки и будете ссылаться позже, вот краткое изложение того, что нужно для работы шорткода:
- Создайте код, который вы хотите
- Сохраните код (обычно в каком-то месте, например, в папке wp-content)
- Включите новый файл, который вы сохранили в файле functions.php
- Присвойте свой шорткод, используя add_shortcode («шорткод», «функция»)
- Разместите свой шорткод там, где вы хотите
Почему именно шорткод любит, именно?
Если вам когда-либо приходилось заниматься разработкой на WordPress, вы попадаете в ситуацию, когда вам нужны пользовательские функции или специализированный элемент дизайна. По соображениям безопасности WordPress удаляет множество HTML-тегов и всего PHP-кода из постов и страниц.
Обычно это для нашего же блага, но это кошмар, когда вы просто хотите простую модификацию дизайна.
Шорткоды — это пробел. Они позволяют вам вводить любой PHP или другой код в нужное вам место. Как только вы освоите создание разметки шорткода, вы никогда не вернетесь назад.
Итак, давайте перейдем к созданию собственного шорткода и создадим процесс, на который вы сможете ссылаться в будущем, когда будете готовы создать свой собственный.
Шаг 1. Создайте код
Это где вам нужно создать свою функциональность. Я не знаю, чего вы хотите достичь, но вот очень простой пример шорткода, который позволяет мне вставлять пользовательское сообщение в сообщение. Это только для демонстрации, но это должно вызвать у вас воображение:
[sourcecode language = ”php”]
<? PHP
function some_random_code () {
echo ‘Спасибо за чтение моих постов!’;
} // Конец some_random_code ()
?>
[/исходный код]
Итак, у нас есть очень простая маленькая функция PHP. Вы можете буквально поместить в эту функцию все, что вы хотите выполнить на своем сайте — настраиваемую форму, специальную разметку HTML или вызовы внешней базы данных.
Шаг 2. Сохраните код (но НЕ в файле Functions.php)
Хотя вы можете хранить приведенный выше код в файле functions.php, я бы настроил вас на долгосрочную неудачу, если бы я действительно посоветовал это. Я настоятельно рекомендую вам создать отдельный файл для ваших собственных шорткодов. Называйте его как угодно и сохраняйте в папке wp-content, или создайте плагин (см. Мою статью о создании плагинов WordPress ).
Для этого примера создайте файл с именем «my_custom_shortcodes.php» и сохраните его в папке wp-content. Эта папка, как правило, защищена от обновлений WordPress и обновлений ядра, которые могут перезаписать существующий файл functions.php. Вы можете быстро потерять много работы, если клиент решит обновить приложение до последней версии или установить новую тему, не сообщая вам об этом. Намного проще войти и воссоздать следующие несколько шагов.
Шаг 3. Включите ваш пользовательский файл PHP
Теперь нам нужно сообщить WordPress, где найти ваш файл шорткода. Предполагая, что вы сохранили его в папке wp-content, вот что вам нужно добавить в файл functions.php:
[sourcecode language = ”php”]
include (WP_CONTENT_DIR. ‘/my_custom_shortcodes.php’);
[/исходный код]
Теперь WordPress знает о вашем контенте и интегрирует его в свою функциональность. На данный момент мы на 90% сделали!
Шаг 4: Определите свой шорткод
Прежде чем вы начнете использовать шорткод на своем сайте, вы должны сказать WordPress, что это действительно шорткод. Прямо под кодом на шаге 3 в файле functions.php добавьте следующее:
[sourcecode language = ”php”]
add_shortcode (‘some_random_code_sc’, ‘some_random_code’);
[/исходный код]
Вот что происходит — первая часть вызова add_shortcode — это имя шорткода, который вы хотите использовать. Это то, что будет помещено в ваши посты и страницы. Следующим аргументом является имя функции. Итак, вот пример на более простом английском:
[sourcecode language = ”php”]
add_shortcode (‘shortcode_name’, ‘function_name’);
[/исходный код]
Краткое примечание: мне нравится использовать имя функции для моего шорткода, но я добавляю «_sc» к шорткоду (для шорткода), чтобы помочь мне отследить свой код, если я захочу отредактировать его позже.
Вот как выглядит мой файл functions.php после добавления двух строк кода:
Шаг 5: Добавьте свой шорткод
Теперь все, что вам нужно сделать, это добавить свой шорткод в любой пост или страницу! Создайте новый пост / страницу и добавьте к нему шорткод, опубликуйте и просмотрите страницу.
И вы должны увидеть вывод своего кода на опубликованной странице:
Ты сделал это! Теперь вы можете быстро создавать все виды пользовательских функций и интегрировать их в свой сайт WordPress за считанные минуты.
Как вы используете шорткоды? Покажите свою работу в комментариях!