С помощью компонента QAInclude вы можете извлечь и отобразить содержимое из статей информатория. Выборка статей выполняется на основании значений параметров, указанных в описании компонента. В отличие от компонента QA этот компонент позволяет извлекать содержимое из заданных статей не целиком, а частично (по секциям).
Такой режим компоновки контента может быть полезен в тех случаях, когда из статей нужно извлекать только определенные, заранее обозначенные блоки текста (секции).
Начало секции в тексте статей обозначается следующим образом:
##[section:_имя секции_:start]##
Окончание секции обозначается:
##[section:_имя секции_:stop]##
Если в параметрах компонента указано значение Section, то при обработке статей, содержащих одну или несколько секций, результирующий текст будет сформирован только из содержимого секций, имеющих соответствующее имя секции.
Вывод в три колонки шести новых статей, опубликованных на сайте:
##QAInclude ( { "PageSize": 6, "Columns": 3, "Sort": "CreateDateDesc" } )##
Вывод трёх подстатей из раздела «components», упорядоченных по дате публикации статьи (новые в начале):
##QAInclude ( { "Parent": "components", "PageSize": 3, "Sort": "CreateDateDesc" } )##
Вывод всех статей и подстатей из раздела «realty», соответствющих атрибутивному значению «Город:Иркутск», с автоматической разбивкой записей списка по страницам и формированием навигационных элементов для постраничного перехода:
##QAInclude ( { "Parent": "realty", "ShowGrandChildren": true, "Keywords": "Город:Иркутск", "ShowPaging": true } )##
##QAInclude ({"Template": "QAInclude","Sort": "CreateDate","Keywords": "Город:Иркутск","PageSize": 3,"Parent": "123","IssueList": "123; 125; 118; 19","Section": "Характеристики"})##
Template – идентификатор визуального шаблона, используемого для построения компонента (по умолчанию QAInclude).
Sort – код поля сортировки (по умолчанию «InfoDate»):
- InfoSort – сортировка по коду сортировки статей;
- CreateDate – сортировка по дате создания статьи (новые в конце);
- CreateDateDesc – сортировка по дате создания статьи (новые в начале).
Keywords – ключевые слова для фильтрации статей в списке (используется для атрибутивного поиска в информатории).
PageSize – максимальное количество обрабатываемых статей.
Parent – идентификатор раздела, из которого выбираются статьи (по умолчанию код текущей статьи).
IssueList – список идентификаторов статей, из которых нужно извлечь контент (по умолчанию обрабатываются все статьи в заданном разделе).
Section – идентификатор секций, содержимое которых включается в результирующий текст (по умолчанию пусто и включается весь текст обрабатываемых статей).