class views_plugin_display_block

The plugin that handles a block.

Hierarchy

Expanded class hierarchy of views_plugin_display_block

Related topics

1 string reference to 'views_plugin_display_block'
views_views_plugins in includes/plugins.inc
Implements hook_views_plugins().

File

plugins/views_plugin_display_block.inc, line 13

View source
class views_plugin_display_block extends views_plugin_display {
    
    /**
     * {@inheritdoc}
     */
    public function option_definition() {
        $options = parent::option_definition();
        $options['block_description'] = array(
            'default' => '',
            'translatable' => TRUE,
        );
        $options['block_caching'] = array(
            'default' => DRUPAL_NO_CACHE,
        );
        return $options;
    }
    
    /**
     * The default block handler doesn't support configurable items,
     * but extended block handlers might be able to do interesting
     * stuff with it.
     */
    public function execute_hook_block_list($delta = 0, $edit = array()) {
        $delta = $this->view->name . '-' . $this->display->id;
        $desc = $this->get_option('block_description');
        if (empty($desc)) {
            if ($this->display->display_title == $this->definition['title']) {
                $desc = t('View: !view', array(
                    '!view' => $this->view
                        ->get_human_name(),
                ));
            }
            else {
                $desc = t('View: !view: !display', array(
                    '!view' => $this->view
                        ->get_human_name(),
                    '!display' => $this->display->display_title,
                ));
            }
        }
        return array(
            $delta => array(
                'info' => $desc,
                'cache' => $this->get_cache_type(),
            ),
        );
    }
    
    /**
     * The display block handler returns the structure necessary for a block.
     */
    public function execute() {
        // Prior to this being called, the $view should already be set to this
        // display, and arguments should be set on the view.
        $info['content'] = $this->view
            ->render();
        $title = $this->view
            ->get_title();
        $info['subject'] = $title == '<none>' ? '' : filter_xss_admin($title);
        if (!empty($this->view->result) || $this->get_option('empty') || !empty($this->view->style_plugin->definition['even empty'])) {
            return $info;
        }
    }
    
    /**
     * Provide the summary for page options in the views UI.
     *
     * This output is returned as an array.
     */
    public function options_summary(&$categories, &$options) {
        // It is very important to call the parent function here.
        parent::options_summary($categories, $options);
        $categories['block'] = array(
            'title' => t('Block settings'),
            'column' => 'second',
            'build' => array(
                '#weight' => -10,
            ),
        );
        $block_description = strip_tags($this->get_option('block_description'));
        if (empty($block_description)) {
            $block_description = t('None');
        }
        $options['block_description'] = array(
            'category' => 'block',
            'title' => t('Block name'),
            'value' => views_ui_truncate($block_description, 24),
        );
        $types = $this->block_caching_modes();
        $options['block_caching'] = array(
            'category' => 'other',
            'title' => t('Block caching'),
            'value' => $types[$this->get_cache_type()],
        );
    }
    
    /**
     * Provide a list of core's block caching modes.
     */
    public function block_caching_modes() {
        return array(
            DRUPAL_NO_CACHE => t('Do not cache'),
            DRUPAL_CACHE_GLOBAL => t('Cache once for everything (global)'),
            DRUPAL_CACHE_PER_PAGE => t('Per page'),
            DRUPAL_CACHE_PER_ROLE => t('Per role'),
            DRUPAL_CACHE_PER_ROLE | DRUPAL_CACHE_PER_PAGE => t('Per role per page'),
            DRUPAL_CACHE_PER_USER => t('Per user'),
            DRUPAL_CACHE_PER_USER | DRUPAL_CACHE_PER_PAGE => t('Per user per page'),
        );
    }
    
    /**
     * Provide a single method to figure caching type, keeping a sensible default
     * for when it's unset.
     */
    public function get_cache_type() {
        $cache_type = $this->get_option('block_caching');
        if (empty($cache_type)) {
            $cache_type = DRUPAL_NO_CACHE;
        }
        return $cache_type;
    }
    
    /**
     * Provide the default form for setting options.
     */
    public function options_form(&$form, &$form_state) {
        // It is very important to call the parent function here.
        parent::options_form($form, $form_state);
        switch ($form_state['section']) {
            case 'block_description':
                $form['#title'] .= t('Block admin description');
                $form['block_description'] = array(
                    '#type' => 'textfield',
                    '#description' => t('This will appear as the name of this block in administer >> structure >> blocks.'),
                    '#default_value' => $this->get_option('block_description'),
                );
                break;
            case 'block_caching':
                $form['#title'] .= t('Block caching type');
                $form['block_caching'] = array(
                    '#type' => 'radios',
                    '#description' => t("This sets the default status for Drupal's built-in block caching method; this requires that caching be turned on in block administration, and be careful because you have little control over when this cache is flushed."),
                    '#options' => $this->block_caching_modes(),
                    '#default_value' => $this->get_cache_type(),
                );
                break;
            case 'exposed_form_options':
                $this->view
                    ->init_handlers();
                if (!$this->uses_exposed() && parent::uses_exposed()) {
                    $form['exposed_form_options']['warning'] = array(
                        '#weight' => -10,
                        '#markup' => '<div class="messages warning">' . t('Exposed filters in block displays require "Use AJAX" to be set to work correctly.') . '</div>',
                    );
                }
                break;
        }
    }
    
    /**
     * Perform any necessary changes to the form values prior to storage.
     * There is no need for this function to actually store the data.
     */
    public function options_submit(&$form, &$form_state) {
        // It is very important to call the parent function here.
        parent::options_submit($form, $form_state);
        switch ($form_state['section']) {
            case 'display_id':
                $this->update_block_bid($form_state['view']->name, $this->display->id, $this->display->new_id);
                break;
            case 'block_description':
                $this->set_option('block_description', $form_state['values']['block_description']);
                break;
            case 'block_caching':
                $this->set_option('block_caching', $form_state['values']['block_caching']);
                $this->save_block_cache($form_state['view']->name . '-' . $form_state['display_id'], $form_state['values']['block_caching']);
                break;
        }
    }
    
    /**
     * Block views use exposed widgets only if AJAX is set.
     */
    public function uses_exposed() {
        if ($this->use_ajax()) {
            return parent::uses_exposed();
        }
        return FALSE;
    }
    
    /**
     * Update the block delta when the machine name of the display changes.
     */
    public function update_block_bid($name, $old_delta, $delta) {
        $old_hashes = $hashes = variable_get('views_block_hashes', array());
        $old_delta = $name . '-' . $old_delta;
        $delta = $name . '-' . $delta;
        if (strlen($old_delta) >= 32) {
            $old_delta = md5($old_delta);
            unset($hashes[$old_delta]);
        }
        if (strlen($delta) >= 32) {
            $md5_delta = md5($delta);
            $hashes[$md5_delta] = $delta;
            $delta = $md5_delta;
        }
        // Maybe people don't have block module installed, so let's skip this.
        if (db_table_exists('block')) {
            db_update('block')->fields(array(
                'delta' => $delta,
            ))
                ->condition('delta', $old_delta)
                ->execute();
        }
        // Update the hashes if needed.
        if ($hashes != $old_hashes) {
            variable_set('views_block_hashes', $hashes);
        }
    }
    
