Шорткоды WordPress – это небольшие теги, которые используются в качестве ярлыков для выполнения определенных функций на сообщениях и страницах. Вы можете распознать короткие коды в квадратных скобках, окружающие одно слово или фразу. Они были представлены в версии 2.5 с целью помочь людям легко выполнять функции.
Как вы, возможно, уже знаете, WordPress использует язык программирования PHP для включения. Поэтому, когда вы хотите добавить определенную функцию непосредственно к сообщениям и страницам, вам нужно будет написать код в текстовом редакторе. Вместо этого шорткоды позволяют пользователям заменить весь блок кода одним термином и просто выполнить его, опубликовав сообщение. Невероятно, не правда ли?
В этом руководстве вы можете узнать:
Рекомендуемое чтение: курсы WordPress от Udemy
Как использовать шорткоды WordPress
Чтобы использовать шорткоды, не нужно знать, как кодировать или понимать, как они работают на бэкэнде. В самом WordPress, а также в большинстве тем и плагинов WordPRess используются разные шорткоды, что позволяет использовать многие расширенные функции.
Например, чтобы отобразить всю галерею изображений, просто используйте (Галерея) шорткод, который поставляется с WordPress. Большинство шорткодов можно использовать в их основной форме, как в примере выше.
Шорткоды заменяются реальным содержимым, как только вы публикуете или просматриваете сообщение или страницу.
Параметры шорткода
Чаще всего, короткие коды могут иметь дополнительные параметры, Добавляя к ним дополнительную информацию, вы можете настроить и изменить вывод. Например, хотя тривиальный (галерея) шорткод показывает все изображения, прикрепленные к сообщению, вы можете изменить его. Шорткод галереи позволяет указывать изображения по их идентификатору, поэтому вы можете отображать только определенные изображения или даже включать изображения, которые не являются частью этого конкретного сообщения.
Также вы можете определить размер галереи и многое другое, предоставив дополнительные параметры. Вот пример:
(галерея id = "1,5,7" size = "средний")
Галерея в этом примере будет отображать только изображения с определенными идентификационными номерами. В этом случае размер автоматически изменится на средний. И вы получаете все это с помощью простого шорткода. Теперь представьте, как это выглядело бы, если бы вы собирались вручную добавить код PHP, который имел бы десятки, если не сотни строк. Спасибо, шорткоды!
Начальный и конечный теги
Некоторые более сложные шорткоды могут иметь начальный и конечный теги. Таким образом, вместо шорткода вы получите два с определенным контентом между ними.
Например, плагин Google Maps может позволить отображать местоположение на картах с помощью шорткода. Большинство из этих плагинов будут иметь начальный и конечный теги, а адрес должен быть написан в середине. Вот пример:
((карты)) Нью-Йорк, США UU. ((/ карты))
Как видно из примера, конечная метка всегда начинается с косой черты "/". Имея оба тега, WordPress может легче идентифицировать части шорткодов.
Работа в текстовом редакторе
Хотя они и являются ярлыками функций, они сами по себе являются криптограммами для WordPress. Поэтому, если вы попытаетесь написать шорткод в визуальном редакторе, WordPress немедленно покажет вам вывод (или только заполнитель) этого шорткода. Если вы последовали примеру из галереи и написали шорткод в визуальном редакторе, вы увидите, что WordPress немедленно отображает его содержимое (см. Первое изображение в этом посте, чтобы увидеть, как оно работает).
Если вы хотите редактировать шорткод и работать с его параметрами, переключитесь на текстовый редактор, который позволяет вам увидеть структуру любого заданного шорткода.
WordPress шорткоды по умолчанию
Шорткоды обычно управляются темами и плагинами. Каждый разработчик может зарегистрировать шорткоды самостоятельно, поэтому каждый из них отличается. То, что делает шорткод, каковы его параметры и функции, зависит исключительно от конкретного плагина и темы, которую вы используете.
Например, плагин, который помогает вам отображать местоположение на Картах Google, может иметь шорткод ((карты)), который отображает формы подписки ((форма)) и т. Д.
Каждый продукт индивидуален, поэтому обязательно ознакомьтесь с описанием и документацией по темам и плагинам для получения дополнительной информации об их конкретном использовании.
Но WordPress поставляется с набором шорткодов по умолчанию, которые вы можете использовать без установки дополнительных расширений. По умолчанию это шорткоды, с которыми вы можете работать:
- (аудио): вставлять аудио файлы
- (субтитры): настроить субтитры вокруг содержимого
- (вставлять): оборачивать встроенные элементы и устанавливать их максимальные размеры
- (галерея) – отображает галерею изображений
- (список воспроизведения): отображает коллекцию аудио и видео файлов
- (видео) – вставлять видео файлы
Escape-шорткоды (отображать шорткод без запуска)
Иногда вам может потребоваться отобразить текст, представляющий короткий код, а не выполнять его. Если вы попытались добавить шорткод в текстовый и визуальный редакторы, вы обнаружили, что он запускается оба раза.
Чтобы отобразить текст шорткода, используйте двойные скобки: ((Короткий код))
Если вы хотите отобразить шорткод с начальным и конечным тегами, используйте только первую и последнюю двойные скобки: ((карты) Нью-Йорк, США (/ карты))
При работе в текстовом редакторе вы также можете заменить квадратные скобки своими кодами. Поэтому вместо «(« вы можете использовать »(», а вместо «)» использовать «)». Например: (шорткод & # 93 (шорткод & # 93; он покажет шорткод также без его выполнения.
Как создать простой короткий код
Когда вы пишете статьи на WordPress ежедневно, бывают случаи, когда вы повторяете себя и вам приходится что-то писать снова и снова. Неважно, будет ли это URL-адрес веб-сайта, длинное предложение или фрагмент кода HTML, который вы постоянно пишете с нуля, вам следует подумать о том, чтобы написать для него короткий код.
И с этой простой функцией вам не нужно быть программистом или вы даже не будете нанимать его, чтобы упростить задачу. Выполните следующие действия и создайте собственный шорткод:
- Откройте файл function.php в меню Внешний вид -> Редактор
- Поместите следующий код в конец файла:
- Перейдите в текстовый редактор и введите (ФСГ) получить URL вместо шорткода
function fsg_shortURL() {
return 'http://www.firstsiteguide.com';
}
add_shortcode('fsg', 'fsg_shortURL');
Это было не так сложно, правда?
Более сложный пример: добавление изображения шорткода
Поместив следующий код в functions.php, вы можете создать короткий код для размещения изображения с пользовательскими атрибутами ширины и высоты:
- Перейдите в файл functions.php
- Вставьте следующий код:
- Открыть текстовый редактор:
function img_shortcode( $atts , $content = null ) {
extract( shortcode_atts(
array(
'width' => '',
'height' => '',
), $atts )
);
return '
';
}
add_shortcode( 'img', 'img_shortcode' );
Здесь вы можете использовать (img width = 'x' height = 'y') http: //… (/ img) шорткод, где «x» и «y» – это числа, представляющие ширину и высоту в пикселях.
Вы можете легко добавить другие атрибуты изображения, если они вам нужны; Посмотрите на список всех атрибутов изображения в школах W3.
Как использовать шорткоды в текстовом виджете
В WordPress версии 4.9, выпущенной 15 ноября 2017 года, шорткоды автоматически работают в текстовых виджетах. Но если вы все еще используете старую версию WordPress, эта часть руководства поможет вам получить результат.
Шорткоды могут содержать различные функции, которые вы можете добавить на свой сайт WordPress. Независимо от того, создали ли вы для себя, или поставляете с установленной темой или плагином, вы, вероятно, будете использовать шорткоды постоянно. Поскольку вы действительно можете сэкономить время и воспользоваться ими, нет причин не использовать шорткоды.
Если вы только начали создавать свой сайт WordPress, возможно, вы использовали шорткоды только в редакторе постов. но, правда в том, что вы можете использовать шорткоды практически где угодно,
Например, если вы используете 5-секундный плагин Google Maps PRO, который позволяет легко создавать карты с бесчисленными булавками, вы можете вставить карту с помощью короткого кода прямо в текстовый виджет и вместо этого отобразить ее местоположение на боковой панели. одного отправления. Но если ваша тема не поддерживает шорткоды в виджетах, вам нужно будет включить функцию самостоятельно, и это то, что мы собираемся показать в этой статье.
Если вам нужно использовать короткий код в ваших PHP-файлах (например, если вы хотите запустить код в своем файле header.php и запустить короткий код, где находится заголовок), вы можете легко сделать это, обернув код вокруг него. , Но если вы попытались использовать шорткод в своем текстовом виджете, как в примере, который мы упомянули выше, вы разочаровались, потому что это просто не работает, и виджет вместо шорткода представляет собой содержимое. Если ваша тема не имеет зарегистрированной функции, вам нужно включить ее самостоятельно.
Поэтому, если вы хотите иметь возможность поместить шорткод в текстовый виджет и запустить его, не беспокойтесь; Вы можете сделать это за считанные секунды:
- Откройте functions.php
- Скопируйте и вставьте следующие две строки:
- Сохранить изменения
add_filter( 'widget_text', 'shortcode_unautop'); add_filter( 'widget_text', 'do_shortcode');
Хотя на самом деле достаточно просто использовать вторую строку, которая заставляет работать шорткод, вы захотите, чтобы первая строка избегала автоматической вставки в WordPress абзаца и тегов разрыва, когда вы бессознательно создаете разрывы строк путем форматирования текста в виджете. Если вы поместите короткий код в отдельную строку, он удалит эти теги абзаца, и короткий код будет отлично работать.
Теперь вы можете перемещаться и перетаскивать текстовый виджет туда, куда вы хотите. После всего этого, когда вы пишете шорткод непосредственно в ваш текстовый виджет (который, конечно, зарегистрирован на вашем сайте), он будет работать так же, как он был написан в редакторе постов.
Точно так же вы можете запустить код PHP из вашего текстового виджета. Это было достаточно легко, не так ли? Наслаждайтесь вашими шорткодами.
Короткие коды везде
Если вы только начинаете блог на WordPress, шорткоды могут показаться излишними и сложными для понимания. Большую часть времени можно будет избежать коротких кодов, используя удобный интерфейс, предоставляемый плагином. Но когда вы будете больше заниматься блогом и начнете использовать больше плагинов, вы поймете истинную силу шорткодов.
Их использование станет обычным делом, и вы быстро привыкнете вводить квадратные скобки в каждом новом сообщении, которое создаете. Потратьте несколько минут и используйте эту статью, чтобы изучить основы.
