You are here

Home » API reference » Drupal 8 » SwitchShortcutSet.php

class SwitchShortcutSet in Drupal 8

Same name and namespace in other branches
  1. 9 core/modules/shortcut/src/Form/SwitchShortcutSet.php \Drupal\shortcut\Form\SwitchShortcutSet
  2. 10 core/modules/shortcut/src/Form/SwitchShortcutSet.php \Drupal\shortcut\Form\SwitchShortcutSet

Builds the shortcut set switch form.

@internal

Hierarchy

Expanded class hierarchy of SwitchShortcutSet

1 string reference to 'SwitchShortcutSet'
shortcut.routing.yml in core/modules/shortcut/shortcut.routing.yml
core/modules/shortcut/shortcut.routing.yml

File

core/modules/shortcut/src/Form/SwitchShortcutSet.php, line 18

Namespace

Drupal\shortcut\Form
View source 
class SwitchShortcutSet extends FormBase {

  /**
   * The account the shortcut set is for.
   *
   * @var \Drupal\user\UserInterface
   */
  protected $user;

  /**
   * The shortcut set storage.
   *
   * @var \Drupal\shortcut\ShortcutSetStorageInterface
   */
  protected $shortcutSetStorage;

  /**
   * Constructs a SwitchShortcutSet object.
   *
   * @param \Drupal\shortcut\ShortcutSetStorageInterface $shortcut_set_storage
   *   The shortcut set storage.
   */
  public function __construct(ShortcutSetStorageInterface $shortcut_set_storage) {
    $this->shortcutSetStorage = $shortcut_set_storage;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container) {
    return new static($container
      ->get('entity_type.manager')
      ->getStorage('shortcut_set'));
  }

  /**
   * {@inheritdoc}
   */
  public function getFormId() {
    return 'shortcut_set_switch';
  }

  /**
   * {@inheritdoc}
   */
  public function buildForm(array $form, FormStateInterface $form_state, UserInterface $user = NULL) {
    $account = $this
      ->currentUser();
    $this->user = $user;

    // Prepare the list of shortcut sets.
    $options = array_map(function (ShortcutSet $set) {
      return $set
        ->label();
    }, $this->shortcutSetStorage
      ->loadMultiple());
    $current_set = shortcut_current_displayed_set($this->user);

    // Only administrators can add shortcut sets.
    $add_access = $account
      ->hasPermission('administer shortcuts');
    if ($add_access) {
      $options['new'] = $this
        ->t('New set');
    }
    $account_is_user = $this->user
      ->id() == $account
      ->id();
    if (count($options) > 1) {
      $form['set'] = [
        '#type' => 'radios',
        '#title' => $account_is_user ? $this
          ->t('Choose a set of shortcuts to use') : $this
          ->t('Choose a set of shortcuts for this user'),
        '#options' => $options,
        '#default_value' => $current_set
          ->id(),
      ];
      $form['label'] = [
        '#type' => 'textfield',
        '#title' => $this
          ->t('Label'),
        '#description' => $this
          ->t('The new set is created by copying items from your default shortcut set.'),
        '#access' => $add_access,
        '#states' => [
          'visible' => [
            ':input[name="set"]' => [
              'value' => 'new',
            ],
          ],
          'required' => [
            ':input[name="set"]' => [
              'value' => 'new',
            ],
          ],
        ],
      ];
      $form['id'] = [
        '#type' => 'machine_name',
        '#machine_name' => [
          'exists' => [
            $this,
            'exists',
          ],
          'replace_pattern' => '[^a-z0-9-]+',
          'replace' => '-',
        ],
        // This ID could be used for menu name.
        '#maxlength' => 23,
        '#states' => [
          'required' => [
            ':input[name="set"]' => [
              'value' => 'new',
            ],
          ],
        ],
        '#required' => FALSE,
      ];
      if (!$account_is_user) {
        $default_set = $this->shortcutSetStorage
          ->getDefaultSet($this->user);
        $form['new']['#description'] = $this
          ->t('The new set is created by copying items from the %default set.', [
          '%default' => $default_set
            ->label(),
        ]);
      }
      $form['actions'] = [
        '#type' => 'actions',
      ];
      $form['actions']['submit'] = [
        '#type' => 'submit',
        '#value' => $this
          ->t('Change set'),
      ];
    }
    else {

      // There is only 1 option, so output a message in the $form array.
      $form['info'] = [
        '#markup' => '<p>' . $this
          ->t('You are currently using the %set-name shortcut set.', [
          '%set-name' => $current_set
            ->label(),
        ]) . '</p>',
      ];
    }
    return $form;
  }

