class DirectoryBrowser in Media Directories 3.x

Uses a view to provide entity listing in a browser's widget.

Plugin annotation

@EntityBrowserWidget(
  id = "directory_browser",
  label = @Translation("Directory browser"),
  provider = "views",
  description = @Translation("Classical directory browsing."),
  auto_select = TRUE
)

Hierarchy

• class \Drupal\media_directories_ui\Plugin\EntityBrowser\Widget\DirectoryBrowser extends \Drupal\entity_browser\WidgetBase implements ContainerFactoryPluginInterface

File

modules/media_directories_ui/src/Plugin/EntityBrowser/Widget/DirectoryBrowser.php, line 29

Namespace

Drupal\media_directories_ui\Plugin\EntityBrowser\Widget

class DirectoryBrowser extends WidgetBase implements ContainerFactoryPluginInterface {

  /**
   * The current user.
   *
   * @var \Drupal\Core\Session\AccountInterface
   */
  protected $currentUser;

  /**
   * {@inheritdoc}
   */
  public function defaultConfiguration() {
    return [] + parent::defaultConfiguration();
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
    return new static($configuration, $plugin_id, $plugin_definition, $container
      ->get('event_dispatcher'), $container
      ->get('entity_type.manager'), $container
      ->get('plugin.manager.entity_browser.widget_validation'), $container
      ->get('current_user'));
  }

  /**
   * Constructs a new View object.
   *
   * @param array $configuration
   *   A configuration array containing information about the plugin instance.
   * @param string $plugin_id
   *   The plugin_id for the plugin instance.
   * @param mixed $plugin_definition
   *   The plugin implementation definition.
   * @param \Symfony\Component\EventDispatcher\EventDispatcherInterface $event_dispatcher
   *   Event dispatcher service.
   * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
   *   The entity type manager.
   * @param \Drupal\entity_browser\WidgetValidationManager $validation_manager
   *   The Widget Validation Manager service.
   * @param \Drupal\Core\Session\AccountInterface $current_user
   *   The current user.
   */
  public function __construct(array $configuration, $plugin_id, $plugin_definition, EventDispatcherInterface $event_dispatcher, EntityTypeManagerInterface $entity_type_manager, WidgetValidationManager $validation_manager, AccountInterface $current_user) {
    parent::__construct($configuration, $plugin_id, $plugin_definition, $event_dispatcher, $entity_type_manager, $validation_manager);
    $this->currentUser = $current_user;
  }

  /**
   * {@inheritdoc}
   */
  public function getForm(array &$original_form, FormStateInterface $form_state, array $additional_widget_parameters) {
    $form = parent::getForm($original_form, $form_state, $additional_widget_parameters);
    $form['#attached']['library'][] = 'media_directories_ui/media-ui';
    $form['#attached']['library'][] = 'media_library/view';

    // Default values.
    $form['#attached']['drupalSettings']['media_directories']['cardinality'] = -1;
    $form['#attached']['drupalSettings']['media_directories']['target_bundles'] = [];

    // Routes for different actions.
    $form['#attached']['drupalSettings']['media_directories']['url'] = [
      'directory.tree' => Url::fromRoute('media_directories_ui.directory.tree')
        ->toString(),
      'directory.content' => Url::fromRoute('media_directories_ui.directory.content')
        ->toString(),
      'directory.add' => Url::fromRoute('media_directories_ui.directory.add')
        ->toString(),
      'directory.rename' => Url::fromRoute('media_directories_ui.directory.rename')
        ->toString(),
      'directory.delete' => Url::fromRoute('media_directories_ui.directory.delete')
        ->toString(),
      'directory.move' => Url::fromRoute('media_directories_ui.directory.move')
        ->toString(),
      'media.add' => Url::fromRoute('media_directories_ui.media.add')
        ->toString(),
      'media.edit' => Url::fromRoute('media_directories_ui.media.edit')
        ->toString(),
      'media.move' => Url::fromRoute('media_directories_ui.media.move')
        ->toString(),
      'media.delete' => Url::fromRoute('media_directories_ui.media.delete')
        ->toString(),
    ];
    $cardinality = (int) NestedArray::getValue($form_state
      ->getStorage(), [
      'entity_browser',
      'validators',
      'cardinality',
      'cardinality',
    ]);
    $remaining = (int) NestedArray::getValue($form_state
      ->getStorage(), [
      'entity_browser',
      'widget_context',
      'remaining',
    ]);
    $target_bundles = NestedArray::getValue($form_state
      ->getStorage(), [
      'entity_browser',
      'validators',
      'target_bundles',
    ]);
    if ($cardinality) {
      $form['#attached']['drupalSettings']['media_directories']['cardinality'] = $cardinality;
    }
    if ($remaining) {
      $form['#attached']['drupalSettings']['media_directories']['remaining'] = $remaining;
    }
    if ($target_bundles) {
      $enabled_bundles = $target_bundles['bundle'];
    }
    else {

      /** @var \Drupal\media\Entity\MediaType[] $types */
      $types = $this->entityTypeManager
        ->getStorage('media_type')
        ->loadMultiple();
      foreach ($types as $type) {
        $enabled_bundles[] = $type
          ->id();
      }
    }
    $form['#attached']['drupalSettings']['media_directories']['target_bundles'] = $enabled_bundles;
    $form['browser'] = [
      '#theme' => 'media_directories_browser',
    ];
    $form['browser']['active_directory'] = [
      '#type' => 'hidden',
      '#default_value' => MEDIA_DIRECTORY_ROOT,
    ];
    if ($this->configuration['entity_browser_id'] === 'directory_browser') {
      $form['actions']['#access'] = FALSE;
      $form['browser']['#attributes']['class'][] = 'media-browser--full';
    }
    else {
      $form['browser']['actions'] = $form['actions'];
      unset($form['actions']);
    }

    // When rebuilding makes no sense to keep checkboxes that were previously
    // selected.
    if (!empty($form['browser']['entity_browser_select'])) {
      foreach (Element::children($form['browser']['entity_browser_select']) as $child) {
        $form['browser']['entity_browser_select'][$child]['#process'][] = [
          '\\Drupal\\entity_browser\\Plugin\\EntityBrowser\\Widget\\View',
          'processCheckbox',
        ];
        $form['browser']['entity_browser_select'][$child]['#process'][] = [
          '\\Drupal\\Core\\Render\\Element\\Checkbox',
          'processAjaxForm',
        ];
        $form['browser']['entity_browser_select'][$child]['#process'][] = [
          '\\Drupal\\Core\\Render\\Element\\Checkbox',
          'processGroup',
        ];
      }
    }
    return $form;
  }

