Шорткод это: Что такое шорткоды и как их использовать?

Leave a Comment / Разное / By /

Содержание

Что такое шорткоды и как их использовать?

НовичкамПлагины

Dmitry26.06.2012

15 16 596 2 minutes read

Приветствую, уважаемые читатели wpnice. Сегодня поговорим о такой полезной функции в вашем блоге как шорткоды. А последующие две публикации я посвящу обзору двух самых популярных плагинов по использованию шорткодов. Первый плагин бесплатный — Shortcodes Ultimate. И еще один, платный — Styles with Shortcodes. Изначально хотел сразу приступить к обзору плагинов, но все таки, решил сначала сделать небольшую статью о том, что такое вообще шорткоды.

Что такое шорткоды [shortcodes]?

Говоря простым языком, это возможность превратить сложный PHP код для вывода какого то контента в код короткий, простой  и понятный. Если вы знакомы с PHP, то легко сможете создавать шортсоды сами. По крайней мере, простые. В интернете можно найти немало туториалов на эту тему. Если же вы шарахаетесь от любого программирования как «черт от ладана», тогда можете использовать уже готовые плагины для быстрой вставки и использования шорткодов.

Что дают шорткоды?

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

Шоркоды стали использоваться в WordPress c версии 2.5. Собственно говоря, многие привычные плагины именно тем и занимаются, что выводят необходимый пользователю контент именно в виде шорткодов. Например, плагин — Video Sidebar Widgets или всем известная галерея — Nextgen Gallery. Я уж не говорю о таком популярном плагине как Visual Composer.

Визуально шорткоды выглядят как правило, в виде текста заключенного квадратные скобки — [ shortcode ]. Их легко запомнить и достаточно просто вставить в контент вашей страницы, записи или даже в текстовый виджет в сайдбаре.

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

Как их использовать?

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

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

Примеры использования щорткодов

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

Смотри выше по тексту

Больной пошел на поправку. Но не дошел.

Воспитанный мужчина не сделает замечания женщине, плохо несущей шпалу.

Граждане! Летайте самолетами Аэрофлота! Спешите! Их осталось совсем немного.

Кнопка

Большая кнопка

  • Поговорка 1
  • Поговорка 2
  • Поговорка 3

Tab 1 | Если вы, посмотрев в зеркало, никого там не увидели. Значит, вы неотразимы!

Tab 2 | Если гора не идет к Магомету, … Значит, травка была не очень……

Tab 3 | Если тебе лизнули зад, не расслабляйся — это смазка!

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

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

Читайте так же:
Shortcodes Ultimate — шорткоды для вашего блога
4 бесплатных WordPress плагина шорткодов

Похожие

что это и как ими пользоваться: Плагины шорткодов для WP и Joomla

Автор Игорь Лобода На чтение 7 мин. Просмотров 3.4k. Опубликовано

Содержание

Вступление

Современное SEO на 50%, если не больше, состоит из оптимизации и работы с сайтом. Перелопатив множество проектов в визуальном плане, мы заметили, что техническая работа с сайтом (верстка, программирование) занимает достаточно большой объем рабочего времени. Если бюджет на SEO не высокий, то практически не остается времени на то, чтобы и реализовать все фишки на сайте и проводить аналитические и другие дополнительные мероприятия. Это конечно, не касается больших студий, у которых за все отвечают разные люди или по крайнеей мере должны отвечать. Скорее, это актуально для SEO-специалистов, которые работают над сайтами самостоятельно или небольшой командой с ограниченным бюджетом. Поиски какого-то легкого и не затратного по времени решения привели меня к такой вещи, как Шорткоды. Тема достаточно не новая (архаизм можно сказать), но почему-то редко где можно услышать о том, что это мастхэв в работе с сайтом и возможность без каких-либо серьезных технических знаний (коими не часто обладают SEOшники) сделать на сайте что-то крутое, оформить посадочные страницы и добавить важный для продвижения функционал. Сегодня об этом и поговорим. В основном данный материал будет полезен тем, кто работает с сайтами на WordPress и Joomla, опыта работы с Шорткодами в других системах у нас нет, но я слышал, что есть плагины шорткодов на OpenCart и других CMS. Можете промониторить этот вопрос. Мы не будем вдаваться в детальные подробности, просто покажем, как эта вещь работает, а далее, если тема будет интересной, можем развить ее в других статьях.

Что такое Шорткоды

