Слайдер на всех страницах сайтах (bxslider) XSLT — различия между версиями
Stexe (обсуждение | вклад) |
Stexe (обсуждение | вклад) |
||
(не показана 1 промежуточная версия этого же участника) | |||
Строка 43: | Строка 43: | ||
if ($item instanceof iUmiHierarchyElement){ | if ($item instanceof iUmiHierarchyElement){ | ||
$image = $item->getValue('slider_item_image'); | $image = $item->getValue('slider_item_image'); | ||
− | $item_arr['@image'] = $image->getFilePath(); | + | $item_arr['@image'] = '/'.$image->getFilePath(); |
$item_arr['@name'] = $item->getName(); | $item_arr['@name'] = $item->getName(); | ||
$item_arr['@link'] = $item->getValue('slider_item_link'); | $item_arr['@link'] = $item->getValue('slider_item_link'); | ||
Строка 117: | Строка 117: | ||
<li>Поле "Отображать надписи" включает/выключает надписи под изображениями</li> | <li>Поле "Отображать надписи" включает/выключает надписи под изображениями</li> | ||
</ul> | </ul> | ||
+ | <br/> | ||
+ | <center>[[Файл:Slider.png]]</center> |
Текущая версия на 11:58, 24 сентября 2013
Задача: Реализовать вывод слайд-шоу на всех страницах сайта, путем интеграции стороннего слайдера bxslider с системой UMI.CMS.
Реализация:
Необходимые для работы слайдера файлы можно скачать по ссылке Файл:Bxslider.zip
Работа в административной части
В модуле "Шаблоны данных" создадим два подтипа (дочерний тип) типа данных "Страница контента":
- Первый тип данных: Название типа - "Слайдер". В данном типе данных создадим группу полей "Настройки слайдера", в котором должны присутствовать следующие поля:
- Поле "Автоматической переключение" типа "Кнопка-флажок" с идентификатором slider_auto
- Поле "Случайный слайд" типа "Кнопка-флажок" с идентификатором slider_random
- Поле "Отображать надписи" типа "Кнопка-флажок" с идентификатором slider_captions
- Второй тип данных: Название типа - "Элемент слайдера". В данном типе данных создадим группу полей "Слайдер", в котором должны присутствовать следующие поля:
- Поле "Изображение" типа "Изображение" с идентификатором slider_item_image
- Поле "Ссылка для элемента" типа "Строка" с идентификатором slider_item_link и форматом значения Web-адрес
В модуле "Структура" добавим страницу с именем "Слайдер" и выберем для нее тип данных "Слайдер". Для страницы "Слайдер" добавим подстраницы и выберем для каждой из них тип данных "Элемент слайдера". Каждая добавленная подстраница будет являться отдельным слайдом. Для поля "Изображение" нужно выбрать картинку для отдельного слайда, в поле "Ссылка для элемента" - ссылку, по которой будет осуществляется переход при нажатии на картинку слайда.
Добавление custom макросов
Далее, в файл classes\modules\custom.php добавим определение двух макросов: getSliderItems() и bxSlider().
- getSliderItems($parent_id, $template = "default") - возвращает данные для верстки блока слайдера ($parent_id - id страницы "Слайдер")
- bxSlider($parent_id) - возвращает скрипт для работы слайдера с установленными настройками ($parent_id - id страницы "Слайдер")
public function getSliderItems($parent_id, $template = "default"){
if (!$parent_id)
return 'Parent page id is not set';
list($template_items, $template_item) = def_module::loadTemplates("data/slider/" . $template, "items", "item");
$umiHierarchy = umiHierarchy::getInstance();
$childs_arr = $umiHierarchy->getChildIds($parent_id, false);
$item_arr = array();
$items_arr = array();
foreach ($childs_arr as $item_id){
$item = $umiHierarchy->getElement($item_id);
if ($item instanceof iUmiHierarchyElement){
$image = $item->getValue('slider_item_image');
$item_arr['@image'] = '/'.$image->getFilePath();
$item_arr['@name'] = $item->getName();
$item_arr['@link'] = $item->getValue('slider_item_link');
$items_arr[] = def_module::parseTemplate($template_item, $item_arr);
}
}
$items_arr = array('subnodes:items' => $items_arr);
return def_module::parseTemplate($template_items, $items_arr);
}
public function bxSlider($parent_id){
if (!$parent_id)
return 'Parent page id is not set';
$slider = umiHierarchy::getInstance()->getElement($parent_id);
$auto = ($slider->getValue('slider_auto') ? 'true': 'false');
$random = ($slider->getValue('slider_random') ? 'true': 'false');
$captions = ($slider->getValue('slider_captions') ? 'true': 'false');
$result = <<<END
<script>
$(document).ready(function(){
$('.bxslider').bxSlider({
mode: 'fade',
captions: {$captions},
auto: {$auto},
randomStart: {$random}
});
});
</script>
END;
return $result;
}
Верстка шаблонов
Необходимые для работы слайдера файлы можно скачать по ссылке Файл:Bxslider.zip
Из скаченного Вами архива, CSS файл нужно поместить в директорию /css/bxslider, изображения из папки images в директорию /images/bxslider и JS файл в директорию /js/bxslider.
В шаблоне, перед закрывающимся тегом </head> (в "demodizzy" в файле templates\demodizzy\xslt\layouts\default.xsl) нужно подключить js библиотеку слайдера bxslider, CSS файл для слайдера и добавить вызов custom макроса bxSlider():
<script type="text/javascript" src="/templates/demodizzy/js/bxslider/jquery.bxslider.min.js"></script>
<link type="text/css" rel="stylesheet" href="/templates/demodizzy/css/bxslider/jquery.bxslider.css" />
<xsl:value-of select="document('udata://custom/bxSlider/2158')/udata" disable-output-escaping="yes"/>
В данном случае приведено подключение файлов для демонстрационного интернет-магазина "Современный" ("demodizzy"). Если у Вас отсутствует директория /templates, то файлы из архива можно разместить в корневых директориях. В первом параметре макроса bxSlider() нужно указать id страницы "Слайдер", то есть вместо id 2158 нужно указать Ваш id.
В шаблоне между тегами <body> в том месте, где должен быть выведен слайдер, нужно добавить следующий код:
<div id="top_menu">
<ul class="bxslider">
<xsl:apply-templates select="document('udata://custom/getSliderItems/2158')/udata/items/item" mode="bxslider"/>
</ul>
</div>
Вместо указания в первом параметре id 2158 нужно указать Ваш id страницы страницы "Слайдер".
И наконец, добавим шаблон для обработки результатов макроса getSliderItems().
<xsl:template match="item" mode="bxslider">
<li>
<a href="{@link}">
<img src="{@image}" title="{@name}" width="auto" height="200"/>
</a>
</li>
</xsl:template>
Размеры изображений слайдов можно задать в атрибутах тега <img>: width и height.
На странице "Слайдер" в группе полей "Настройки слайдера" можно изменять настройки слайдера bxSlider:
- Поле "Автоматической переключение" отвечает за автоматическое переключение слайдов
- Поле "Случайный слайд" отвечает за показ случайного слайда
- Поле "Отображать надписи" включает/выключает надписи под изображениями