  /**
   * Sets the #checked property when rebuilding form.
   *
   * Every time when we rebuild we want all checkboxes to be unchecked.
   *
   * @see \Drupal\Core\Render\Element\Checkbox::processCheckbox()
   */
  public static function processCheckbox(&$element, FormStateInterface $form_state, &$complete_form) {
    if ($form_state
      ->isRebuilding()) {
      $element['#checked'] = FALSE;
    }
    return $element;
  }

  /**
   * {@inheritdoc}
   */
  public function validate(array &$form, FormStateInterface $form_state) {
    $user_input = $form_state
      ->getUserInput();
    if (isset($user_input['entity_browser_select'])) {
      $selected_rows = array_values(array_filter($user_input['entity_browser_select']));
      foreach ($selected_rows as $row) {

        // Verify that the user input is a string and split it.
        // Each $row is in the format entity_type:id.
        if (is_string($row) && ($parts = explode(':', $row, 2))) {

          // Make sure we have a type and id present.
          if (count($parts) == 2) {
            try {
              $storage = $this->entityTypeManager
                ->getStorage($parts[0]);
              if (!$storage
                ->load($parts[1])) {
                $message = $this
                  ->t('The @type Entity @id does not exist.', [
                  '@type' => $parts[0],
                  '@id' => $parts[1],
                ]);
                $form_state
                  ->setError($form['widget']['view']['entity_browser_select'], $message);
              }
            } catch (PluginNotFoundException $e) {
              $message = $this
                ->t('The Entity Type @type does not exist.', [
                '@type' => $parts[0],
              ]);
              $form_state
                ->setError($form['widget']['view']['entity_browser_select'], $message);
            }
          }
        }
      }

      // If there weren't any errors set, run the normal validators.
      if (empty($form_state
        ->getErrors())) {
        parent::validate($form, $form_state);
      }
    }
    else {
      $form_state
        ->setError($form, $this
        ->t('Please select media element!'));
    }
  }

  /**
   * {@inheritdoc}
   */
  protected function prepareEntities(array $form, FormStateInterface $form_state) {
    $selected_rows = array_values(array_filter($form_state
      ->getUserInput()['entity_browser_select']));
    $entities = [];
    foreach ($selected_rows as $row) {
      list($type, $id) = explode(':', $row);
      $storage = $this->entityTypeManager
        ->getStorage($type);
      if ($entity = $storage
        ->load($id)) {
        $entities[] = $entity;
      }
    }
    return $entities;
  }

  /**
   * {@inheritdoc}
   */
  public function submit(array &$element, array &$form, FormStateInterface $form_state) {
    $entities = $this
      ->prepareEntities($form, $form_state);
    $this
      ->selectEntities($entities, $form_state);
  }

  /**
   * {@inheritdoc}
   */
  public function buildConfigurationForm(array $form, FormStateInterface $form_state) {
    $form = parent::buildConfigurationForm($form, $form_state);
    return $form;
  }

  /**
   * {@inheritdoc}
   */
  public function submitConfigurationForm(array &$form, FormStateInterface $form_state) {
    $values = $form_state
      ->getValues()['table'][$this
      ->uuid()]['form'];
    $this->configuration['submit_text'] = $values['submit_text'];
    $this->configuration['auto_select'] = $values['auto_select'];
  }

}

Members

Name	Modifiers	Type	Description	Overrides
DirectoryBrowser::$currentUser	protected	property	The current user.
DirectoryBrowser::buildConfigurationForm	public	function
DirectoryBrowser::create	public static	function	Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface::create
DirectoryBrowser::defaultConfiguration	public	function
DirectoryBrowser::getForm	public	function
DirectoryBrowser::prepareEntities	protected	function
DirectoryBrowser::processCheckbox	public static	function	Sets the #checked property when rebuilding form.
DirectoryBrowser::submit	public	function
DirectoryBrowser::submitConfigurationForm	public	function
DirectoryBrowser::validate	public	function
DirectoryBrowser::__construct	public	function	Constructs a new View object.