Skip to content
  1. Компоненты
  2. msReviews
  3. Для разработчика

AJAX API (connector)

Базовый URL:

fenom
{$_modx->getOption('assets_url')}components/msreviews/connector.php
modx
[[++assets_url]]components/msreviews/connector.php

На витрине обычно хватает сниппетов. Коннектор нужен для кастомного JS, cron и интеграций с CMP.

Запрос: POST с полем action. Ответ JSON: success, message, data, errors.

Публичные действия

actionНазначениеОсновные параметры
review/createСоздание отзываdata[...]
review/listСписок + summaryproduct_id, offset, limit, фильтры
review/vote«Полезно»review_id или id
review/update_ownПравка своегоid, edit_token, data
review/delete_ownУдаление своегоid, edit_token
rating/getАгрегат по товаруproduct_id
question/createВопросdata[...]
qna/listСписок Q&Aproduct_id, offset, limit, faq_only
media/uploadЗагрузка фотоfile, review_id, edit_token
request/processCron очереди писемkey или k = msreviews_cron_key

request/process

  • Ключ в настройках пустой403, forbidden.
  • Успех: data.sent — число отправленных писем (батч до 20).

Пример cron:

text
POST assets/components/msreviews/connector.php
action=request/process&key=ВАШ_КЛЮЧ

Действия менеджера (mgr)

Требуются сессия менеджера и права компонента. Mutating mgr/*только POST (иначе 405).

actionНазначениеПраво
mgr/review/listСписок для модерацииreview_view
mgr/review/getПревью одного отзываreview_view
mgr/review/update-statusСтатусreview_moderate
mgr/review/set-replyОтвет магазинаreview_reply
mgr/review/set-pinnedЗакрепreview_moderate
mgr/review/bulkМассовая сменаreview_moderate
mgr/review/moderation-logЖурналreview_view
mgr/question/listСписок вопросовquestion_moderate
mgr/question/update-statusСтатус вопросаquestion_moderate
mgr/answer/createОтвет на вопросquestion_moderate
mgr/dashboard/summaryСводка дашбордаreview_analytics
mgr/analytics/summaryРасширенная аналитикаreview_analytics
mgr/export/reviewsCSV отзывовreview_export
mgr/export/questionsCSV вопросовreview_export
mgr/import/reviewsИмпорт CSVreview_import
mgr/media/listСписок медиаreview_view
mgr/media/deleteУдалить медиаreview_moderate
mgr/queue/processОчередь из mgrqueue_process
mgr/catalog/searchПоиск товаров/папокreview_analytics
mgr/catalog/resolveПодписи по IDreview_analytics

Полные параметры — в исходниках ConnectorRegistryFactory и Права доступа.

Формат ответа

json
{
  "success": true,
  "message": "...",
  "data": {},
  "errors": []
}

HTTP-коды

HTTPКлюч messageСитуация
401msr_err_unauthorizedmgr/* без входа
403msr_err_forbiddenНет прав
403forbiddenНеверный cron key
405msr_err_method_not_allowedMutating не через POST
400msr_err_*Невалидные параметры

Коды сообщений: События MODX.

См. также