  /**
   * Determines if a shortcut set exists already.
   *
   * @param string $id
   *   The set ID to check.
   *
   * @return bool
   *   TRUE if the shortcut set exists, FALSE otherwise.
   */
  public function exists($id) {
    return (bool) $this->shortcutSetStorage
      ->getQuery()
      ->condition('id', $id)
      ->execute();
  }

  /**
   * {@inheritdoc}
   */
  public function validateForm(array &$form, FormStateInterface $form_state) {
    if ($form_state
      ->getValue('set') == 'new') {

      // Check to prevent creating a shortcut set with an empty title.
      if (trim($form_state
        ->getValue('label')) == '') {
        $form_state
          ->setErrorByName('label', $this
          ->t('The new set label is required.'));
      }
    }
  }

  /**
   * {@inheritdoc}
   */
  public function submitForm(array &$form, FormStateInterface $form_state) {
    $account = $this
      ->currentUser();
    $account_is_user = $this->user
      ->id() == $account
      ->id();
    if ($form_state
      ->getValue('set') == 'new') {

      // Save a new shortcut set with links copied from the user's default set.

      /* @var \Drupal\shortcut\Entity\ShortcutSet $set */
      $set = $this->shortcutSetStorage
        ->create([
        'id' => $form_state
          ->getValue('id'),
        'label' => $form_state
          ->getValue('label'),
      ]);
      $set
        ->save();
      $replacements = [
        '%user' => $this->user
          ->label(),
        '%set_name' => $set
          ->label(),
        ':switch-url' => Url::fromRoute('<current>')
          ->toString(),
      ];
      if ($account_is_user) {

        // Only administrators can create new shortcut sets, so we know they have
        // access to switch back.
        $this
          ->messenger()
          ->addStatus($this
          ->t('You are now using the new %set_name shortcut set. You can edit it from this page or <a href=":switch-url">switch back to a different one.</a>', $replacements));
      }
      else {
        $this
          ->messenger()
          ->addStatus($this
          ->t('%user is now using a new shortcut set called %set_name. You can edit it from this page.', $replacements));
      }
      $form_state
        ->setRedirect('entity.shortcut_set.customize_form', [
        'shortcut_set' => $set
          ->id(),
      ]);
    }
    else {

      // Switch to a different shortcut set.

      /* @var \Drupal\shortcut\Entity\ShortcutSet $set */
      $set = $this->shortcutSetStorage
        ->load($form_state
        ->getValue('set'));
      $replacements = [
        '%user' => $this->user
          ->getDisplayName(),
        '%set_name' => $set
          ->label(),
      ];
      $this
        ->messenger()
        ->addStatus($account_is_user ? $this
        ->t('You are now using the %set_name shortcut set.', $replacements) : $this
        ->t('%user is now using the %set_name shortcut set.', $replacements));
    }

    // Assign the shortcut set to the provided user account.
    $this->shortcutSetStorage
      ->assignUser($set, $this->user);
  }

