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

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