You are here

Home » API reference » Display Suite 8.2 » DsLayout.php

class DsLayout in Display Suite 8.2

Same name and namespace in other branches
  1. 8.4 src/Plugin/DsLayout.php \Drupal\ds\Plugin\DsLayout
  2. 8.3 src/Plugin/DsLayout.php \Drupal\ds\Plugin\DsLayout

Layout class for all Display Suite layouts.

Hierarchy

Expanded class hierarchy of DsLayout

2 string references to 'DsLayout'
ds.layouts.yml in ./ds.layouts.yml
ds.layouts.yml
ds_test.layouts.yml in tests/modules/ds_test/ds_test.layouts.yml
tests/modules/ds_test/ds_test.layouts.yml

File

src/Plugin/DsLayout.php, line 14

Namespace

Drupal\ds\Plugin
View source 
class DsLayout extends LayoutBase {

  /**
   * {@inheritdoc}
   */
  public function defaultConfiguration() {
    return parent::defaultConfiguration() + [
      'wrappers' => [],
      'outer_wrapper' => 'div',
      'attributes' => '',
      'link_attribute' => '',
      'link_custom' => '',
      'classes' => [
        'layout_class' => [],
      ],
    ];
  }

  /**
   * {@inheritdoc}
   */
  public function buildConfigurationForm(array $form, FormStateInterface $form_state) {
    $form = parent::buildConfigurationForm($form, $form_state);
    $configuration = $this
      ->getConfiguration();
    $regions = $this
      ->getRegionDefinitions();

    // Add wrappers.
    $wrapper_options = array(
      'div' => 'Div',
      'span' => 'Span',
      'section' => 'Section',
      'article' => 'Article',
      'header' => 'Header',
      'footer' => 'Footer',
      'aside' => 'Aside',
      'figure' => 'Figure',
    );
    $form['region_wrapper'] = array(
      '#group' => 'additional_settings',
      '#type' => 'details',
      '#title' => $this
        ->t('Custom wrappers'),
      '#description' => $this
        ->t('Choose a wrapper. All Display Suite layouts support this option.'),
      '#tree' => TRUE,
    );
    foreach ($regions as $region_name => $region_definition) {
      $form['region_wrapper'][$region_name] = array(
        '#type' => 'select',
        '#options' => $wrapper_options,
        '#title' => $this
          ->t('Wrapper for @region', array(
          '@region' => $region_definition['label'],
        )),
        '#default_value' => !empty($configuration['wrappers'][$region_name]) ? $configuration['wrappers'][$region_name] : 'div',
      );
    }
    $form['region_wrapper']['outer_wrapper'] = array(
      '#type' => 'select',
      '#options' => $wrapper_options,
      '#title' => $this
        ->t('Outer wrapper'),
      '#default_value' => $configuration['outer_wrapper'],
      '#weight' => 10,
    );
    $form['region_wrapper']['attributes'] = array(
      '#type' => 'textfield',
      '#title' => $this
        ->t('Layout attributes'),
      '#description' => 'E.g. role|navigation,data-something|some value',
      '#default_value' => $configuration['attributes'],
      '#weight' => 11,
    );
    $form['region_wrapper']['link_attribute'] = array(
      '#type' => 'select',
      '#options' => array(
        '' => $this
          ->t('No link'),
        'content' => $this
          ->t('Link to content'),
        'custom' => $this
          ->t('Custom'),
        'tokens' => $this
          ->t('Tokens'),
      ),
      '#title' => $this
        ->t('Add link'),
      '#description' => $this
        ->t('This will add an onclick attribute on the layout wrapper.'),
      '#default_value' => $configuration['link_attribute'],
      '#weight' => 12,
    );
    $form['region_wrapper']['link_custom'] = array(
      '#type' => 'textfield',
      '#title' => $this
        ->t('Custom link'),
      '#description' => $this
        ->t('You may use tokens for this link if you selected tokens.'),
      '#default_value' => $configuration['link_custom'],
      '#weight' => 13,
      '#states' => array(
        'visible' => array(
          array(
            ':input[name="layout_configuration[region_wrapper][link_attribute]"]' => array(
              array(
                "value" => "tokens",
              ),
              array(
                "value" => "custom",
              ),
            ),
          ),
        ),
      ),
    );
    if (\Drupal::moduleHandler()
      ->moduleExists('token')) {
      $form['region_wrapper']['tokens'] = array(
        '#title' => $this
          ->t('Tokens'),
        '#type' => 'container',
        '#weight' => 14,
        '#states' => array(
          'visible' => array(
            ':input[name="layout_configuration[region_wrapper][link_attribute]"]' => array(
              "value" => "tokens",
            ),
          ),
        ),
      );
      $form['region_wrapper']['tokens']['help'] = array(
        '#theme' => 'token_tree_link',
        '#token_types' => 'all',
        '#global_types' => FALSE,
        '#dialog' => TRUE,
      );
    }

    // Add extra classes for the regions to have more control while theming.
    $form['ds_classes'] = array(
      '#group' => 'additional_settings',
      '#type' => 'details',
      '#title' => $this
        ->t('Custom classes'),
      '#tree' => TRUE,
      '#collapsible' => TRUE,
      '#collapsed' => TRUE,
    );
    $classes_access = \Drupal::currentUser()
      ->hasPermission('admin_classes');
    $classes = Ds::getClasses();
    if (!empty($classes)) {
      $form['ds_classes']['layout_class'] = array(
        '#type' => 'select',
        '#multiple' => TRUE,
        '#options' => $classes,
        '#title' => $this
          ->t('Class for layout'),
        '#default_value' => !empty($configuration['classes']['layout_class']) ? $configuration['classes']['layout_class'] : [],
      );
      foreach ($regions as $region_name => $region_definition) {
        $form['ds_classes'][$region_name] = array(
          '#type' => 'select',
          '#multiple' => TRUE,
          '#options' => $classes,
          '#title' => $this
            ->t('Class for @region', array(
            '@region' => $region_definition['label'],
          )),
          '#default_value' => isset($configuration['classes'][$region_name]) ? $configuration['classes'][$region_name] : [],
        );
      }
      if ($classes_access) {
        $url = Url::fromRoute('ds.classes');
        $destination = \Drupal::destination()
          ->getAsArray();
        $url
          ->setOption('query', $destination);
        $form['ds_classes']['info'] = array(
          '#markup' => \Drupal::l($this
            ->t('Manage region and field CSS classes'), $url),
        );
      }
    }
    else {
      if ($classes_access) {
        $url = Url::fromRoute('ds.classes');
        $destination = \Drupal::destination()
          ->getAsArray();
        $url
          ->setOption('query', $destination);
        $form['ds_classes']['info'] = array(
          '#markup' => '<p>' . $this
            ->t('You have not defined any CSS classes which can be used on regions.') . '</p><p>' . \Drupal::l($this
            ->t('Manage region and field CSS classes'), $url) . '</p>',
        );
      }
      else {
        $form['ds_classes']['#access'] = FALSE;
      }
    }
    return $form;
  }

