Как создавать шорткоды WordPress и работать с ними проще

Как создавать шорткоды WordPress и работать с ними проще


Шорткоды WordPress – это небольшие теги, которые используются в качестве ярлыков для выполнения определенных функций в постах и ​​страницах. Вы можете узнать короткие коды по квадратным скобкам, которые окружают простое слово или фразу. Они были представлены в версии 2.5 с целью помочь людям легко выполнять функции..

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

В этом руководстве вы можете узнать:

  • Как использовать шорткоды WordPress
  • Как создать простой шорткод
  • Как использовать шорткоды в Text Widget

Рекомендуемое чтение: Курсы WordPress от Удеми

Как использовать шорткоды WordPress

Шорткоды в текстовых и визуальных редакторах

Чтобы использовать шорткоды, не нужно знать, как кодировать или понимать, как они работают в бэкэнде. В самом WordPress, а также в большинстве тем и плагинов WordPRess используются разные шорткоды, что позволяет использовать многие расширенные функции..

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

Шорткоды заменяются фактическим контентом, как только вы публикуете или просматриваете сообщение или страницу.

Параметры шорткода

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

Также можно определить размер галереи и многое другое, предоставив дополнительные параметры. Вот пример:

Галерея из этого примера будет показывать только изображения с указанными идентификационными номерами. В этом случае размер будет автоматически изменен на средний. И вы получите все это с помощью простого шорткода. Теперь представьте, как бы все это выглядело, если бы вы собирались вручную добавить код PHP, который содержал бы десятки, если не сотни строк. Спасибо, шорткоды!

Начальный и конечный теги

Некоторые более сложные шорткоды могут иметь начальный и конечный теги. Таким образом, вместо одного шорткода вы получите два с определенным контентом между.

Например, плагин Google Maps может позволить отображать местоположение на картах с помощью шорткода. Большинство таких плагинов будут иметь начальный и конечный теги, а адрес должен быть написан между ними. Вот пример:

[[maps]] Нью-Йорк, США [[/ maps]]

Как видно из примера, конечный тег всегда начинается со знака «/». Имея оба тега, WordPress может легче идентифицировать части коротких кодов.

Работа в текстовом редакторе

WordPress шорткоды

Хотя они являются просто ярлыками для функций, шорткоды на самом деле являются криптограммами, специфичными для WordPress. Итак, если вы попытаетесь написать шорткод в визуальном редакторе, WordPress немедленно покажет вам вывод (или только заполнитель) этого шорткода. Если вы последовали примеру галереи и написали шорткод в визуальном редакторе, вы бы увидели, что WordPress немедленно отображает его содержимое (см. Первое изображение в этом посте, чтобы увидеть, как это работает).

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

Шорткоды WordPress по умолчанию

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

Например, плагин, который помогает вам отображать местоположение на Картах Google, может иметь короткий код [[maps]], тот, который отображает формы подписки, будет использовать [[form]] и т. Д..

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

Но WordPress поставляется с набором шорткодов по умолчанию, которые вы можете использовать без установки дополнительных расширений. По умолчанию это шорткоды, с которыми вы можете работать:

  • [аудио] – вставлять аудио файлы
  • [заголовок] – обернуть заголовки вокруг содержимого
  • – оборачивать элементы и устанавливать их максимальные размеры
  • – отображать галерею изображений
  • – показать коллекцию аудио и видео файлов
  • [видео] – вставлять видео файлы

Экранирование шорткодов (отображение текста шорткодов без его выполнения)

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

Чтобы отобразить текст шорткода, используйте двойные скобки: [[короткий код]]

Если вы хотите отобразить шорткод с начальным и конечным тегами, используйте только первую и последнюю двойные скобки: [[карты] Нью-Йорк, США [/ карты]]

При работе в текстовом редакторе вы также можете заменить квадратные скобки их кодами. Таким образом, вместо «[» вы можете использовать «[», а вместо «]» использовать «]». Например: [Шорткод & # 93; будет также отображать шорткод без его выполнения.

Как создать простой шорткод

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

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

  1. Откройте файл function.php в меню «Внешний вид» -> «Редактор».
  2. Поместите следующий код в конец файла:
  3. function fsg_shortURL () {
    return 'http://www.firstsiteguide.com';
    }
    add_shortcode ('fsg', 'fsg_shortURL');
  4. Перейдите в текстовый редактор и введите [FSG] получить URL вместо шорткода

Это было не так сложно, верно?

Более сложный пример: добавление изображения шорткода

Поместив следующий код в functions.php, вы можете создать шорткод для размещения изображения с пользовательскими атрибутами ширины и высоты:

  1. Перейти в файл functions.php
  2. Вставьте следующий код:
  3. function img_shortcode ($ atts, $ content = null) {
    
    извлечь (shortcode_atts (
    массив (
    'ширина' => '',
    'height' => '',
    ), $ atts)
    );
    возвращение '«;
    }
    add_shortcode ('img', 'img_shortcode');
    
    
  4. Открыть текстовый редактор:

Здесь вы можете использовать [img width = ’x’ height = ’y’] http: //… [/ img] шорткод, где «х» и «у» являются числами, которые представляют ширину и высоту в пикселях.

Вы можете легко добавить другие атрибуты изображения, если они вам нужны; проверить список все атрибуты изображений в школах W3.

Как использовать шорткоды в Text Widget

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

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

Если вы только начали создавать свой веб-сайт WordPress, возможно, вы использовали шорткоды только в редакторе сообщений. Но, правда в том, что вы можете использовать шорткоды практически где угодно.

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

Если вам нужно использовать шорткод в ваших файлах PHP (например, если вы хотите запустить код в вашем файле header.php и запускать шорткод везде, где присутствует заголовок), вы можете легко сделать это, обернув код вокруг него. , Но если вы попытались использовать шорткод в текстовом виджете, как в примере, который мы упомянули выше, вы разочаровались, потому что это просто не работает, и виджет вместо шорткода отображал его содержимое. Если ваша тема не имеет зарегистрированной функции, вам нужно включить ее самостоятельно..

Поэтому, если вы хотите иметь возможность вставить шорткод в текстовый виджет и запустить его, не беспокойтесь; Вы можете сделать это за считанные секунды:

  1. Откройте functions.php
  2. Скопируйте и вставьте следующие две строки:
  3. add_filter ('widget_text', 'shortcode_unautop');
    add_filter ('widget_text', 'do_shortcode');
  4. Сохранить изменения

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

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

Точно так же вы можете запускать код PHP из текстового виджета. Это было достаточно легко, не так ли? Наслаждайтесь вашими шорткодами.

Шорткоды везде

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

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

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map