Viewer — оформлення (параметри URL)

Оформлення параметрами URL

Параметри URL дають змогу змінювати вигляд і поведінку Viewer без редагування коду. Параметри можна налаштувати безпосередньо в застосунку (наприклад, на вкладці «Поділитися» або у Viewer). Вони керують режимом фону, ефектами фонового зображення, освітленням 3D-оточення, видимістю інтерфейсу та кнопки «До кошика». Попередній вибір варіанта (атрибути WooCommerce): Ви також можете попередньо вибрати варіант товару через параметри запиту, наприклад attribute_pa_color, pa_size або size. Ці параметри визначаються за зіставленням атрибутів і значень вашого магазину та дозволяють відкривати Viewer з уже вибраним кольором, розміром, матеріалом, способом друку або власним кольором.

Список доступних параметрів URL

ПараметрТипОписТипове значення
nav0 / 1Приховує (0) або показує (1) навігацію. Доступно лише в тарифі Business.1
add_to_cart0 / 1Приховує (0) або показує (1) кнопку «До кошика».0
bcgstringРежим фону сцени: grad_f6f7fb_e8fff6, app_img_123, uploaded, theme або env.Магазин / типове
envintID оточення HDRI для освітлення сцени. За bcg=env оточення також використовується як видимий фон сцени.1
light_intensity0 - 2Інтенсивність освітлення 3D-сцени.0.6
bcg_blur0 - 100Розмиття фонового зображення, вибраного через bcg=app_img_*, bcg=uploaded або bcg=theme.0
bcg_brightness0 - 3Рівень яскравості / самосвітіння фонових зображень.1
bcg_underlaystringПідкладка під фоновими зображеннями. Використовуйте grad_ffffff_f5f7fb для градієнта або none, щоб прибрати її.Типовий фон
attribute_pa_*stringПопередній вибір значення атрибута товару WooCommerce. Підтримувані форми ключа: attribute_pa_color, pa_color і color; псевдоніми охоплюють розмір, колір, матеріал, тип друку та візерунок.
custom_color0 / 1 / trueЗапитує варіант із власним кольором, якщо товар його підтримує. Те саме можна зробити через color=custom.0
picked_colorsstringПеревизначення власних кольорів, розділені комами, у форматі detailKey:%23hex, наприклад front:%23ff6b6b,back:%2300ff88. Символ # потрібно закодувати в URL як %23.

Приклад

URL: https://alterproduct.com/app/viewer/1?bcg=grad_f6f7fb_e8fff6&env=8&light_intensity=1.2&bcg_underlay=none&add_to_cart=1&nav=0&attribute_pa_color=white&attribute_pa_size=m

<iframe
  loading="lazy"
  title="Product Viewer"
  src="https://alterproduct.com/app/viewer/1?bcg=grad_f6f7fb_e8fff6&env=8&light_intensity=1.2&bcg_underlay=none&add_to_cart=1&nav=0&attribute_pa_color=white&attribute_pa_size=m"
  width="100%"
  height="100%"
  frameBorder="0"
  allowFullScreen
></iframe>