Перейти к основному содержимому

FAQ и устранение неполадок

Быстрые ответы на вопросы, которые задают чаще всего.


Установка и настройка

Требует ли Vertex план Shopify Plus или Advanced?

Нет. Vertex устанавливается на любом плане Shopify. Однако нативные функции B2B (компании, каталоги B2B, NET-условия, освобождение от налога, мультилокация) требуют Shopify Plus или Advanced с дополнением B2B. Без них Vertex по-прежнему работает как отполированная B2C-тема для промышленных товаров — каждая B2B-функция изящно скрывается.

Нужны ли мне сторонние приложения?

Нет. Vertex использует нативные функции B2B Shopify сквозного действия. Никаких приложений управления котировками, оптовых цен, мульти-валюты или сравнения.

Сколько времени занимает полная установка?

  • Базовая установка (только тема): 5 минут
  • Полная установка B2B (тема + нативный B2B + компании + каталоги + метаполя): 45–60 минут в первый раз. Последующие компании занимают 5 минут каждая.

Могу ли я сначала использовать Vertex на тестовом магазине?

Да. Установите Vertex на любой тестовый магазин и настройте, не затрагивая ваш живой магазин. Публикуйте только когда будете готовы.


Видимость B2B-элементов

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

В порядке вероятности:

  1. Вы не авторизованы как B2B-покупатель. Полоса отображается только когда customer.b2b? равно true И установлен customer.current_company.
  2. Режим витрины установлен на «Только B2C». Откройте Theme settings ▸ B2B ▸ Storefront mode и измените на Hybrid (auto) или B2B-only.
  3. Нативный B2B не включён в админке Shopify. Перейдите в Settings ▸ Customer accounts ▸ B2B ▸ Manage ▸ Enable B2B.
  4. Компания покупателя удалена или отозвана. Vertex защитно пропускает полосу, когда customer.current_company становится nil посреди сессии.

Почему не появляется пилюля торгового представителя в шапке?

Пилюля представителя отображается только когда все три условия истинны:

  1. Покупатель авторизован как B2B (customer.b2b? == true)
  2. У компании покупателя установлено метаполе vertex.rep_name
  3. Режим витрины не Только B2C

Проверьте в Customers ▸ Companies ▸ [Company name] ▸ Metafields, что vertex.rep_name заполнено.

Почему уровни объёмных цен не отображаются на странице товара?

Vertex читает уровни объёмов из нативного quantity_price_breaks Shopify. Таблица объёмов на странице товара отображается только когда:

  1. Покупатель авторизован в компании
  2. Компания назначена каталогу B2B
  3. Прайс-лист каталога включает товар с уровнями цен на основе количества

Если таблица пустая, перепроверьте прайс-лист в B2B ▸ Catalogs ▸ [Catalog name] ▸ Price list.

Почему мой B2B-покупатель видит «Войдите, чтобы увидеть цены», хотя авторизован?

Включён переключатель Theme settings ▸ B2B ▸ Hide prices until customer logs in. Эта функция скрывает цены только для гостей. Авторизованные покупатели (B2C ИЛИ B2B) всегда должны видеть цены. Если они их не видят, отключите настройку и сохраните.

Почему витрина ощущается «как B2C», хотя я авторизован как B2B?

Либо:

  1. Режим витрины установлен на «Только B2C». Измените на Hybrid или B2B-only.
  2. Запись покупателя не связана с компанией. Откройте Customers ▸ [Customer name] и подтвердите, что он привязан к компании во вкладке Companies.

Настройка

Как изменить цвет бренда?

  1. Откройте Theme settings ▸ Colors
  2. Выберите Starter color palette для перекраски в один клик ИЛИ выберите Custom и переопределите каждый цвет индивидуально

Как добавить кастомный шрифт?

Выборщики шрифтов в Theme settings ▸ Typography используют библиотеку шрифтов Shopify. Чтобы использовать шрифт вне неё, добавьте <link> в theme.liquid и обновите CSS-свойства --font-body / --font-heading.

Как добавить мой логотип?

  1. Откройте редактор темы и нажмите Header в панели секций
  2. Нажмите Logo image и загрузите ваш файл
  3. Рекомендуемая высота: ~40 px; предпочтителен SVG

Как настроить текст полосы объявлений?

  1. Откройте Header group ▸ Announcement bar в редакторе темы
  2. Отредактируйте поле Text
  3. У полосы есть встроенный закрывающий ×, который учитывает localStorage

Как добавить/отредактировать вспомогательную навигацию (Спецпредложения / Гайды / Услуги / FAQ)?

  1. Перейдите в Online Store ▸ Navigation
  2. Создайте новое меню с обработчиком secondary-menu (автоматически определяется Vertex)
  3. Добавьте ссылки — они отображаются справа в десктопной шапке

Как переключаться между 4 демо-витринами (Vertex / Throttle / OfficeIT / Inkline)?

