splide-1.0.x-dev/modules/splide_ui/src/Controller/SplideListBuilder.php

<?php

namespace Drupal\splide_ui\Controller;

use Drupal\Component\Utility\Html;
use Drupal\Component\Utility\Xss;
use Drupal\Core\Entity\EntityInterface;
use Drupal\splide\Entity\SplideInterface;

/**
 * Provides a listing of Splide optionsets.
 */
class SplideListBuilder extends SplideListBuilderBase {

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

  /**
   * {@inheritdoc}
   */
  public function buildHeader() {
    $header = [
      'label'      => $this->t('Optionset'),
      'breakpoint' => $this->t('Breakpoint'),
      'group'      => $this->t('Group'),
      'nav'        => $this->t('Nav'),
      'skin'       => $this->t('Skin'),
    ];

    return $header + parent::buildHeader();
  }

  /**
   * {@inheritdoc}
   */
  public function buildRow(EntityInterface $entity) {
    // Satisfy phpstan.
    if (!($entity instanceof SplideInterface)) {
      return parent::buildRow($entity);
    }

    $skins = $this->manager->skinManager()->getSkins()['skins'];
    $skin = $entity->getSkin();

    $row['label'] = Html::escape($entity->label());
    $row['breakpoint']['#markup'] = $entity->getBreakpoint();
    $row['group']['#markup'] = $entity->getGroup() ?: $this->t('All');
    $row['nav']['#markup'] = $entity->getSetting('isNavigation') ? $this->t('Yes') : $this->t('No');

    $markup = $skin;
    if (isset($skins[$skin]['description'])) {
      // No need to re-translate, as already translated at SplideSkin.php.
      $markup .= '<br />' . Html::escape($skins[$skin]['description']);
    }

    $row['skin']['#markup'] = $markup;

    return $row + parent::buildRow($entity);
  }

  /**
   * Adds some descriptive text to the splide optionsets list.
   *
   * @return array
   *   Renderable array.
   */
  public function render() {
    $manager = $this->manager;

    $build['description'] = [
      '#markup' => $this->t("<p>Manage the Splide optionsets. Optionsets are Config Entities.</p><p>By default, when this module is enabled, a single optionset is created from configuration. Install Splide X module to speed up by cloning them. Use the Operations column to edit, clone and delete optionsets.<br /><strong>Important!</strong> Avoid overriding Default/ factory optionsets, even samples, as they are meant for Default -- checking and cleaning, and might be updated when a new library version has breaking changes. Use <strong>Duplicate</strong> instead. Otherwise messes are yours.<br />Splide doesn't need Splide UI to run. It is always safe to uninstall Splide UI once done with optionsets.</p>"),
    ];

    $availaible_skins = [];
    $skins = $manager->skinManager()->getSkins()['skins'];

    foreach ($skins as $key => $skin) {
      $name = $skin['name'] ?? $key;
      $group = Html::escape($skin['group'] ?? 'None');
      $provider = Html::escape($skin['provider'] ?? 'splide');
      $description = Xss::filterAdmin($skin['description'] ?? 'No description');

      $markup = '<h3>' . $this->t('@skin', [
        '@skin' => $name,
      ]) . '</h3>';

      $markup .= '<p>' . $this->t('Id: @id | Group: @group', [
        '@id' => $key,
        '@group' => $group,
      ]) . '</p>';

      $markup .= '<p><em>&mdash; ' . $description . '</em></p>';

      $availaible_skins[$provider][$key] = [
        '#markup' => '<div class="messages messages--status">' . $markup . '</div>',
      ];

      ksort($availaible_skins[$provider]);
    }

    ksort($availaible_skins);
    if ($item = $availaible_skins['splide']['default'] ?? []) {
      $core = $availaible_skins['splide'];
      unset($core['default']);
      $availaible_skins['splide'] = [
        'default' => $item,
      ];

      $availaible_skins['splide'] += $core;
    }

    $settings = [];
    $settings['grid'] = 3;
    $settings['grid_medium'] = 2;
    $settings['grid_small'] = 1;
    $settings['style'] = 'column';

    $header = '<br><hr><h2>' . $this->t('Available skins') . '</h2>';
    $header .= '<p>' . $this->t('Some skin works best with a specific Optionset, and vice versa. Use matching names if found. Else happy adventure!') . '</p>';
    $build['skins_header']['#markup'] = $header;
    $build['skins_header']['#weight'] = 20;

    $skin_items = [];
    foreach ($availaible_skins as $provider => $items) {
      $skin_items[$provider] = [
        '#type'  => 'details',
        '#open'  => FALSE,
        '#title' => $this->t('Provider: @provider', [
          '@provider' => $provider,
        ]),
      ];

      $grids = [];
      foreach ($items as $skin => $item) {
        $grids[$skin] = $item;
      }

      $skin_items[$provider]['list'] = [
        '#type' => 'container',
        'items' => $manager->toGrid($grids, $settings),
      ];
    }

    $build['skins'] = $skin_items;
    $build['skins']['#weight'] = 21;
    $build['skins']['#attached'] = $manager->attach($settings);
    $build['skins']['#attached']['library'][] = 'blazy/admin';

    $build[] = parent::render();
    return $build;
  }

}