Вставки

Административная часть
Примеры вставок
Вставки в модулях
Видео
База данных
Файлы

Модуль «Вставки» – инструмент, который выводит HTML-код, в том числе шаблонные теги на сайте, используя в качестве якоря выведенные на сайте шаблонные теги.

Модуль относится к части CMS «Сервис» и является обязательным для установки.

Вставки добавлены в сборке 6.0.9.2.

Административная часть

Для редактирования вставки необходимо нажать на нее.

Дополнительные параметры располагаются во всплывающем блоке справа.

Вставка имеет следующие характеристики.

Примеры вставок

Примеры приведены для того, чтобы продемонстрировать возможности модуля. Все примеры проверялись на шаблоне по умолчанию.

Информационный блок перед блоком новостей на главной

Название видно только администратору, поэтому название может быть любым. Зададим название как «Бонусная карта».

Размещение – перед меткой

Шаблонный тег-метка – <insert name="show_block" module="news">

Содержание вставки:

<div class="block">
    <div class="block_header">Бонусная карта</div>
    <img src="/edu/img/bonus_card.jpg" width="100%">
</div>

Отображать на страницах – выбрана «Главная страница»

Блок «Купон на скидку» перед блоком новостей

Название – «Купон на скидку»

Размещение – перед меткой

Шаблонный тег-метка – <insert name="show_block" module="news">

Содержание вставки:

<div class="block">
    <insert name="show_add_coupon" module="shop">
</div>

Отображать на страницах – выбрано «Все»

Скрываем поиск на сайте

Название – «Скрывает поиск на сайте»

Размещение – вместо метки

Шаблонный тег-метка – <insert name="show_search" module="search">

Содержание вставки – пустое

Новогодний баннер

Предварительно создадим в модуле «Баннеры» категорию «Новогодний баннер» (ID 4). В баннерах добавим баннер в эту категорию:

загрузим изображение
описание – <h2>С Новым годом и Рождеством!</h2><p>от всей души</p>
категория – «Новогодний баннер»

Создадим вставку:

Название – «Новогодний баннер»

Размещение – вместо метки

Шаблонный тег-метка – <insert name="show_block" module="bs" cat_id="1">

Содержание вставки – <insert name="show_block" module="bs" cat_id="4" template="slider">

Отображать на страницах – Главная страница

Период показа – 15 декабря – 10 января

Вставки в модулях

Модуль задумывался в первую очередь как инструмент для дополнений. При установке дополнения администратор должен сразу увидеть его визуальную часть у себя на сайте. Для этого в файле установки модуля дополнения нужно указать какую вставку нужно сделать (добавлено в сборке 6.0.9.6).

Пример:


// modules/mymodule/mymodule.install.php – файл установки модуля дополнения
class Mymodule_install extends Install
{
    public $inserts = array(
        array(
            // название вставки видно только администратору
            "name" => "Блок моего модуля",

            // шаблонный тег – якорь
            "tag" => '<insert name="show_block" module="bs" cat_id="1">',

            // размещение – после якоря
            "prefix" => 'after',

            // добавляемый визуальный блок – содержит шаблонный тег устанавливаемого модуля
            "text" => '<insert name="show_block" module="mymodule">',

            // выводить только на главной странице (ID 1)
            "site_rel" => array(1),
        )
    );
    //...

Если вставка планируется только в режиме «Заполнить сайт примерами», тогда содержимое свойства $inserts нужно перенести в свойство $demo под ключ 'inserts'.

Пример:


class Mymodule_install extends Install
{
    //часть устанавливающаяся только, если отмечена опция «Заполнить сайт примерами»
    public $demo = array(
        "inserts" => array(
            array(
                "name" => "Блок моего модуля",
                "tag" => '<insert name="show_block" module="bs" cat_id="1">',
                "prefix" => 'after',
                "text" => '<insert name="show_block" module="mymodule">',
                "site_rel" => array(1),
            )
        ),
        //...
    );

Если дополнение реализовано не в виде отдельного модуля, то можно добавить SQL-запрос на добавление вставки в файле install.sql. Этот файл содержит SQL-запросы, выполняющиеся при установке дополнения.

Пример:

install.sql

INSERT INTO {inserts} (name, tag, prefix, text) VALUES ('Блок моего модуля', '<insert name="show_block" module="bs" cat_id="1">', 'after', '<insert name="show_block" module="mymodule">');