LinksWidget.php in Facets 8

Namespace

Drupal\facets\Plugin\facets\widget

File

src/Plugin/facets/widget/LinksWidget.php

<?php

namespace Drupal\facets\Plugin\facets\widget;

use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Url;
use Drupal\facets\FacetInterface;
use Drupal\facets\Result\Result;
use Drupal\facets\Widget\WidgetPluginBase;

/**
 * The links widget.
 *
 * @FacetsWidget(
 *   id = "links",
 *   label = @Translation("List of links"),
 *   description = @Translation("A simple widget that shows a list of links"),
 * )
 */
class LinksWidget extends WidgetPluginBase {

  /**
   * {@inheritdoc}
   */
  public function defaultConfiguration() {
    return [
      'soft_limit' => 0,
      'soft_limit_settings' => [
        'show_less_label' => 'Show less',
        'show_more_label' => 'Show more',
      ],
      'show_reset_link' => FALSE,
      'hide_reset_when_no_selection' => FALSE,
      'reset_text' => $this
        ->t('Show all'),
    ] + parent::defaultConfiguration();
  }

  /**
   * {@inheritdoc}
   */
  public function build(FacetInterface $facet) {
    $build = parent::build($facet);
    $this
      ->appendWidgetLibrary($build);
    $soft_limit = (int) $this
      ->getConfiguration()['soft_limit'];
    if ($soft_limit !== 0) {
      $show_less_label = $this
        ->getConfiguration()['soft_limit_settings']['show_less_label'];
      $show_more_label = $this
        ->getConfiguration()['soft_limit_settings']['show_more_label'];
      $build['#attached']['library'][] = 'facets/soft-limit';
      $build['#attached']['drupalSettings']['facets']['softLimit'][$facet
        ->id()] = $soft_limit;
      $build['#attached']['drupalSettings']['facets']['softLimitSettings'][$facet
        ->id()]['showLessLabel'] = $show_less_label;
      $build['#attached']['drupalSettings']['facets']['softLimitSettings'][$facet
        ->id()]['showMoreLabel'] = $show_more_label;
    }
    if ($facet
      ->getUseHierarchy()) {
      $build['#attached']['library'][] = 'facets/drupal.facets.hierarchical';
    }
    $results = $facet
      ->getResults();
    if ($this
      ->getConfiguration()['show_reset_link'] && count($results) > 0 && (!$this
      ->getConfiguration()['hide_reset_when_no_selection'] || $facet
      ->getActiveItems())) {

      // Add reset link.
      $max_items = array_sum(array_map(function ($item) {
        return $item
          ->getCount();
      }, $results));
      $urlProcessorManager = \Drupal::service('plugin.manager.facets.url_processor');
      $url_processor = $urlProcessorManager
        ->createInstance($facet
        ->getFacetSourceConfig()
        ->getUrlProcessorName(), [
        'facet' => $facet,
      ]);
      $active_filters = $url_processor
        ->getActiveFilters();
      if (isset($active_filters[''])) {
        unset($active_filters['']);
      }
      unset($active_filters[$facet
        ->id()]);

      // Only if there are still active filters, use url generator.
      if ($active_filters) {
        $url = \Drupal::service('facets.utility.url_generator')
          ->getUrl($active_filters, FALSE);
      }
      else {
        $request = \Drupal::request();
        $url = Url::createFromRequest($request);
        $params = $request->query
          ->all();
        unset($params[$url_processor
          ->getFilterKey()]);
        if (\array_key_exists('page', $params)) {

          // Go back to the first page on reset.
          unset($params['page']);
        }
        $url
          ->setRouteParameter('facets_query', '');
        $url
          ->setOption('query', $params);
      }
      $result_item = new Result($facet, 'reset_all', $this
        ->getConfiguration()['reset_text'], $max_items);
      $result_item
        ->setActiveState(FALSE);
      $result_item
        ->setUrl($url);

      // Check if any other facet is in use.
      $none_active = TRUE;
      foreach ($results as $result) {
        if ($result
          ->isActive() || $result
          ->hasActiveChildren()) {
          $none_active = FALSE;
          break;
        }
      }

      // Add an is-active class when no other facet is in use.
      if ($none_active) {
        $result_item
          ->setActiveState(TRUE);
      }

      // Build item.
      $item = $this
        ->buildListItems($facet, $result_item);

      // Add a class for the reset link wrapper.
      $item['#wrapper_attributes']['class'][] = 'facets-reset';

      // Put reset facet link on first place.
      array_unshift($build['#items'], $item);
    }
    return $build;
  }

