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

Что такое Шорткод в WordPress?

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

При загрузке страницы блога с шорткодом «gallery», WordPress заменяет шорткод «gallery» на код, который на самом деле отображает галерею из ваших изображений. P.s. Замените ковычки на квадратные скобки.

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

В случае, если не имеет смысла, давайте рассмотрим пример. Допустим, я хочу выводить объявлению Adsense в моем посте. Я мог бы перейти в режим HTML в Вордпресс контент-редактор и скопировать и вставить код Adsense блок в него, но это было бы утомительно и отвлекает потенциально со всеми дополнительными разметки в моем посте. Кроме того, если я хотел изменить рекламный блок, я бы вернуться в каждый пост, чтобы сменить его на новый. Способ попроще и более надежный способ добавить блок Адсенса везде, где я хотел бы использовать Adsense с шорткодом. Короткий код может выглядеть так:

[adsense]

На самом деле глядя на пост на вашем сайте, короткий номер будет заменен на рекламный блок Адсенса. Итак, как же создать этот шорткод в WordPress? Давайте рассмотрим.

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

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

function get_adsense($atts) {

    return '<script type="text/javascript"><!--

google_ad_client = "pub-296324648221577";

/* 468x60, created 10/07/15 */

google_ad_slot = "77323465768";

google_ad_width = 350;

google_ad_height = 115;

//-->

</script>

<script type="text/javascript"

src="https://pagead2.googlesyndication.com/pagead/show_ads.js">

</script>

';

}

Эта функция довольно проста – она просто возвращает мне Гугл Адсенсе код в виде строки. Все, что возвращает эта функция, мой короткий код будет заменен.

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

add_shortcode('adsense', 'get_adsense');

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

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

Как использовать Шорткод?

Эта последнее, просто добавьте

 [adsense]

шорткод в HTML или визуальный вид в пост или страницу редактора содержимого. Вы создали свой первый шорткод.

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

Что такое сайт-специфический плагин

Специфический плагин WordPress — это особое место для добавления участков кода, которые вы находите в сети , выполняющий функции, не связанные с темой. Другими словами:

Всё время, вы будете “как-бы” читать статьи, относящиеся к WordPress во всем интернете (включая наш сайт), где мы делимся фрагментами и советуем добавлять их в ваш файл темы functions.php. Эти фрагменты не так велики, чтобы быть оправданным в качестве плагинов самостоятельно, но некоторые из них, конечно, могли бы добавить конкретную функциональность для сайта, которая не зависит от темы, таких как перенаправление пользователей сайта на случайный пост. В то время как другие функции могут иметь ключевое значение для вашего конкретного сайта, такие как пользовательские типы постов.

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

Почему вам нужен специфический плагин для WordPress

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

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

Одна из причин, почему мы создали руководство для начинающих для вставки фрагментов из Интернета в WordPress является предотвращение белого экрана смерти, который получают пользователи при вставке фрагмента с неправильным форматированием. Часто новые пользователи просто редактируют темы с использованием WordPress без применения пользователями FTP. Мы помогли бесчисленным пользователям, которые были заперты из их сайта, когда они вставили неправильный фрагмент.

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

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

Как создать специфический плагин WordPress

Вы можете подумать, что это может быть тяжело, но это действительно не так.

• Все, что вам нужно сделать, это создать новую папку в plugins. Пример: /wp-content/plugins/yoursitename-plugin/
• Создать файл и сохраните его как “yoursitename-plugin.php”
• Поместите следующий код в файл:

  <?РНР
  
  /*
  
  Название плагина: плагин для сайта AndreyEx.ru
  
  Описание: сайт специфического кода для изменения AndreyEx.ru
  
  */
  
  /* Начать добавлять функции ниже этой строки */
  
  	 
  
  	 
  
  /* Добавление функции стоп ниже этой строки */
  
  ?>

• Теперь загрузите этот файл в созданную папку ‘yoursitename-plugin’. Затем просто активируйте плагин.

С этого момента, мы будем рекомендовать, чтобы вы добавляли соответствующие фрагменты которые мы советуем в специфический плагин, а не в файл темы functions.php.

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