Плагин Oneline Info

Плагин Oneline был написан для вывода в любой локации сайта систематизированной информации – своего рода мини-страниц, которые по умолчанию имеют следующие стандартные поля:

• ID записи
• дата
• текст
• код виртуального раздела

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

Для чего можно использовать плагин Oneline

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

• вопрос-ответ (FAQ);
• небольшие прайсы;
• цитаты;
• интересные факты;
• имитация фида соцсети.

При использовании плагина можно манипулировать уникальными номерами (ID) записей, поэтому к ним можно прикреплять изображения с помощью плагина Attach или аналогичного.

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

1. В настройках плагина указать кастомный код для настроек, например, sedby
2. В папке inc создать файл настроек, в нашем примере oneline.settings.sedby.php
3. Заполнить разделы как указано в дефолтном файле с примером oneline.settings.default.php
4. Добавить необходимые экстраполя через админку

Файл настроек содержит два массива, один из которых состоит из кодов виртуальных разделов, второй – из заголовков для них. Убедитесь, что они заполнены в правильном порядке:

$oneline_cats = array('sample_section_1', 'sample_section_2');
$oneline_cats_titles = array('Sample Section Title 1', 'Sample Section Title 2');

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

Для формирования виджетов используется функция sedby_oneline() со следующими аргументами:

sedby_oneline(
   $tpl = 'oneline.list', // Имя шаблона
   $items = 0,            // Количество элементов
   $order = '',           // Порядок сортировки в формате MySQL
   $extra = '',           // Дополнительный MySQL-запрос
   $section = '',         // Код раздела из файла настроек
   $offset = 0,           // Сдвиг с начала
   $pagination = '',      // Код паджинации
   $ajax_block = '',      // ID ajax-блока 
   $cache_name = '',      // Имя кэш-записи
   $cache_ttl = ''        // Срок действия кэша в секундах
);

Образец шаблона можно найти в папке tpl плагина:

<!-- BEGIN: MAIN -->
<ul class="list-unstyled">
<!-- BEGIN: PAGE_ROW -->
	<li>
		{PAGE_ROW_TEXT}
	</li>
<!-- END: PAGE_ROW -->
</ul>

<!-- IF {PAGE_TOP_PAGINATION} -->
<nav aria-label="Oneline Pagination">
	<ul class="pagination justify-content-center mb-0">
		{PAGE_TOP_PAGEPREV}{PAGE_TOP_PAGINATION}{PAGE_TOP_PAGENEXT}
	</ul>
</nav>
<!-- ENDIF -->
<!-- END: MAIN -->

Примеры использования в шаблоне:

{PHP|sedby_oneline('oneline.quotes.tpl', 5, 'oneline_id DESC', '', 'quotes')}

Эта конструкция выведет 5 последних записей (цитат) из виртуального раздела quotes.

Основные настройки аналогичны другим плагинам, формирующим виджеты (Pagelist, Comlist и др.) и не вызовут особых затруднений.

Приятного использования. Свои отзывы, пожелания и багрепорты отставляйте в комментариях на нашем сайте (не требуют регистрации) или в Issues на Github.