  /**
   * Checks access for the shortcut set switch form.
   *
   * @param \Drupal\user\UserInterface $user
   *   (optional) The owner of the shortcut set.
   *
   * @return \Drupal\Core\Access\AccessResultInterface
   *   The access result.
   */
  public function checkAccess(UserInterface $user = NULL) {
    return shortcut_set_switch_access($user);
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DependencySerializationTrait::$_entityStorages protected property An array of entity type IDs keyed by the property name of their storages.
DependencySerializationTrait::$_serviceIds protected property An array of service IDs keyed by property name used for serialization.
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
FormBase::$configFactory protected property The config factory. 1
FormBase::$requestStack protected property The request stack. 1
FormBase::$routeMatch protected property The route match.
FormBase::config protected function Retrieves a configuration object.
FormBase::configFactory protected function Gets the config factory for this form. 1
FormBase::container private function Returns the service container.
FormBase::currentUser protected function Gets the current user.
FormBase::getRequest protected function Gets the request object.
FormBase::getRouteMatch protected function Gets the route match.
FormBase::logger protected function Gets the logger for a specific channel.
FormBase::redirect protected function Returns a redirect response object for the specified route. Overrides UrlGeneratorTrait::redirect
FormBase::resetConfigFactory public function Resets the configuration factory.
FormBase::setConfigFactory public function Sets the config factory for this form.
FormBase::setRequestStack public function Sets the request stack object to use.
LinkGeneratorTrait::$linkGenerator protected property The link generator. 1
LinkGeneratorTrait::getLinkGenerator Deprecated protected function Returns the link generator.
LinkGeneratorTrait::l Deprecated protected function Renders a link to a route given a route name and its parameters.
LinkGeneratorTrait::setLinkGenerator Deprecated public function Sets the link generator service.
LoggerChannelTrait::$loggerFactory protected property The logger channel factory service.
LoggerChannelTrait::getLogger protected function Gets the logger for a specific channel.
LoggerChannelTrait::setLoggerFactory public function Injects the logger channel factory.
MessengerTrait::$messenger protected property The messenger. 29
MessengerTrait::messenger public function Gets the messenger. 29
MessengerTrait::setMessenger public function Sets the messenger.
RedirectDestinationTrait::$redirectDestination protected property The redirect destination service. 1
RedirectDestinationTrait::getDestinationArray protected function Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url.
RedirectDestinationTrait::getRedirectDestination protected function Returns the redirect destination service.
RedirectDestinationTrait::setRedirectDestination public function Sets the redirect destination service.
StringTranslationTrait::$stringTranslation protected property The string translation service. 1
StringTranslationTrait::formatPlural protected function Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals protected function Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation protected function Gets the string translation service.
StringTranslationTrait::setStringTranslation public function Sets the string translation service to use. 2
StringTranslationTrait::t protected function Translates a string to the current language or to a given language.
SwitchShortcutSet::$shortcutSetStorage protected property The shortcut set storage.
SwitchShortcutSet::$user protected property The account the shortcut set is for.
SwitchShortcutSet::buildForm public function Form constructor. Overrides FormInterface::buildForm
SwitchShortcutSet::checkAccess public function Checks access for the shortcut set switch form.
SwitchShortcutSet::create public static function Instantiates a new instance of this class. Overrides FormBase::create
SwitchShortcutSet::exists public function Determines if a shortcut set exists already.
SwitchShortcutSet::getFormId public function Returns a unique string identifying the form. Overrides FormInterface::getFormId
SwitchShortcutSet::submitForm public function Form submission handler. Overrides FormInterface::submitForm
SwitchShortcutSet::validateForm public function Form validation handler. Overrides FormBase::validateForm
SwitchShortcutSet::__construct public function Constructs a SwitchShortcutSet object.
UrlGeneratorTrait::$urlGenerator protected property The url generator.
UrlGeneratorTrait::getUrlGenerator Deprecated protected function Returns the URL generator service.
UrlGeneratorTrait::setUrlGenerator Deprecated public function Sets the URL generator service.
UrlGeneratorTrait::url Deprecated protected function Generates a URL or path for a specific route based on the given parameters.