  /**
   * Appends widget library and relevant information for it to build array.
   *
   * @param array $build
   *   Reference to build array.
   */
  protected function appendWidgetLibrary(array &$build) {
    $build['#attached']['library'][] = 'facets/drupal.facets.link-widget';
    $build['#attributes']['class'][] = 'js-facets-links';
  }

  /**
   * {@inheritdoc}
   */
  public function buildConfigurationForm(array $form, FormStateInterface $form_state, FacetInterface $facet) {
    $form = parent::buildConfigurationForm($form, $form_state, $facet);
    $options = [
      50,
      40,
      30,
      20,
      15,
      10,
      5,
      3,
    ];
    $form['soft_limit'] = [
      '#type' => 'select',
      '#title' => $this
        ->t('Soft limit'),
      '#default_value' => $this
        ->getConfiguration()['soft_limit'],
      '#options' => [
        0 => $this
          ->t('No limit'),
      ] + array_combine($options, $options),
      '#description' => $this
        ->t('Limit the number of displayed facets via JavaScript.'),
    ];
    $form['soft_limit_settings'] = [
      '#type' => 'container',
      '#title' => $this
        ->t('Soft limit settings'),
      '#states' => [
        'invisible' => [
          ':input[name="widget_config[soft_limit]"]' => [
            'value' => 0,
          ],
        ],
      ],
    ];
    $form['soft_limit_settings']['show_less_label'] = [
      '#type' => 'textfield',
      '#title' => $this
        ->t('Show less label'),
      '#description' => $this
        ->t('This text will be used for "Show less" link.'),
      '#default_value' => $this
        ->getConfiguration()['soft_limit_settings']['show_less_label'],
      '#states' => [
        'optional' => [
          ':input[name="widget_config[soft_limit]"]' => [
            'value' => 0,
          ],
        ],
      ],
    ];
    $form['soft_limit_settings']['show_more_label'] = [
      '#type' => 'textfield',
      '#title' => $this
        ->t('Show more label'),
      '#description' => $this
        ->t('This text will be used for "Show more" link.'),
      '#default_value' => $this
        ->getConfiguration()['soft_limit_settings']['show_more_label'],
      '#states' => [
        'optional' => [
          ':input[name="widget_config[soft_limit]"]' => [
            'value' => 0,
          ],
        ],
      ],
    ];
    $form['show_reset_link'] = [
      '#type' => 'checkbox',
      '#title' => $this
        ->t('Show reset link'),
      '#default_value' => $this
        ->getConfiguration()['show_reset_link'],
    ];
    $form['reset_text'] = [
      '#type' => 'textfield',
      '#title' => $this
        ->t('Reset text'),
      '#default_value' => $this
        ->getConfiguration()['reset_text'],
      '#states' => [
        'visible' => [
          ':input[name="widget_config[show_reset_link]"]' => [
            'checked' => TRUE,
          ],
        ],
        'required' => [
          ':input[name="widget_config[show_reset_link]"]' => [
            'checked' => TRUE,
          ],
        ],
      ],
    ];
    $form['hide_reset_when_no_selection'] = [
      '#type' => 'checkbox',
      '#title' => $this
        ->t('Hide reset link when no facet item is selected'),
      '#default_value' => $this
        ->getConfiguration()['hide_reset_when_no_selection'],
    ];
    return $form;
  }

}

Classes

Name	Description
LinksWidget	The links widget.