--- /dev/null
+<?php
+
+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 {
+
+ public $validator = NULL;
+ public $argument = NULL;
+ public $value = NULL;
+
+ /**
+ * The table to use for the name, should it not be in the same table as the argument.
+ * @var string
+ */
+ public $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
+ */
+ public $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 bool
+ */
+ 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'] = ['default' => 'ignore'];
+ $options['exception'] = [
+ 'contains' => [
+ 'value' => ['default' => 'all'],
+ 'title_enable' => ['default' => FALSE],
+ 'title' => ['default' => 'All'],
+ ],
+ ];
+ $options['title_enable'] = ['default' => FALSE];
+ $options['title'] = ['default' => ''];
+ $options['default_argument_type'] = ['default' => 'fixed'];
+ $options['default_argument_options'] = ['default' => []];
+ $options['default_argument_skip_url'] = ['default' => FALSE];
+ $options['summary_options'] = ['default' => []];
+ $options['summary'] = [
+ 'contains' => [
+ 'sort_order' => ['default' => 'asc'],
+ 'number_of_records' => ['default' => 0],
+ 'format' => ['default' => 'default_summary'],
+ ],
+ ];
+ $options['specify_validation'] = ['default' => FALSE];
+ $options['validate'] = [
+ 'contains' => [
+ 'type' => ['default' => 'none'],
+ 'fail' => ['default' => 'not found'],
+ ],
+ ];
+ $options['validate_options'] = ['default' => []];
+
+ return $options;
+ }
+
+ public function buildOptionsForm(&$form, FormStateInterface $form_state) {
+ parent::buildOptionsForm($form, $form_state);
+
+ $argument_text = $this->view->display_handler->getArgumentText();
+
+ $form['#pre_render'][] = [get_class($this), 'preRenderMoveArgumentOptions'];
+
+ $form['description'] = [
+ '#markup' => $argument_text['description'],
+ '#theme_wrappers' => ['container'],
+ '#attributes' => ['class' => ['description']],
+ ];
+
+ $form['no_argument'] = [
+ '#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'] = [
+ '#weight' => 1000,
+ '#markup' => '<div class="clearfix"></div>',
+ ];
+ $form['default_action'] = [
+ '#title' => $this->t('Default actions'),
+ '#title_display' => 'invisible',
+ '#type' => 'radios',
+ '#process' => [[$this, 'processContainerRadios']],
+ '#default_value' => $this->options['default_action'],
+ '#fieldset' => 'no_argument',
+ ];
+
+ $form['exception'] = [
+ '#type' => 'details',
+ '#title' => $this->t('Exceptions'),
+ '#fieldset' => 'no_argument',
+ ];
+ $form['exception']['value'] = [
+ '#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'] = [
+ '#type' => 'checkbox',
+ '#title' => $this->t('Override title'),
+ '#default_value' => $this->options['exception']['title_enable'],
+ ];
+ $form['exception']['title'] = [
+ '#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' => [
+ 'visible' => [
+ ':input[name="options[exception][title_enable]"]' => ['checked' => TRUE],
+ ],
+ ],
+ ];
+
+ $options = [];
+ $defaults = $this->defaultActions();
+ $validate_options = [];
+ 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'] = [
+ '#type' => 'details',
+ '#title' => $argument_text['filter value present'],
+ '#open' => TRUE,
+ ];
+ $form['title_enable'] = [
+ '#type' => 'checkbox',
+ '#title' => $this->t('Override title'),
+ '#default_value' => $this->options['title_enable'],
+ '#fieldset' => 'argument_present',
+ ];
+ $form['title'] = [
+ '#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' => [
+ 'visible' => [
+ ':input[name="options[title_enable]"]' => ['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'] = [
+ '#type' => 'checkbox',
+ '#title' => $this->t('Specify validation criteria'),
+ '#default_value' => $this->options['specify_validation'],
+ '#fieldset' => 'argument_present',
+ ];
+
+ $form['validate'] = [
+ '#type' => 'container',
+ '#fieldset' => 'argument_present',
+ ];
+ // Validator options include derivatives with :. These are sanitized for js
+ // and reverted on submission.
+ $form['validate']['type'] = [
+ '#type' => 'select',
+ '#title' => $this->t('Validator'),
+ '#default_value' => static::encodeValidatorId($this->options['validate']['type']),
+ '#states' => [
+ 'visible' => [
+ ':input[name="options[specify_validation]"]' => ['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] = [
+ '#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' => [
+ 'visible' => [
+ ':input[name="options[specify_validation]"]' => ['checked' => TRUE],
+ ':input[name="options[validate][type]"]' => ['value' => $sanitized_id],
+ ],
+ ],
+ '#id' => 'edit-options-validate-options-' . $sanitized_id,
+ '#default_value' => [],
+ ];
+ $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'] = [
+ '#type' => 'select',
+ '#title' => $this->t('Action to take if filter value does not validate'),
+ '#default_value' => $this->options['validate']['fail'],
+ '#options' => $validate_options,
+ '#states' => [
+ 'visible' => [
+ ':input[name="options[specify_validation]"]' => ['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', ['@argument' => $handler->adminLabel()]);
+ $options[(string) t('Arguments')]["{{ raw_arguments.$arg }}"] = $this->t('@argument input', ['@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 = [];
+ foreach ($options[$type] as $key => $value) {
+ $items[] = $key . ' == ' . $value;
+ }
+ $item_list = [
+ '#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 = [
+ 'ignore' => [
+ 'title' => $this->t('Display all results for the specified field'),
+ 'method' => 'defaultIgnore',
+ ],
+ 'default' => [
+ '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' => [
+ 'title' => $this->t('Hide view'),
+ 'method' => 'defaultNotFound',
+ 'hard fail' => TRUE, // This is a hard fail condition
+ ],
+ 'summary' => [
+ 'title' => $this->t('Display a summary'),
+ 'method' => 'defaultSummary',
+ 'form method' => 'defaultSummaryForm',
+ 'style plugin' => TRUE,
+ ],
+ 'empty' => [
+ 'title' => $this->t('Display contents of "No results found"'),
+ 'method' => 'defaultEmpty',
+ ],
+ 'access denied' => [
+ '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 = [];
+
+ $form['default_argument_skip_url'] = [
+ '#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'] = [
+ '#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' => [
+ 'visible' => [
+ ':input[name="options[default_action]"]' => ['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] = [
+ '#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' => [
+ 'visible' => [
+ ':input[name="options[default_action]"]' => ['value' => 'default'],
+ ':input[name="options[default_argument_type]"]' => ['value' => $id],
+ ],
+ ],
+ '#default_value' => [],
+ ];
+ $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 = [];
+ $format_options = [];
+ 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'] = [
+ // Views custom key, moves this element to the appropriate container
+ // under the radio button.
+ '#argument_option' => 'summary',
+ ];
+ $form['summary']['sort_order'] = [
+ '#type' => 'radios',
+ '#title' => $this->t('Sort order'),
+ '#options' => ['asc' => $this->t('Ascending'), 'desc' => $this->t('Descending')],
+ '#default_value' => $this->options['summary']['sort_order'],
+ '#states' => [
+ 'visible' => [
+ ':input[name="options[default_action]"]' => ['value' => 'summary'],
+ ],
+ ],
+ ];
+ $form['summary']['number_of_records'] = [
+ '#type' => 'radios',
+ '#title' => $this->t('Sort by'),
+ '#default_value' => $this->options['summary']['number_of_records'],
+ '#options' => [
+ 0 => $this->getSortName(),
+ 1 => $this->t('Number of records')
+ ],
+ '#states' => [
+ 'visible' => [
+ ':input[name="options[default_action]"]' => ['value' => 'summary'],
+ ],
+ ],
+ ];
+
+ $form['summary']['format'] = [
+ '#type' => 'radios',
+ '#title' => $this->t('Format'),
+ '#options' => $format_options,
+ '#default_value' => $this->options['summary']['format'],
+ '#states' => [
+ 'visible' => [
+ ':input[name="options[default_action]"]' => ['value' => 'summary'],
+ ],
+ ],
+ ];
+
+ foreach ($summary_plugins as $id => $info) {
+ $plugin = $this->getPlugin('style', $id);
+ if (!$plugin->usesOptions()) {
+ continue;
+ }
+ if ($plugin) {
+ $form['summary']['options'][$id] = [
+ '#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' => [
+ 'visible' => [
+ ':input[name="options[default_action]"]' => ['value' => 'summary'],
+ ':input[name="options[summary][format]"]' => ['value' => $id],
+ ],
+ ],
+ '#default_value' => [],
+ ];
+ $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([&$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 = [];
+ 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.
+ */
+ public 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', ['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.
+ */
+ public 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 = [];
+ 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', [], ['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 += [$key => []];
+ // 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'], [$key]);
+
+ $element[$key] += [
+ '#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'] = [
+ '#type' => 'container',
+ '#attributes' => ['class' => ['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 below 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;
+ }
+
+ /**
+ * Returns a context definition for this argument.
+ *
+ * @return \Drupal\Core\Plugin\Context\ContextDefinitionInterface|null
+ * A context definition that represents the argument or NULL if that is
+ * not possible.
+ */
+ public function getContextDefinition() {
+ return $this->getPlugin('argument_validator')->getContextDefinition();
+ }
+
+}
+
+/**
+ * @}
+ */