Документация для разработчиков
Темная тема

Add

Описание и параметры

int
CRatings::Add(
	array fields,
);

Метод добавляет новый рейтинг. Нестатический метод.

Параметры метода

Параметр Описание
fields Массив значений параметров. В качестве ключей данного массива допустимо использовать:
  • NAME – название рейтинга
  • ACTIVE – активность рейтинга (Y|N)
  • ENTITY_ID – оцениваемый объект (например: USER, BLOG, и т.д.)
  • CALCULATION_METHOD – тип подсчета рейтинга (SUM -суммирование критериев, AVG – средние значение критериев)
  • CONFIGS – массив, описывающий критерии рейтингования.
Все поля являются обязательными.

Смотрите также

Примеры использования

<?
// создадим рейтинг с критериями рейтингования от модуля форум и блог
// учитывать будем только рейтинговые голосования, активность учитывать не будем
$arConfig = array();
$arConfig['FORUM'] = array(
	'VOTE' => array(
		'TOPIC' => array(
			'ACTIVE' => 'Y',
			'COEFFICIENT' => '1',
		),
		'POST' => array(
			'ACTIVE' => 'Y',
			'COEFFICIENT' => '1',
		),
	),
	'RATING' => array(
		'ACTIVITY' => array(
			'ACTIVE' => 'N',
			'TODAY_TOPIC_COEF' => '20',
			'WEEK_TOPIC_COEF' => '10',
			'MONTH_TOPIC_COEF' => '5',
			'TODAY_POST_COEF' => '0.4',
			'WEEK_POST_COEF' => '0.2',
			'MONTH_POST_COEF' => '0.1',
		),
	),
);
$arConfig['BLOG'] = array(
'VOTE' => array(
		'POST' => array(
			'ACTIVE' => 'Y',
			'COEFFICIENT' => '1',
		),
		'COMMENT' => array(
			'ACTIVE' => 'Y',
			'COEFFICIENT' => '1',
		),
	),
	'RATING' => array(
		'ACTIVITY' => array(
			'ACTIVE' => 'N',
			'TODAY_POST_COEF' => '20',
			'WEEK_POST_COEF' => '10',
			'MONTH_POST_COEF' => '5',
			'TODAY_COMMENT_COEF' => '0.4',
			'WEEK_COMMENT_COEF' => '0.2',
			'MONTH_COMMENT_COEF' => '0.1',
		),
	),
);

$arAddRating = array(
	'ACTIVE' => 'Y',
	'NAME' => 'Рейтинг созданный через API',
	'ENTITY_ID' => 'USER',
	'CALCULATION_METHOD' => 'SUM',
	'CONFIGS' => $arConfig
);
$ratingId = CRatings::Add($arAddRating);
if (intval($ratingId) > 0)
	echo "Рейтинг успешно добавлен.";
?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх