Same filename and directory in other branches
  1. 5.0.x views_slideshow.theme.inc 1 commentaire
  2. 8.x-3.x views_slideshow.theme.inc 1 commentaire
  3. 8.x-4.x views_slideshow.theme.inc 1 commentaire

The theme system, which controls the output of views slideshow.

Fichier

theme/views_slideshow.theme.inc

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.