Настройка модуля «3D Просмотр»

Модуль для загрузки и просмотра 3D-моделей в объявлениях. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

• Площадкам, которые развивают публичные страницы, профили, карточки или визуальные блоки без доработки кода.
• Владельцам, которым нужно быстро проверить новую функцию на тестовой странице или объявлении.
• Командам, которые хотят управлять контентом из панели ADWOS CMS и не ждать отдельного релиза.

Что изменится на сайте

• В ADWOS CMS появляется новый публичный или визуальный сценарий без правки кода.
• Администратор настраивает поведение модуля из панели управления.
• Результат можно проверить на тестовой странице, профиле, объявлении или блоке.
• Владелец сохраняет контроль над публикацией и отображением контента.

Что подготовить заранее

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

• Выберите тестовую страницу, профиль, объявление или публичный блок, где можно безопасно проверить результат.
• Проверьте права ролей, которые смогут создавать, редактировать или видеть новый контент.
• Если модуль влияет на публичную страницу, заранее учтите кеш и время обновления.
• Подготовьте текст, изображения или настройки, которые будут выглядеть нормально на desktop и mobile.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «3D Просмотр» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

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

• «Разрешённые форматы (через запятую)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: glb,gltf,usdz,obj,stl. Глобально допустимые расширения. Категории могут сужать этот список.
• «Макс. размер файла (МБ)». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 50. Лимит на один загружаемый 3D-файл (1–500).
• «Макс. моделей на объявление». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 3. Сколько 3D-моделей можно прикрепить к одному объявлению.

После сохранения обновите страницу панели управления и убедитесь, что модуль остался включенным. Если есть тестовый режим, сначала завершите проверку в нем, а уже потом переходите на боевые ключи.

Проверка перед запуском

• Создайте или откройте тестовую страницу, профиль, объявление или публичный блок.
• Проверьте, что настройки модуля применились после сохранения.
• Если страница кешируется, очистите кеш или дождитесь обновления TTL.
• Проверьте отображение на desktop и mobile.

Частые ошибки

• Настройки не применились. Сохраните модуль повторно и обновите страницу панели управления.
• Функция не видна пользователю. Проверьте роли, категорию и публичное включение модуля.
• Данные не обновляются. Проверьте кеш, фоновые задачи и журналы модуля.
• Нужно временно остановить сценарий. Отключите модуль в панели управления, не удаляя его настройки.

Когда тест проходит без ошибок, оставьте модуль включенным и зафиксируйте, какие данные использовались для проверки. Это поможет быстро восстановить настройку после обновления или смены ключей.