  /**
   * {@inheritdoc}
   */
  public function submitConfigurationForm(array &$form, FormStateInterface $form_state) {
    $this->configuration['wrappers'] = $form_state
      ->getValue('region_wrapper');
    foreach ([
      'outer_wrapper',
      'attributes',
      'link_attribute',
      'link_custom',
    ] as $name) {
      $this->configuration[$name] = $this->configuration['wrappers'][$name];
      unset($this->configuration['wrappers'][$name]);
    }

    // Apply Xss::filter to attributes.
    $this->configuration['attributes'] = Xss::filter($this->configuration['attributes']);

    // In case classes is missing entirely, use the defaults.
    $defaults = $this
      ->defaultConfiguration();
    $this->configuration['classes'] = $form_state
      ->getValue('ds_classes', $defaults['classes']);

    // Do not save empty classes.
    foreach ($this->configuration['classes'] as $region_name => &$classes) {
      foreach ($classes as $class) {
        if (empty($class)) {
          unset($classes[$class]);
        }
      }
    }
  }

}

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
DsLayout::buildConfigurationForm public function Form constructor. Overrides LayoutBase::buildConfigurationForm
DsLayout::defaultConfiguration public function Gets default configuration for this plugin. Overrides LayoutBase::defaultConfiguration
DsLayout::submitConfigurationForm public function Form submission handler. Overrides LayoutBase::submitConfigurationForm
LayoutBase::$configuration protected property The layout configuration. Overrides PluginBase::$configuration
LayoutBase::build public function Build a render array for layout with regions. Overrides LayoutInterface::build
LayoutBase::calculateDependencies public function Calculates dependencies for the configured plugin. Overrides DependentPluginInterface::calculateDependencies
LayoutBase::getBasePath public function Gets the path to resources like icon or template.
LayoutBase::getCategory public function Gets the human-readable category.
LayoutBase::getConfiguration public function Gets this plugin's configuration. Overrides ConfigurablePluginInterface::getConfiguration
LayoutBase::getDescription public function Gets the optional description for advanced layouts.
LayoutBase::getIconFilename public function Gets the path to the preview image.
LayoutBase::getLabel public function Gets the human-readable name.
LayoutBase::getLibrary public function Get the asset library.
LayoutBase::getRegionDefinitions public function Gets information on regions keyed by machine name.
LayoutBase::getRegionNames public function Gets human-readable list of regions keyed by machine name.
LayoutBase::getThemeHook public function Gets the theme hook used to render this layout.
LayoutBase::setConfiguration public function Sets the configuration for this plugin instance. Overrides ConfigurablePluginInterface::setConfiguration
LayoutBase::validateConfigurationForm public function Form validation handler. Overrides PluginFormInterface::validateConfigurationForm
MessengerTrait::$messenger protected property The messenger. 29
MessengerTrait::messenger public function Gets the messenger. 29
MessengerTrait::setMessenger public function Sets the messenger.
PluginBase::$pluginDefinition protected property The plugin implementation definition. 1
PluginBase::$pluginId protected property The plugin_id.
PluginBase::DERIVATIVE_SEPARATOR constant A string which is used to separate base plugin IDs from the derivative ID.
PluginBase::getBaseId public function Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface::getBaseId
PluginBase::getDerivativeId public function Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface::getDerivativeId
PluginBase::getPluginDefinition public function Gets the definition of the plugin implementation. Overrides PluginInspectionInterface::getPluginDefinition 3
PluginBase::getPluginId public function Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface::getPluginId
PluginBase::isConfigurable public function Determines if the plugin is configurable.
PluginBase::__construct public function Constructs a \Drupal\Component\Plugin\PluginBase object. 92
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.