С помощью компонента 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 – идентификатор секций, содержимое которых включается в результирующий текст (по умолчанию пусто и включается весь текст обрабатываемых статей).
