Рассказать

Интеграция собственного шаблона для сайта

Если вы хотите использовать собственный шаблон для сайта, выполните следующие действия:

Подготовьте шаблон в виде статической HTML-страницу (вручную, с помощью визуальных HTML-редакторов или других средств) и убедитесь, что она отображается корректно. Стили могут находиться как внутри шаблона, так и в отдельном CSS-файле.
Расставьте в HTML ключевые последовательности — строки, которые при рабте TextCMS заменяются на реальное содержимое. В настоящее время используются следующие ключевые последовательности:
- ##CONTENT# — основная последовательность, которая должна быть в любом шаблоне. На ее место вставляется собственно текст Web-страницы.
-  — отладочные сообщения, если отладочный режим включен. При отсутствии этой последовательности они выводятся непосредственно перед тегом </body>
-  — copyright-сообщение движка. В случае его отсутствия выводится перед тегом </body>
- ##PAGE_NAME# — название текущей страницы сайта (может вставляться в любое место, включая тег TITLE).
- ##SITE_NAME# — название сайта (может вставляться в любое место, включая тег TITLE).
-  — статистика времени выполнения скрипта. Необязательная последовательность.
-  — вставляет теги для подключения JavaScript-файлов, запрошенных модулями. Должен быть в секции </head>.
-  — место вставки ссылки на CSS. Должна находиться в секции <head>. Необязательная последовательность в случае, если CSS-стили встроены прямо в шаблон.
- ##block[модуль_процедура, параметры]# — вызывает процедуру с именем модуль_процедура из модуля модуль и вставляет в данное место результаты работы. В случае отсутствия модуля блок оказывается пустым, а в отладочное сообщение выдается информация о том, что такого модуля нет. Если указано только имя модуля, вызывается процедура модуль_main. Параметры перечисляются через запятую, в случае их отсутствия запятая после процедура может не ставиться. (Пример: ##block[menu]# — вставка одноуровнего динамически генерируемого меню.)
- ##url[адрес]# — преобразует адрес относительно корня CMS в адрес относительно корня сайта, что требуется при включенной поддержке URL, когда не известен путь, куда будет установлена CMS. Например, ##url [template/images/pic. gif]# в случае если TextCMS установлена в каталог /textcms/, будет преобразовано в /textcms/template/images. gif. Используйте эту ключевую последовательность для ссылки на файлы графики и другие статические файлы
- ##hurl[адрес]# — преобразует адрес в HURL станицы, построенный в соответствии с выбранным в данный момент режимом построения HURLs. Используйте для ссылки на другие Web-страницы сайта.
- ##include[файл]— вставляет вместо себя содержимое файла файл, который должен находиться в каталоге данного стиля (т. е. там же, где лежит template. htm). Это единственная директива, которая обрабатыватеся рекурсивно!
Создайте в каталоге templates каталог с названием шаблона (желательно без символов кириллицы и пробелов во избежание проблем с кодировками).
Скопируйте статический HTML-файл в этот каталог под именем template.htm, а CSS-файл (если он есть) — под именем style.css.
Название нового шаблона появится в списке стилей в настройках «стиля по умолчанию» в параметрах сайта, а также в настройках новых страниц. Задайте его там, где это вам необходимо. После этого страница станет отображаться уже в новом стиле.