Шорткод — дословно «Короткий код». Это технология, которая позволяет настроить корреляцию длинной строчки кода с простой фразой в квадратных скобках, которую вы будете вставлять в код страницы сайта и она будет выполнять абсолютно те же функции, что и длинная заранее подготовленная строчка. Это, если рассматривать основную задачу данной технологии. Но, мы выберем путь полегче и подберем готовые решения, которые сэкономят нам ценное время. Дело в том, что для достаточно распространенных движков Joomla и Wordpress, есть специальные плагины, имеющие в своей обойме уже готовые шорткоды, которые позволят Вам решать множество различных задач по оптимизации и визуальному оформлению страниц. При чем, это подходит, как для блогов, или каких-то информационных сайтов (даже в больше степени), так и для коммерческих сайтов. Шорткод, просто, с помощью специального функционала плагинов настраивается по вашему усмотрению и вставляется на страницу сайта, а далее вы можете его внедрить на другие страницы, просто скопировав.
Чтобы не вводить в заблуждение, рассмотрим, как это работает, на примере пары плагинов для WordPress, в Joomla отличий практически нет.

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

Тут все предельно просто. Ниже будет большой список плагинов с шорткодами, которые Вы можете использовать. Мы остановимся для примера на плагине Shortcodes Ultimate для WordPress. Устанавливаем плагин и в меню редактирования страницы у нас появляется специальный функционал, который так и называется «Вставить Шорткод».

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

Для примера выберем пункт «Кнопка». Перед нами открывается меню, где мы можем сделать настройки для данной кнопки. Настраиваем, как нравится, тут все интуитивно понятно. Пример настроек Вы можете видеть ниже:

Когда все настройки сделаны, мы жмем кнопку «Вставить Шорткод» внизу окна с настройками и видим, что в наше текстовой поле добавилась строчка (шорткод) примерно такого вида:

[su_button style=”3d” size=”10″]Наша Кнопка[/su_button]

Теперь смотрим, как это выглядит на сайте:

Отлично, всего в 2 шага, за 5 минут, мы сделали неплохую 3D кнопку на сайте, к которой можем потом прикрутить форму заявки или что-то подобное. Если, Вы хотите добавить точно такую же кнопку на другие страницы сайта, то нужно просто скопировать Шорткод и вставить его в тело нужной страницы, повторно проводить итерацию настройки не нужно!

Функционал плагинов с шорткодами

В функционале любого плагина с Шорткодами, есть масса крутейших фишек для внедрения, давайте посмотрим самые интересные:

    • Оптимизация и визуализация изображений. Формирование слайдеров, галерей изображений, а также каруселей. Все это улучшит вид страницы, сделает ее более интерактивной, удобной и разнообразной.
  • Широкие возможности для работы с текстовой составляющей на странице. Делать различные персонализированные списки, оформлять заголовок страницы h2 по своему вкусу, выделять текст цветом, делать из него блок «заметку», выводить комментарии при наведении курсора в определенную часть текста. Также, можно добавлять различные аккордеоны или просто отдельные спойлеры, для того чтобы сделать материал на странице более компактным и также добавить интерактивности.
  • Как видно на скриншоте ниже, можно делать целые блоки с вкладками, как в карточках товара на интернет-магазинах. Также, прикреплять к странице видео с различных видео-хостингов (не только YouTube, но и Vimeo, Dailymotion) или аудиозаписи, например, ваши подкасты или просто музыку, которая подходит к статье, она сформируется в аккуратную аудио-дорожку.
  • Добавление выделений для цитат, описаний услуг. Размещение превью предыдущих постов, буквениц, интерактивных карт, дополнительного меню и многое другое.

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

Плагины для WordPress

  • Shortcodes Ultimate — самый популярный пак шорткодов, мы взяли его для примера в данную статью;
  • WordPress Shortcodes — второй по популярности плагин для формирования шорткодов, имеет схожий функционал с первым вариантом;
  • Shortcoder — плагин для создания собственных шорткодов;
  • Easy Bootstrap Shortcode — плагин совместимый с Bootstrap 3. 0.3 ;
  • Simple Shortcodes — самый просто в обращении, без всего лишнего, но и функционал не самый обширный;
  • WooCommerce Shortcodes — специализированные шорткоды для превращения вашего сайта в интернет-магазин.

Вообще, чтобы найти себе плагин с шорткодами, нужно зайти в админку WP, перейти во вкладку «Плагины», нажать «Добавить новый» и вбить в поле поиска «Шорткоды» или «Shortcodes». В выдаче будет великое множество разнообразных вариантов, которые можно использовать.

Плагины для Joomla

Для Joomla такого широкого выбора плагинов нет. По сути, самых основных можно выделить два :

  • YT Shortcode
  • Shortcode Ultimate

Они имеют абсолютно идентичный функционал с Вордпрессовскими плагинами.

