Плагин Oneline Info
- 341 просмотр
- 12 ноября, 2023
- Обновлено: 13 ноября, 2023
- admin
- Время чтения: 3 минуты
- 1 (Подробно)
![Плагин Oneline Info для Cotoni Siena](pics/thumbs/99/img-99-966x644-crop.jpg)
Плагин Oneline был написан для вывода в любой локации сайта систематизированной информации – своего рода мини-страниц, которые по умолчанию имеют следующие стандартные поля:
- ID записи
- дата
- текст
- код виртуального раздела
Как и для обычных страниц модуля Page, записи плагина Oneline могут быть расширены за счет поддерживаемых им в полном объеме экстраполей Cotonti.
Для чего можно использовать плагин Oneline
В первую очередь, это блоки информации, которые необходимо формировать из данных, слишком компактных для модуля Page или другого полноценного расширения, использующего структуру. Плагин Oneline отлично подходит для реализации следующего функционала::
- вопрос-ответ (FAQ);
- небольшие прайсы;
- цитаты;
- интересные факты;
- имитация фида соцсети.
При использовании плагина можно манипулировать уникальными номерами (ID) записей, поэтому к ним можно прикреплять изображения с помощью плагина Attach или аналогичного.
Перед использованием плагина Oneline необходимо выполнить следующие действия:
- В настройках плагина указать кастомный код для настроек, например, sedby
- В папке inc создать файл настроек, в нашем примере oneline.settings.sedby.php
- Заполнить разделы как указано в дефолтном файле с примером oneline.settings.default.php
- Добавить необходимые экстраполя через админку
Файл настроек содержит два массива, один из которых состоит из кодов виртуальных разделов, второй – из заголовков для них. Убедитесь, что они заполнены в правильном порядке:
$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.
Новый комментарий