    /**
     * Save the block cache setting in the blocks table if this block already
     * exists in the blocks table. Dirty fix until http://drupal.org/node/235673
     * gets in.
     */
    public function save_block_cache($delta, $cache_setting) {
        if (strlen($delta) >= 32) {
            $delta = md5($delta);
        }
        if (db_table_exists('block') && db_query("SELECT bid FROM {block} WHERE module = 'views' AND delta = :delta", array(
            ':delta' => $delta,
        ))->fetchField()) {
            db_update('block')->fields(array(
                'cache' => $cache_setting,
            ))
                ->condition('module', 'views')
                ->condition('delta', $delta)
                ->execute();
        }
    }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overriden Title Overrides
views_object::$definition public property Handler&#039;s definition.
views_object::$options public property Except for displays, options for the object will be held here. 1
views_object::altered_option_definition public function Collect this handler&#039;s option definition and alter them, ready for use.
views_object::construct public function Views handlers use a special construct function. 4
views_object::export_options public function
views_object::export_option_always public function Always exports the option, regardless of the default value.
views_object::options Deprecated public function Set default options on this object. 1
views_object::set_default_options public function Set default options.
views_object::set_definition public function Let the handler know what its full definition is.
views_object::unpack_options public function Unpack options over our existing defaults, drilling down into arrays so
that defaults don&#039;t get totally blown away.
views_object::unpack_translatable public function Unpack a single option definition.
views_object::unpack_translatables public function Unpacks each handler to store translatable texts.
views_object::_set_option_defaults public function
views_plugin::$display public property The current used views display.
views_plugin::$plugin_name public property The plugin name of this plugin, for example table or full.
views_plugin::$plugin_type public property The plugin type of this plugin, for example style or query.
views_plugin::additional_theme_functions public function Provide a list of additional theme functions for the theme info page.
views_plugin::plugin_title public function Return the human readable name of the display.
views_plugin::summary_title public function Returns the summary of the settings in the display. 8
views_plugin::theme_functions public function Provide a full list of possible theme templates used by this style.
views_plugin_display::$extender public property Stores all available display extenders.
views_plugin_display::$handlers public property List of handlers for this display.
views_plugin_display::$view public property The top object of a view. Overrides views_plugin::$view
views_plugin_display::accept_attachments public function Can this display accept attachments?
views_plugin_display::access public function Determine if the user has access to this display of the view.
views_plugin_display::attach_to public function Allow displays to attach to other views. 2
views_plugin_display::defaultable_sections public function List which sections are defaultable and what items each section contains. 1
views_plugin_display::destroy public function Destructor. Overrides views_object::destroy
views_plugin_display::displays_exposed public function Determine if this display should display the exposed filters widgets. 1
views_plugin_display::export_handler public function Special method to export items that have handlers.
views_plugin_display::export_option public function Override of export_option() Overrides views_object::export_option
views_plugin_display::export_plugin public function Special handling for plugin export.
views_plugin_display::export_style public function Special handling for the style export.
views_plugin_display::format_themes public function Format a list of theme templates for output by the theme info helper.
views_plugin_display::get_arguments_tokens public function Returns to tokens for arguments.
views_plugin_display::get_argument_text public function Provide some helpful text for the arguments. 1
views_plugin_display::get_field_labels public function List of fields for the current display with the associated relationship.
views_plugin_display::get_handler public function Get the handler object for a single handler.
views_plugin_display::get_handlers public function Get a full array of handlers for $type. This caches them.
views_plugin_display::get_link_display public function Check to see which display to use when creating links.
views_plugin_display::get_option public function Intelligently get an option either from this or default display.
views_plugin_display::get_pager_text public function Provide some helpful text for pagers. 1
views_plugin_display::get_path public function Return the base path to use for this display.
views_plugin_display::get_plugin public function Get the instance of a plugin, for example style or row.
views_plugin_display::get_special_blocks public function Provide the block system with any exposed widget blocks for this display.
views_plugin_display::get_style_type public function Displays can require a certain type of style plugin. 1
views_plugin_display::get_url public function
views_plugin_display::has_path public function Check to see if the display has a &#039;path&#039; field. 1
views_plugin_display::hook_block_list public function If this display creates a block, implement one of these.
views_plugin_display::hook_menu public function If this display creates a page with a menu item, implement it here.
views_plugin_display::init public function 1
views_plugin_display::is_defaulted public function Determine if a given option is set to use the default or current display.
views_plugin_display::is_default_display public function If this display is the &#039;default&#039; display which contains fallback settings. 1
views_plugin_display::is_identifier_unique public function Check if the provided identifier is unique.
views_plugin_display::options_override public function If override/revert was clicked, perform the proper toggle.
views_plugin_display::options_validate public function Validate the options form. Overrides views_plugin::options_validate 1
views_plugin_display::option_link public function Because forms may be split up into sections, this provides
an easy URL to exactly the right section. Don&#039;t override this.
views_plugin_display::override_option public function Set an option and force it to be an override.
views_plugin_display::preview public function Fully render the display. 1
views_plugin_display::pre_execute public function Set up any variables on the view prior to execution.
views_plugin_display::query public function Inject anything into the query that the display handler needs. Overrides views_plugin::query
views_plugin_display::render public function Render this display. 1
views_plugin_display::render_area public function
views_plugin_display::render_empty public function
views_plugin_display::render_filters public function Not all display plugins will support filtering.
views_plugin_display::render_footer public function Render the footer of the view.
views_plugin_display::render_header public function Render the header of the view.
views_plugin_display::render_more_link public function Render the &#039;more&#039; link.
views_plugin_display::render_pager public function Not all display plugins will suppert pager rendering. 1
views_plugin_display::set_option public function Intelligently set an option either from this display or from the
default display, if directed to do so.
views_plugin_display::set_override public function Flip the override setting for the given section.
views_plugin_display::unpack_handler public function Special method to unpack items that have handlers.
views_plugin_display::unpack_plugin public function Special handling for plugin unpacking.
views_plugin_display::unpack_style public function
views_plugin_display::uses_breadcrumb public function Check to see if the display needs a breadcrumb. 1
views_plugin_display::uses_exposed_form_in_block public function Check to see if the display can put the exposed form in a block.
views_plugin_display::uses_fields public function Determine if the display&#039;s style uses fields.
views_plugin_display::uses_link_display public function Check to see if the display has some need to link to another display. 1
views_plugin_display::use_ajax public function Does the display use AJAX?
views_plugin_display::use_group_by public function Does the display have groupby enabled?
views_plugin_display::use_more public function Does the display have a more link enabled?
views_plugin_display::use_more_always public function Should the enabled display more link be shown when no more items?
views_plugin_display::use_more_open_new_window public function Should the enabled display more link being opened in an new window?
views_plugin_display::use_more_text public function Does the display have custom link text?
views_plugin_display::use_pager public function Does the display have a pager enabled? 1
views_plugin_display::validate public function Make sure the display and all associated handlers are valid. Overrides views_plugin::validate 1
views_plugin_display::view_special_blocks public function Render any special blocks provided for this display.
views_plugin_display_block::block_caching_modes public function Provide a list of core&#039;s block caching modes.
views_plugin_display_block::execute public function The display block handler returns the structure necessary for a block. Overrides views_plugin_display::execute
views_plugin_display_block::execute_hook_block_list public function The default block handler doesn&#039;t support configurable items,
but extended block handlers might be able to do interesting
stuff with it.
views_plugin_display_block::get_cache_type public function Provide a single method to figure caching type, keeping a sensible default
for when it&#039;s unset.
views_plugin_display_block::options_form public function Provide the default form for setting options. Overrides views_plugin_display::options_form
views_plugin_display_block::options_submit public function Perform any necessary changes to the form values prior to storage.
There is no need for this function to actually store the data.
Overrides views_plugin_display::options_submit
views_plugin_display_block::options_summary public function Provide the summary for page options in the views UI. Overrides views_plugin_display::options_summary
views_plugin_display_block::option_definition public function Information about options for all kinds of purposes will be held here. Overrides views_plugin_display::option_definition
views_plugin_display_block::save_block_cache public function Save the block cache setting in the blocks table if this block already
exists in the blocks table. Dirty fix until http://drupal.org/node/235673
gets in.
views_plugin_display_block::update_block_bid public function Update the block delta when the machine name of the display changes.
views_plugin_display_block::uses_exposed public function Block views use exposed widgets only if AJAX is set. Overrides views_plugin_display::uses_exposed