Заключение

В заключении хотелось бы сказать, что максимально идеально шорткоды работают у людей, которые все же разбираются в технической части. Потому, что иногда возникают трудности, например, с адаптивностью. Эти случаи не часты, но имеют место. И тогда необходимо вручную дорабатывать файлы стилей. Но в целом Шорткоды всем экономят время. Если активно ими пользоваться, то реализация практически любой задумки по оформлению Вашей новой статьи или страниц услуг займет очень короткое время, а результат будет качественный, если грамотно и со вкусом делать настройки в редакторах шорткодов. Если тема будет интересна, можем более подробно уделить внимание деталям. Это был вводный, обзорный материал по Шорткодам. Оставляйте комментарии, делитесь своим видением! Для нас это очень важно!

коротких кодов | Хьюго

Что такое шорткод

Хьюго любит Markdown из-за его простого формата контента, но бывают случаи, когда Markdown не оправдывает ожиданий. Часто авторы контента вынуждены добавлять необработанный HTML (например, видео

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

Первое слово в объявлении шорткода всегда является именем шорткода. Параметры следуют за названием. В зависимости от того, как определен шорткод, параметры могут быть именованными, позиционными или и тем, и другим, хотя вы не можете смешивать типы параметров в одном вызове. Формат именованных параметров моделирует HTML с форматом name="value" .

Некоторые шорткоды используют или требуют закрытия шорткодов. Опять же, как и в HTML, шорткоды открытия и закрытия совпадают (только имя) с объявлением закрытия, перед которым стоит косая черта.

Вот два примера парных шорткодов:

 {{% mdshortcode %}}Вещи для `обработки` в *center*.{{% /mdshortcode %}}
 
 {{< Highlight Go >}} Куча кода здесь {{< /highlight >}}

В приведенных выше примерах используются два разных разделителя, разница между которыми заключается в % символов в первом и <> символов во втором.

Шорткоды с необработанными строковыми параметрами

Вы можете передать несколько строк в качестве параметров шорткоду, используя необработанные строковые литералы:

 {{< myshortcode `Это какой-то HTML,
и новая строка со "строкой в ​​кавычках".` >}}

Шорткоды с Markdown

В Hugo 0.55 мы изменили принцип работы разделителя % . Шорткоды, использующие % в качестве самого внешнего разделителя, теперь будут полностью отображаться при отправке в средство визуализации содержимого. Они могут быть частью сгенерированного оглавления, сносок и т. д.

Если вам нужно старое поведение, вы можете поместить следующую строку в начало шаблона шорткода:

 {{ $_hugo_config := `{ "версия": 1 }` }}

Шорткоды без уценки

Символ < указывает, что внутреннее содержимое шорткода , а не нуждается в дальнейшей обработке. Часто шорткоды без Markdown включают внутренний HTML:

 {{< myshortcode >}}
Hello World!
{{< /myshortcode >}}

Вложенные шорткоды

Вы можете вызывать шорткоды внутри других шорткодов, создавая собственные шаблоны, использующие .Родительская переменная. .Parent позволяет проверить контекст, в котором вызывается шорткод. См. Шаблоны шорткодов.

Использование встроенных коротких кодов Hugo

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

фигура

фигура — это расширение синтаксиса изображения в Markdown, которое не обеспечивает сокращения для более семантического HTML5 <рисунок> элемент.

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

src
URL-адрес отображаемого изображения.
ссылка
Если изображение должно быть гиперссылкой, URL места назначения.
target
Необязательный атрибут target для URL-адреса, если установлен параметр link .
rel
Необязательный атрибут rel для URL-адреса, если ссылка 9Параметр 0006 установлен.
alt
Альтернативный текст для изображения, если изображение не может быть отображено.
заголовок
Название изображения.
Подпись
Подпись к изображению. Markdown в пределах значения будет отображаться заголовок .
class
class атрибут HTML тега figure .
высота
высота атрибут изображения.
ширина
ширина атрибут изображения.
attr
Текст с указанием авторства изображения. Markdown в пределах значения attr будет отображаться.
attrlink
Если текст атрибуции должен быть гиперссылкой, URL назначения.
Пример
рисунок Ввод

рисунок-ввод-example.md

 {{< рисунок src="/media/spf13.jpg" title="Стив Франсия" >}}
Пример
рисунок

1 Вывод

7

рисунок-выход-example.html

<рисунок>
  
  

       
Стив Франсиа

суть

Блоггеры часто хотят включать суть GitHub при написании сообщений. Предположим, мы хотим использовать gist по следующему адресу:

 https://gist.github.com/spf13/7896402.

Мы можем встроить суть в наш контент с помощью имени пользователя и идентификатора сущности, извлеченных из URL-адреса:

 {{< gist spf13 7896402 >}}
Пример
gist Input

Если gist содержит несколько файлов и вы хотите указать только один из них, вы можете передать имя файла (в кавычках) в качестве необязательного третьего аргумента:

gist-input. md

 {{ < gist spf13 7896402 "img.html" >}}
Пример
gist Вывод

gist-output.html
Example
gist Display

Чтобы продемонстрировать замечательную эффективность функции шорткода Hugo, мы встроили на эту страницу пример spf13 gist . Следующее имитирует работу посетителей вашего веб-сайта. Естественно, окончательный вид будет зависеть от ваших таблиц стилей и окружающей разметки.

highlight

Этот шорткод преобразует предоставленный исходный код в HTML с выделенным синтаксисом. Подробнее о подсветке. Highlight принимает ровно один требуемый параметр языка и требует закрывающий шорткод.

Пример
Highlight Input

content/tutorials/learn-html.md

 {{< Highlight html >}}
<раздел>
  <дел>
    
{{ .
 Название }} 
    {{ диапазон .страниц }}
        {{ .Render "резюме"}}
    {{ конец }}
{{< /highlight >}}
Пример
Highlight Выход

Приведенный выше пример шорткода highlight создаст следующий HTML-код при отображении сайта:

tutorials/learn-html/index.html

<section id="main">
  <div>
   <h2 id="title">{{ .Title }}< /h2>
    {{ диапазон .страниц }}
        {{ .Render "резюме"}}
    {{ конец }}
  </div>
</section>

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

instagram

Если вы хотите встроить фотографию из Instagram, вам нужен только идентификатор фотографии. Вы можете узнать идентификатор фотографии Instagram по URL-адресу:

 https://www.instagram.com/p/BWNjjyYFxVx/
Пример
instagram Ввод

instagram-input.md

 {{< instagram BWNjjyYFxVx >}}

У вас также есть возможность скрыть заголовок:

instagram-input-hide-caption.md

 {{< instagram BWNjjyYFxVx hidecaption >}}
Example
instagram Output Например, к разметке отображаемого веб-сайта будет добавлен следующий HTML-код:

instagram-hide-caption-output.html

Example
instagram Display

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

Шорткод instagram ссылается на конечную точку API Instagram, которая устарела с 24 октября 2020 года. Таким образом, из этой конечной точки API невозможно получить изображения, что приводит к ошибке при использовании короткого кода instagram . Для получения дополнительной информации ознакомьтесь с выпуском GitHub № 7879..

param

Получает значение из параметров текущей страницы , установленных в начале, с возвратом к значению параметра сайта. Он зарегистрирует ОШИБКА , если параметр с данным ключом не может быть найден ни в одном из них.

 {{< параметр теста >}}

Поскольку testparam — это параметр, определенный в начале этой страницы со значением Hugo Rocks! , выше будет напечатано:

Hugo Rocks!

Для доступа к глубоко вложенным параметрам используйте «точечный синтаксис», например:

 {{< параметр "my.nested.param" >}}

ref и relref

Эти шорткоды будут искать страницы по их относительному пути (например, blog/post. md ) или их логическому имени ( post.md ) и возвращать постоянную ссылку ( ref ) или относительная постоянная ссылка ( relref ) для найденной страницы.

ref и relref также позволяют создавать фрагментарные ссылки, которые работают для ссылок заголовков, сгенерированных Hugo.

Прочитайте более подробное описание ref и relref в документации по перекрестным ссылкам.

ref и relref берут ровно один обязательный параметр reference , указанный в кавычках и в позиции 0 .

Пример
ref и relref Ввод
 [Neat]({{< ref "blog/neat.md" >}})
[Кто]({{< relref "about.md#who" >}})
Пример
№ и relref Вывод

Предположим, что стандартные URL-адреса Hugo включены.

  com/blog/neat">Отлично
Кто

твит

Вы хотите включить один твит в свой блог? Все, что вам нужно, это URL-адрес твита:

 https://twitter.com/SanDiegoZoo/status/1453110110599868418.
Пример
твит Ввод

Передать пользователя твита (без учета регистра) и идентификатор из URL-адреса в качестве параметров в твит шорткод.

example-tweet-input.md

 {{< tweet user="SanDiegoZoo" >}}
Example
tweet Output

Используя предыдущий пример tweet , следующий HTML-код будет добавлен к отображаемому веб-сайту. разметка:

пример-tweet-output.html

Сова, держу пари, ты проиграешь в этом состязании в гляделки 🦉 pic.twitter.com/ eJh5f2zncC
— Альянс дикой природы зоопарка Сан-Диего (@sandiegozoo)  com/sandiegozoo/status/1453110110599868418?ref_src=twsrc%5Etfw">26 октября 2021 г.
Пример
tweet Display

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

Сова, держу пари, ты проиграешь в этом состязании в гляделки 🦉 pic.twitter.com/eJh5f2zncC

— Альянс дикой природы зоопарка Сан-Диего (@sandiegozoo) 26 октября 2021 г.

vimeo

Добавление видео из Vimeo эквивалентно шорткоду ввода YouTube.

 https://vimeo.com/channels/staffpicks/146022717
Пример
vimeo Ввод

Извлеките идентификатор из URL-адреса видео и передайте его в шорткод vimeo :

example-vimeo-input. md

 {{< vimeo 146022917 >}0005 vimeo  Output   
 Используя предыдущий пример  vimeo , следующий HTML-код будет добавлен к разметке вашего веб-сайта: 
 
 example-vimeo-output.html 
 
<дел>

Если вы хотите дополнительно настроить визуальный стиль вывода YouTube или Vimeo, добавьте класса именованный параметр при вызове шорткода. Новый класс будет добавлен к

, который обертывает

youtube

Шорткод youtube встраивает адаптивный видеоплеер для видео YouTube. Требуется только идентификатор видео, например:

 https://www.youtube.com/watch?v=w7Ft2ymGmfc
Пример
youtube Вход

Скопируйте идентификатор видео YouTube, следующий за v= в URL-адресе видео, и передайте его на шорткод youtube :

example-youtube-input.md

 {{< youtube w7Ft2ymGmfc >}}

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

example-youtube-input-with-autoplay. md

 {{< youtube autoplay="true" >}}

Из соображений доступности лучше указать название для вашего видео на YouTube. Вы можете сделать это с помощью шорткода, указав параметр title . Если заголовок не указан, по умолчанию будет использоваться «YouTube Video».

example-youtube-input-with-title.md

 {{< youtube title="Новый сайт Hugo менее чем за две минуты" >}}
Пример
youtube Output

Используя предыдущий пример youtube , следующий HTML-код будет добавлен к разметке отображаемого веб-сайта:

example-youtube-output.html
Пример
youtube Display

Используя предыдущий пример youtube (без autoplay="true" ), следующее имитирует отображаемый опыт для посетителей вашего веб-сайта. Естественно, окончательный вид будет зависеть от ваших таблиц стилей и разметки. Видео также включено в краткий обзор документации Hugo.

Конфигурация конфиденциальности

Чтобы узнать, как настроить свой сайт Hugo в соответствии с новыми правилами конфиденциальности ЕС, см. Hugo и GDPR.

Создание пользовательских коротких кодов

Чтобы узнать больше о создании пользовательских коротких кодов, см. документацию по шаблону коротких кодов.

Шорткоды

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

Шорткоды работают только на простых страницах и в текстовых полях блоков Exhibit Builder Exhibit Page.

Общие

Шорткоды могут быть добавлены в текстовые поля «Простая страница» и «Конструктор выставок». Общий синтаксис

[ключ=значение]

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

[клавиша короткого кода='значение'] или [клавиша короткого кода='значение']

Встроенные короткие коды

Omeka.net поставляется с несколькими короткими кодами, доступными по умолчанию.

Недавние элементы

Шорткод последних элементов возвращает список элементов, недавно добавленных в базу данных.

Шорткод [последние_элементы] . Без каких-либо дополнительных параметров он вернет пять элементов.

Опции

Поддерживаются следующие опции:

число

укажите количество возвращаемых товаров; по умолчанию — «5»

Например, чтобы вернуть 10 элементов, шорткод должен выглядеть так:

[recent_items num=’10’]

Featured Items

Шорткод избранных элементов возвращает набор количество предметов, отмеченных в админке как рекомендуемые.

Шорткод: [featured_items] . Без каких-либо дополнительных параметров он будет возвращать один элемент за раз.

Опции

Поддерживаются следующие опции:

число

укажите количество возвращаемых товаров; по умолчанию — «1»

has_image

Может использоваться, чтобы требовать наличия или отсутствия изображения у рекомендуемого элемента; по умолчанию возвращаются элементы как с изображениями, так и без них

Опции:

true — будут возвращены только избранные элементы, с которыми связан файл изображения

false — будут возвращены только избранные элементы, с которыми не связан файл изображения

Например, чтобы вернуть 2 избранных элемента, и только те, которые не содержат изображения:

[featured\_items num=2 has\_image=false]

Items

Шорткод элементов возвращает один или несколько элементов.

Шорткод [items]. Без каких-либо дополнительных параметров он вернет список из 10 самых старых элементов в вашем архиве.

Опции

Поддерживаются следующие опции:

число

укажите количество возвращаемых товаров; указание 0 вернет все элементы; значение по умолчанию 10

Например, чтобы вернуть пять элементов

[число элементов = 5]

идентификаторы

вернуть элемент или список элементов на основе идентификаторов элементов. Можно ввести несколько идентификаторов элементов, разделенных запятой, без пробелов; или диапазон, разделенный дефисом.

Например:

для возврата одного элемента с идентификатором 13

[items ids=13]

для возврата элементов с идентификаторами 10, 76 и 432

[items ids= 10,76,432]

, чтобы вернуть все элементы между 30 и 55

[items id=30-55]

is_featured

указать, следует ли возвращать только рекомендуемые элементы или нет

Опции:

1 — будут возвращены только те элементы, которые представлены

0 — будут возвращены только элементы, которые не представлены

Например,

[items is_featured=1]

коллекция

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

Например,

[items collection=7]

теги

возвращают только элементы из определенного тега. Можно ввести несколько тегов, разделенных запятой, без пробелов.

Например,

[items tags=baseball,math]

пользователь

возвращает только элементы, добавленные конкретным пользователем, используя идентификатор пользователя. Можно указать только одного пользователя. Чтобы найти номер пользователя, перейдите на вкладку «Пользователь» в верхней части панели управления и нажмите «Ключи API». Число в конце URL — это номер пользователя.

Например,

[items user=3]

has_image

можно использовать, чтобы потребовать, чтобы у избранного элемента было или не было изображения; по умолчанию «ноль»

Параметры:

null — будут возвращены все избранные элементы независимо от того, есть ли изображение или нет

true — будут возвращены только избранные элементы, с которыми связан файл изображения

false — будет возвращать только избранные элементы, с которыми не связан файл изображения

Например,

[items has_image=true]

Элементы также можно сортировать по-разному со следующими параметрами.

sort

указывает поле, которое будет использоваться для сортировки элементов.

Элементы – укажите элемент для сортировки элементов. Синтаксис: «Набор элементов, Элемент»

Например, для сортировки элементов по их названиям Dublin Core:

[items sort="Dublin Core,Title"]

ПРИМЕЧАНИЕ. В этом случае необходимо использовать двойные кавычки. для переноса значений, и между запятой, следующей за набором элементов, и самим элементом не может быть пробела.

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

Например, если вы хотите показать один случайно выбранный предмет из предметов определенной коллекции:

[items num=1 collection=3 sort=random]

добавлено – может передаваться для сортировки предметов по дате добавления

Например, чтобы получить 10 последних элементов

[items num=10 sort=added order=d]

модифицировано – может передаваться для сортировки товаров по дате изменения a – элементы отображаются в порядке возрастания

d – элементы отображаются в порядке убывания

ПРИМЕЧАНИЕ. Порядок требует указания значения сортировки.

Например, чтобы получить 5 последних элементов из коллекции:

[items num=5 collection=3 sort=added order=d]

Примеры

Чтобы вернуть один случайный предмет из набора предметов с тегом «бейсбол»:

[items num=1 tags =baseball sort=random]

Чтобы вернуть список из пяти последних элементов, добавленных пользователем с идентификатором 3:

[items num=5 user=3 sort=added order=d]

Чтобы вернуться все элементы с тегом бейсбол из коллекции с идентификатором 5, отсортированные по названию:

[items num=0 collection=5 tags=baseball sort="Dublin Core,Title" order=a]

Чтобы вернуть все рекомендуемые элементы из коллекции с идентификатором 7, отсортированные по дате изменения, старейшие first:

[число элементов=0 collection=7 sort=modified order=a]

Коллекции

Шорткод коллекций возвращает одну или несколько коллекций.

Шорткод [коллекции]. Без каких-либо дополнительных параметров он вернет список из 10 самых старых коллекций.

Опции

Поддерживаются следующие опции:

число

укажите количество возвращаемых коллекций; указание «0» вернет все коллекции; по умолчанию 10

is_featured

укажите, следует ли возвращать только избранные или непредставленные коллекции.

1 – будут возвращены только коллекции, которые представлены

** – будут возвращены только коллекции, которые не представлены

Например, чтобы вернуть все коллекции, помеченные как избранные:

[коллекции коллекций=0 is_featured=1]

Коллекции также можно сортировать по-разному со следующими параметрами.

sort

указывает поле, которое будет использоваться для сортировки коллекций.

Элементы – укажите элемент для сортировки элементов. Синтаксис: «Набор элементов, Элемент»

Например, для сортировки коллекций по их названиям Dublin Core

[коллекции sort="Dublin Core,Title"]

ПРИМЕЧАНИЕ. В этом случае для переноса значений необходимо использовать двойные кавычки, и между запятой, следующей за набором элементов, и элементом не может быть пробела.

random

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

добавлено

может быть передано для сортировки коллекций по дате добавления

Например, чтобы получить 10 самых последних коллекций

[коллекции коллекций = 10 sort = добавленный порядок = d]

измененный

7

измененный

7

можно передать для сортировки элементов по дате изменения

порядок

указать порядок коллекций

a – коллекции будут отображаться в порядке возрастания

d – коллекции будут отображаться в порядке убывания

ПРИМЕЧАНИЕ-порядок требует указания значения сортировки.

Избранные коллекции

Шорткод избранных коллекций возвращает заданное количество коллекций, отмеченных в админке как рекомендуемые.

Шорткод: [featured_collections] . Без каких-либо дополнительных параметров он будет возвращать по одной коллекции за раз.

Опции

Поддерживаются следующие опции:

число

укажите количество возвращаемых коллекций; по умолчанию «1»

Например, чтобы вернуть две избранные коллекции:

[featured_collections num=2]

Последние коллекции

Шорткод последних коллекций возвращает список последних созданных коллекций.

Шорткод: [recent_collections] . Без каких-либо дополнительных параметров он вернет пять коллекций.

Опции

Поддерживаются следующие опции:

число

укажите количество возвращаемых коллекций; по умолчанию «5»

Например, чтобы перейти к трем последним созданным коллекциям:

[recent_collections num=3]

Файл

Шорткод файла вернет файл с указанным идентификатором.

Шорткод [файл] . Он не будет работать, если ему не предоставлен идентификатор файла.

Опции

Поддерживаются следующие опции:

id Обязательно

укажите идентификационный номер файла, который вы хотите восстановить; см. ниже инструкции о том, как найти идентификационный номер

Например, чтобы получить файл с идентификатором 362:

[идентификатор файла=362]

размер

укажите размер изображения для файлов изображений

– 90 миниатюра 90 Параметры:

47 90 версия изображения

Square_thumbnail – миниатюра изображения в квадрате и по центру

fullsize – полноразмерная версия изображения

link_file

укажите, следует ли файлу отображать страницу файла; по умолчанию «1»

Параметры:

1 или True - ссылки на исходный файл

0 или false - Удаляет все ссылки на файл

Thumbnail - ссылки на миниатюрный квадратный миниатюрный файл

fullsize – ссылки на полноразмерный файл

width

укажите ширину аудио или видео плеера в пикселях; доступно для большинства типов аудио и видео; значения по умолчанию различаются.

height

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

Примеры

Чтобы вернуть миниатюру изображения, связанного с исходным файлом, с идентификатором файла 5:

[идентификатор файла=5 size=миниатюра]

Чтобы вернуть квадратную миниатюру изображения , который ссылается на полноразмерное изображение с идентификатором файла 12:

[идентификатор файла = 12, размер = квадратный \_ ссылка на миниатюру \_ файл = полный размер]

Найдите идентификатор файла

Чтобы найти идентификатор файла, перейдите на страницу администратора для элемента, к которому он прикреплен; например

http://yoursitename.omeka.net/admin/items/show/482 .

В верхней части страницы элемента находится список файлов, связанных с этим элементом. Нажав на один из них, вы попадете на страницу с файлом; например

http://yoursitename. omeka.net/omeka/admin/files/show/752 .

В верхней части страницы находится заголовок, содержащий идентификатор файла # и название файла; например, файл № 752: «Название файла». Целое число после знака # является идентификатором; в данном случае это будет 752. Чтобы вернуть этот файл, шорткод будет [идентификатор файла = 752] .

Шорткоды плагинов

Несколько плагинов также имеют короткие коды.

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

Избранные экспонаты

Требуется установка и активация плагина Exhibit Builder.

Шорткод избранных экспонатов вернет один или несколько экспонатов, отмеченных как рекомендуемые.

Шорткод [featured_exhibits] . Без дополнительных опций он случайным образом вернет один экспонат из всех отмеченных как рекомендуемые.

Опции

NUM

Укажите количество экспонатов для отображения

, например, для показа, что три показанные экспонаты:

[Infected_exhibits num = 3]

Приложение

требует плагина для выставок. установлен и активирован.

Шорткод экспонатов возвращает один или несколько экспонатов.

Шорткод [экспонаты] . Без дополнительных опций он вернет десять экспонатов, начиная с самого старого.

Опции

NUM

Укажите количество экспонатов для отображения

Например, показывать три экспоната:

[Приложение NUM = 3]

ID

. Возвращение к экспозиции или списку. экспонатов по идентификационным номерам предметов. Можно ввести несколько идентификаторов экспонатов через запятую без пробелов; или диапазон, разделенный дефисом. Идентификаторы экспонатов можно найти в конце URL-адреса страницы редактирования для экспоната; например yoursite/admin/exhibits/edit/11 - идентификатор выставки равен 11.

Например:

для возврата одной выставки с идентификатором 13

[exhibits ids=13]

для возврата экспонаты с идентификаторами 10, 12 и 32

[идентификаторы экспонатов = 10,12,32]

, чтобы вернуть все экспонаты между экспонатом 5 и экспонатом 10

[идентификаторы экспонатов = 5-10]

is_featured

указать, следует ли возвращать только экспонаты, которые представлены или не представлены

Опции:

1 – будут возвращены только те предметы, которые показаны

** – будут возвращены только предметы, которые не представлены

Экспонаты также могут быть отсортированы по-разному со следующими опциями.

sort

указывает поле, которое будет использоваться для сортировки экспонатов.

название : сортировать экспонаты по названию

добавлено : сортировать экспонаты по дате добавления

random — может быть передан на сортировку для случайного выбора из набора возвращаемых элементов.

порядок

указать порядок экспонатов

Опции:

a – экспонаты будут отображаться в порядке возрастания

d – экспонаты будут отображаться в порядке убывания чтобы было указано.

Например, чтобы получить пять последних экспонатов:

[количество экспонатов=5 sort=added order=d]

Геолокация

Требуется установка и активация плагина геолокации. Геолокация доступна только для владельцев тарифных планов Silver, Gold и Platinum.

Шорткод геолокации создаст карту элементов на основе заданных параметров.

Шорткод [геолокация] . Без каких-либо дополнительных параметров он вернет карту всех элементов, содержащих данные геолокации.

Опции

Поддерживаются следующие опции:

fit

укажите, разрешить ли Google Map автоматически центрировать и масштабировать карту, чтобы она соответствовала всем маркерам. Это включено по умолчанию.

Чтобы вручную указать масштаб карты/местоположения, используйте следующие параметры. Обратите внимание, чтобы использовать эти параметры, нужно установить значение «0» или «ложь».

широта

укажите широту начальной центральной точки карты в градусах. Должно быть от -90 до 90.

lon

укажите долготу начальной центральной точки карты в градусах. Должно быть между -180 и 180

масштаб

указать начальный уровень масштабирования карты. 0 максимально уменьшен.

Если какие-либо параметры широты, долготы или масштабирования не заданы специально, а для параметра «подгонка» задано значение 0 или false, будут использоваться параметры со страницы конфигурации плагина геолокации.

введите

укажите тип отображаемой карты google. По умолчанию используется настройка на странице конфигурации плагина геолокации.

дорожная карта — отображает вид дорожной карты

Satellite — отображает спутниковые изображения Google Earth

Hybrid — отображает комбинацию дорожных карт и изображений со спутника

Terrain — отображает физическую карту на основе информации о местности элементы из определенной коллекции, используя идентификационный номер коллекции. Можно указать только одну коллекцию.

Например,

[сбор геолокаций=5]

теги

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

Например,

[теги геолокации=бейсбол,математика]

высота

установить высоту карты. Может быть задано в пикселях или процентах, но требует указания либо в пикселях, либо в %; по умолчанию 436px.

Например,

[высота геолокации=300 пикселей]

или

[геолокация высота=50%]

ширина

установить ширину карты. Может быть задано в пикселях или процентах, но требует указания либо в пикселях, либо в %; по умолчанию 100%.

Например,

[ширина геолокации=200 пикселей]

или

[ширина геолокации=75%]

Ни один, любой или все параметры не могут быть установлены. Ни один не требуется.

Примеры

Чтобы распечатать карту всех объектов с геотегами, просто введите:

[геолокация]

Для карты, которая содержит все предметы из вашей первой коллекции, которые также имеют тег «бейсбол» из возможных параметров будет выглядеть так:

[геолокация широта=42 долгота=117 масштаб=7 тип=гибридная коллекция=4 теги=бейсбол,математика,окленд высота=500px ширина=500px]

Шорткоды Карусель

Требуется Плагин Shortcodes Carousel, который доступен только для обладателей планов Silver, Gold и Platinum.