Логотип Tagix
Изображение Изображение

← Назад

tgx:domain-add#

Добавляет/обновляет домен в каталог (и при необходимости связывает с проектом).

Синтаксис#

<tgx tgx:domain-add="domain=example.com"></tgx>

Пример 1: минимум (копипаст для старта)#

<tgx tgx:domain-add="domain=example.com"></tgx>

Пример 2: реальный сценарий#

<tgx tgx:domain-add="domain=example.com&add=local.domain_add"></tgx>

Пример 3: комбинированный сценарий#

<tgx tgx:domain-add="project=12&domain=example.com&add=local.bind_result"></tgx>
<div tgx:if="local.bind_result">Домен привязан к проекту.</div>

Разбор#

Без project директива регистрирует домен в каталоге. С project выполняет bind к проекту текущего пользователя.

Когда использовать#

  • Когда нужно подключать и обслуживать пользовательские домены в проекте через шаблонный сценарий.
  • Когда нужно показать пользователю понятный flow: добавить домен -> подтвердить -> привязать к проекту.

Поведение в runtime#

  • Тип: пользовательская директива.
  • В sandbox директива tgx:domain-add: запрещена.
  • Эта директива выполняет действие на сервере во время рендера, поэтому её стоит вызывать только при явном условии.

Параметры#

Обязательные#

  • tgx:domain-add — payload операции (plain, query-string или JSON).

Необязательные#

  • Ключи результата verify|confirm|add|delete|list|as для записи ответа в переменную.

По умолчанию#

  • Доступно только в доменном flow slot=0.

Типы#

  • Payload: строка или JSON-объект.

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

  • Пытаться bind без подтвержденного домена
  • Путать режимы register (без project) и bind (с project)

Проверка перед публикацией#

  • В payload передан domain
  • Для bind добавлен project/project_id

См. также#