Как сделать свой шорткод в WordPress?

Приветсвую вас, уважаемые читатели моего маленького блога!

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

Если вы ведете свой блог на движке ВордПресс, то вы скорее всего хотели добавить какой-то специализированный контент в свой пост или страницу, но не знаете как это сделать? Может быть вы хотели встроить виджет Twitter, рекламу Гугл-Адсенс или какой-то другой контент. Как вы можете легко добавить этот тип контента в свой пост или страницу? К счастью, WordPress предоставляет нечто, называемое шорткодом, чтобы сделать этот вид задач чрезвычайно простым. В этом посте вы пройдете процесс создания, установки и использования шорткода в вашей теме WordPress. Но начнем с того, что же такое шорткод.

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

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

Когда вы загружаете страницу блога с коротким кодом [nggallery id=1], WordPress заменяет шорткод [nggallery id=1] всем кодом, который фактически отображает галерею со вставленными вашими изображениями с определенным ID.

Как видно из приведенного выше примера, шорткод похож на тег HTML, но заключенный в квадратные скобки вместо угловых скобок. Этот код подменяется другим кодом, когда страница действительно загружается в веб-браузере. Действительно здорово что WordPress позволяет создавать собственные пользовательские шорткоды, чтобы отображать практически все! Вы можете использовать его для чего хотете, например вывода видео с Youtube, показа вашего последнего твита или даже настройки его — как вам нравится.

Если вам все еще интересно, давайте рассмотрим пример. Предположим, я хочу вывести объявление AdSense в свой пост. Я мог бы перейти в режим HTML-редактора WordPress, скопировать и вставить в него блок кода Adsense, но это было бы утомительно и отвлекало бы на переключения видов редактора в моем посте. Кроме того, если бы я захотел изменить свой рекламный блок, мне пришлось бы вернуться к каждому сообщению, чтобы изменить его на новый. Более простой способ и более надежный способ добавления блока Adsense, где бы я ни захотел — это использовать шорткод adsense.

Шорткод может выглядеть следующим образом:

[adsense]

Когда вы на самом деле смотрите сообщение на своем сайте, шорткод будет заменен рекламным блоком Adsense. Итак, как создать этот шорткод? Скорее всего вам потребуется как-то сказать WordPress, чтобы он заменил каким-то образом шорткод на то, что вам нужно. Давайте посмотрим, что для этого нужно сделать дальше.

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

К счастью, в ВордПрессе реализовано довольно просто создание собственных шорткодов, поэтому давайте фактически начнем реализацию шорткода [adsense]. Первое, что нам нужно сделать — это определить функцию, которая выводит фактический код Adsense. Весь следующий код надо будет добавить в файл functions.php вашей теме. Все понятно? Хорошо, давайте посмотрим на эту функцию.

function zacompom_adsense($atrs) {
	return '<script type="text/javascript"><!--
	google_ad_client = "pub-123456789012345";
	/* 468x60, created 21/05/14 */
	google_ad_slot = "1234567890";
	google_ad_width = 468;
	google_ad_height = 60;
	//-->
	</script>
	<script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"></script>';
}

Эта функция довольно проста — она ​​просто возвращает мой код Google-Adsense в виде строки. Эта функция возвратит все, что вы там напишите — будь-то виджет Twitter, какое-то специализированное меню сайта или просто какое-то сообщение или контент.

Теперь, когда у нас есть функция, возвращающая то, что мы хотим, как мы можем привязать ее к короткому коду? Теперь здесь на сцену ВордПресс выходит WordPress API. Еще раз посмотрим, как мы это сделаем, а затем объясним, что происходит. Вот призыв к настройке шорткода adsense.

add_shortcode('adsense', 'zacompom_adsense');

Вот оно! Первым переданным параметром является имя шорткода, поэтому в нашем случае «adsense» сообщает WordPress о создании короткого кода [adsense]. Второй параметр обозначает функцию, которая будет вызываться при обнаружении нового шорткода. Опять же, в нашем случае, ‘zacompom_adsense’ говорит WordPress заменить [adsense] результатами нашей функции zacompom_adsense.

Не плохо? Теперь это очень простой шорткод, WordPress позволяет вам делать гораздо больше с вашими шорткодами, включая добавление параметров (может быть, вы хотите выбрать между блоками adsense?). Полный список API можно увидеть в WordPress Codex.

Как использовать мой шорткод?

Эта последняя часть самая простая, просто добавьте шорткод [adsense] в HTML или визуальные представления редактора поста или страницы. Это оно! Вы создали свой первый шорткод. Поздравляю!

На самом деле и поздравлять то не с чем))) Просто сделали то, о чем давно мечтали. Теперь вы можете спокойно делать свои шорткоды и вставлять их куда вам нужно!

На этом буду закругляться, до скорых встреч!

Вам понравилась статья?
плохохорошо (+4 баллов, 2 оценок)
Загрузка...
Обо мне
Юрич:
Занимаюсь созданием сайтов на ВордПресс более 5 лет. Работал в нескольких веб-студиях, да и сейчас работаю. Иногда подрабатываю на фрилансе, как на нашем так и на зарубежном. Везде зарекомендовал себя очень хорошо. Если нужен сайт на вордресс, шаблон для сайта или лендинг - не стесняйтесь - пишите. Рад буду помочь!