Описание iblock.vote
Компонент реализует возможность голосования для пользователей. Компонент стандартный и входит в дистрибутив модуля.
В визуальном редакторе компонент расположен по пути Контент > Инфоблоки > Голосование.
Параметры
| Поле |
Параметр |
Описание |
| Основные параметры |
|---|
| Тип инфоблока |
IBLOCK_TYPE |
Указывается один из созданных в системе типов информационных блоков. |
| Инфоблок |
IBLOCK_ID |
Для выбранного типа инфоблоков указывается идентификатор необходимого информационного блока. |
| ID элемента |
ELEMENT_ID |
Указывается числовой код, в котором передается идентификатор элемента. Поле может быть оставлено пустым, если указан Код элемента. |
| Код элемента |
ELEMENT_CODE |
Указывается символьный код элемента. Поле может быть оставлено пустым, если указан ID элемента. |
| Настройки кеширования |
|---|
| Тип кеширования |
CACHE_TYPE |
Тип кеширования:
- A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
- Y - Кешировать: для кеширования необходимо определить время кеширования;
- N - Не кешировать: кеширования нет в любом случае.
|
| Время кеширования (сек.) |
CACHE_TIME |
Время кеширования, указанное в секундах. |
| Дополнительные настройки |
|---|
| Максимальный балл |
MAX_VOTE |
Указывается максимально возможный балл, т.е. число возможных оценок. |
| Подписи к баллам |
VOTE_NAMES |
Указываются подписи к каждому баллу. В коде вводится массив, в котором задаются подписи к баллам в таком виде:
"VOTE_NAMES" => Array("0","1","2","3","4","5"),
Если подписи заданы, то они будут выведены вместо оценок-цифр. Если массив не задан, то будут использованы значения по умолчанию. |
В качестве рейтинга показывать
(кроме шаблонов default, ajax_photo) |
DISPLAY_AS_RATING |
Выбирается что отображать в качестве рейтинга: сам рейтинг, либо среднее значение (сумма голосов поделённая на количество). |
| Настройки 404 ошибки |
|---|
| Устанавливать статус 404, если не найдены элемент или раздел |
SET_STATUS_404 |
[Y|N] Если система не находит в каталоге элемент или раздел, то при отмеченной опции вместо HTTP статуса 200 будет сообщаться HTTP статус 404. |
| Сообщение для показа (по умолчанию из компонента) | MESSAGE_404 | Задается сообщение, которое будет показано в случае возникновения ошибки 404. Если ничего не указывать, то будет использоваться стандартное сообщение из компонента. |
Пример вызова
<?$APPLICATION->IncludeComponent("bitrix:iblock.vote","",Array(
"IBLOCK_TYPE" => "photos",
"IBLOCK_ID" => "22",
"ELEMENT_ID" => $_REQUEST["ELEMENT_ID"],
"ELEMENT_CODE" => $_REQUEST["code"],
"MAX_VOTE" => "5",
"VOTE_NAMES" => array("0","1","2","3","4"),
"SET_STATUS_404" => "N",
"MESSAGE_404" => "",
"CACHE_TYPE" => "A",
"CACHE_TIME" => "3600"
)
);?>