Как сделать свой шорткод в WordPress?
Приветсвую вас, уважаемые читатели моего маленького блога!
Опять давненько не писал, но на то были свои причины. Сегодня я бы хотел пролить немного света на тему создания своего короткого кода (шорткода) в Вордпресс. Сам как-то долго искал — нужно было заменить на сайте заказчика шорткод плагина, а сам плагин снести. По-моему в предидущей статье я так и говорил — чем меньше пралинов — тем лучше. На самом деле это так и есть. Но это уже другой вопрос, а мы возвращаемся к нашему шорткоду.
Если вы ведете свой блог на движке ВордПресс, то вы скорее всего хотели добавить какой-то специализированный контент в свой пост или страницу, но не знаете как это сделать? Может быть вы хотели встроить виджет Twitter, рекламу Гугл-Адсенс или какой-то другой контент. Как вы можете легко добавить этот тип контента в свой пост или страницу? К счастью, WordPress предоставляет нечто, называемое шорткодом, чтобы сделать этот вид задач чрезвычайно простым. В этом посте вы пройдете процесс создания, установки и использования шорткода в вашей теме WordPress. Но начнем с того, что же такое шорткод.
Что же такое шорткод WordPress?
Короче, шорткод — это специальный тег, который вы можете вставить в статью и которое будет заменен другим контентом при фактическом просмотре сообщения на сайте. Если вы когда-либо встраивали галерею WordPress в свой блог, то вы уже видели встроенный короткий код.
Ко мне часто поступают вопросы про хостинг, которым я пользуюсь и поэтому решил указать хостинг в статье https://sprinthost.ru. Вы можете попробовать попользоваться хостингом 30 дней бесплатно. Чтобы понять, как будет работать Ваш сайт на этом хостинге просто перенести свой сайт (в этом поможет поддержка хостинга бесплатно) и и таким образом сможете понять подходит хостинг Вам или нет. На этом хостинге находятся сайты с 20 000 тысяч посещаемость и сайты чувствуют себя отлично. Рекомендую! Да, если делать оплату на 1 год то получаете скидку 25%. И что мне нравится — тех. поддержка всегда помогает в технических вопросах, за что им спасибо. Как Вы понимаете не всегда проходит всё гладко и нет желания, чтобы сайт не был доступен тем самым страдал трафик и доход.
Когда вы загружаете страницу блога с коротким кодом [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»; /* 468×60, 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 или визуальные представления редактора поста или страницы. Это оно! Вы создали свой первый шорткод. Поздравляю!
На самом деле и поздравлять то не с чем))) Просто сделали то, о чем давно мечтали. Теперь вы можете спокойно делать свои шорткоды и вставлять их куда вам нужно!
На этом буду закругляться, до скорых встреч!