Same filename and directory in other branches
The theme system, which controls the output of views slideshow.
Fichier
View source
<?php
/**
* @file
* The theme system, which controls the output of views slideshow.
*/
/**
* @defgroup vss_templates Templates
* @{
* Slideshow and component templates.
*
* @see vss_theme
* @}
*/
/**
* @defgroup vss_theme Theme Functions
* @{
* Theme processing and display generation.
*
* Most of the logic behind the generation of the slideshow is here.
*
* @see vss_templates
*/
/**
* Implements hook_preprocess_views_slideshow().
*/
function template_preprocess_views_slideshow(&$vars) {
$options = $vars['options'];
$vars['skin'] = 'default';
$vars['slideshow'] = '';
$main_frame_module = $options['slideshow_type'];
if (empty($main_frame_module)) {
// Get all slideshow types.
$slideshows = module_invoke_all('views_slideshow_slideshow_info');
if ($slideshows) {
foreach ($slideshows as $slideshow_id => $slideshow_info) {
$main_frame_module = $slideshow_id;
break;
}
}
}
// Make sure the main slideshow settings are defined before building the
// slideshow.
if (empty($main_frame_module)) {
drupal_set_message(t('No main frame module is enabled for views slideshow. This is often because another module which Views Slideshow needs is not enabled. For example, 3.x needs a module like "Views Slideshow: Cycle" enabled.'), 'error');
}
elseif (empty($options[$main_frame_module])) {
drupal_set_message(t('The options for !module does not exists.', array(
'!module' => $main_frame_module,
)), 'error');
}
elseif (!empty($vars['rows'])) {
$settings = $options[$main_frame_module];
$view = $vars['view'];
$rows = $vars['rows'];
$vss_id = $view->name . '-' . $view->current_display;
// Give each slideshow a unique id if there are more than one on the page.
static $instances = array();
if (isset($instances[$vss_id])) {
$instances[$vss_id]++;
$vss_id .= "_" . $instances[$vss_id];
}
else {
$instances[$vss_id] = 1;
$vss_id .= '_1';
}
// Building our default methods.
$methods = array(
'goToSlide' => array(),
'nextSlide' => array(),
'pause' => array(),
'play' => array(),
'previousSlide' => array(),
'transitionBegin' => array(),
'transitionEnd' => array(),
);
// Pull all widget info and slideshow info and merge them together.
$widgets = module_invoke_all('views_slideshow_widget_info');
$slideshows = module_invoke_all('views_slideshow_slideshow_info');
$addons = array_merge($widgets, $slideshows);
// Loop through all the addons and call their methods if needed.
foreach ($addons as $addon_id => $addon_info) {
foreach ($addon_info['accepts'] as $imp_key => $imp_value) {
if (is_array($imp_value)) {
$methods[$imp_key][] = views_slideshow_format_addons_name($addon_id);
}
else {
$methods[$imp_value][] = views_slideshow_format_addons_name($addon_id);
}
}
}
$js_settings = array(
'viewsSlideshow' => array(
$vss_id => array(
'methods' => $methods,
'paused' => 0,
),
),
);
drupal_add_library('views_slideshow', 'views_slideshow');
drupal_add_js($js_settings, 'setting');
// Process Skins.
$skin_info = array();
if (isset($options['skin_info'])) {
$skin_info = $options['skin_info'];
}
// Make sure $skin_info has all the values.
$skin_info += array(
'class' => 'default',
'name' => t('Untitled skin'),
'module' => 'views_slideshow',
'path' => '',
'stylesheets' => array(),
);
$vars['skin'] = $skin_info['class'];
// Enqueue any stylesheets set for the skin on this view are added.
$skin_path = drupal_get_path('module', $skin_info['module']);
if ($skin_info['path']) {
$skin_path .= '/' . $skin_info['path'];
}
// Add stylesheet.
if (!empty($skin_info['stylesheets'])) {
foreach ($skin_info['stylesheets'] as $stylesheet) {
drupal_add_css($skin_path . '/' . $stylesheet);
}
}
// Process Widgets.
// Build weights.
for ($i = 1; $i <= count($widgets); $i++) {
$weight['top'][$i] = array();
$weight['bottom'][$i] = array();
}
foreach ($widgets as $widget_id => $widget_name) {
// Put our widgets in the right location.
if ($options['widgets']['top'][$widget_id]['enable']) {
$widget_weight = $options['widgets']['top'][$widget_id]['weight'] > count($widgets) ? count($widgets) : $options['widgets']['top'][$widget_id]['weight'];
$weight['top'][$widget_weight][] = $widget_id;
}
if ($options['widgets']['bottom'][$widget_id]['enable']) {
$widget_weight = $options['widgets']['bottom'][$widget_id]['weight'] > count($widgets) ? count($widgets) : $options['widgets']['bottom'][$widget_id]['weight'];
$weight['bottom'][$widget_weight][] = $widget_id;
}
}
// Build our widgets.
foreach ($weight as $location => $order) {
$vars[$location . '_widget_rendered'] = '';
foreach ($order as $order_num => $widgets) {
if (is_array($widgets)) {
foreach ($widgets as $widget_id) {
$vars[$widget_id . '_' . $location] = theme(views_theme_functions($widget_id . '_widget_render', $view, $view->display[$view->current_display]), array(
'vss_id' => $vss_id,
'view' => $view,
'settings' => $options['widgets'][$location][$widget_id],
'location' => $location,
'rows' => $rows,
));
$vars[$location . '_widget_rendered'] .= $vars[$widget_id . '_' . $location];
}
}
}
}
// Process Slideshow.
$slides = theme(views_theme_functions($main_frame_module . '_main_frame', $view, $view->display[$view->current_display]), array(
'vss_id' => $vss_id,
'view' => $view,
'settings' => $settings,
'rows' => $rows,
'options' => $options,
));
$vars['slideshow'] = theme(views_theme_functions('views_slideshow_main_section', $view, $view->display[$view->current_display]), array(
'vss_id' => $vss_id,
'slides' => $slides,
'plugin' => $main_frame_module,
));
}
}
/**
* The current element of the slideshow.
*
* @param array $vars
* Theme variables.
*
* @return string
* The html string for the slideshow element.
*/
function theme_views_slideshow_main_section($vars) {
return '<div id="' . $vars['plugin'] . '_main_' . $vars['vss_id'] . '" class="' . $vars['plugin'] . '_main views_slideshow_main">' . $vars['slides'] . '</div>';
}
/**
* Views Slideshow: pager.
*
* @param array $vars
* Theme variables.
*
* @return string
* The html string for the pager widget or an empty string if disabled.
*/
function theme_views_slideshow_pager_widget_render($vars) {
if (isset($vars['settings']['hide_on_single_slide']) && $vars['settings']['hide_on_single_slide'] === 1 && count($vars['rows']) < 2) {
return '';
}
// Add JavaScript settings for the pager type.
$js_vars = array(
'viewsSlideshowPager' => array(
$vars['vss_id'] => array(
$vars['location'] => array(
'type' => views_slideshow_format_addons_name($vars['settings']['type']),
'master_pager' => views_slideshow_format_addons_name($vars['settings']['master_pager']),
),
),
),
);
drupal_add_library('views_slideshow', 'views_slideshow');
drupal_add_js($js_vars, 'setting');
// Create some attributes.
$attributes['class'] = 'widget_pager widget_pager_' . $vars['location'];
$attributes['id'] = 'widget_pager_' . $vars['location'] . '_' . $vars['vss_id'];
return theme(views_theme_functions($vars['settings']['type'], $vars['view'], $vars['view']->display[$vars['view']->current_display]), array(
'vss_id' => $vars['vss_id'],
'view' => $vars['view'],
'settings' => $vars['settings'],
'location' => $vars['location'],
'attributes' => $attributes,
));
}
/**
* Theme pager fields.
*
* @param array $vars
* Theme variables.
*/
function template_preprocess_views_slideshow_pager_fields(&$vars) {
// Build our JavaScript settings.
$js_vars = array(
'viewsSlideshowPagerFields' => array(
$vars['vss_id'] => array(
$vars['location'] => array(
'activatePauseOnHover' => $vars['settings']['views_slideshow_pager_fields_hover'],
),
),
),
);
// Add the settings to the page.
drupal_add_library('views_slideshow', 'views_slideshow');
drupal_add_js($js_vars, 'setting');
// Add hover intent library.
if ($vars['settings']['views_slideshow_pager_fields_hover']) {
if (module_exists('libraries')) {
// Load jQuery hoverIntent.
$hoverIntent_path = libraries_get_path('jquery.hoverIntent');
if (!empty($hoverIntent_path) && file_exists($hoverIntent_path . '/jquery.hoverIntent.js')) {
drupal_add_js($hoverIntent_path . '/jquery.hoverIntent.js');
}
}
}
$vars['classes_array'][] = $vars['attributes']['class'];
$vars['widget_id'] = $vars['attributes']['id'];
// Add our class to the wrapper.
$vars['classes_array'][] = 'views_slideshow_pager_field';
// Render all the fields unless there is only 1 slide and the user specified
// to hide them when there is only one slide.
$items_per_slide = isset($vars['view']->style_options['views_slideshow_cycle']['items_per_slide']) ? $vars['view']->style_options['views_slideshow_cycle']['items_per_slide'] : null;
$vars['rendered_field_items'] = '';
if (empty($vars['settings']['hide_on_single_slide']) || count($vars['view']->result) > $items_per_slide) {
foreach ($vars['view']->result as $count => $node) {
$rendered_fields = '';
foreach ($vars['settings']['views_slideshow_pager_fields_fields'] as $field => $use) {
if ($use !== 0 && is_object($vars['view']->field[$field])) {
$rendered_fields .= theme(views_theme_functions('views_slideshow_pager_field_field', $vars['view'], $vars['view']->display[$vars['view']->current_display]), array(
'view' => $vars['view'],
'field' => $field,
'count' => $count,
));
}
}
$vars['rendered_field_items'] .= theme(views_theme_functions('views_slideshow_pager_field_item', $vars['view'], $vars['view']->display[$vars['view']->current_display]), array(
'vss_id' => $vars['vss_id'],
'item' => $rendered_fields,
'count' => $count,
'location' => $vars['location'],
'length' => count($vars['view']->result),
));
}
}
}
/**
* Views Slideshow: pager item.
*
* @param array $vars
* Theme variables.
*/
function template_preprocess_views_slideshow_pager_field_item(&$vars) {
$vars['classes_array'][] = 'views_slideshow_pager_field_item';
$vars['classes_array'][] = $vars['count'] % 2 ? 'views-row-even' : 'views-row-odd';
if ($vars['count'] == 0) {
$vars['classes_array'][] = 'views-row-first';
}
elseif ($vars['count'] == $vars['length'] - 1) {
$vars['classes_array'][] = 'views-row-last';
}
}
/**
* Views Slideshow: pager field item field.
*
* @param array $vars
* Theme variables.
*/
function template_preprocess_views_slideshow_pager_field_field(&$vars) {
$view = $vars['view'];
$vars['field_item'] = $view->field[$vars['field']];
$vars['field_rendered'] = $view->style_plugin->rendered_fields[$vars['count']][$vars['field']];
$vars['css_id'] = drupal_clean_css_identifier($vars['field_item']->field);
if (!strstr($vars['field_rendered'], '<a')) {
$vars['field_rendered'] = "<a href='#slideshow-{$vars['count']}'>{$vars['field_rendered']}</a>";
}
}
/**
* Views Slideshow: Controls.
*
* @param array $vars
* Theme variables.
*
* @return string
* The html string for the control widget.
*/
function theme_views_slideshow_controls_widget_render($vars) {
// Add JavaScript settings for the controls type.
$js_vars = array(
'viewsSlideshowControls' => array(
$vars['vss_id'] => array(
$vars['location'] => array(
'type' => views_slideshow_format_addons_name($vars['settings']['type']),
),
),
),
);
drupal_add_library('views_slideshow', 'views_slideshow');
drupal_add_js($js_vars, 'setting');
$items_per_slide = isset($vars['view']->style_options['views_slideshow_cycle']['items_per_slide']) ? $vars['view']->style_options['views_slideshow_cycle']['items_per_slide'] : null;
$output = '';
if (empty($vars['settings']['hide_on_single_slide']) || count($vars['rows']) > $items_per_slide) {
$output = theme(views_theme_functions($vars['settings']['type'], $vars['view'], $vars['view']->display[$vars['view']->current_display]), array(
'vss_id' => $vars['vss_id'],
'view' => $vars['view'],
'settings' => $vars['settings'],
'location' => $vars['location'],
'rows' => $vars['rows'],
));
}
return $output;
}
/**
* The slideshow controls.
*
* @param array $vars
* Theme variables.
*/
function template_preprocess_views_slideshow_controls_text(&$vars) {
$module_path = drupal_get_path('module', 'views_slideshow');
drupal_add_css($module_path . '/views_slideshow_controls_text.css', array(
'type' => 'file',
));
$vars['classes_array'][] = 'views_slideshow_controls_text';
$vars['rendered_control_previous'] = theme(views_theme_functions('views_slideshow_controls_text_previous', $vars['view'], $vars['view']->display[$vars['view']->current_display]), array(
'vss_id' => $vars['vss_id'],
'view' => $vars['view'],
'settings' => $vars['settings'],
));
$vars['rendered_control_pause'] = theme(views_theme_functions('views_slideshow_controls_text_pause', $vars['view'], $vars['view']->display[$vars['view']->current_display]), array(
'vss_id' => $vars['vss_id'],
'view' => $vars['view'],
'settings' => $vars['settings'],
));
$vars['rendered_control_next'] = theme(views_theme_functions('views_slideshow_controls_text_next', $vars['view'], $vars['view']->display[$vars['view']->current_display]), array(
'vss_id' => $vars['vss_id'],
'view' => $vars['view'],
'settings' => $vars['settings'],
));
}
/**
* Views Slideshow: "previous" control.
*
* @param array $vars
* Theme variables.
*/
function template_preprocess_views_slideshow_controls_text_previous(&$vars) {
$vars['classes_array'][] = 'views_slideshow_controls_text_previous';
}
/**
* Views Slideshow: "pause" control.
*
* @param array $vars
* Theme variables.
*/
function template_preprocess_views_slideshow_controls_text_pause(&$vars) {
$vars['classes_array'][] = 'views_slideshow_controls_text_pause views-slideshow-controls-text-status-play';
$vars['start_text'] = t('Pause');
}
/**
* Views Slideshow: "next" control.
*
* @param array $vars
* Theme variables.
*/
function template_preprocess_views_slideshow_controls_text_next(&$vars) {
$vars['classes_array'][] = 'views_slideshow_controls_text_next';
}
/**
* Views Slideshow: Slide Counter.
*
* @param array $vars
* Theme variables.
*
* @return string
* The html string for the counter widget.
*/
function theme_views_slideshow_slide_counter_widget_render($vars) {
return theme(views_theme_functions('views_slideshow_slide_counter', $vars['view'], $vars['view']->display[$vars['view']->current_display]), array(
'vss_id' => $vars['vss_id'],
'view' => $vars['view'],
'settings' => $vars['settings'],
'location' => $vars['location'],
'rows' => $vars['rows'],
));
}
/**
* Views Slideshow: slide counter.
*
* @param array $vars
* Theme variables.
*/
function template_preprocess_views_slideshow_slide_counter(&$vars) {
$vars['classes_array'][] = 'views_slideshow_slide_counter';
$vars['slide_count'] = count($vars['rows']);
}
/**
* Backwards compatibility wrapper.
*
* @param array $vars
* Theme variables.
*
* @deprecated Removed in 3.5 when the hook_theme() implementation was fixed.
*
* @see template_preprocess_views_slideshow().
*/
function _views_slideshow_preprocess_views_slideshow(&$vars) {
template_preprocess_views_slideshow($vars);
}
/**
* Backwards compatibility wrapper.
*
* @param array $vars
* Theme variables.
*
* @deprecated Removed in 3.5 when the hook_theme() implementation was fixed.
*
* @see template_preprocess_views_slideshow_pager_fields().
*/
function _views_slideshow_preprocess_views_slideshow_pager_fields(&$vars) {
template_preprocess_views_slideshow_pager_fields($vars);
}
/**
* Backwards compatibility wrapper.
*
* @param array $vars
* Theme variables.
*
* @param array $vars
* Theme variables.
*
* @deprecated Removed in 3.5 when the hook_theme() implementation was fixed.
*
* @see template_preprocess_views_slideshow_pager_field_item().
*/
function _views_slideshow_preprocess_views_slideshow_pager_field_item(&$vars) {
template_preprocess_views_slideshow_pager_field_item($vars);
}
/**
* Backwards compatibility wrapper.
*
* @param array $vars
* Theme variables.
*
* @deprecated Removed in 3.5 when the hook_theme() implementation was fixed.
*
* @see template_preprocess_views_slideshow_controls_text().
*/
function _views_slideshow_preprocess_views_slideshow_controls_text(&$vars) {
template_preprocess_views_slideshow_controls_text($vars);
}
/**
* Backwards compatibility wrapper.
*
* @param array $vars
* Theme variables.
*
* @see template_preprocess_views_slideshow_controls_text_previous().
*/
function _views_slideshow_preprocess_views_slideshow_controls_text_previous(&$vars) {
template_preprocess_views_slideshow_controls_text_previous($vars);
}
/**
* Backwards compatibility wrapper.
*
* @param array $vars
* Theme variables.
*
* @deprecated Removed in 3.5 when the hook_theme() implementation was fixed.
*
* @see template_preprocess_views_slideshow_controls_text_pause().
*/
function _views_slideshow_preprocess_views_slideshow_controls_text_pause(&$vars) {
template_preprocess_views_slideshow_controls_text_pause($vars);
}
/**
* Backwards compatibility wrapper.
*
* @param array $vars
* Theme variables.
*
* @deprecated Removed in 3.5 when the hook_theme() implementation was fixed.
*
* @see template_preprocess_views_slideshow_controls_text_next().
*/
function _views_slideshow_preprocess_views_slideshow_controls_text_next(&$vars) {
template_preprocess_views_slideshow_controls_text_next($vars);
}
/**
* Backwards compatibility wrapper.
*
* @param array $vars
* Theme variables.
*
* @deprecated Removed in 3.5 when the hook_theme() implementation was fixed.
*
* @see template_preprocess_views_slideshow_slide_counter().
*/
function _views_slideshow_preprocess_views_slideshow_slide_counter(&$vars) {
template_preprocess_views_slideshow_slide_counter($vars);
}
/**
* @} End of "defgroup vss_theme".
*/
Functions
Titre | Deprecated | Résumé |
---|---|---|
template_preprocess_views_slideshow | Implements hook_preprocess_views_slideshow(). | |
template_preprocess_views_slideshow_controls_text | The slideshow controls. | |
template_preprocess_views_slideshow_controls_text_next | Views Slideshow: "next" control. | |
template_preprocess_views_slideshow_controls_text_pause | Views Slideshow: "pause" control. | |
template_preprocess_views_slideshow_controls_text_previous | Views Slideshow: "previous" control. | |
template_preprocess_views_slideshow_pager_fields | Theme pager fields. | |
template_preprocess_views_slideshow_pager_field_field | Views Slideshow: pager field item field. | |
template_preprocess_views_slideshow_pager_field_item | Views Slideshow: pager item. | |
template_preprocess_views_slideshow_slide_counter | Views Slideshow: slide counter. | |
theme_views_slideshow_controls_widget_render | Views Slideshow: Controls. | |
theme_views_slideshow_main_section | The current element of the slideshow. | |
theme_views_slideshow_pager_widget_render | Views Slideshow: pager. | |
theme_views_slideshow_slide_counter_widget_render | Views Slideshow: Slide Counter. | |
_views_slideshow_preprocess_views_slideshow | Removed in 3.5 when the hook_theme() implementation was fixed. |
Backwards compatibility wrapper. |
_views_slideshow_preprocess_views_slideshow_controls_text | Removed in 3.5 when the hook_theme() implementation was fixed. |
Backwards compatibility wrapper. |
_views_slideshow_preprocess_views_slideshow_controls_text_next | Removed in 3.5 when the hook_theme() implementation was fixed. |
Backwards compatibility wrapper. |
_views_slideshow_preprocess_views_slideshow_controls_text_pause | Removed in 3.5 when the hook_theme() implementation was fixed. |
Backwards compatibility wrapper. |
_views_slideshow_preprocess_views_slideshow_controls_text_previous | Backwards compatibility wrapper. | |
_views_slideshow_preprocess_views_slideshow_pager_fields | Removed in 3.5 when the hook_theme() implementation was fixed. |
Backwards compatibility wrapper. |
_views_slideshow_preprocess_views_slideshow_pager_field_item | Removed in 3.5 when the hook_theme() implementation was fixed. |
Backwards compatibility wrapper. |
_views_slideshow_preprocess_views_slideshow_slide_counter | Removed in 3.5 when the hook_theme() implementation was fixed. |
Backwards compatibility wrapper. |