Code Coverage |
||||||||||
Classes and Traits |
Functions and Methods |
Lines |
||||||||
Total | |
0.00% |
0 / 1 |
|
0.00% |
0 / 47 |
CRAP | |
0.00% |
0 / 500 |
ArgumentPluginBase | |
0.00% |
0 / 1 |
|
0.00% |
0 / 47 |
28056 | |
0.00% |
0 / 500 |
init | |
0.00% |
0 / 1 |
12 | |
0.00% |
0 / 6 |
|||
isException | |
0.00% |
0 / 1 |
20 | |
0.00% |
0 / 3 |
|||
exceptionTitle | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 3 |
|||
needsStylePlugin | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 3 |
|||
defineOptions | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 14 |
|||
buildOptionsForm | |
0.00% |
0 / 1 |
210 | |
0.00% |
0 / 112 |
|||
getTokenHelp | |
0.00% |
0 / 1 |
42 | |
0.00% |
0 / 16 |
|||
validateOptionsForm | |
0.00% |
0 / 1 |
30 | |
0.00% |
0 / 17 |
|||
submitOptionsForm | |
0.00% |
0 / 1 |
56 | |
0.00% |
0 / 29 |
|||
defaultActions | |
0.00% |
0 / 1 |
20 | |
0.00% |
0 / 22 |
|||
defaultArgumentForm | |
0.00% |
0 / 1 |
42 | |
0.00% |
0 / 33 |
|||
defaultSummaryForm | |
0.00% |
0 / 1 |
56 | |
0.00% |
0 / 38 |
|||
defaultAction | |
0.00% |
0 / 1 |
20 | |
0.00% |
0 / 7 |
|||
validateFail | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 2 |
|||
defaultIgnore | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 1 |
|||
defaultNotFound | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 2 |
|||
defaultAccessDenied | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 2 |
|||
defaultEmpty | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 4 |
|||
defaultDefault | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 1 |
|||
hasDefaultArgument | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 2 |
|||
getDefaultArgument | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 4 |
|||
processSummaryArguments | |
0.00% |
0 / 1 |
20 | |
0.00% |
0 / 4 |
|||
defaultSummary | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 10 |
|||
summaryQuery | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 4 |
|||
summaryNameField | |
0.00% |
0 / 1 |
30 | |
0.00% |
0 / 13 |
|||
summaryBasics | |
0.00% |
0 / 1 |
12 | |
0.00% |
0 / 7 |
|||
summarySort | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 2 |
|||
summaryArgument | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 1 |
|||
summaryName | |
0.00% |
0 / 1 |
12 | |
0.00% |
0 / 4 |
|||
query | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 3 |
|||
title | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 1 |
|||
getTitle | |
0.00% |
0 / 1 |
6 | |
0.00% |
0 / 3 |
|||
validateArgument | |
0.00% |
0 / 1 |
12 | |
0.00% |
0 / 6 |
|||
validateMenuArgument | |
0.00% |
0 / 1 |
12 | |
0.00% |
0 / 8 |
|||
setArgument | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 2 |
|||
getValue | |
0.00% |
0 / 1 |
72 | |
0.00% |
0 / 18 |
|||
getPlugin | |
0.00% |
0 / 1 |
156 | |
0.00% |
0 / 29 |
|||
getSortName | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 1 |
|||
processContainerRadios | |
0.00% |
0 / 1 |
30 | |
0.00% |
0 / 16 |
|||
preRenderMoveArgumentOptions | |
0.00% |
0 / 1 |
20 | |
0.00% |
0 / 8 |
|||
encodeValidatorId | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 1 |
|||
decodeValidatorId | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 1 |
|||
unpackArgumentValue | |
0.00% |
0 / 1 |
2 | |
0.00% |
0 / 4 |
|||
getCacheMaxAge | |
0.00% |
0 / 1 |
56 | |
0.00% |
0 / 8 |
|||
getCacheContexts | |
0.00% |
0 / 1 |
56 | |
0.00% |
0 / 9 |
|||
getCacheTags | |
0.00% |
0 / 1 |
56 | |
0.00% |
0 / 8 |
|||
calculateDependencies | |
0.00% |
0 / 1 |
56 | |
0.00% |
0 / 8 |
<?php | |
/** | |
* @file | |
* Contains \Drupal\views\Plugin\views\argument\ArgumentPluginBase. | |
*/ | |
namespace Drupal\views\Plugin\views\argument; | |
use Drupal\Component\Plugin\DependentPluginInterface; | |
use Drupal\Component\Utility\Html; | |
use Drupal\Component\Utility\NestedArray; | |
use Drupal\Core\Cache\Cache; | |
use Drupal\Core\Cache\CacheableDependencyInterface; | |
use Drupal\Core\Form\FormStateInterface; | |
use Drupal\Core\Render\Element; | |
use Drupal\views\Plugin\views\display\DisplayPluginBase; | |
use Drupal\views\ViewExecutable; | |
use Drupal\views\Plugin\views\HandlerBase; | |
use Drupal\views\Views; | |
/** | |
* @defgroup views_argument_handlers Views argument handlers | |
* @{ | |
* Handler plugins for Views contextual filters. | |
* | |
* Handler plugins help build the view query object. Views argument handlers | |
* are for contextual filtering. | |
* | |
* Views argument handlers extend | |
* \Drupal\views\Plugin\views\argument\ArgumentPluginBase. They must be | |
* annotated with \Drupal\views\Annotation\ViewsArgument annotation, and they | |
* must be in namespace directory Plugin\views\argument. | |
* | |
* @ingroup views_plugins | |
* @see plugin_api | |
*/ | |
/** | |
* Base class for argument (contextual filter) handler plugins. | |
* | |
* The basic argument works for very simple arguments such as nid and uid | |
* | |
* Definition terms for this handler: | |
* - name field: The field to use for the name to use in the summary, which is | |
* the displayed output. For example, for the node: nid argument, | |
* the argument itself is the nid, but node.title is displayed. | |
* - name table: The table to use for the name, should it not be in the same | |
* table as the argument. | |
* - empty field name: For arguments that can have no value, such as taxonomy | |
* which can have "no term", this is the string which | |
* will be displayed for this lack of value. Be sure to use | |
* $this->t(). | |
* - validate type: A little used string to allow an argument to restrict | |
* which validator is available to just one. Use the | |
* validator ID. This probably should not be used at all, | |
* and may disappear or change. | |
* - numeric: If set to TRUE this field is numeric and will use %d instead of | |
* %s in queries. | |
*/ | |
abstract class ArgumentPluginBase extends HandlerBase implements CacheableDependencyInterface { | |
var $validator = NULL; | |
var $argument = NULL; | |
var $value = NULL; | |
/** | |
* The table to use for the name, should it not be in the same table as the argument. | |
* @var string | |
*/ | |
var $name_table; | |
/** | |
* The field to use for the name to use in the summary, which is | |
* the displayed output. For example, for the node: nid argument, | |
* the argument itself is the nid, but node.title is displayed. | |
* @var string | |
*/ | |
var $name_field; | |
/** | |
* Overrides Drupal\views\Plugin\views\HandlerBase:init(). | |
*/ | |
public function init(ViewExecutable $view, DisplayPluginBase $display, array &$options = NULL) { | |
parent::init($view, $display, $options); | |
if (!empty($this->definition['name field'])) { | |
$this->name_field = $this->definition['name field']; | |
} | |
if (!empty($this->definition['name table'])) { | |
$this->name_table = $this->definition['name table']; | |
} | |
} | |
public function isException($arg = NULL) { | |
if (!isset($arg)) { | |
$arg = isset($this->argument) ? $this->argument : NULL; | |
} | |
return !empty($this->options['exception']['value']) && $this->options['exception']['value'] === $arg; | |
} | |
public function exceptionTitle() { | |
// If title overriding is off for the exception, return the normal title. | |
if (empty($this->options['exception']['title_enable'])) { | |
return $this->getTitle(); | |
} | |
return $this->options['exception']['title']; | |
} | |
/** | |
* Determine if the argument needs a style plugin. | |
* | |
* @return TRUE/FALSE | |
*/ | |
public function needsStylePlugin() { | |
$info = $this->defaultActions($this->options['default_action']); | |
$validate_info = $this->defaultActions($this->options['validate']['fail']); | |
return !empty($info['style plugin']) || !empty($validate_info['style plugin']); | |
} | |
protected function defineOptions() { | |
$options = parent::defineOptions(); | |
$options['default_action'] = array('default' => 'ignore'); | |
$options['exception'] = array( | |
'contains' => array( | |
'value' => array('default' => 'all'), | |
'title_enable' => array('default' => FALSE), | |
'title' => array('default' => 'All'), | |
), | |
); | |
$options['title_enable'] = array('default' => FALSE); | |
$options['title'] = array('default' => ''); | |
$options['default_argument_type'] = array('default' => 'fixed'); | |
$options['default_argument_options'] = array('default' => array()); | |
$options['default_argument_skip_url'] = array('default' => FALSE); | |
$options['summary_options'] = array('default' => array()); | |
$options['summary'] = array( | |
'contains' => array( | |
'sort_order' => array('default' => 'asc'), | |
'number_of_records' => array('default' => 0), | |
'format' => array('default' => 'default_summary'), | |
), | |
); | |
$options['specify_validation'] = array('default' => FALSE); | |
$options['validate'] = array( | |
'contains' => array( | |
'type' => array('default' => 'none'), | |
'fail' => array('default' => 'not found'), | |
), | |
); | |
$options['validate_options'] = array('default' => array()); | |
return $options; | |
} | |
public function buildOptionsForm(&$form, FormStateInterface $form_state) { | |
parent::buildOptionsForm($form, $form_state); | |
$argument_text = $this->view->display_handler->getArgumentText(); | |
$form['#pre_render'][] = array(get_class($this), 'preRenderMoveArgumentOptions'); | |
$form['description'] = array( | |
'#markup' => $argument_text['description'], | |
'#theme_wrappers' => array('container'), | |
'#attributes' => array('class' => array('description')), | |
); | |
$form['no_argument'] = array( | |
'#type' => 'details', | |
'#title' => $argument_text['filter value not present'], | |
'#open' => TRUE, | |
); | |
// Everything in the details is floated, so the last element needs to | |
// clear those floats. | |
$form['no_argument']['clearfix'] = array( | |
'#weight' => 1000, | |
'#markup' => '<div class="clearfix"></div>', | |
); | |
$form['default_action'] = array( | |
'#title' => $this->t('Default actions'), | |
'#title_display' => 'invisible', | |
'#type' => 'radios', | |
'#process' => array(array($this, 'processContainerRadios')), | |
'#default_value' => $this->options['default_action'], | |
'#fieldset' => 'no_argument', | |
); | |
$form['exception'] = array( | |
'#type' => 'details', | |
'#title' => $this->t('Exceptions'), | |
'#fieldset' => 'no_argument', | |
); | |
$form['exception']['value'] = array( | |
'#type' => 'textfield', | |
'#title' => $this->t('Exception value'), | |
'#size' => 20, | |
'#default_value' => $this->options['exception']['value'], | |
'#description' => $this->t('If this value is received, the filter will be ignored; i.e, "all values"'), | |
); | |
$form['exception']['title_enable'] = array( | |
'#type' => 'checkbox', | |
'#title' => $this->t('Override title'), | |
'#default_value' => $this->options['exception']['title_enable'], | |
); | |
$form['exception']['title'] = array( | |
'#type' => 'textfield', | |
'#title' => $this->t('Override title'), | |
'#title_display' => 'invisible', | |
'#size' => 20, | |
'#default_value' => $this->options['exception']['title'], | |
'#description' => $this->t('Override the view and other argument titles. You may use Twig syntax in this field as well as the "arguments" and "raw_arguments" arrays.'), | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[exception][title_enable]"]' => array('checked' => TRUE), | |
), | |
), | |
); | |
$options = array(); | |
$defaults = $this->defaultActions(); | |
$validate_options = array(); | |
foreach ($defaults as $id => $info) { | |
$options[$id] = $info['title']; | |
if (empty($info['default only'])) { | |
$validate_options[$id] = $info['title']; | |
} | |
if (!empty($info['form method'])) { | |
$this->{$info['form method']}($form, $form_state); | |
} | |
} | |
$form['default_action']['#options'] = $options; | |
$form['argument_present'] = array( | |
'#type' => 'details', | |
'#title' => $argument_text['filter value present'], | |
'#open' => TRUE, | |
); | |
$form['title_enable'] = array( | |
'#type' => 'checkbox', | |
'#title' => $this->t('Override title'), | |
'#default_value' => $this->options['title_enable'], | |
'#fieldset' => 'argument_present', | |
); | |
$form['title'] = array( | |
'#type' => 'textfield', | |
'#title' => $this->t('Provide title'), | |
'#title_display' => 'invisible', | |
'#default_value' => $this->options['title'], | |
'#description' => $this->t('Override the view and other argument titles. You may use Twig syntax in this field.'), | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[title_enable]"]' => array('checked' => TRUE), | |
), | |
), | |
'#fieldset' => 'argument_present', | |
); | |
$output = $this->getTokenHelp(); | |
$form['token_help'] = [ | |
'#type' => 'details', | |
'#title' => $this->t('Replacement patterns'), | |
'#value' => $output, | |
'#states' => [ | |
'visible' => [ | |
[ | |
':input[name="options[title_enable]"]' => ['checked' => TRUE], | |
], | |
[ | |
':input[name="options[exception][title_enable]"]' => ['checked' => TRUE], | |
], | |
], | |
], | |
]; | |
$form['specify_validation'] = array( | |
'#type' => 'checkbox', | |
'#title' => $this->t('Specify validation criteria'), | |
'#default_value' => $this->options['specify_validation'], | |
'#fieldset' => 'argument_present', | |
); | |
$form['validate'] = array( | |
'#type' => 'container', | |
'#fieldset' => 'argument_present', | |
); | |
// Validator options include derivatives with :. These are sanitized for js | |
// and reverted on submission. | |
$form['validate']['type'] = array( | |
'#type' => 'select', | |
'#title' => $this->t('Validator'), | |
'#default_value' => static::encodeValidatorId($this->options['validate']['type']), | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[specify_validation]"]' => array('checked' => TRUE), | |
), | |
), | |
); | |
$plugins = Views::pluginManager('argument_validator')->getDefinitions(); | |
foreach ($plugins as $id => $info) { | |
if (!empty($info['no_ui'])) { | |
continue; | |
} | |
$valid = TRUE; | |
if (!empty($info['type'])) { | |
$valid = FALSE; | |
if (empty($this->definition['validate type'])) { | |
continue; | |
} | |
foreach ((array) $info['type'] as $type) { | |
if ($type == $this->definition['validate type']) { | |
$valid = TRUE; | |
break; | |
} | |
} | |
} | |
// If we decide this validator is ok, add it to the list. | |
if ($valid) { | |
$plugin = $this->getPlugin('argument_validator', $id); | |
if ($plugin) { | |
if ($plugin->access() || $this->options['validate']['type'] == $id) { | |
// Sanitize ID for js. | |
$sanitized_id = static::encodeValidatorId($id); | |
$form['validate']['options'][$sanitized_id] = array( | |
'#prefix' => '<div id="edit-options-validate-options-' . $sanitized_id . '-wrapper">', | |
'#suffix' => '</div>', | |
'#type' => 'item', | |
// Even if the plugin has no options add the key to the form_state. | |
'#input' => TRUE, // trick it into checking input to make #process run | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[specify_validation]"]' => array('checked' => TRUE), | |
':input[name="options[validate][type]"]' => array('value' => $sanitized_id), | |
), | |
), | |
'#id' => 'edit-options-validate-options-' . $sanitized_id, | |
'#default_value' => array(), | |
); | |
$plugin->buildOptionsForm($form['validate']['options'][$sanitized_id], $form_state); | |
$validate_types[$sanitized_id] = $info['title']; | |
} | |
} | |
} | |
} | |
asort($validate_types); | |
$form['validate']['type']['#options'] = $validate_types; | |
$form['validate']['fail'] = array( | |
'#type' => 'select', | |
'#title' => $this->t('Action to take if filter value does not validate'), | |
'#default_value' => $this->options['validate']['fail'], | |
'#options' => $validate_options, | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[specify_validation]"]' => array('checked' => TRUE), | |
), | |
), | |
'#fieldset' => 'argument_present', | |
); | |
} | |
/** | |
* Provide token help information for the argument. | |
* | |
* @return array | |
* A render array. | |
*/ | |
protected function getTokenHelp() { | |
$output = []; | |
foreach ($this->view->display_handler->getHandlers('argument') as $arg => $handler) { | |
/** @var \Drupal\views\Plugin\views\argument\ArgumentPluginBase $handler */ | |
$options[(string) t('Arguments')]["{{ arguments.$arg }}"] = $this->t('@argument title', array('@argument' => $handler->adminLabel())); | |
$options[(string) t('Arguments')]["{{ raw_arguments.$arg }}"] = $this->t('@argument input', array('@argument' => $handler->adminLabel())); | |
} | |
// We have some options, so make a list. | |
if (!empty($options)) { | |
$output[] = [ | |
'#markup' => '<p>' . $this->t("The following replacement tokens are available for this argument.") . '</p>', | |
]; | |
foreach (array_keys($options) as $type) { | |
if (!empty($options[$type])) { | |
$items = array(); | |
foreach ($options[$type] as $key => $value) { | |
$items[] = $key . ' == ' . $value; | |
} | |
$item_list = array( | |
'#theme' => 'item_list', | |
'#items' => $items, | |
); | |
$output[] = $item_list; | |
} | |
} | |
} | |
return $output; | |
} | |
public function validateOptionsForm(&$form, FormStateInterface $form_state) { | |
$option_values = &$form_state->getValue('options'); | |
if (empty($option_values)) { | |
return; | |
} | |
// Let the plugins do validation. | |
$default_id = $option_values['default_argument_type']; | |
$plugin = $this->getPlugin('argument_default', $default_id); | |
if ($plugin) { | |
$plugin->validateOptionsForm($form['argument_default'][$default_id], $form_state, $option_values['argument_default'][$default_id]); | |
} | |
// summary plugin | |
$summary_id = $option_values['summary']['format']; | |
$plugin = $this->getPlugin('style', $summary_id); | |
if ($plugin) { | |
$plugin->validateOptionsForm($form['summary']['options'][$summary_id], $form_state, $option_values['summary']['options'][$summary_id]); | |
} | |
$sanitized_id = $option_values['validate']['type']; | |
// Correct ID for js sanitized version. | |
$validate_id = static::decodeValidatorId($sanitized_id); | |
$plugin = $this->getPlugin('argument_validator', $validate_id); | |
if ($plugin) { | |
$plugin->validateOptionsForm($form['validate']['options'][$default_id], $form_state, $option_values['validate']['options'][$sanitized_id]); | |
} | |
} | |
public function submitOptionsForm(&$form, FormStateInterface $form_state) { | |
$option_values = &$form_state->getValue('options'); | |
if (empty($option_values)) { | |
return; | |
} | |
// Let the plugins make submit modifications if necessary. | |
$default_id = $option_values['default_argument_type']; | |
$plugin = $this->getPlugin('argument_default', $default_id); | |
if ($plugin) { | |
$options = &$option_values['argument_default'][$default_id]; | |
$plugin->submitOptionsForm($form['argument_default'][$default_id], $form_state, $options); | |
// Copy the now submitted options to their final resting place so they get saved. | |
$option_values['default_argument_options'] = $options; | |
} | |
// summary plugin | |
$summary_id = $option_values['summary']['format']; | |
$plugin = $this->getPlugin('style', $summary_id); | |
if ($plugin) { | |
$options = &$option_values['summary']['options'][$summary_id]; | |
$plugin->submitOptionsForm($form['summary']['options'][$summary_id], $form_state, $options); | |
// Copy the now submitted options to their final resting place so they get saved. | |
$option_values['summary_options'] = $options; | |
} | |
// If the 'Specify validation criteria' checkbox is not checked, reset the | |
// validation options. | |
if (empty($option_values['specify_validation'])) { | |
$option_values['validate']['type'] = 'none'; | |
// We need to keep the empty array of options for the 'None' plugin as | |
// it will be needed later. | |
$option_values['validate']['options'] = ['none' => []]; | |
$option_values['validate']['fail'] = 'not found'; | |
} | |
$sanitized_id = $option_values['validate']['type']; | |
// Correct ID for js sanitized version. | |
$option_values['validate']['type'] = $validate_id = static::decodeValidatorId($sanitized_id); | |
$plugin = $this->getPlugin('argument_validator', $validate_id); | |
if ($plugin) { | |
$options = &$option_values['validate']['options'][$sanitized_id]; | |
$plugin->submitOptionsForm($form['validate']['options'][$sanitized_id], $form_state, $options); | |
// Copy the now submitted options to their final resting place so they get saved. | |
$option_values['validate_options'] = $options; | |
} | |
// Clear out the content of title if it's not enabled. | |
if (empty($option_values['title_enable'])) { | |
$option_values['title'] = ''; | |
} | |
} | |
/** | |
* Provide a list of default behaviors for this argument if the argument | |
* is not present. | |
* | |
* Override this method to provide additional (or fewer) default behaviors. | |
*/ | |
protected function defaultActions($which = NULL) { | |
$defaults = array( | |
'ignore' => array( | |
'title' => $this->t('Display all results for the specified field'), | |
'method' => 'defaultIgnore', | |
), | |
'default' => array( | |
'title' => $this->t('Provide default value'), | |
'method' => 'defaultDefault', | |
'form method' => 'defaultArgumentForm', | |
'has default argument' => TRUE, | |
'default only' => TRUE, // this can only be used for missing argument, not validation failure | |
), | |
'not found' => array( | |
'title' => $this->t('Hide view'), | |
'method' => 'defaultNotFound', | |
'hard fail' => TRUE, // This is a hard fail condition | |
), | |
'summary' => array( | |
'title' => $this->t('Display a summary'), | |
'method' => 'defaultSummary', | |
'form method' => 'defaultSummaryForm', | |
'style plugin' => TRUE, | |
), | |
'empty' => array( | |
'title' => $this->t('Display contents of "No results found"'), | |
'method' => 'defaultEmpty', | |
), | |
'access denied' => array( | |
'title' => $this->t('Display "Access Denied"'), | |
'method' => 'defaultAccessDenied', | |
), | |
); | |
if ($this->view->display_handler->hasPath()) { | |
$defaults['not found']['title'] = $this->t('Show "Page not found"'); | |
} | |
if ($which) { | |
if (!empty($defaults[$which])) { | |
return $defaults[$which]; | |
} | |
} | |
else { | |
return $defaults; | |
} | |
} | |
/** | |
* Provide a form for selecting the default argument when the | |
* default action is set to provide default argument. | |
*/ | |
public function defaultArgumentForm(&$form, FormStateInterface $form_state) { | |
$plugins = Views::pluginManager('argument_default')->getDefinitions(); | |
$options = array(); | |
$form['default_argument_skip_url'] = array( | |
'#type' => 'checkbox', | |
'#title' => $this->t('Skip default argument for view URL'), | |
'#default_value' => $this->options['default_argument_skip_url'], | |
'#description' => $this->t('Select whether to include this default argument when constructing the URL for this view. Skipping default arguments is useful e.g. in the case of feeds.') | |
); | |
$form['default_argument_type'] = array( | |
'#prefix' => '<div id="edit-options-default-argument-type-wrapper">', | |
'#suffix' => '</div>', | |
'#type' => 'select', | |
'#id' => 'edit-options-default-argument-type', | |
'#title' => $this->t('Type'), | |
'#default_value' => $this->options['default_argument_type'], | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[default_action]"]' => array('value' => 'default'), | |
), | |
), | |
// Views custom key, moves this element to the appropriate container | |
// under the radio button. | |
'#argument_option' => 'default', | |
); | |
foreach ($plugins as $id => $info) { | |
if (!empty($info['no_ui'])) { | |
continue; | |
} | |
$plugin = $this->getPlugin('argument_default', $id); | |
if ($plugin) { | |
if ($plugin->access() || $this->options['default_argument_type'] == $id) { | |
$form['argument_default']['#argument_option'] = 'default'; | |
$form['argument_default'][$id] = array( | |
'#prefix' => '<div id="edit-options-argument-default-options-' . $id . '-wrapper">', | |
'#suffix' => '</div>', | |
'#id' => 'edit-options-argument-default-options-' . $id, | |
'#type' => 'item', | |
// Even if the plugin has no options add the key to the form_state. | |
'#input' => TRUE, | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[default_action]"]' => array('value' => 'default'), | |
':input[name="options[default_argument_type]"]' => array('value' => $id), | |
), | |
), | |
'#default_value' => array(), | |
); | |
$options[$id] = $info['title']; | |
$plugin->buildOptionsForm($form['argument_default'][$id], $form_state); | |
} | |
} | |
} | |
asort($options); | |
$form['default_argument_type']['#options'] = $options; | |
} | |
/** | |
* Provide a form for selecting further summary options when the | |
* default action is set to display one. | |
*/ | |
public function defaultSummaryForm(&$form, FormStateInterface $form_state) { | |
$style_plugins = Views::pluginManager('style')->getDefinitions(); | |
$summary_plugins = array(); | |
$format_options = array(); | |
foreach ($style_plugins as $key => $plugin) { | |
if (isset($plugin['display_types']) && in_array('summary', $plugin['display_types'])) { | |
$summary_plugins[$key] = $plugin; | |
$format_options[$key] = $plugin['title']; | |
} | |
} | |
$form['summary'] = array( | |
// Views custom key, moves this element to the appropriate container | |
// under the radio button. | |
'#argument_option' => 'summary', | |
); | |
$form['summary']['sort_order'] = array( | |
'#type' => 'radios', | |
'#title' => $this->t('Sort order'), | |
'#options' => array('asc' => $this->t('Ascending'), 'desc' => $this->t('Descending')), | |
'#default_value' => $this->options['summary']['sort_order'], | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[default_action]"]' => array('value' => 'summary'), | |
), | |
), | |
); | |
$form['summary']['number_of_records'] = array( | |
'#type' => 'radios', | |
'#title' => $this->t('Sort by'), | |
'#default_value' => $this->options['summary']['number_of_records'], | |
'#options' => array( | |
0 => $this->getSortName(), | |
1 => $this->t('Number of records') | |
), | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[default_action]"]' => array('value' => 'summary'), | |
), | |
), | |
); | |
$form['summary']['format'] = array( | |
'#type' => 'radios', | |
'#title' => $this->t('Format'), | |
'#options' => $format_options, | |
'#default_value' => $this->options['summary']['format'], | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[default_action]"]' => array('value' => 'summary'), | |
), | |
), | |
); | |
foreach ($summary_plugins as $id => $info) { | |
$plugin = $this->getPlugin('style', $id); | |
if (!$plugin->usesOptions()) { | |
continue; | |
} | |
if ($plugin) { | |
$form['summary']['options'][$id] = array( | |
'#prefix' => '<div id="edit-options-summary-options-' . $id . '-wrapper">', | |
'#suffix' => '</div>', | |
'#id' => 'edit-options-summary-options-' . $id, | |
'#type' => 'item', | |
'#input' => TRUE, // trick it into checking input to make #process run | |
'#states' => array( | |
'visible' => array( | |
':input[name="options[default_action]"]' => array('value' => 'summary'), | |
':input[name="options[summary][format]"]' => array('value' => $id), | |
), | |
), | |
'#default_value' => array(), | |
); | |
$options[$id] = $info['title']; | |
$plugin->buildOptionsForm($form['summary']['options'][$id], $form_state); | |
} | |
} | |
} | |
/** | |
* Handle the default action, which means our argument wasn't present. | |
* | |
* Override this method only with extreme care. | |
* | |
* @return | |
* A boolean value; if TRUE, continue building this view. If FALSE, | |
* building the view will be aborted here. | |
*/ | |
public function defaultAction($info = NULL) { | |
if (!isset($info)) { | |
$info = $this->defaultActions($this->options['default_action']); | |
} | |
if (!$info) { | |
return FALSE; | |
} | |
if (!empty($info['method args'])) { | |
return call_user_func_array(array(&$this, $info['method']), $info['method args']); | |
} | |
else { | |
return $this->{$info['method']}(); | |
} | |
} | |
/** | |
* How to act if validation fails. | |
*/ | |
public function validateFail() { | |
$info = $this->defaultActions($this->options['validate']['fail']); | |
return $this->defaultAction($info); | |
} | |
/** | |
* Default action: ignore. | |
* | |
* If an argument was expected and was not given, in this case, simply | |
* ignore the argument entirely. | |
*/ | |
public function defaultIgnore() { | |
return TRUE; | |
} | |
/** | |
* Default action: not found. | |
* | |
* If an argument was expected and was not given, in this case, report | |
* the view as 'not found' or hide it. | |
*/ | |
protected function defaultNotFound() { | |
// Set a failure condition and let the display manager handle it. | |
$this->view->build_info['fail'] = TRUE; | |
return FALSE; | |
} | |
/** | |
* Default action: access denied. | |
* | |
* If an argument was expected and was not given, in this case, report | |
* the view as 'access denied'. | |
*/ | |
public function defaultAccessDenied() { | |
$this->view->build_info['denied'] = TRUE; | |
return FALSE; | |
} | |
/** | |
* Default action: empty | |
* | |
* If an argument was expected and was not given, in this case, display | |
* the view's empty text | |
*/ | |
public function defaultEmpty() { | |
// We return with no query; this will force the empty text. | |
$this->view->built = TRUE; | |
$this->view->executed = TRUE; | |
$this->view->result = array(); | |
return FALSE; | |
} | |
/** | |
* This just returns true. The view argument builder will know where | |
* to find the argument from. | |
*/ | |
protected function defaultDefault() { | |
return TRUE; | |
} | |
/** | |
* Determine if the argument is set to provide a default argument. | |
*/ | |
function hasDefaultArgument() { | |
$info = $this->defaultActions($this->options['default_action']); | |
return !empty($info['has default argument']); | |
} | |
/** | |
* Get a default argument, if available. | |
*/ | |
public function getDefaultArgument() { | |
$plugin = $this->getPlugin('argument_default'); | |
if ($plugin) { | |
return $plugin->getArgument(); | |
} | |
} | |
/** | |
* Process the summary arguments for display. | |
* | |
* For example, the validation plugin may want to alter an argument for use in | |
* the URL. | |
*/ | |
public function processSummaryArguments(&$args) { | |
if ($this->options['validate']['type'] != 'none') { | |
if (isset($this->validator) || $this->validator = $this->getPlugin('argument_validator')) { | |
$this->validator->processSummaryArguments($args); | |
} | |
} | |
} | |
/** | |
* Default action: summary. | |
* | |
* If an argument was expected and was not given, in this case, display | |
* a summary query. | |
*/ | |
protected function defaultSummary() { | |
$this->view->build_info['summary'] = TRUE; | |
$this->view->build_info['summary_level'] = $this->options['id']; | |
// Change the display style to the summary style for this | |
// argument. | |
$this->view->style_plugin = Views::pluginManager("style")->createInstance($this->options['summary']['format']); | |
$this->view->style_plugin->init($this->view, $this->displayHandler, $this->options['summary_options']); | |
// Clear out the normal primary field and whatever else may have | |
// been added and let the summary do the work. | |
$this->query->clearFields(); | |
$this->summaryQuery(); | |
$by = $this->options['summary']['number_of_records'] ? 'num_records' : NULL; | |
$this->summarySort($this->options['summary']['sort_order'], $by); | |
// Summaries have their own sorting and fields, so tell the View not | |
// to build these. | |
$this->view->build_sort = FALSE; | |
return TRUE; | |
} | |
/** | |
* Build the info for the summary query. | |
* | |
* This must: | |
* - addGroupBy: group on this field in order to create summaries. | |
* - addField: add a 'num_nodes' field for the count. Usually it will | |
* be a count on $view->base_field | |
* - setCountField: Reset the count field so we get the right paging. | |
* | |
* @return | |
* The alias used to get the number of records (count) for this entry. | |
*/ | |
protected function summaryQuery() { | |
$this->ensureMyTable(); | |
// Add the field. | |
$this->base_alias = $this->query->addField($this->tableAlias, $this->realField); | |
$this->summaryNameField(); | |
return $this->summaryBasics(); | |
} | |
/** | |
* Add the name field, which is the field displayed in summary queries. | |
* This is often used when the argument is numeric. | |
*/ | |
protected function summaryNameField() { | |
// Add the 'name' field. For example, if this is a uid argument, the | |
// name field would be 'name' (i.e, the username). | |
if (isset($this->name_table)) { | |
// if the alias is different then we're probably added, not ensured, | |
// so look up the join and add it instead. | |
if ($this->tableAlias != $this->name_table) { | |
$j = HandlerBase::getTableJoin($this->name_table, $this->table); | |
if ($j) { | |
$join = clone $j; | |
$join->leftTable = $this->tableAlias; | |
$this->name_table_alias = $this->query->addTable($this->name_table, $this->relationship, $join); | |
} | |
} | |
else { | |
$this->name_table_alias = $this->query->ensureTable($this->name_table, $this->relationship); | |
} | |
} | |
else { | |
$this->name_table_alias = $this->tableAlias; | |
} | |
if (isset($this->name_field)) { | |
$this->name_alias = $this->query->addField($this->name_table_alias, $this->name_field); | |
} | |
else { | |
$this->name_alias = $this->base_alias; | |
} | |
} | |
/** | |
* Some basic summary behavior that doesn't need to be repeated as much as | |
* code that goes into summaryQuery() | |
*/ | |
public function summaryBasics($count_field = TRUE) { | |
// Add the number of nodes counter | |
$distinct = ($this->view->display_handler->getOption('distinct') && empty($this->query->no_distinct)); | |
$count_alias = $this->query->addField($this->view->storage->get('base_table'), $this->view->storage->get('base_field'), 'num_records', array('count' => TRUE, 'distinct' => $distinct)); | |
$this->query->addGroupBy($this->name_alias); | |
if ($count_field) { | |
$this->query->setCountField($this->tableAlias, $this->realField); | |
} | |
$this->count_alias = $count_alias; | |
} | |
/** | |
* Sorts the summary based upon the user's selection. The base variant of | |
* this is usually adequate. | |
* | |
* @param $order | |
* The order selected in the UI. | |
*/ | |
public function summarySort($order, $by = NULL) { | |
$this->query->addOrderBy(NULL, NULL, $order, (!empty($by) ? $by : $this->name_alias)); | |
} | |
/** | |
* Provide the argument to use to link from the summary to the next level; | |
* this will be called once per row of a summary, and used as part of | |
* $view->getUrl(). | |
* | |
* @param $data | |
* The query results for the row. | |
*/ | |
public function summaryArgument($data) { | |
return $data->{$this->base_alias}; | |
} | |
/** | |
* Provides the name to use for the summary. By default this is just | |
* the name field. | |
* | |
* @param $data | |
* The query results for the row. | |
*/ | |
public function summaryName($data) { | |
$value = $data->{$this->name_alias}; | |
if (empty($value) && !empty($this->definition['empty field name'])) { | |
$value = $this->definition['empty field name']; | |
} | |
return $value; | |
} | |
/** | |
* Set up the query for this argument. | |
* | |
* The argument sent may be found at $this->argument. | |
*/ | |
public function query($group_by = FALSE) { | |
$this->ensureMyTable(); | |
$this->query->addWhere(0, "$this->tableAlias.$this->realField", $this->argument); | |
} | |
/** | |
* Get the title this argument will assign the view, given the argument. | |
* | |
* This usually needs to be overridden to provide a proper title. | |
*/ | |
function title() { | |
return $this->argument; | |
} | |
/** | |
* Called by the view object to get the title. This may be set by a | |
* validator so we don't necessarily call through to title(). | |
*/ | |
public function getTitle() { | |
if (isset($this->validated_title)) { | |
return $this->validated_title; | |
} | |
else { | |
return $this->title(); | |
} | |
} | |
/** | |
* Validate that this argument works. By default, all arguments are valid. | |
*/ | |
public function validateArgument($arg) { | |
// By using % in URLs, arguments could be validated twice; this eases | |
// that pain. | |
if (isset($this->argument_validated)) { | |
return $this->argument_validated; | |
} | |
if ($this->isException($arg)) { | |
return $this->argument_validated = TRUE; | |
} | |
$plugin = $this->getPlugin('argument_validator'); | |
return $this->argument_validated = $plugin->validateArgument($arg); | |
} | |
/** | |
* Called by the menu system to validate an argument. | |
* | |
* This checks to see if this is a 'soft fail', which means that if the | |
* argument fails to validate, but there is an action to take anyway, | |
* then validation cannot actually fail. | |
*/ | |
public function validateMenuArgument($arg) { | |
$validate_info = $this->defaultActions($this->options['validate']['fail']); | |
if (empty($validate_info['hard fail'])) { | |
return TRUE; | |
} | |
$rc = $this->validateArgument($arg); | |
// If the validator has changed the validate fail condition to a | |
// soft fail, deal with that: | |
$validate_info = $this->defaultActions($this->options['validate']['fail']); | |
if (empty($validate_info['hard fail'])) { | |
return TRUE; | |
} | |
return $rc; | |
} | |
/** | |
* Set the input for this argument | |
* | |
* @return TRUE if it successfully validates; FALSE if it does not. | |
*/ | |
public function setArgument($arg) { | |
$this->argument = $arg; | |
return $this->validateArgument($arg); | |
} | |
/** | |
* Get the value of this argument. | |
*/ | |
public function getValue() { | |
// If we already processed this argument, we're done. | |
if (isset($this->argument)) { | |
return $this->argument; | |
} | |
// Otherwise, we have to pretend to process ourselves to find the value. | |
$value = NULL; | |
// Find the position of this argument within the view. | |
$position = 0; | |
foreach ($this->view->argument as $id => $argument) { | |
if ($id == $this->options['id']) { | |
break; | |
} | |
$position++; | |
} | |
$arg = isset($this->view->args[$position]) ? $this->view->args[$position] : NULL; | |
$this->position = $position; | |
// Clone ourselves so that we don't break things when we're really | |
// processing the arguments. | |
$argument = clone $this; | |
if (!isset($arg) && $argument->hasDefaultArgument()) { | |
$arg = $argument->getDefaultArgument(); | |
// remember that this argument was computed, not passed on the URL. | |
$this->is_default = TRUE; | |
} | |
// Set the argument, which will also validate that the argument can be set. | |
if ($argument->setArgument($arg)) { | |
$value = $argument->argument; | |
} | |
unset($argument); | |
return $value; | |
} | |
/** | |
* Get the display or row plugin, if it exists. | |
*/ | |
public function getPlugin($type = 'argument_default', $name = NULL) { | |
$options = array(); | |
switch ($type) { | |
case 'argument_default': | |
if (!isset($this->options['default_argument_type'])) { | |
return; | |
} | |
$plugin_name = $this->options['default_argument_type']; | |
$options_name = 'default_argument_options'; | |
break; | |
case 'argument_validator': | |
if (!isset($this->options['validate']['type'])) { | |
return; | |
} | |
$plugin_name = $this->options['validate']['type']; | |
$options_name = 'validate_options'; | |
break; | |
case 'style': | |
if (!isset($this->options['summary']['format'])) { | |
return; | |
} | |
$plugin_name = $this->options['summary']['format']; | |
$options_name = 'summary_options'; | |
} | |
if (!$name) { | |
$name = $plugin_name; | |
} | |
// we only fetch the options if we're fetching the plugin actually | |
// in use. | |
if ($name == $plugin_name) { | |
$options = isset($this->options[$options_name]) ? $this->options[$options_name] : []; | |
} | |
$plugin = Views::pluginManager($type)->createInstance($name); | |
if ($plugin) { | |
$plugin->init($this->view, $this->displayHandler, $options); | |
if ($type !== 'style') { | |
// It's an argument_default/argument_validate plugin, so set the argument. | |
$plugin->setArgument($this); | |
} | |
return $plugin; | |
} | |
} | |
/** | |
* Return a description of how the argument would normally be sorted. | |
* | |
* Subclasses should override this to specify what the default sort order of | |
* their argument is (e.g. alphabetical, numeric, date). | |
*/ | |
public function getSortName() { | |
return $this->t('Default sort', array(), array('context' => 'Sort order')); | |
} | |
/** | |
* Custom form radios process function. | |
* | |
* Roll out a single radios element to a list of radios, using the options | |
* array as index. While doing that, create a container element underneath | |
* each option, which contains the settings related to that option. | |
* | |
* @see \Drupal\Core\Render\Element\Radios::processRadios() | |
*/ | |
public static function processContainerRadios($element) { | |
if (count($element['#options']) > 0) { | |
foreach ($element['#options'] as $key => $choice) { | |
$element += array($key => array()); | |
// Generate the parents as the autogenerator does, so we will have a | |
// unique id for each radio button. | |
$parents_for_id = array_merge($element['#parents'], array($key)); | |
$element[$key] += array( | |
'#type' => 'radio', | |
'#title' => $choice, | |
// The key is sanitized in drupal_attributes() during output from the | |
// theme function. | |
'#return_value' => $key, | |
'#default_value' => isset($element['#default_value']) ? $element['#default_value'] : NULL, | |
'#attributes' => $element['#attributes'], | |
'#parents' => $element['#parents'], | |
'#id' => Html::getUniqueId('edit-' . implode('-', $parents_for_id)), | |
'#ajax' => isset($element['#ajax']) ? $element['#ajax'] : NULL, | |
); | |
$element[$key . '_options'] = array( | |
'#type' => 'container', | |
'#attributes' => array('class' => array('views-admin-dependent')), | |
); | |
} | |
} | |
return $element; | |
} | |
/** | |
* Moves argument options into their place. | |
* | |
* When configuring the default argument behavior, almost each of the radio | |
* buttons has its own fieldset shown bellow it when the radio button is | |
* clicked. That fieldset is created through a custom form process callback. | |
* Each element that has #argument_option defined and pointing to a default | |
* behavior gets moved to the appropriate fieldset. | |
* So if #argument_option is specified as 'default', the element is moved | |
* to the 'default_options' fieldset. | |
*/ | |
public static function preRenderMoveArgumentOptions($form) { | |
foreach (Element::children($form) as $key) { | |
$element = $form[$key]; | |
if (!empty($element['#argument_option'])) { | |
$container_name = $element['#argument_option'] . '_options'; | |
if (isset($form['no_argument']['default_action'][$container_name])) { | |
$form['no_argument']['default_action'][$container_name][$key] = $element; | |
} | |
// Remove the original element this duplicates. | |
unset($form[$key]); | |
} | |
} | |
return $form; | |
} | |
/** | |
* Sanitize validator options including derivatives with : for js. | |
* | |
* Reason and alternative: https://www.drupal.org/node/2035345. | |
* | |
* @param string $id | |
* The identifier to be sanitized. | |
* | |
* @return string | |
* The sanitized identifier. | |
* | |
* @see decodeValidatorId(). | |
*/ | |
public static function encodeValidatorId($id) { | |
return str_replace(':', '---', $id); | |
} | |
/** | |
* Revert sanitized validator options. | |
* | |
* @param string $id | |
* The sanitized identifier to be reverted. | |
* | |
* @return string | |
* The original identifier. | |
*/ | |
public static function decodeValidatorId($id) { | |
return str_replace('---', ':', $id); | |
} | |
/** | |
* Splits an argument into value and operator properties on this instance. | |
* | |
* @param bool $force_int | |
* Enforce that values should be numeric. | |
*/ | |
protected function unpackArgumentValue($force_int = FALSE) { | |
$break = static::breakString($this->argument, $force_int); | |
$this->value = $break->value; | |
$this->operator = $break->operator; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function getCacheMaxAge() { | |
$max_age = Cache::PERMANENT; | |
// Asks all subplugins (argument defaults, argument validator and styles). | |
if (($plugin = $this->getPlugin('argument_default')) && $plugin instanceof CacheableDependencyInterface) { | |
$max_age = Cache::mergeMaxAges($max_age, $plugin->getCacheMaxAge()); | |
} | |
if (($plugin = $this->getPlugin('argument_validator')) && $plugin instanceof CacheableDependencyInterface) { | |
$max_age = Cache::mergeMaxAges($max_age, $plugin->getCacheMaxAge()); | |
} | |
// Summaries use style plugins. | |
if (($plugin = $this->getPlugin('style')) && $plugin instanceof CacheableDependencyInterface) { | |
$max_age = Cache::mergeMaxAges($max_age, $plugin->getCacheMaxAge()); | |
} | |
return $max_age; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function getCacheContexts() { | |
$contexts = []; | |
// By definition arguments depends on the URL. | |
// @todo Once contexts are properly injected into block views we could pull | |
// the information from there. | |
$contexts[] = 'url'; | |
// Asks all subplugins (argument defaults, argument validator and styles). | |
if (($plugin = $this->getPlugin('argument_default')) && $plugin instanceof CacheableDependencyInterface) { | |
$contexts = Cache::mergeContexts($contexts, $plugin->getCacheContexts()); | |
} | |
if (($plugin = $this->getPlugin('argument_validator')) && $plugin instanceof CacheableDependencyInterface) { | |
$contexts = Cache::mergeContexts($contexts, $plugin->getCacheContexts()); | |
} | |
if (($plugin = $this->getPlugin('style')) && $plugin instanceof CacheableDependencyInterface) { | |
$contexts = Cache::mergeContexts($contexts, $plugin->getCacheContexts()); | |
} | |
return $contexts; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function getCacheTags() { | |
$tags = []; | |
// Asks all subplugins (argument defaults, argument validator and styles). | |
if (($plugin = $this->getPlugin('argument_default')) && $plugin instanceof CacheableDependencyInterface) { | |
$tags = Cache::mergeTags($tags, $plugin->getCacheTags()); | |
} | |
if (($plugin = $this->getPlugin('argument_validator')) && $plugin instanceof CacheableDependencyInterface) { | |
$tags = Cache::mergeTags($tags, $plugin->getCacheTags()); | |
} | |
if (($plugin = $this->getPlugin('style')) && $plugin instanceof CacheableDependencyInterface) { | |
$tags = Cache::mergeTags($tags, $plugin->getCacheTags()); | |
} | |
return $tags; | |
} | |
/** | |
* {@inheritdoc} | |
*/ | |
public function calculateDependencies() { | |
$dependencies = []; | |
if (($argument_default = $this->getPlugin('argument_default')) && $argument_default instanceof DependentPluginInterface) { | |
$dependencies = NestedArray::mergeDeep($dependencies, $argument_default->calculateDependencies()); | |
} | |
if (($argument_validator = $this->getPlugin('argument_validator')) && $argument_validator instanceof DependentPluginInterface) { | |
$dependencies = NestedArray::mergeDeep($dependencies, $argument_validator->calculateDependencies()); | |
} | |
if (($style = $this->getPlugin('style')) && $style instanceof DependentPluginInterface) { | |
$dependencies = NestedArray::mergeDeep($dependencies, $style->calculateDependencies()); | |
} | |
return $dependencies; | |
} | |
} | |
/** | |
* @} | |
*/ |