Файл описания шаблонов сайта .templates.php

Файл .templates.php определяет шаги Выбор группы шаблонов, Выбор шаблона и Установка шаблона в цепочке шагов мастера создания сайта. Если в папке мастера нет файла .templates.php, то шаги Выбор группы шаблонов, Выбор шаблона и Установка шаблона отсутствуют. Группа шаблонов предоставляет возможность сгруппировать шаблоны сайта, например, по тематике или компоновке (layout).

В файле .templates.php описываются шаблоны, находящиеся в поддиректории templates папки мастера. В поддиректории templates должны находиться папки шаблонов сайта. Данные (название, описание, скриншоты шаблонов сайта) для шага Выбор шаблона берутся из файлов (description.php, screen.gif и preview.gif), находящихся в папке шаблона.

Если в поддиректории templates есть шаблоны сайтов, а файл .templates.php отсутствует, то шаги Выбор шаблона и Установка шаблона все равно добавятся в цепочку шагов мастера создания сайта.

Структура типичного файла .templates.php такова:

<?
if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true) die();
$arWizardTemplates = Array(
	"GROUPS" => Array(
		"BUSINESS" => Array(
			"NAME" => GetMessage("TEMPLATE_GROUP_BUSINESS"), 
			"SITE_ID" => "homepage", 
			"SCREENSHOT" => "images/comp1.gif",
			"PREVIEW" => "images/comp1_prev.gif"
		),
		"COMPUTER" => Array(
            		"NAME" => "Компьютер", 
			"SITE_ID" => "homepage", 
			"SCREENSHOT" => "images/comp2.gif",
			"PREVIEW" => "images/comp2_prev.gif"
		),
		"BLOGS" => Array(
			"NAME" => "Блоги", 
			"SITE_ID" => "blog", 
			"SCREENSHOT" => "images/comp3.gif",
			"PREVIEW" => "images/comp3_prev.gif",
			"DEFAULT" => "Y",
		),
		"CARS" => Array(
			"NAME" => "Машины", 
			"SITE_ID" => Array("blog", "homepage"), 
			"SCREENSHOT" => "images/comp4.gif",
			"PREVIEW" => "images/comp4_prev.gif"
		),
	),
	"TEMPLATES" => Array(
		"template1" => Array(
			"GROUP_ID" => "BUSINESS",
			"INSTALL_STEPS" => Array(
				"SCRIPT" => "scripts/template1.php",
				"STEPS" => Array(
					"step100" => "Step100",
					"step200" => "Step200",
				)
			),
		),
		"template2" => Array(
			"GROUP_ID" => "BUSINESS",
		),
		"three_columns" => Array(
			"GROUP_ID" => Array("BLOGS", "BUSINESS", "CARS", "COMPUTER"),
			"DEFAULT" => "Y",
			"FILES" => Array(
				Array("FROM" => "files/three_columns", "TO" => "/"),
			),
			"SELECT_STEPS" => Array(
				"SCRIPT" => "three_columns.php",
				"STEPS" => Array(
					"templatestep" => "TemplateStep",
				)
			),
		),
		"two_columns" => Array(
			"GROUP_ID" => "COMPUTER",
		),
	),
);
?>

В файле .templates.php определяется массив $arWizardTemplates, имеющий следующие ключи:

• "GROUPS" – значением этого ключа является массив групп шаблонов. Если этот ключ не определён, шаг Выбор группы шаблонов отсутствует в цепочке шагов мастера создания сайта. Массив групп шаблонов состоит из элементов следующего вида:

  "ID группы шаблона" => Array(
  	"NAME" => имя группы шаблона
  	"SITE_ID" => ID сайта (одиночное значение или массив)
  	"SCREENSHOT" => путь относительно папки мастера к картинке группы
  	"PREVIEW" => путь относительно папки мастера к уменьшенной копии картинки группы
  	"DEFAULT" => если равно "Y", то данная группа будет выбрана по умолчанию
  ),

• "TEMPLATES" – значением этого ключа является массив шаблонов. Массив шаблонов состоит из элементов следующего вида:

  "ID шаблона" => Array(
  	"GROUP_ID" => ID группы, к которой принадлежит шаблон (одиночное значение или массив)
  	"SITE_ID" => ID сайта, к которому принадлежит шаблон (одиночное значение или массив)
  	"DEFAULT" => если параметр равен "Y", то данный шаблон будет
    выбран по умолчанию в шаге Выбор шаблона
  	"SORT" => индекс сортировки
  	"REWRITE" => если параметр равен "N", то выбранный шаблон не будет перезаписывать файлы 
    существующего в системе шаблона при совпадении идентификаторов;
    по умолчанию параметр равен "Y" (перезаписывать);
  	"SELECT_STEPS" => массив, описывающий дополнительные шаги после шага Выбор шаблона
  	Array(
  		"SCRIPT" => путь к файлу с классами шагов относительно папки мастера
  		"STEPS" => массив шагов, добавляемых в мастер
  		Array(
  			"ID шага 1" => "Имя класса шага 1",
  			"ID шага 2" => "Имя класса шага 2",
  			…
  		)
  	)
  ),
  	"INSTALL_STEPS" => массив, описывающий дополнительные шаги после шага Установка шаблона
  	Array(
  		"SCRIPT" => путь к файлу с классами относительно папки мастера,
  		"STEPS" => массив шагов, добавляемых в мастер
  		Array(
  			"ID шага 1" => "Имя класса шага 1",
  			"ID шага 2" => "Имя класса шага 2",
  			…
  		)
  	),
  	"FILES" => массив, описывающий файлы для копирования/удаления
  	Array(
  		Array(
  			"FROM" => путь к каталогу (файлу) относительно папки мастера, 
  			содержимое которого нужно скопировать,
  			"TO" => путь к файлу или папке относительно корня сайта,
  			куда будут скопированы файлы
  			"REWRITE" => перезаписывать ли существующие файлы; 
  			необязательный параметр, по умолчанию равен "Y" (перезаписывать),
  			"RECURSIVE" => копировать ли рекурсивно все подкаталоги и файлы, 
  			входящие в путь, указанный в параметре FROM;
  			необязательный параметр, по умолчанию равен "Y" (копировать рекурсивно),
  			"DELETE" => путь к папке (файлу), которую нужно удалить 
  		),
     		…
    	)
  ),