Version 1
[yaffs-website] / web / modules / contrib / ctools / src / Form / RequiredContext.php
diff --git a/web/modules/contrib/ctools/src/Form/RequiredContext.php b/web/modules/contrib/ctools/src/Form/RequiredContext.php
new file mode 100644 (file)
index 0000000..76b5ec2
--- /dev/null
@@ -0,0 +1,212 @@
+<?php
+
+namespace Drupal\ctools\Form;
+
+use Drupal\Component\Plugin\PluginManagerInterface;
+use Drupal\Core\Ajax\AjaxResponse;
+use Drupal\Core\Ajax\OpenModalDialogCommand;
+use Drupal\Core\Form\FormBase;
+use Drupal\Core\Form\FormStateInterface;
+use Drupal\Core\Url;
+use Symfony\Component\DependencyInjection\ContainerInterface;
+
+abstract class RequiredContext extends FormBase {
+
+  /**
+   * @var \Drupal\Core\TypedData\TypedDataManager
+   */
+  protected $typedDataManager;
+
+  /**
+   * @var string
+   */
+  protected $machine_name;
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function create(ContainerInterface $container) {
+    return new static($container->get('typed_data_manager'));
+  }
+
+  public function __construct(PluginManagerInterface $typed_data_manager) {
+    $this->typedDataManager = $typed_data_manager;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function getFormId() {
+    return 'ctools_required_context_form';
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function buildForm(array $form, FormStateInterface $form_state) {
+    $cached_values = $form_state->getTemporaryValue('wizard');
+    $this->machine_name = $cached_values['id'];
+    $form['#attached']['library'][] = 'core/drupal.dialog.ajax';
+    $options = [];
+    foreach ($this->typedDataManager->getDefinitions() as $plugin_id => $definition) {
+      $options[$plugin_id] = (string) $definition['label'];
+    }
+    $form['items'] = array(
+      '#type' => 'markup',
+      '#prefix' => '<div id="configured-contexts">',
+      '#suffix' => '</div>',
+      '#theme' => 'table',
+      '#header' => array($this->t('Information'), $this->t('Description'), $this->t('Operations')),
+      '#rows' => $this->renderContexts($cached_values),
+      '#empty' => $this->t('No required contexts have been configured.')
+    );
+    $form['contexts'] = [
+      '#type' => 'select',
+      '#options' => $options,
+    ];
+    $form['add'] = [
+      '#type' => 'submit',
+      '#name' => 'add',
+      '#value' => $this->t('Add required context'),
+      '#ajax' => [
+        'callback' => [$this, 'add'],
+        'event' => 'click',
+      ],
+      '#submit' => [
+        'callback' => [$this, 'submitform'],
+      ]
+    ];
+    return $form;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function submitForm(array &$form, FormStateInterface $form_state) {
+    $cached_values = $form_state->getTemporaryValue('wizard');
+    list($route_name, $route_parameters) = $this->getOperationsRouteInfo($cached_values, $this->machine_name, $form_state->getValue('contexts'));
+    $form_state->setRedirect($route_name . '.edit', $route_parameters);
+  }
+
+  /**
+   * Custom ajax form submission handler.
+   *
+   * @param array $form
+   * @param \Drupal\Core\Form\FormStateInterface $form_state
+   *
+   * @return \Drupal\Core\Ajax\AjaxResponse
+   */
+  public function add(array &$form, FormStateInterface $form_state) {
+    $context = $form_state->getValue('contexts');
+    $content = \Drupal::formBuilder()->getForm($this->getContextClass(), $context, $this->getTempstoreId(), $this->machine_name);
+    $content['#attached']['library'][] = 'core/drupal.dialog.ajax';
+    $response = new AjaxResponse();
+    $response->addCommand(new OpenModalDialogCommand($this->t('Configure Required Context'), $content, array('width' => '700')));
+    return $response;
+  }
+
+  /**
+   * @param $cached_values
+   *
+   * @return array
+   */
+  public function renderContexts($cached_values) {
+    $configured_contexts = array();
+    foreach ($this->getContexts($cached_values) as $row => $context) {
+      list($plugin_id, $label, $machine_name, $description) = array_values($context);
+      list($route_name, $route_parameters) = $this->getOperationsRouteInfo($cached_values, $cached_values['id'], $row);
+      $build = array(
+        '#type' => 'operations',
+        '#links' => $this->getOperations($route_name, $route_parameters),
+      );
+      $configured_contexts[] = array(
+        $this->t('<strong>Label:</strong> @label<br /> <strong>Type:</strong> @type', ['@label' => $label, '@type' => $plugin_id]),
+        $this->t('@description', ['@description' => $description]),
+        'operations' => [
+          'data' => $build,
+        ],
+      );
+    }
+    return $configured_contexts;
+  }
+
+  protected function getOperations($route_name_base, array $route_parameters = array()) {
+    $operations['edit'] = array(
+      'title' => $this->t('Edit'),
+      'url' => new Url($route_name_base . '.edit', $route_parameters),
+      'weight' => 10,
+      'attributes' => array(
+        'class' => array('use-ajax'),
+        'data-accepts' => 'application/vnd.drupal-modal',
+        'data-dialog-options' => json_encode(array(
+          'width' => 700,
+        )),
+      ),
+      'ajax' => [
+        ''
+      ],
+    );
+    $route_parameters['id'] = $route_parameters['context'];
+    $operations['delete'] = array(
+      'title' => $this->t('Delete'),
+      'url' => new Url($route_name_base . '.delete', $route_parameters),
+      'weight' => 100,
+      'attributes' => array(
+        'class' => array('use-ajax'),
+        'data-accepts' => 'application/vnd.drupal-modal',
+        'data-dialog-options' => json_encode(array(
+          'width' => 700,
+        )),
+      ),
+    );
+    return $operations;
+  }
+
+  /**
+   * Return a subclass of '\Drupal\ctools\Form\ContextConfigure'.
+   *
+   * The ContextConfigure class is designed to be subclassed with custom route
+   * information to control the modal/redirect needs of your use case.
+   *
+   * @return string
+   */
+  abstract protected function getContextClass();
+
+  /**
+   * Provide the tempstore id for your specified use case.
+   *
+   * @return string
+   */
+  abstract protected function getTempstoreId();
+
+  /**
+   * Document the route name and parameters for edit/delete context operations.
+   *
+   * The route name returned from this method is used as a "base" to which
+   * ".edit" and ".delete" are appeneded in the getOperations() method.
+   * Subclassing '\Drupal\ctools\Form\ContextConfigure' and
+   * '\Drupal\ctools\Form\RequiredContextDelete' should set you up for using
+   * this approach quite seamlessly.
+   *
+   * @param mixed $cached_values
+   *
+   * @param string $machine_name
+   *
+   * @param string $row
+   *
+   * @return array
+   *   In the format of
+   *   return ['route.base.name', ['machine_name' => $machine_name, 'context' => $row]];
+   */
+  abstract protected function getOperationsRouteInfo($cached_values, $machine_name, $row);
+
+  /**
+   * Custom logic for retrieving the contexts array from cached_values.
+   *
+   * @param $cached_values
+   *
+   * @return array
+   */
+  abstract protected function getContexts($cached_values);
+
+}