Раздел Блоки и банеры в админке SLAED CMS. Инструкция по применению.
Раздел «Блоки и баннеры» предоставляет возможность строить сайт из «кирпичиков», которые называются «блоки».
Существуют следующие виды блоков:
• Стандартные – размещаются в определенных местах сайта;
• Свободные (fly) – данные блоки можно использовать в любых местах, шаблонах или модулях системы.
Большинство потребностей по функциональности сайта покрываются при помощи стандартных блоков, но в некоторых случаях можно применять свободные блоки.
Стандартные блоки
Стандартные блоки можно разделить по следующим свойствам:
• По типу:
* Файловые – блоки, информация в которых выводится посредством html и php функций, заданных в соответствующем файле.
* HTML – блоки, информация в которых выводится посредством html функций, заданных в содержании блока.
* RSS – блоки, в которых выводится информация, взятая по RSS ссылке.
* Системные – к системным блокам относятся: Admin, UserBox.
• По доступности (кто видит): все пользователи, только пользователи, только администраторы, только анонимы.
• По позиции: слева, по центру внизу, по центру вверху, справа, верхний баннер, нижний баннер.
Оформление стандартных блоков
За оформление стандартных блоков отвечают шаблоны тем: block-center.html, block-all.html, block-right.html и другие шаблоны, имеющие в названии префикс block. (См. раздел «Тема оформления»).
Можно создать уникальное оформление для любого блока, находящегося в директории blocks/ (block-name.php; name - это имя блока). Для этого:
1. В директории templates/тема_оформления/ необходимо создать файл шаблона с именем block-name.html.
2. В созданном шаблоне необходимо сделать уникальное оформление для блока block-name.php.
Пример:
необходимо сделать уникальное оформление для блока block-voting.php. В этом случае создается файл шаблона в директории templates/тема_оформления/ с названием block-voting.html. Система найдёт этот файл шаблона автоматически, а затем будет использовать его только для оформления блока block-voting.php.
Добавление файлового блока
Для добавления файлового блока необходимо выполнить следующие действия:
1. Создать файл блока.
Создать файл для файлового блока можно двумя способами: через интерфейс администраторского раздела и через файловую структуру сайта.
Создание файла через интерфейс администраторского раздела
Перейдите во вкладку «Добавить файловый блок», которая отображает форму добавления нового файлового блока.
Укажите имя создаваемого файла (например, mysite), учитывая, что SLAED CMS сама подставит к имени файла префикс «block-».
Укажите тип создаваемого файла.
Нажмите кнопку «Создать блок» после чего загрузится форма, в которую необходимо вставить код блока.
Внимание!
В тексте программного кода блока, для вывода информации необходимо использовать переменную $content вместо стандартных методов echo или print, это единственная отличительная особенность которую необходимоучитывать. Всё остальное реализуется при помощи стандартных методов и функций PHP и HTML. При реализации блоков учитывайте, любой PHP код должен начинаться c <?php и заканчиваться ?>.
После вставки нажмите кнопку «Сохранить» и в файловой структуре сайта будет создан соответствующий файл (например, block-mysite.php, как в нашем примере).
Внимание!
При создании файла файлового блока, необходимо установить права CHMOD 777 на папку blocks/, а в дальнейшем CHMOD 666 на созданный файл.
Создание файла через файловую структуру сайта
Php файлы для файловых блоков хранятся в директории «blocks», которая находится в корневой директории сайта. В данной директории можно создать свой php файл, обязательно назвав его в формате «block-имя_блока.php» (в случае, если формат названия отличается, то при добавлении блока файл не будет виден в списке).
2. Установить связь между созданным файлом и блоком.
Для того чтобы установить связь между файлом и файловым блоком, необходимо добавить новый блок, перейдя во вкладку «Добавить блок».
Форма добавления имеет следующие поля:
• Заголовок – вводится заголовок блока (какой заголовок введён - такой и отображается);
• Ссылка на канал RSS – в случае, если необходимо, чтобы в блоке выводилась определенная RSS лента – укажите ссылку на неё или выберите из стандартного списка. В случае ввода ссылки на RSS не нужно выбирать файл в поле «Имя файла» и заполнять «Содержание». При создании файлового блока данное поле остается без изменений.
• Время обновления – с какой частотой должна обновляться RSS лента. При создании файлового блока данное поле остается без изменений.
• Имя файла – при создании файлового блока выбирается предварительно созданный файл.
• Содержание – заполняется только в случае создания HTML блока (при заполнении содержания не нужно выбирать файл). При создании файлового блока данное поле остается без изменений.
• Позиция – выбирается позиция, на которой должен выводиться блок.
• Отображать блок в модулях – выбирается перечень модулей, в которых необходимо отображать блок.
• Язык – выбор языковой версии, в которой необходимо отображать блок.
• Активировать – «да» - блок будет показываться, «нет» - блок не будет показываться.
• Время работы в днях – можно указать количество дней, в течение которых блок должен быть активен. 0 – блок активен без ограничений.
• После истечения – можно выбрать, что система должна автоматически сделать с блоком после истечения времени работы.
• Кто это будет видеть? – можно указать, для каких категорий пользователей доступен просмотр блока.
Добавление HTML блока
Создавать HTML-блоки очень удобно в целях вывода баннеров, ссылок и других элементов, для вывода которых достаточно использования HTML кода.
Добавить HTML-блок также просто, как и файловый, для этого необходимо перейти во вкладку «Добавить блок» и заполнить поля, что и при создании файлового блока, но вместо выбора файла заполнить поле «Содержание». Заполнять содержание необходимо html-кодом.
Добавление RSS-блока
Перейдите во вкладку «Добавить блок» и заполнить поля, что и при создании файлового блока, но вместо выбора файла укажите ссылку на канал RSS и время обновления.
Использование блоков непосредственно в html файлах темы оформления
1. Создайте блок в панели администратора системы, им может быть стандартный или свободный блок.
2. Активируйте блок и в списке блоков определите его № - номер
3. Для вставки блока, например в основной файл: index.html темы оформления, достаточно добавить участок кода: {%BLOCKS n,ХХХ%}
ХХХ - номер вашего блока
n - без оформления
или
ХХХ - полное название файла блока в директории: blocks/ например: block-forum.php
s - стандартное оформление
Возможны и другие варианты, на ваше усмотрение.
Описание переменных
{%BLOCKS none,ХХХ%} или {%BLOCKS n,ХХХ%} - Произвольный блок системы или свободный блок без оформления, где ХХХ - это либо ID блока, либо название файла блока.
{%BLOCKS standart,ХХХ%} или {%BLOCKS s,ХХХ%} - Произвольный блок системы или свободный блок с оформлением свободного блока, где ХХХ - это либо ID блока, либо название файла блока.
Создание персонального оформления для блока
Для формирования эксклюзивного оформления для блока необходимо создать файл шаблона этого блока с именем.
block-15.html
15 - это номер блока в списке блоков. В базе данных (таблица префикс_blocks, поле bid).
или
block-name.html
name - это имя блока, полное название файла блока в директории: blocks/
Файл оформления блока следует размещать в основной директории темы оформления вместе с другими стандартными шаблонами системы.
Свободные (fly) блоки
Свободный блок (fly) можно разместить в любом месте страницы сайта, для чего требуется вставить код формирования этого свободного блока в соответствующий php-файл (в config/config_header.php, например). В шаблоны тем оформления (файлы *.html) нельзя вставлять код формирования свободного блока, так как в этом случае этот php-код не будет обрабатываться. Более полная информация о вставке блоков в шаблоны тем оформления приведена в разделе «Тема оформления».
Свободный блок описывается в php-скрипте функцией: blocks("why", "who"), где blocks - функция создания свободного блока с параметрами: why и who.
В зависимости от параметров why и who функция создания свободного блока может:
• Печатать на стандартный вывод сформированный свободный блок (выводить блок на страничку).
• Возвращать строку со сформированным свободным блоком (вывод блока в переменную для последующей вставки этого блока в html-шаблон). При этом этот свободный блок может быть с оформлением или без него – это зависит от параметров why.
Значение параметров why:
• none (выводит тело блока на страничку без оформления)
$fly_block_1_1 = blocks("none", 15);
$fly_block_1_2 = blocks("none", "block-menu2.php");
• standart (выводит тело блока на страничку с оформлением)
$fly_block_2_1 = blocks("standart", 15);
$fly_block_2_2 = blocks("standart", "block-menu2.php");
• plzreturn (выводит тело блока в переменную без вывода на страничку и без оформления)
$fly_block_3_1 = blocks("plzreturn", 15);
$fly_block_3_2 = blocks("plzreturn", "block-menu2.php");
• oreturnform (тело блока в переменную без вывода на страничку, но с оформлением)
$fly_block_4_1 = blocks("oreturnform", 15);
$fly_block_4_1 = blocks("oreturnform", "block-menu2.php");
* 15 – это bid, номер блока в базе данных (Номер блока можно посмотреть в панели администратора в строке №).
Значение параметров who:
• bid блока (номер блока в базе данных; таблица преф_blocks (преф – это префикс таблиц БД), поле bid)
$fly_block_5_1 = blocks("none", 15);
$fly_block_5_2 = blocks("standart", 15);
$fly_block_5_3 = blocks("plzreturn", 15);
$fly_block_5_4 = blocks("oreturnform", 15);
• block-name.php (имя php-файла блока; name - это имя блока)
$fly_block_6_1 = blocks("none", "block-menu2.php");
$fly_block_6_2 = blocks("standart", "block-menu2.php");
$fly_block_6_3 = blocks("plzreturn", "block-menu2.php");
$fly_block_6_4 = blocks("oreturnform", "block-menu2.php");
Чтобы пользоваться созданным свободным блоком необходимо, чтобы этот блок был активным. На этом блоке должна быть только одна отметка - «Свободный блок», в противном случае этот блок будет стандартным.
Для формирования эксклюзивного оформления для свободного блока необходимо создать файл шаблона этого блока с именем:
• fly-block-15.html (15 - это номер блока в базе данных (таблица преф_blocks, поле bid));
• fly-block-name.html (name - это имя блока).
Стандартные блоки можно разделить по следующим свойствам:
• По типу:
* Файловые – блоки, информация в которых выводится посредством html и php функций, заданных в соответствующем файле.
* HTML – блоки, информация в которых выводится посредством html функций, заданных в содержании блока.
* RSS – блоки, в которых выводится информация, взятая по RSS ссылке.
* Системные – к системным блокам относятся: Admin, UserBox.
• По доступности (кто видит): все пользователи, только пользователи, только администраторы, только анонимы.
• По позиции: слева, по центру внизу, по центру вверху, справа, верхний баннер, нижний баннер.
Оформление стандартных блоков
За оформление стандартных блоков отвечают шаблоны тем: block-center.html, block-all.html, block-right.html и другие шаблоны, имеющие в названии префикс block. (См. раздел «Тема оформления»).
Можно создать уникальное оформление для любого блока, находящегося в директории blocks/ (block-name.php; name - это имя блока). Для этого:
1. В директории templates/тема_оформления/ необходимо создать файл шаблона с именем block-name.html.
2. В созданном шаблоне необходимо сделать уникальное оформление для блока block-name.php.
Пример:
необходимо сделать уникальное оформление для блока block-voting.php. В этом случае создается файл шаблона в директории templates/тема_оформления/ с названием block-voting.html. Система найдёт этот файл шаблона автоматически, а затем будет использовать его только для оформления блока block-voting.php.
Добавление файлового блока
Для добавления файлового блока необходимо выполнить следующие действия:
1. Создать файл блока.
Создать файл для файлового блока можно двумя способами: через интерфейс администраторского раздела и через файловую структуру сайта.
Создание файла через интерфейс администраторского раздела
Перейдите во вкладку «Добавить файловый блок», которая отображает форму добавления нового файлового блока.
Укажите имя создаваемого файла (например, mysite), учитывая, что SLAED CMS сама подставит к имени файла префикс «block-».
Укажите тип создаваемого файла.
Нажмите кнопку «Создать блок» после чего загрузится форма, в которую необходимо вставить код блока.
Внимание!
В тексте программного кода блока, для вывода информации необходимо использовать переменную $content вместо стандартных методов echo или print, это единственная отличительная особенность которую необходимоучитывать. Всё остальное реализуется при помощи стандартных методов и функций PHP и HTML. При реализации блоков учитывайте, любой PHP код должен начинаться c <?php и заканчиваться ?>.
После вставки нажмите кнопку «Сохранить» и в файловой структуре сайта будет создан соответствующий файл (например, block-mysite.php, как в нашем примере).
Внимание!
При создании файла файлового блока, необходимо установить права CHMOD 777 на папку blocks/, а в дальнейшем CHMOD 666 на созданный файл.
Создание файла через файловую структуру сайта
Php файлы для файловых блоков хранятся в директории «blocks», которая находится в корневой директории сайта. В данной директории можно создать свой php файл, обязательно назвав его в формате «block-имя_блока.php» (в случае, если формат названия отличается, то при добавлении блока файл не будет виден в списке).
2. Установить связь между созданным файлом и блоком.
Для того чтобы установить связь между файлом и файловым блоком, необходимо добавить новый блок, перейдя во вкладку «Добавить блок».
Форма добавления имеет следующие поля:
• Заголовок – вводится заголовок блока (какой заголовок введён - такой и отображается);
• Ссылка на канал RSS – в случае, если необходимо, чтобы в блоке выводилась определенная RSS лента – укажите ссылку на неё или выберите из стандартного списка. В случае ввода ссылки на RSS не нужно выбирать файл в поле «Имя файла» и заполнять «Содержание». При создании файлового блока данное поле остается без изменений.
• Время обновления – с какой частотой должна обновляться RSS лента. При создании файлового блока данное поле остается без изменений.
• Имя файла – при создании файлового блока выбирается предварительно созданный файл.
• Содержание – заполняется только в случае создания HTML блока (при заполнении содержания не нужно выбирать файл). При создании файлового блока данное поле остается без изменений.
• Позиция – выбирается позиция, на которой должен выводиться блок.
• Отображать блок в модулях – выбирается перечень модулей, в которых необходимо отображать блок.
• Язык – выбор языковой версии, в которой необходимо отображать блок.
• Активировать – «да» - блок будет показываться, «нет» - блок не будет показываться.
• Время работы в днях – можно указать количество дней, в течение которых блок должен быть активен. 0 – блок активен без ограничений.
• После истечения – можно выбрать, что система должна автоматически сделать с блоком после истечения времени работы.
• Кто это будет видеть? – можно указать, для каких категорий пользователей доступен просмотр блока.
Добавление HTML блока
Создавать HTML-блоки очень удобно в целях вывода баннеров, ссылок и других элементов, для вывода которых достаточно использования HTML кода.
Добавить HTML-блок также просто, как и файловый, для этого необходимо перейти во вкладку «Добавить блок» и заполнить поля, что и при создании файлового блока, но вместо выбора файла заполнить поле «Содержание». Заполнять содержание необходимо html-кодом.
Добавление RSS-блока
Перейдите во вкладку «Добавить блок» и заполнить поля, что и при создании файлового блока, но вместо выбора файла укажите ссылку на канал RSS и время обновления.
Использование блоков непосредственно в html файлах темы оформления
1. Создайте блок в панели администратора системы, им может быть стандартный или свободный блок.
2. Активируйте блок и в списке блоков определите его № - номер
3. Для вставки блока, например в основной файл: index.html темы оформления, достаточно добавить участок кода: {%BLOCKS n,ХХХ%}
ХХХ - номер вашего блока
n - без оформления
или
ХХХ - полное название файла блока в директории: blocks/ например: block-forum.php
s - стандартное оформление
Возможны и другие варианты, на ваше усмотрение.
Описание переменных
{%BLOCKS none,ХХХ%} или {%BLOCKS n,ХХХ%} - Произвольный блок системы или свободный блок без оформления, где ХХХ - это либо ID блока, либо название файла блока.
{%BLOCKS standart,ХХХ%} или {%BLOCKS s,ХХХ%} - Произвольный блок системы или свободный блок с оформлением свободного блока, где ХХХ - это либо ID блока, либо название файла блока.
Создание персонального оформления для блока
Для формирования эксклюзивного оформления для блока необходимо создать файл шаблона этого блока с именем.
block-15.html
15 - это номер блока в списке блоков. В базе данных (таблица префикс_blocks, поле bid).
или
block-name.html
name - это имя блока, полное название файла блока в директории: blocks/
Файл оформления блока следует размещать в основной директории темы оформления вместе с другими стандартными шаблонами системы.
Свободные (fly) блоки
Свободный блок (fly) можно разместить в любом месте страницы сайта, для чего требуется вставить код формирования этого свободного блока в соответствующий php-файл (в config/config_header.php, например). В шаблоны тем оформления (файлы *.html) нельзя вставлять код формирования свободного блока, так как в этом случае этот php-код не будет обрабатываться. Более полная информация о вставке блоков в шаблоны тем оформления приведена в разделе «Тема оформления».
Свободный блок описывается в php-скрипте функцией: blocks("why", "who"), где blocks - функция создания свободного блока с параметрами: why и who.
В зависимости от параметров why и who функция создания свободного блока может:
• Печатать на стандартный вывод сформированный свободный блок (выводить блок на страничку).
• Возвращать строку со сформированным свободным блоком (вывод блока в переменную для последующей вставки этого блока в html-шаблон). При этом этот свободный блок может быть с оформлением или без него – это зависит от параметров why.
Значение параметров why:
• none (выводит тело блока на страничку без оформления)
$fly_block_1_1 = blocks("none", 15);
$fly_block_1_2 = blocks("none", "block-menu2.php");
• standart (выводит тело блока на страничку с оформлением)
$fly_block_2_1 = blocks("standart", 15);
$fly_block_2_2 = blocks("standart", "block-menu2.php");
• plzreturn (выводит тело блока в переменную без вывода на страничку и без оформления)
$fly_block_3_1 = blocks("plzreturn", 15);
$fly_block_3_2 = blocks("plzreturn", "block-menu2.php");
• oreturnform (тело блока в переменную без вывода на страничку, но с оформлением)
$fly_block_4_1 = blocks("oreturnform", 15);
$fly_block_4_1 = blocks("oreturnform", "block-menu2.php");
* 15 – это bid, номер блока в базе данных (Номер блока можно посмотреть в панели администратора в строке №).
Значение параметров who:
• bid блока (номер блока в базе данных; таблица преф_blocks (преф – это префикс таблиц БД), поле bid)
$fly_block_5_1 = blocks("none", 15);
$fly_block_5_2 = blocks("standart", 15);
$fly_block_5_3 = blocks("plzreturn", 15);
$fly_block_5_4 = blocks("oreturnform", 15);
• block-name.php (имя php-файла блока; name - это имя блока)
$fly_block_6_1 = blocks("none", "block-menu2.php");
$fly_block_6_2 = blocks("standart", "block-menu2.php");
$fly_block_6_3 = blocks("plzreturn", "block-menu2.php");
$fly_block_6_4 = blocks("oreturnform", "block-menu2.php");
Чтобы пользоваться созданным свободным блоком необходимо, чтобы этот блок был активным. На этом блоке должна быть только одна отметка - «Свободный блок», в противном случае этот блок будет стандартным.
Для формирования эксклюзивного оформления для свободного блока необходимо создать файл шаблона этого блока с именем:
• fly-block-15.html (15 - это номер блока в базе данных (таблица преф_blocks, поле bid));
• fly-block-name.html (name - это имя блока).
Пример 1:
Необходимо создать свободный блок с параметрами:
• Вывод тела свободного блока на страничку.
• Без оформления.
• По номеру блока в базе данных.
1 |
blocks("none", 15); |
• C использованием имени блока.
1 |
blocks("none", "block-menu2.php"); |
Пример 2:
Необходимо создать свободный блок с параметрами:
• Вывод тела свободного блока на страничку.
• С оформлением.
• По номеру блока в базе данных.
1 |
blocks("standart", 15); |
• С использованием имени блока:
1 |
blocks("standart", "block-menu2.php"); |
Пример 3:
Необходимо создать свободный блок с параметрами:
• Вывод тела свободного блока в переменную.
• Без оформления.
• По номеру блока в базе данных
1 |
global $blockg; |
2 |
ob_start(); |
3 |
blocks("plzreturn", 15); |
4 |
$blockg["15"] = ob_get_clean(); |
• С использованием имени блока:
1 |
global $blockg; |
2 |
$blockg["menu2"] = blocks("plzreturn", "block-menu2.php"); |
Пример 4:
Необходимо создать свободный блок с параметрами:
• Вывод тела свободного блока в переменную.
• С оформлением.
• По номеру блока в базе данных.
1 |
global $blockg; |
2 |
ob_start(); |
3 |
blocks("oreturnform", 15); |
4 |
$blockg["15"] = ob_get_clean(); |
• С использованием имени блока.
1 |
global $blockg; |
2 |
$blockg["menu2"] = blocks("oreturnform", "block-menu2.php"); |
Для вывода на страницу переменной, содержащей в себе тело свободного блока, необходимо сделать следующее:
Открываем файл config/config_header.php и в него вставляем код:
Открываем файл config/config_header.php и в него вставляем код:
1 |
global $blockg; |
2 |
$blockg["menu2"] = blocks("plzreturn", "block-menu2.php"); |
В любое место шаблона (в templates/ваша_тема/index.html, например) вставляем массив $blockg[menu2] (обратите внимание на отсутствие кавычек внутри квадратных скобок!) На страницу вместо $blockg[menu2] будет выведен блок menu2, код которого содержится в файле blocks/block-menu2.php.
Для корректного вывода на страничку свободного блока, который из базы данных запрашивается по bid из таблицы преф_blocks, при включённом модуле rss_info (вывод новостей в формате RSS) необходимо в php-файл config/config_header.php записать:
Для корректного вывода на страничку свободного блока, который из базы данных запрашивается по bid из таблицы преф_blocks, при включённом модуле rss_info (вывод новостей в формате RSS) необходимо в php-файл config/config_header.php записать:
1 |
global $blockg; |
2 |
$blockg["menu2"] = blocks("plzreturn", "block-menu2.php"); |
3 |
ob_start(); |
4 |
blocks("none", 15); |
5 |
$blockg["15"] = ob_get_clean(); |
Свободный блок может выводиться на страницы сайта на всём сайте, если его код встроен в тему оформления, или он может выводиться в каком-то определённом модуле, если его код встроен в код этого модуля.
Свободный блок не может быть обработан системой как стандартный блок, но стандартный блок может быть обработан системой как свободный блок. Пример: блок modules, имеющий bid 1 (таблица slaed_blocks), можно вывести на страничку ещё раз как свободный блок, и тогда на этот блок накладываются все те ограничения, которые наложены на блок modules (показывать только на главной страничке сайта или только в одном модуле или в выбранных модулях или во всех модулях).
Изменение файла блока
Для редактирования файла файлового блока перейдите во вкладку «Редактировать блок» и выберите нужный для редактирования файл.
Изменение блока
Во вкладке «Главная» в столбце «Функции» перейдите по значению (Полное редактирование) – отобразится форма редактирования блока.
Изменение положения блока
Во вкладке «Главная» в столбце «Положение» при помощи стрелок меняйте положение блока. Выбранная позиция блока выводится в столбце «Позиция».
Свободный блок не может быть обработан системой как стандартный блок, но стандартный блок может быть обработан системой как свободный блок. Пример: блок modules, имеющий bid 1 (таблица slaed_blocks), можно вывести на страничку ещё раз как свободный блок, и тогда на этот блок накладываются все те ограничения, которые наложены на блок modules (показывать только на главной страничке сайта или только в одном модуле или в выбранных модулях или во всех модулях).
Изменение файла блока
Для редактирования файла файлового блока перейдите во вкладку «Редактировать блок» и выберите нужный для редактирования файл.
Изменение блока
Во вкладке «Главная» в столбце «Функции» перейдите по значению (Полное редактирование) – отобразится форма редактирования блока.
Изменение положения блока
Во вкладке «Главная» в столбце «Положение» при помощи стрелок меняйте положение блока. Выбранная позиция блока выводится в столбце «Позиция».