Два способа:

  1. Постоянная перекраскаTheme settings ▸ Colors ▸ Starter color palette — выберите один из 4 пресетов
  2. Временный предпросмотр — добавьте ?view=throttle (или officeit / printsupply) к любому URL вашей витрины

→ См. Руководство по демо-пресетам для подробностей.


Производительность

Какой балл Lighthouse у витрины Vertex?

Зафиксировано на демо-витрине:

  • Mobile Performance: 65–100 (в зависимости от типа страницы)
  • Desktop Performance: 90+ на каждой странице
  • Accessibility: 92–95
  • Best Practices: 95+
  • SEO: 100

Как улучшить Lighthouse Performance дальше?

  1. Оптимизируйте hero-изображения. Используйте WebP в нескольких ширинах; стремитесь к менее чем 300 КБ на слайд.
  2. Ограничьте hero одним слайдом. Многослайдовые hero-ротаторы стоят LCP. По умолчанию поставляется с 1 слайдом.
  3. Ограничьте встраиваемые приложения Shopify. Каждое стороннее приложение внедряет JS — каждое добавляет к TBT.

Почему моя Mobile Performance ниже моей Desktop Performance?

Стандартно для тем Shopify — мобильная троттлится в Lighthouse (более медленный CPU + более медленная сеть). Реальные пользователи iPhone 14 / Galaxy S22 получают намного лучшие баллы, чем число Lighthouse.


Доступность и интернационализация

Соответствует ли Vertex WCAG 2.1 AA?

Да. Навигация с клавиатуры, видимый фокус, минимальный контраст 4.5:1, сенсорные цели 24 px на мобильных, правильные ARIA-роли, ссылка «Перейти к содержимому», подписанные поля форм.

С какими языками поставляется Vertex?

5: английский (по умолчанию), французский, итальянский, немецкий, испанский. Переведены как строки UI, так и метки схемы.

Поддерживает ли Vertex языки RTL?

Да — полностью. <html dir> автоматически переключается для арабского, иврита, фарси, урду, идиш, курдского, дхивехи и пушту. CSS использует логические свойства, поэтому макет зеркалится чисто.

Могу ли я добавить другой язык?

Да. Переведите locales/en.default.json на ваш целевой язык, сохраните как locales/{code}.json. Метки схемы находятся в locales/en.default.schema.json — переведите в locales/{code}.schema.json, чтобы локализовать также UI редактора.


Метаполя и данные товара

Какие метаполя использует Vertex?

В пространстве имён vertex:

  • vertex.mpn (product) — артикул производителя, индексируется в предиктивном поиске
  • vertex.ships_from (product) — город отправки для каждого товара
  • vertex.price_history (product) — JSON-список записей {date, price}
  • vertex.datasheet, vertex.msds, vertex.brochure, vertex.tech_sheet, vertex.install_guide, vertex.warranty (product) — выборщики файлов для PDF
  • vertex.rep_name, vertex.rep_email, vertex.rep_phone (company) — торговый представитель для каждой компании
  • vertex.payment_terms (company) — переопределение метки значка NET-условий

Плюс vertex.tech_specs (product) — список записей «spec» (у каждой label, value и опциональная unit) для таблицы технических характеристик. Метаобъект не требуется.

→ Полный справочник: Руководство по настройке метаполей.

Что происходит, если метаполе отсутствует?

Соответствующий блок страницы товара автоматически скрывается. Vertex защищён от отсутствующих метаполей — пустые значения никогда не отображают сломанный UI.


Цены и лицензирование

Сколько стоит Vertex?

399 USD лицензия на один магазин. Включает бесплатные обновления для всех релизов v1.x.

Могу ли я использовать одну лицензию Vertex на нескольких магазинах?

Нет — стандартная лицензия Theme Store предназначена для одного магазина. Для лицензирования нескольких магазинов поднимите тикет через портал поддержки Theme Store.

Будет ли Vertex получать обновления?

Да. Релизы v1.x включают исправления ошибок, улучшения производительности и новые секции. См. Список изменений.


Типичные ошибки и исправления

«Theme Check показывает 18 предупреждений в моей кастомизированной версии»

Вы, вероятно, отредактировали шаблоны Liquid и ввели неиспользуемые переменные или жёстко прописанные маршруты. Запустите shopify theme check локально, чтобы увидеть подробности. Сам Vertex поставляется с 0 нарушениями Theme Check.

«Мой кастомный CSS перебивается»

Файлы CSS Vertex по секциям имеют более высокую специфичность, чем общий стайл. Добавляйте переопределения через:

  1. Theme settings ▸ Colors ▸ Custom (предпочтительно — большинство вещей управляется CSS-переменными)
  2. Кастомный CSS в assets/vertex.css после существующих правил
  3. Новый assets/custom-overrides.css с !important (крайнее средство)

Всё ещё застряли?