Частые вопросы

Где настройки самого плагина?

Отдельной формы нет. В MCP настраиваются доступ к инструментам и права, а настройки выбранной темы агент получает через themes_get_settings. См. «Доступ и права».

Почему агент видит тему, но не может её изменить?

Чтение и запись имеют отдельные права. Запись также требует права пользователя на дизайн, доступа ко всем затрагиваемым доменам и отсутствия режима песочницы. Токен с ограничением по витринам менять темы не может. Даже предпросмотр записи проверяет область действия токена.

Почему при изменении одной темы затрагивается несколько сайтов?

Тема общая для всех её поселений. Унаследованный файл может принадлежать родителю, который используется и в других приложениях. В предпросмотре проверьте written_to и settlements, включая дочерние темы, блоковые страницы и зеркала.

Почему некоторые настройки доступны только для чтения?

Плагин не записывает поля загрузки файлов, многоязычные значения, поля с кодом и неподдерживаемые типы. Некорректное или несовместимое текущее значение также блокирует запись. Причина возвращается в read_only_reason; защищённые ключи скрываются. Правила приведены в статье о настройках тем.

Можно ли менять меню и блоки главной, сохранённые в JSON?

Да, если значение соответствует правилам плагина. Объекты объединяются по полям, массивы с идентификаторами — по записям, прочие массивы заменяются целиком. В массив нужно включить все сохраняемые записи: пропущенные удаляются. Записи с HTML или кодом изменять нельзя.

Предпросмотр прошёл. Почему шаблон не сохранился?

Предпросмотр не компилирует Smarty. При подтверждённой записи шаблон пробно компилируется; ошибка даёт smarty_compile_failed, запись не выполняется. Для записи также нужны права сервера на файлы и доступное хранилище резервных копий.

Что делать с content_conflict, revision_conflict или operation_busy?

content_conflict означает изменение файла после чтения, revision_conflict — изменение ревизии темы. Перечитайте данные, заново подготовьте правку и покажите предпросмотр. operation_busy означает другую выполняющуюся операцию плагина: дождитесь её завершения и получите актуальные данные перед повтором.

Почему подтверждение не принимается?

confirm_required требует подтверждённого вызова, consent_required — одноразового подтверждения MCP. consent_invalid означает, что оно просрочено, использовано или связано с другими аргументами. Во внешнем клиенте получают новое подтверждение через mcp_issue_confirm после согласования окончательного запроса. В бэкенде используется карточка «Агента для MCP».

Как вернуть файл к поставке и как отменить правку агента?

Для поставки используется themes_revert_file, для отмены операции — themes_restore с её backup_id. Если после операции тот же файл или ключ настройки меняли, отмена остановится с restore_conflict. У нового файла нет оригинала: отменяйте его добавление. См. «Отмена изменений».

Почему нет ссылки предпросмотра неактивной темы?

Она доступна только администратору всей установки без ограничений токена по доменам и витринам и при наличии подходящего поселения приложения. Иначе откройте предпросмотр в редакторе дизайна. Полученные ссылки с ключом предпросмотра не публикуйте.

Нужно ли сбрасывать кеш после каждой правки?

Встроенная инструкция рекомендует themes_flush_cache лишь при необходимости: ядро само перекомпилирует изменённые шаблоны. Сброс удаляет скомпилированные шаблоны всех тем приложения и приложений с дочерними темами, а не одной выбранной темы. Он не очищает кеш браузера.

Что произойдёт при обновлении темы из маркета?

Изменённый файл имеет штатную пометку «изменён», и обновление темы его не перезапишет. Проверяйте совместимость собственных доработок с новой поставкой. Возврат к поставке снимает пометку; отмена отдельной операции восстанавливает прежнее содержимое и, когда это возможно по состоянию поставки, прежнюю пометку.