======  🐘 PHP API ======


=====  Работа с комментариями =====


==== Добавление комментария =====


<code php>
use Chililab\Comments\Comment;

$commentId = Comment::addComment(
    $name,        // Имя автора
    $text,        // Текст комментария
    $parentId,    // ID родительского комментария (0 - корневой)
    $moderated,   // Требуется ли модерация (bool)
    $active,      // Активен ли комментарий (bool)
    $url,         // URL страницы (false - текущая)
    $created,     // Дата создания (false - текущая)
    $siteId,      // ID сайта (false - текущий)
    $sendEvents,  // Отправка событий (bool)
    $iblockId,    // ID инфоблока (optional)
    $elementId    // ID элемента (optional)
);
</code>
=====  Удаление комментария =====


<code php>
// Удалить один комментарий
Comment::deleteComment($id, $withChildren = false);

// Удалить несколько комментариев
Comment::delete([$ids], $withChildren = false);
</code>

==== Активация/Деактивация ====

<code php>
Comment::activate([$ids]);
Comment::deactivate([$ids]);
</code>

==== Модерация ====

<code php>
Comment::setModerated([$ids]);
Comment::cancelModerated([$ids]);
</code>

==== Редактирование ====

<code php>
Comment::edit([
    $id1 => ['NAME' => 'Новое имя', 'TEXT' => 'Новый текст'],
    $id2 => ['TEXT' => 'Текст 2'],
]);
</code>

----

===== Работа с отзывами =====

==== Добавление отзыва ====

<code php>
use Chililab\Comments\Review;

$reviewId = Review::add(
    $name,        // Имя автора
    $text,        // Текст отзыва
    $rating,      // Оценка (1-5)
    $recommend,   // Рекомендует ли товар (bool)
    $moderated,   // Требуется ли модерация (bool)
    $active,      // Активен ли отзыв (bool)
    $url,         // URL страницы (false - текущая)
    $created,     // Дата создания (false - текущая)
    $likes,       // Количество лайков (0)
    $dislikes,    // Количество дизлайков (0)
    $answer,      // Ответ администратора (false)
    $siteId,      // ID сайта (false - текущий)
    $sendEvents,  // Отправка событий (bool)
    $iblockId,    // ID инфоблока (optional)
    $elementId    // ID элемента (optional)
);
</code>

==== Лайки и Дизлайки ====

<code php>
// Поставить лайк
Review::like($id);

// Отменить лайк
Review::likeCancel($id);

// Поставить дизлайк
Review::dislike($id);

// Отменить дизлайк
Review::dislikeCancel($id);
</code>

==== Удаление ====

<code php>
Review::deleteReview($id, $withChildren = false);
Review::delete([$ids]);
</code>

----

===== Работа с рейтингами =====

==== Добавление рейтинга ====

<code php>
use Chililab\Comments\Rating;

// Для авторизованного пользователя
Rating::addCurrentUserRating($rating);

// Для неавторизованного пользователя
Rating::addNotAutorazedRating(
    $url,       // URL страницы
    $rating,    // Оценка (1-5)
    $active,    // Активен ли рейтинг
    $siteId,    // ID сайта
    $iblockId,  // ID инфоблока (optional)
    $elementId  // ID элемента (optional)
);
</code>

==== Получение рейтинга страницы ====

<code php>
// Получить рейтинг по URL
$pageRating = Rating::getPageRating();

// Получить рейтинг по инфоблоку и элементу
$pageRating = Rating::getPageRating($iblockId, $elementId);

// Результат:
[
    'AVG' => 4.5,     // Средний рейтинг
    'COUNT' => 10     // Количество голосов
]
</code>

==== Текущий рейтинг пользователя ====

<code php>
$userRating = Rating::getCurrentUserRating();
// Результат: ['ID' => 123, 'RATING' => 4, ...]
</code>

==== Удаление ====

<code php>
Rating::delete([$ids]);
</code>