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	Список + summary	product_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&A	product_id, offset, limit, faq_only
media/upload	Загрузка фото	file, review_id, edit_token
request/process	Cron очереди писем	key или k = msreviews_cron_key

request/process

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

Пример cron:

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

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

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

action	Назначение	Право
mgr/review/list	Список для модерации	review_view
mgr/review/create	Ручное создание отзыва	review_moderate
mgr/review/update	Ручное редактирование (можно сменить product_id)	review_moderate
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/create	Ручное создание вопроса в CMP	question_moderate
mgr/question/update	Редактирование вопроса в CMP	question_moderate
mgr/question/get	Один вопрос для формы CMP (с answer_text)	question_moderate
mgr/question/update-status	Статус вопроса	question_moderate
mgr/question/set-pinned	Закреп вопроса	question_moderate
mgr/answer/create	Ответ на вопрос	question_moderate
mgr/dashboard/summary	Сводка дашборда	review_analytics
mgr/analytics/summary	Расширенная аналитика	review_analytics
mgr/export/reviews	CSV отзывов	review_export
mgr/export/questions	CSV вопросов	review_export
mgr/export/request_queue	CSV очереди писем	review_export
mgr/import/reviews	Импорт отзывов CSV	review_import
mgr/import/questions	Импорт вопросов CSV (с 1.2.4)	review_import
mgr/media/list	Список медиа	review_view
mgr/media/upload	Загрузка медиа в CMP	review_moderate
mgr/media/delete	Удалить медиа	review_moderate
mgr/review/product-summary	Сводка для вкладки «Отзывы» на ресурсе	review_view
mgr/request_queue/list	Список очереди писем	review_export
mgr/queue/process	Очередь из mgr	queue_process
mgr/catalog/search	Поиск папок, товаров или ресурсов	review_analytics или question_moderate
mgr/catalog/resolve	Подписи по ID	review_analytics или question_moderate

Полные параметры mgr/review/create и mgr/review/update: product_id, rating (1–5), title, text, author_name, author_email, status, is_verified (0/1). product_id принимает любой неудалённый site_content, не только msProduct. У update обязателен id. Опционально shop_reply при праве review_reply. Смена product_id пересчитывает агрегаты старого и нового ресурса.

mgr/question/create / update (только POST): product_id (любой неудалённый site_content), text, author_name, author_email, status, notify (0/1), опционально answer_text. У update обязателен id. Ответ пишет AnswerService (уведомление автора). Статус из поля формы перезаписывает автопубликацию ответа. mgr/answer/create остаётся в API и публикует вопрос. Из списка вопросов CMP его не вызывают с 1.2.4. mgr/question/get: id.

mgr/import/questions (только POST, с 1.2.4): CSV-файл с колонками product_id, text, status и author_email или author_name. Опционально answer_text, notify, pinned.

mgr/catalog/search: type равен parent, product или resource. q до 80 символов. limit от 1 до 100, по умолчанию 50. product ищет только msreviews_product_class_key. resource ищет любой неудалённый site_content (форма и фильтр отзывов и вопросов в CMP). Ответ data.items: { id, label }[]. mgr/catalog/resolve принимает те же type и список ids. Право: review_analytics или question_moderate.

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

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

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

HTTP-коды

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

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

См. также

• События MODX
• Интеграция