Первоначальная идея MACRO(или {{macro}}, что равнозначно) возникла из нашей практики использования шаблонной системы WACT-а. Первоначально WACT строился исходя из следующих принципов:

• XML-подобный синтаксис.
• Наличие контекстов, из которых выводятся данные.

Эти два обстоятельства значительно усложняют использование WACT-а в случаях, когда вы имеете дело со сложной логикой отображения. Более трети документации на WACT посвящено контекстам. Кроме этого контексты и XML-подобный синтаксис значительно усложняют внутренную архитектуру WACT-а, которую становится все сложнее поддерживать.

В результате дискусий родился MACRO как более простая, но не менее мощная альтернатива WACT-у:

• первоначальная идея MACRO
• промежуточные соглашения перед началом разработки MACRO
• ход разработки MACRO

WACT еще какое-то время будет нами поддержваться, но в целом приоритет разработки теперь будет отдан MACRO.

Для тех, кто ранее работал с WACT-ом, проблем с переходом на MACRO быть не должно.

Отличительной особенностью MACRO от WACT-а является и то, что MACRO не является полностью независимым пакетом. Пакет MACRO имеет зависимости от CORE и FS пакетов, что позволяет использовать проверенные временем решения и не «изобретать колесо».

Если вы только начинаете разбираться с MACRO, мы рекомендуем читать страницы секции «Информация по использованию MACRO» подряд, сверху вниз.

• Словарь тегов
• Словарь фильтров

• Базовые знания
  • Плюсы и минусы MACRO шаблонизатора
  • Отличия MACRO от WACT-а
  • Введение в шаблонную систему MACRO. Основные элементы шаблонов
  • Компиляция и выполнение шаблона. Пример рендеринга MACRO-шаблона
  • Как MACRO-шаблон получает данные для вывода?
  • Основные элементы шаблона
    • Выражения. Вывод значений переменных в шаблоне
    • Фильтры. Модификация значений при выводе
    • Использование php-кода в шаблонах
• Базовые средства шаблонизации MACRO
  • Вывод списков
  • Постраничный вывод списков
  • Теги форм и элементов форм
  • Композиция шаблонов (включение, обворачивание и переиспользование шаблонов)
• Механизм шаблонизатора MACRO
  • Словари элементов MACRO-шаблона (Какие элементы шаблона распознает MACRO? Словари тегов и фильтров)
  • Механизм поиска шаблонов(Как MACRO ищет шаблоны)
  • Сообщения об ошибках и отладка шаблонов

• Как работает компилятор MACRO-шаблонов
• Создание своих тегов
• Создание своих фильтров
• Расширение механизма поиска шаблонов. Поддержка скинов, языкозависимых шаблонов и т.д