class charts_plugin_display_chart in Charts 7.2
Display plugin to attach multiple chart configurations to the same chart.
Hierarchy
- class \views_object
- class \views_plugin
- class \views_plugin_display
- class \charts_plugin_display_chart
- class \views_plugin_display
- class \views_plugin
Expanded class hierarchy of charts_plugin_display_chart
1 string reference to 'charts_plugin_display_chart'
- charts_views_plugins in views/
charts.views.inc - Implementation of hook_views_plugins().
File
- views/
charts_plugin_display_chart.inc, line 12 - Contains the Chart display type (similar to Page, Block, Attachment, etc.)
View source
class charts_plugin_display_chart extends views_plugin_display {
function get_style_type() {
return 'chart';
}
function option_definition() {
$options = parent::option_definition();
// Overrides of standard options.
$options['style_plugin']['default'] = 'chart_extension';
$options['row_plugin']['default'] = 'fields';
$options['defaults']['default']['style_plugin'] = FALSE;
$options['defaults']['default']['style_options'] = FALSE;
$options['defaults']['default']['row_plugin'] = FALSE;
$options['defaults']['default']['row_options'] = FALSE;
$options['parent_display'] = array(
'default' => '',
);
$options['inherit_yaxis'] = array(
'default' => '1',
);
$options['inherit_arguments'] = array(
'default' => TRUE,
'bool' => TRUE,
);
$options['inherit_exposed_filters'] = array(
'default' => TRUE,
'bool' => TRUE,
);
return $options;
}
/**
* Provide the summary for page options in the views UI.
*
* This output is returned as an array.
*/
function options_summary(&$categories, &$options) {
// It is very important to call the parent function here:
parent::options_summary($categories, $options);
$categories['chart'] = array(
'title' => t('Chart settings'),
'column' => 'second',
'build' => array(
'#weight' => -10,
),
);
$parent_title = NULL;
$parent_display = $this
->get_option('parent_display');
if (!empty($this->view->display[$parent_display])) {
$parent_title = check_plain($this->view->display[$parent_display]->display_title);
}
$options['parent_display'] = array(
'category' => 'chart',
'title' => t('Combine with parent chart'),
'value' => $parent_title ? $parent_title : t('None'),
);
$options['inherit_yaxis'] = array(
'category' => 'chart',
'title' => t('Axis settings'),
'value' => $this
->get_option('inherit_yaxis') ? t('Use primary Y-axis') : t('Create secondary axis'),
);
$options['inherit_arguments'] = array(
'category' => 'chart',
'title' => t('Inherit contextual filters'),
'value' => $this
->get_option('inherit_arguments') ? t('Yes') : t('No'),
);
$options['inherit_exposed_filters'] = array(
'category' => 'chart',
'title' => t('Inherit exposed filters'),
'value' => $this
->get_option('inherit_exposed_filters') ? t('Yes') : t('No'),
);
}
/**
* Provide the default form for setting options.
*/
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 'parent_display':
$form['#title'] .= t('Parent display');
// Filter down the list of displays to include only those that use
// the chart display style.
$display_options = array();
foreach ($this->view->display as $display_name => $display) {
if ($display->handler
->get_option('style_plugin') === 'chart' && $display_name !== $this->view->current_display) {
$display_options[$display_name] = $display->display_title;
}
}
$form['parent_display'] = array(
'#title' => t('Parent display'),
'#type' => 'select',
'#options' => $display_options,
'#empty_option' => t('- None - '),
'#required' => TRUE,
'#default_value' => $this
->get_option('parent_display'),
'#description' => t('Select a parent display onto which this chart will be overlaid. Only other displays using a "Chart" format are included here. This option may be used to create charts with several series of data or to create combination charts.'),
);
break;
case 'inherit_yaxis':
$form['#title'] .= t('Axis settings');
$form['inherit_yaxis'] = array(
'#title' => t('Y-Axis settings'),
'#type' => 'radios',
'#options' => array(
1 => t('Inherit primary of parent display'),
0 => t('Create a secondary axis'),
),
'#default_value' => $this
->get_option('inherit_yaxis'),
'#description' => t('In most charts, the X and Y axis from the parent display are both shared with each attached child chart. However, if this chart is going to use a different unit of measurement, a secondary axis may be added on the opposite side of the normal Y-axis.'),
);
break;
case 'inherit_arguments':
$form['#title'] .= t('Inherit contextual filters');
$form['inherit_arguments'] = array(
'#type' => 'checkbox',
'#title' => t('Inherit'),
'#description' => t('Should this display inherit its contextual filter values from the parent display to which it is attached?'),
'#default_value' => $this
->get_option('inherit_arguments'),
);
break;
case 'inherit_exposed_filters':
$form['#title'] .= t('Inherit exposed filters');
$form['inherit_exposed_filters'] = array(
'#type' => 'checkbox',
'#title' => t('Inherit'),
'#description' => t('Should this display inherit its exposed filter values from the parent display to which it is attached?'),
'#default_value' => $this
->get_option('inherit_exposed_filters'),
);
break;
}
}
/**
* Perform any necessary changes to the form values prior to storage.
* There is no need for this function to actually store the data.
*/
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 'parent_display':
case 'inherit_yaxis':
case 'inherit_arguments':
case 'inherit_exposed_filters':
$this
->set_option($form_state['section'], $form_state['values'][$form_state['section']]);
break;
}
}
/**
* Determine if this display uses exposed filters.
*/
function uses_exposed() {
if (!empty($this->options['inherit_exposed_filters']) && parent::uses_exposed()) {
return TRUE;
}
return FALSE;
}
/**
* If an attachment is set to inherit the exposed filter
* settings from its parent display, then don't render and
* display a second set of exposed filter widgets.
*/
function displays_exposed() {
return $this->options['inherit_exposed_filters'] ? FALSE : TRUE;
}
}
Members
Name![]() |
Modifiers | Type | Description | Overrides |
---|---|---|---|---|
charts_plugin_display_chart:: |
function |
If an attachment is set to inherit the exposed filter
settings from its parent display, then don't render and
display a second set of exposed filter widgets. Overrides views_plugin_display:: |
||
charts_plugin_display_chart:: |
function |
Displays can require a certain type of style plugin. Overrides views_plugin_display:: |
||
charts_plugin_display_chart:: |
function |
Provide the default form for setting options. Overrides views_plugin_display:: |
||
charts_plugin_display_chart:: |
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:: |
||
charts_plugin_display_chart:: |
function |
Provide the summary for page options in the views UI. Overrides views_plugin_display:: |
||
charts_plugin_display_chart:: |
function |
Information about options for all kinds of purposes will be held here. Overrides views_plugin_display:: |
||
charts_plugin_display_chart:: |
function |
Determine if this display uses exposed filters. Overrides views_plugin_display:: |
||
views_object:: |
public | property | Handler's definition. | |
views_object:: |
public | property | Except for displays, options for the object will be held here. | 1 |
views_object:: |
function | Collect this handler's option definition and alter them, ready for use. | ||
views_object:: |
public | function | Views handlers use a special construct function. | 4 |
views_object:: |
public | function | ||
views_object:: |
public | function | Always exports the option, regardless of the default value. | |
views_object:: |
public | function | Set default options on this object. | 1 |
views_object:: |
public | function | Set default options. | |
views_object:: |
public | function | Let the handler know what its full definition is. | |
views_object:: |
public | function | Unpack options over our existing defaults, drilling down into arrays so that defaults don't get totally blown away. | |
views_object:: |
public | function | Unpack a single option definition. | |
views_object:: |
public | function | Unpacks each handler to store translatable texts. | |
views_object:: |
public | function | ||
views_plugin:: |
public | property | The current used views display. | |
views_plugin:: |
public | property | The plugin name of this plugin, for example table or full. | |
views_plugin:: |
public | property | The plugin type of this plugin, for example style or query. | |
views_plugin:: |
public | function | Provide a list of additional theme functions for the theme info page. | |
views_plugin:: |
public | function | Return the human readable name of the display. | |
views_plugin:: |
public | function | Returns the summary of the settings in the display. | 8 |
views_plugin:: |
public | function | Provide a full list of possible theme templates used by this style. | |
views_plugin_display:: |
public | property | Stores all available display extenders. | |
views_plugin_display:: |
public | property | List of handlers for this display. | |
views_plugin_display:: |
public | property |
The top object of a view. Overrides views_plugin:: |
|
views_plugin_display:: |
public | function | Can this display accept attachments? | |
views_plugin_display:: |
public | function | Determine if the user has access to this display of the view. | |
views_plugin_display:: |
public | function | Allow displays to attach to other views. | 2 |
views_plugin_display:: |
public | function | List which sections are defaultable and what items each section contains. | 1 |
views_plugin_display:: |
public | function |
Destructor. Overrides views_object:: |
|
views_plugin_display:: |
public | function | When used externally, this is how a view gets run and returns data in the format required. | 4 |
views_plugin_display:: |
public | function | Special method to export items that have handlers. | |
views_plugin_display:: |
public | function |
Override of export_option() Overrides views_object:: |
|
views_plugin_display:: |
public | function | Special handling for plugin export. | |
views_plugin_display:: |
public | function | Special handling for the style export. | |
views_plugin_display:: |
public | function | Format a list of theme templates for output by the theme info helper. | |
views_plugin_display:: |
public | function | Returns to tokens for arguments. | |
views_plugin_display:: |
public | function | Provide some helpful text for the arguments. | 1 |
views_plugin_display:: |
public | function | List of fields for the current display with the associated relationship. | |
views_plugin_display:: |
public | function | Get the handler object for a single handler. | |
views_plugin_display:: |
public | function | Get a full array of handlers for $type. This caches them. | |
views_plugin_display:: |
public | function | Check to see which display to use when creating links. | |
views_plugin_display:: |
public | function | Intelligently get an option either from this or default display. | |
views_plugin_display:: |
public | function | Provide some helpful text for pagers. | 1 |
views_plugin_display:: |
public | function | Return the base path to use for this display. | |
views_plugin_display:: |
public | function | Get the instance of a plugin, for example style or row. | |
views_plugin_display:: |
public | function | Provide the block system with any exposed widget blocks for this display. | |
views_plugin_display:: |
public | function | ||
views_plugin_display:: |
public | function | Check to see if the display has a 'path' field. | 1 |
views_plugin_display:: |
public | function | If this display creates a block, implement one of these. | |
views_plugin_display:: |
public | function | If this display creates a page with a menu item, implement it here. | |
views_plugin_display:: |
public | function | 1 | |
views_plugin_display:: |
public | function | Determine if a given option is set to use the default or current display. | |
views_plugin_display:: |
public | function | If this display is the 'default' display which contains fallback settings. | 1 |
views_plugin_display:: |
public | function | Check if the provided identifier is unique. | |
views_plugin_display:: |
public | function | If override/revert was clicked, perform the proper toggle. | |
views_plugin_display:: |
public | function |
Validate the options form. Overrides views_plugin:: |
1 |
views_plugin_display:: |
public | function | Because forms may be split up into sections, this provides an easy URL to exactly the right section. Don't override this. | |
views_plugin_display:: |
public | function | Set an option and force it to be an override. | |
views_plugin_display:: |
public | function | Fully render the display. | 1 |
views_plugin_display:: |
public | function | Set up any variables on the view prior to execution. | |
views_plugin_display:: |
public | function |
Inject anything into the query that the display handler needs. Overrides views_plugin:: |
|
views_plugin_display:: |
public | function | Render this display. | 1 |
views_plugin_display:: |
public | function | ||
views_plugin_display:: |
public | function | ||
views_plugin_display:: |
public | function | Not all display plugins will support filtering. | |
views_plugin_display:: |
public | function | Render the footer of the view. | |
views_plugin_display:: |
public | function | Render the header of the view. | |
views_plugin_display:: |
public | function | Render the 'more' link. | |
views_plugin_display:: |
public | function | Not all display plugins will suppert pager rendering. | 1 |
views_plugin_display:: |
public | function | Intelligently set an option either from this display or from the default display, if directed to do so. | |
views_plugin_display:: |
public | function | Flip the override setting for the given section. | |
views_plugin_display:: |
public | function | Special method to unpack items that have handlers. | |
views_plugin_display:: |
public | function | Special handling for plugin unpacking. | |
views_plugin_display:: |
public | function | ||
views_plugin_display:: |
public | function | Check to see if the display needs a breadcrumb. | 1 |
views_plugin_display:: |
public | function | Check to see if the display can put the exposed form in a block. | |
views_plugin_display:: |
public | function | Determine if the display's style uses fields. | |
views_plugin_display:: |
public | function | Check to see if the display has some need to link to another display. | 1 |
views_plugin_display:: |
public | function | Does the display use AJAX? | |
views_plugin_display:: |
public | function | Does the display have groupby enabled? | |
views_plugin_display:: |
public | function | Does the display have a more link enabled? | |
views_plugin_display:: |
public | function | Should the enabled display more link be shown when no more items? | |
views_plugin_display:: |
public | function | Should the enabled display more link being opened in an new window? | |
views_plugin_display:: |
public | function | Does the display have custom link text? | |
views_plugin_display:: |
public | function | Does the display have a pager enabled? | 1 |
views_plugin_display:: |
public | function |
Make sure the display and all associated handlers are valid. Overrides views_plugin:: |
1 |
views_plugin_display:: |
public | function | Render any special blocks provided for this display. |