Основные шоткоды

Статья опубликована 23.02.2011 в 13:31 пользователем в разделе Плагины

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

Установка и настройка

Плагин входит в базовую поставку системы с 23.02.2011г, установка и активация не требуется. Для пользователей, получивших свои сайты до указанного срока, требуется открыть раздел "Модули", найти там дистрибутив "Основные шоткоды", установить его и активировать плагин. Настройка модуля не требуется.

Использование

Модуль добавляет к основной функциональности сайта новый элемент - шоткоды. Шоткодом мы называем небольшой блок текста, вида [[shortcode]] с возможными параметрами и вложенным текстом. Параметры шоткода указываются аналогично параметрам обычных HTML-кодов, то есть: param="value" - внутри самого тега.

Чтобы использовать теги в тексте без преобразования, необходимо указывать их в двойных квадратных скобках, например: [[news]].

В качестве проверочного блока, в плагин включены стандартные теги BBcode, приведённые в этой таблице:

Код Результат
[b]текст[/b]

Полужирный текст - аналогично тегу strong в HTML разметке и B в визуальном редакторе.

[i]текст[/i]

Текст курсивом - аналогично тегу strong в HTML разметке и B в визуальном редакторе.

[s]текст[/s]

Зачеркнутый текст

[c]текст[/c]

Текст блока выравнивается по центру относительно всей страницы.

Их использование не рекомендуется, так как в отличие от стандартных HTML-тегов, этот BBcode не поддерживает вложенности, то есть сделать жирный текст курсивом уже не получится. Данные коды приведены для ознакомительных целей.

Последние новости

Шоткод [news] позволяет легко выводить последние новости на сайте напрямую из новостного раздела. Функционал тега позволяет выводить последние записи с любой страницы и из любого конкретного её раздела, добавляя к ним полный текст, полное или сокращённое описание. Шоткод [news] может содержать ряд дополнительных параметров, влияющих на вывод новостей. Все используемые параметры и их влияние на вывод приведены в таблице ниже:

Параметр По умолчанию Действие
page не задан

Указывает, из какой страницы требуется отбирать записи. Может быть опущен, содержать номер страницы или параметр this.

  • Параметр не указан - новости отбираются со всех страниц сайта
  • Указан номер страницы - выборка новостей идёт из указанной по номеру страницы. Номер страницы Вы можете увидеть в системе администрирования, раздел "Контент", колонка "#". Может быть указан только один номер страницы.
  • this - используется номер текущей страницы, в текст которой вставлен блок [news]
div не задан Указывает, из какого раздела выбранной страницы ведётся отбор последних новостей. Может быть опущен, содержать номер раздела или параметр this, аналогично параметра page.
count 5 Количество выводимых записей - целое положительное число от 1 до 15.
text 100

Определяет, как выводить текст в последних новостях. Может быть таким:

  • no - текст не выводится, используется только заголовок
  • short - выводится краткое описание элемента, description.
  • full - выводится полный текст записи (не рекомендуется использовать при количестве записей больше одной).
  • Указано целое число - используется краткое описание записи, сокращённое до указанного числа символов. По умолчанию, выводится первые 100 символов новости, обрезанные до целого слова.
title не задан Может быть указан как no, чтобы не выводить заголовки записей.
dates не задан Может быть указан как no, чтобы скрыть даты публикации записей.

Шоткод может быть использован также на главной странице сайта и в блоках контента над и под основным содержимым сайта.

Для работы этого шоткода, необходимо дополнить Ваш файл стилей, используемый на сайте (стандартный стиль включает это по умолчанию):

.lastnewsblock { display: block; clear: both; padding: 5px 0; }
.lastnewsblock ul { padding: 0; margin: 0; list-style: none; }
.lastnewsblock ul li { display: block; padding: 0 0 10px 20px; margin: 0; list-style: none; background: transparent url('blog.png') top left no-repeat; }
.lastnewsblock .date { font-size: 10px; color: #777; }
.lastnewsblock h4 { padding: 0; margin: 2px 0; font: normal 14px Verdana, Tahoma, sans-serif; }
.lastnewsblock .text, .lastnewsblock .text p { text-align: justify; font-size: 10px; padding: 0; margin: 0 0 3px 0; }

Вы можете легко изменить этот стиль под Ваши нужды.

Выборка любых элементов - новости, статьи, книги

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

Параметр По умолчанию Действие
page не задан

Указывает, из какой страницы требуется отбирать записи. Может быть опущен, содержать номер страницы или параметр this.

  • Параметр не указан - элементы отбираются со всех страниц сайта (не рекомендуется).
  • Указан номер страницы - выборка новостей идёт из указанной по номеру страницы. Номер страницы Вы можете увидеть в системе администрирования, раздел "Контент", колонка "#". Может быть указан только один номер страницы.
  • this - используется номер текущей страницы, в текст которой вставлен блок [items]
div не задан Указывает, из какого раздела выбранной страницы ведётся отбор элементов. Может быть опущен, содержать номер раздела или параметр this, аналогично параметра page.
count 5 Количество выводимых заголовков - целое положительное число от 1 до 20.
sort time

Определяет, сортировку элементов. Возможны следующие варианты:

  • time - сортировка выполняется по времени добавления элемента в систему (по умолчанию).
  • title - сортировка по названиям элементов (заголовки новостей и статей, названия книг).
  • order - сортировка по полю "Порядок" каждого элемента, задаётся вручную.
dir desc Направление сортировки, может быть asc (по возрастанию) и desc (по убыванию).
dates no Может быть указан как yes, чтобы показать даты публикации записей.

Шоткод может быть использован также на главной странице сайта и в блоках контента над и под основным содержимым сайта.

Для работы этого шоткода, необходимо дополнить Ваш файл стилей, используемый на сайте (стандартный стиль включает это по умолчанию):

.itemsblock { display: block; clear: both; padding: 5px 0 0 0; }
.itemsblock ul { padding: 0; margin: 0; list-style: none; }
.itemsblock ul li { display: block; padding: 0 0 7px 20px; margin: 0; list-style: none; background: transparent url('arts.png') top left no-repeat; }
.itemsblock .date { font-size: 10px; color: #777; }

Вы можете легко изменить этот стиль под Ваши нужды.

Пара слов просто так: Валь Гардена италия аренда шале и апартаментов в Валь Гарден. . http://www.rbc.ru/ газета шабалов иван павлович.