TypoScript

TypoScript — это конфигурационный язык, используемый в системе управления контентом (CMS) TYPO3 для определения внешнего вида, структуры и поведения веб-сайта. В отличие от традиционных языков программирования, TypoScript не является императивным языком (с последовательным выполнением команд), а представляет собой декларативный язык, описывающий конечное состояние объектов и их свойств. Он служит основным инструментом для настройки шаблонов, интеграции данных и управления выводом контента в TYPO3.

История и происхождение

TypoScript был разработан в конце 1990-х — начале 2000-х годов создателем TYPO3, Каспером Скохей (Kasper Skårhøj), как часть оригинальной архитектуры системы. Изначально язык задумывался как средство для гибкой настройки отображения контента без необходимости написания PHP-кода на уровне шаблонов. С выходом TYPO3 версии 4.0 в 2006 году TypoScript стал обязательным компонентом для настройки большинства сайтов на этой платформе.

С развитием TYPO3 и появлением версии 8.0 (2016 год) и последующих, акцент сместился в сторону использования Fluid — современного шаблонизатора, основанного на HTML. Тем не менее, TypoScript остаётся ключевым элементом для конфигурации бэкенда, управления кэшированием, настройки плагинов и интеграции с внешними сервисами. В версии 12.0 (2022 год) и выше поддержка TypoScript была сохранена, но его использование в чистом виде для шаблонов стало менее распространённым.

Синтаксис и структура

TypoScript имеет собственный синтаксис, который отличается от привычных языков разметки или программирования. Основные элементы:

Объекты и свойства

Язык оперирует объектами, которые представляют собой иерархические структуры. Каждый объект может содержать свойства (простые значения или вложенные объекты). Синтаксис записи:

`` объект.свойство = значение объект.свойство.подсвойство = значение ``

Например: `` page = PAGE page.10 = TEXT page.10.value = Hello, World! ``

Типы данных

• Строки — записываются в кавычках или без, если не содержат пробелов.
• Числа — целые и дробные.
• Логические значения — 1 (истина) или 0 (ложь).
• Списки — разделяются запятыми или пробелами.
• Объекты — ссылки на предопределённые типы (например, TEXT, IMAGE, COA).

Операторы

• = — присваивание значения.
• > — удаление свойства или объекта.
• < — копирование значения из другого объекта.
• := — модификация значения (например, добавление строки).
• { } — группировка вложенных свойств.

Пример группировки: `` page { 10 = TEXT 10.value = Привет } ``

Условия и функции

TypoScript поддерживает условные конструкции (if), циклы (for), а также вызов встроенных функций (например, stdWrap для обработки строк). Условия записываются в квадратных скобках:

`` [globalVar = GP:param = 1] page.10.value = Условие выполнено [else] page.10.value = Условие не выполнено [global] ``

Классификация и виды

TypoScript делится на несколько категорий в зависимости от области применения:

TypoScript для шаблонов (Template TypoScript)

Используется для настройки внешнего вида страниц. Определяет, какие элементы контента отображаются, как они стилизуются, и как формируется HTML-код. Включает объекты PAGE, TEXT, IMAGE, COA (Content Object Array) и другие.

TypoScript для конфигурации (Setup TypoScript)

Отвечает за настройку бэкенда TYPO3: права доступа, кэширование, настройки плагинов, интеграцию с базами данных. Записывается в файлах setup.ts или в полях «Setup» в шаблонах.

TypoScript для констант (Constants TypoScript)

Содержит переменные, которые могут быть изменены администратором сайта без редактирования основного кода. Константы обычно определяются в файлах constants.ts и используются в Setup TypoScript через синтаксис {$variable}.

TypoScript для расширений (Extension TypoScript)

Каждое расширение (плагин) для TYPO3 может включать собственные TypoScript-файлы, которые добавляют новые объекты, настройки или переопределяют существующие.

Применение

TypoScript применяется в следующих основных сценариях:

Настройка шаблонов

С помощью TypoScript разработчик определяет, какие блоки контента (текст, изображения, меню) будут отображаться на странице, в каком порядке и с какими CSS-классами. Например, для создания меню используется объект HMENU, а для вставки изображения — IMAGE.

Интеграция данных

TypoScript позволяет извлекать данные из базы данных TYPO3 (например, записи из таблицы tt_content) и отображать их на странице. Для этого используются объекты CONTENT и RECORDS.

Управление кэшированием

С помощью TypoScript можно настроить стратегию кэширования для отдельных элементов страницы, что критично для производительности высоконагруженных сайтов.

Настройка плагинов

Большинство расширений для TYPO3 (например, новостные ленты, формы обратной связи, интернет-магазины) требуют TypoScript-конфигурации для указания параметров работы, таких как идентификаторы страниц, шаблоны вывода и настройки безопасности.

Примеры использования

Простой пример: вывод текста

`` page = PAGE page.10 = TEXT page.10.value = Добро пожаловать на сайт! page.10.stdWrap.wrap = <h1>|</h1> ``

Пример: создание меню

`` page.20 = HMENU page.20 { 1 = TMENU 1.NO = 1 1.NO.wrapItemAndSub = <li>|</li> 1.wrap = <ul>|</ul> } ``

Пример: использование констант

В файле constants.ts: `` mySite.title = Мой сайт ` В файле setup.ts: ` page.10.value = {$mySite.title} ``

Критика и ограничения

TypoScript неоднократно подвергался критике со стороны разработчиков за свою сложность и неочевидность синтаксиса. Основные претензии:

• Крутая кривая обучения. Для новичков TypoScript кажется запутанным из-за отсутствия привычных конструкций (циклы, функции, классы).
• Отсутствие типизации. Ошибки часто выявляются только во время выполнения, а не на этапе компиляции.
• Плохая читаемость. Иерархическая структура с большим количеством вложенных объектов может быть трудна для восприятия.
• Сложность отладки. Инструменты для отладки TypoScript (например, встроенный анализатор) ограничены по сравнению с современными IDE.

В ответ на эти недостатки сообщество TYPO3 активно продвигает использование Fluid и других современных инструментов, однако TypoScript остаётся незаменимым для глубокой настройки системы.

Интересные факты

• TypoScript не является языком программирования в полном смысле, так как не поддерживает переменные, функции и циклы в классическом понимании. Он ближе к языкам описания конфигурации, таким как YAML или JSON.
• В TYPO3 существует встроенный редактор TypoScript, который позволяет просматривать и редактировать конфигурацию прямо в административной панели.
• Некоторые разработчики создают генераторы TypoScript-кода, которые автоматически создают конфигурацию на основе визуального редактора страниц.

Источники

• Официальная документация TYPO3: «TypoScript Reference» (версии 4.x–12.x).
• Книга «TYPO3 CMS: The Complete Guide» (автор: Michael Schams, 2020).
• Статья «TypoScript vs Fluid: What to Use When» на портале TYPO3.org (2021).
• Документация по расширениям TYPO3: «Extension Development Guide» (2023).