FAQ и документация Tagix — быстрый старт

FAQ и документация Tagix: быстрый старт для новичков#

Эта страница сделана как входная точка для тех, кто впервые зашел в Tagix.Ниже: с чего начать, где что находится, как не запутаться в первых шагах и куда идти дальше.

1. Быстрый старт за 10-15 минут#

Зарегистрируйтесь: /register/ и войдите: /login/.
Откройте кабинет: /dashboard/ и создайте проект.
Создайте базовые страницы: главная, контакты, политика, FAQ.
Проверьте страницу в sandbox или на черновике.
Подключите домен и публикуйте.

2. Как устроен сайт в Tagix#

Страницы: структура сайта и URL-адреса (/pages/*).
Шаблоны страниц: общий каркас страницы (/page-templates/*).
Компоненты: переиспользуемые блоки (header/footer/cards).
Данные: записи в коллекциях и вывод в шаблонах через TGX.
Автоматизация: trigger по событию, cron по расписанию и ручной запуск операций.

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

3. Первый рабочий сценарий#

Создайте страницу и задайте ей понятный slug.
Подключите header и footer через tgx:component.
Добавьте контентные блоки и проверьте адаптив.
Если блок повторяется, перенесите его в компонент.
Подключите форму с tgx:ajax-post и проверьте ответ в целевой блок.
Добавьте одну автоматизацию: уведомление после формы или периодическую проверку статуса.
Проверьте SEO-поля и внутренние ссылки.

4. Частые вопросы новичков#

Я не разработчик. Смогу ли я запустить сайт?

Да. Начните с готового шаблона страниц и небольших правок текста/блоков.

Где безопасно тестировать изменения?

Используйте sandbox.

С чего начать изучение TGX?

Освойте tgx:component, tgx:set, tgx:if, tgx:repeat, затем переходите к tgx:ajax-*.

Что выбрать: trigger, cron или ручной запуск?

Реакция на событие: trigger. По времени: cron. По команде: ручной запуск.

5. Куда идти дальше#

Список TGX-директив#

tgx:component — Подключает компонент или шаблон.
tgx:set — Создает/обновляет переменную в контексте.
tgx:if — Условный вывод узла при истинном выражении.
tgx:else-if — Дополнительная ветка условия.
tgx:else — Фолбэк-ветка, если предыдущие условия не сработали.
tgx:repeat — Цикл по массиву/коллекции.
tgx:repeat-text — Повторяет текст/фрагмент как строку.
tgx:ui — Шорткат utility-стилей.
tgx:record-fields — Рендерит поля записи по схеме коллекции.
tgx:input — Рендерит конкретный тип input.
tgx:ajax-get — AJAX GET-шорткат.
tgx:ajax-post — AJAX POST-шорткат.
tgx:ajax-put — AJAX PUT-шорткат.
tgx:ajax-patch — AJAX PATCH-шорткат.
tgx:ajax-delete — AJAX DELETE-шорткат.
tgx:swap — Задает стратегию замены HTML после ответа.
tgx:target — Определяет узел-получатель ответа.
tgx:trigger — Событие запуска AJAX-действия.
tgx:confirm — Подтверждение действия перед запросом.
tgx:dom-actions — Правила разрешенных DOM-действий в редакторе.
tgx:dom-fields — Карта полей, редактируемых в DOM-модалке.
tgx:switch — Сохраняет значение в local.switch для последующих tgx:case.
tgx:case — Ветка строгого сравнения с local.switch.
tgx:case-default — Fallback-ветка для switch/case, когда совпадений нет.
tgx:session — Проверка наличия ключа в $_SESSION.
tgx:admin — Проверка роли admin у текущего пользователя.
tgx:member — Проверка авторизованного пользователя (member).
tgx:guest — Проверка гостевого режима (не member).
tgx:continue — Управляет продолжением итерации в repeat-контексте.
tgx:break — Прерывает текущий repeat-цикл.
tgx:record-delete — Удаляет запись по указанному record-path.
tgx:domain-verify — Запрашивает TXT challenge для владения доменом и сохраняет результат в runtime-переменную.
tgx:domain-confirm — Проверяет TXT challenge и подтверждает владение доменом.
tgx:domain-add — Добавляет/обновляет домен в каталог (и при необходимости связывает с проектом).
tgx:domain-delete — Отвязывает/удаляет домен из каталога по правилам runtime.
tgx:domain-list — Загружает список доменов в runtime-переменные.
tgx:render — Рендер контента в заданном формате (markdown, markdown-to-html).
tgx:alert — Показывает toast-уведомление через frontend runtime.
tgx:anchor — Назначает стабильный anchor id и data-метку узлу.
tgx:style-step-rem — Служебная style-настройка; в текущем runtime эффект минимальный/технический.
tgx:boost — Маппинг в data-hx-boost.
tgx:loader — Маппинг в data-hx-loader.
tgx:ajax-push-url — Маппинг в data-hx-push-url.
tgx:auto-refresh — Добавляет polling every <interval> в data-hx-trigger.
tgx:ajax-headers — Маппинг в data-hx-headers.
tgx:ajax-include — Маппинг в data-hx-include.
tgx:ajax-vals — Маппинг в data-hx-vals.
tgx:ajax-encoding — Маппинг в data-hx-encoding.
tgx:ajax-json-body — Маппинг в data-hx-json-body.
tgx:ajax-download — Маппинг в data-hx-download для download-ответов.
tgx:ajax-ext — Маппинг в data-hx-ext.
tgx:ajax-group-input — Маппинг в data-hx-group-input для группового ввода.
tgx:ajax-on-after-request — Маппинг в data-hx-on-after-request (inline handler после запроса).
tgx:ajax-alert-success — Показывает alert после успешного HTMX-запроса.
tgx:ajax-alert-error — Показывает alert после ошибочного HTMX-запроса.
tgx:append — Добавляет значение в массив runtime-переменной.
tgx:prepend — Добавляет значение в начало массива runtime-переменной.
tgx:seo — Применяет schema.org microdata-пресет к узлу и вложенным элементам.
tgx:redirect — Выполняет HTTP redirect.
tgx:terminate — Завершает ответ (при необходимости с контентом/кодом).
tgx:header — Отправляет HTTP-заголовок.
tgx:mail — Отправляет письмо из шаблона/контекста.
tgx:wait — Пауза выполнения (us/ms/s).
tgx:log — Пишет сообщение в журнал сервера.

Связанные статьи

tgx-render tgx-repeat tgx-set

← Назад в FAQ