Структура шаблонов VamShop

Все шаблоны должны находиться в папке templates.

По умолчанию, в интернет-магазине VamShop установлено два шаблона: vamshop и vamshop_table.

Соответственно, каждый шаблон находится в свой папке:

/templates/vamshop и /templates/vamshop_table

Требования к названию папок шаблонов:

  1. Вы можете создавать любую папку внутри /templates.

  2. Название папки должно состоять из английских символов, никакой кириллицы, никаких пробелов, никаких заглавных букв.

  3. Возможно также применение цифр, например /templates/moy-shablon или /templates/moi_shablon123

Структура самого шаблона (т.е. содержимое папки /templates/vamshop, к примеру) следующая:

/admin - в данной папке находятся шаблоны для накладной и счёт-фактуры заказа, которые Вы можете просматривать в каждом заказе в Админке - Покупатели - Заказы.

/admin/mail/russian - В данной папке находятся шаблоны писем для русского языка, отправляемых из администраторской. Если Вы установили в магазине какой-либо дополнительный язык, то нужно просто скопировать папку /admin/mail/russian например в /admin/mail/english, это будут шаблоны писем для английского языка.

Шаблоны писем в виде текста (.txt файлы) и в виде html файлов.

Txt отправляются покупателям если в Админке - Настройки - Настройки E-mail - Использовать HTML формат при отправке писем - false. Html письма отправляется если true.

/boxes - В данной папке находятся шаблоны боксов. Шаблоны бокса подключаются в основной шаблон index.html (его писание ниже) через метки, например через метку {$box_CATEGORIES} в /templates/шаблон/index.html файле подключается шаблон бокса Разделы, т.е. файл /templates/шаблон/boxes/box_categories.html и т.д.

/buttons/russian - В данной папке находятся кнопки интернет-магазина для русского языка.

/img - В данной папке находятся элементы оформления шаблона, т.е. различные графические элементы.

/javascript - В данной папке могут находиться JavaScript файлы, необходимые для конкретного шаблона.

/mail/russian - В данной папке находятся шаблоны писем для русского языка, отправляемых покупателям из магазина. В чём разница между .txt и .html файлами я чуть выше уже написал (при описании папки /admin/mail/russian), повторяться не буду.

/module - В данной папке находятся шаблоны всего интернет-магазина, т.е. шаблоны всех страниц интернет-магазина. Читайте ниже раздел таблица соответствия скрипт-файл-шаблон, там как раз будет рассказано, какой шаблон за какую часть интернет-магазина отвечает.

/module/categorie_listing - В данной папке находятся шаблоны для вывода содержимого категорий интернет-магазина. Вы можете создавать свои .html файлы внутри этой папки. Затем, чтобы использовать именно свой шаблон при выводе категории, в Админке - Каталог - Категории / Товары, при создании категории, в закладке Дополнительно, Вы как раз можете выбирать, каким шаблоном будут отрисовываться содержимое данной категории (например подкатегории, новинки, рекомедемые товара), для этого Вы выбираете шаблон в опции Шаблон для списка категорий, в данной опции как раз показываются все доступные html файлы из этой папки, т.е. из папки /templates/шаблон/module/categorie_listing.

/module/product_info - В данной папке находятся шаблоны для страницы карточки товара. Вы можете создавать свои .html файлы внутри этой папки. Затем, чтобы использовать именно свой шаблон при просмотре нужного товара в магазине, в Админке - Каталог - Категории / Товары, при создании товара, в закладке Дополнительно, Вы как раз можете выбирать, каким шаблоном будет отрисовываться страница с информацией о товаре (страница карточки товара), для этого Вы выбираете шаблон в опции Шаблон для описания товара, в данной опции как раз показываются все доступные html файлы из этой папки, т.е. из папки /templates/шаблон/module/product_info.

/module/product_listing - В данной папке находятся шаблоны для списка товаров при просмотре какой-либо категории в магазине. Вы можете создавать свои .html файлы внутри этой папки. Затем, чтобы использовать именно свой шаблон при просмотре товаров в магазине, в Админке - Каталог - Категории / Товары, при создании категории, в закладке Дополнительно, Вы как раз можете выбирать, каким шаблоном будет отрисовываться страница со списком товара создаваемой категори, для этого Вы выбираете шаблон в опции Шаблон для списка товаров, в данной опции как раз показываются все доступные html файлы из этой папки, т.е. из папки /templates/шаблон/module/product_listing.

/module/product_options - В данной папке находятся шаблоны для страницы карточки товара, а именно для вывода атрибутов товара на странице карточки товара. Вы можете создавать свои .html файлы внутри этой папки. Затем, чтобы использовать именно свой шаблон при просмотре атрибутов товара, в Админке - Каталог - Категории / Товары, при создании товара, в закладке Дополнительно, Вы как раз можете выбирать, каким шаблоном будут отрисовываться атрибуты товара, для этого Вы выбираете шаблон в опции Шаблон для атрибутов товара, в данной опции как раз показываются все доступные html файлы из этой папки, т.е. из папки /templates/шаблон/module/product_options.

/source - В данной папке находятся исходные коды боксов магазина. Обычно, тут даже ничего изменять не нужно, достаточно просто изменить шаблоны боксов, находящиеся в папке /templates/шаблон/boxes

index.html - Это основной шаблон интернет-магазина, определяющий, собственно, внешний вид интернет-магазина. Если можно так выразиться, то это оболочка всего интернет-магазина. Именно в index.html идёт подключение боксов из /templates/шаблон/boxes и подключение содержимого страниц /templates/vamshop/module (т.е. центральном части) тоже идёт через index.html.

Что б было понятно, например страница регистрации клиента в магазине генерируется следующим образом:

скрипт create_account.php + основной шаблон /templates/шаблон/index.html + шаблоны боксов из /templates/шаблон/boxes + шаблон страницы регистрации /templates/шаблон/module/create_account.html

Подробнее об это буде рассказано в разделе Таблица соответствия скрипт-файл-шаблон, читайте ниже.

stylesheet.css - Это файл стилей (css стилей) данного шаблона.

Вот такой должна быть структура любого шаблона VamShop.

Да, наверняка сложно воспринять эту информацию с первого раза, но начав работать с интернет-магазином VamShop, Вы быстро разберётсь в данной структуре.