WebPart на страницах
WebPart (вебчасть) — интерактивный блок на странице: таблица списка, лента документов, баннер, навигация по подразделам и другое. Настраивается через панель свойств и в режиме просмотра выглядит как часть страницы.
Эта инструкция для редактора контента. Сборка собственных WebPart — в разделе WebParts для разработчиков.
1. Какие WebPart есть «из коробки»
Заголовок раздела «1. Какие WebPart есть «из коробки»»| Название | Категория | Зачем |
|---|---|---|
| Список | Списки | Таблица элементов выбранного списка |
| Документы | Документы | Файлы из библиотеки документов |
| Баннер | Базовые | Крупный блок: заголовок, подзаголовок, кнопка, фон |
| Информационный блок | Базовые | Цветной callout (инфо / успех / предупреждение / важно). Не путать с лентой «Объявления» из модулей |
| Быстрые ссылки | Навигация | Набор ссылок с иконками |
| Дочерние узлы | Навигация | Ссылки на подразделы узла |
Дополнительные виджеты организация ставит пакетами .portalpart (Админка → WebPart). В каталоге при добавлении на страницу видны только включённые определения.
2. Добавить WebPart на страницу — по шагам
Заголовок раздела «2. Добавить WebPart на страницу — по шагам»- Откройте страницу и нажмите Редактировать.
- В нужной колонке (секция Содержимое) нажмите + WebPart.
- В окне Добавить WebPart:
- при необходимости воспользуйтесь поиском по названию;
- выберите виджет в списке (группы: Списки, Документы, Базовые, Навигация и др.).
- Блок появится в колонке с предпросмотром.
- Нажмите Сохранить внизу страницы — изменения станут видны всем с правом просмотра.
3. Настроить WebPart — по шагам
Заголовок раздела «3. Настроить WebPart — по шагам»- В режиме редактирования на блоке нажмите Настроить (шестерёнка).
- Откроется окно Настройки: {название WebPart}.
- Заполните поля (см. таблицы ниже).
- Нажмите Применить — предпросмотр блока обновится.
- Не забудьте Сохранить страницу.
4. Управление блоками
Заголовок раздела «4. Управление блоками»На панели каждого WebPart:
| Действие | Результат |
|---|---|
| Дублировать | Вторая копия с теми же настройками |
| Настроить | Панель свойств |
| Вверх / Вниз | Порядок в колонке |
| Удалить | Убрать со страницы |
| Перетаскивание | Перенос между колонками (если колонок несколько) |
5. Настройки встроенных WebPart
Заголовок раздела «5. Настройки встроенных WebPart»Список (portal.list-view)
Заголовок раздела «Список (portal.list-view)»| Параметр | Описание |
|---|---|
| Список | Какой список узла показывать (обязательно) |
| Представление | Колонки и сортировка (после выбора списка) |
| Записей на странице | 1–100, по умолчанию 10 |
| Показывать заголовок | Заголовок списка над таблицей |
Документы (portal.document-list)
Заголовок раздела «Документы (portal.document-list)»| Параметр | Описание |
|---|---|
| Библиотека | Библиотека документов узла (обязательно) |
| Файлов на странице | 1–100, по умолчанию 20 |
| Показывать заголовок | Заголовок над списком файлов |
Баннер (portal.hero)
Заголовок раздела «Баннер (portal.hero)»| Параметр | Описание |
|---|---|
| Заголовок | Основной текст (обязательно) |
| Подзаголовок | Дополнительная строка |
| Текст кнопки | Подпись на кнопке |
| URL кнопки | Куда ведёт кнопка |
| URL фонового изображения | Картинка на фоне |
| Выравнивание | Слева / по центру / справа |
Информационный блок (portal.announcement)
Заголовок раздела «Информационный блок (portal.announcement)»Статичный callout. Для ленты объявлений из списка используйте пакетный WebPart Объявления (korport.base.announcements), если он установлен.
| Параметр | Описание |
|---|---|
| Текст | Содержимое (обязательно) |
| Стиль | Информация / Успех / Предупреждение / Важно |
| Иконка Font Awesome | Класс иконки (по умолчанию fa-circle-info) |
Быстрые ссылки (portal.quick-links)
Заголовок раздела «Быстрые ссылки (portal.quick-links)»| Параметр | Описание |
|---|---|
| Ссылки | Редактор списка: заголовок, URL, иконка для каждой ссылки |
Дочерние узлы (portal.child-nodes)
Заголовок раздела «Дочерние узлы (portal.child-nodes)»| Параметр | Описание |
|---|---|
| Узел | Корень дерева (пусто = текущий узел страницы) |
| Показывать заголовок | Заголовок над списком подразделов |
6. Типы полей в панели свойств
Заголовок раздела «6. Типы полей в панели свойств»В настройках (в том числе у пакетных WebPart) встречаются:
| Тип | Как выглядит |
|---|---|
| Текст | Однострочное поле |
| Многострочный текст | Текстовая область |
| Число | Числовое поле |
| Флажок | Да / нет |
| Выбор | Выпадающий список |
| Список | Выбор списка текущего узла |
| Библиотека | Выбор библиотеки документов |
| Узел | Выбор узла (иногда с путём «Родитель / Узел») |
| Представление | Представление выбранного списка |
| Редактор ссылок | Таблица: заголовок, URL, иконка |
| Цвет | Выбор цвета |
Некоторые поля зависят от других (например, «Представление» активно после выбора «Список»).
7. Текст и WebPart на одной странице
Заголовок раздела «7. Текст и WebPart на одной странице»Страница = колонки; в каждой колонке — цепочка блоков:
- Текст — статичный контент;
- WebPart — динамические данные.
Типичный порядок: баннер → вводный текст → таблица списка → пояснение текстом.
8. Права и WebPart
Заголовок раздела «8. Права и WebPart»WebPart показывает только данные, к которым у пользователя есть доступ. Если список закрыт — пустое состояние или подсказка. Настройка прав: Права доступа.
9. Установить новый WebPart (администратор)
Заголовок раздела «9. Установить новый WebPart (администратор)»- Админка → WebPart.
- Загрузите файл
.portalpart. - Убедитесь, что определение включено.
- Редакторы увидят виджет в окне Добавить WebPart.