You are here

Home » API reference » YAML Form 8 » YamlFormSubmissionsDeleteFormBase.php

abstract class YamlFormSubmissionsDeleteFormBase in YAML Form 8

Base form for deleting form submission.

Hierarchy

Expanded class hierarchy of YamlFormSubmissionsDeleteFormBase

File

src/Form/YamlFormSubmissionsDeleteFormBase.php, line 16

Namespace

Drupal\yamlform\Form
View source 
abstract class YamlFormSubmissionsDeleteFormBase extends ConfirmFormBase {

  /**
   * Default number of submission to be deleted during batch processing.
   *
   * @var int
   */
  protected $batchLimit = 1000;

  /**
   * The form entity.
   *
   * @var \Drupal\yamlform\YamlFormInterface
   */
  protected $yamlform;

  /**
   * The form source entity.
   *
   * @var \Drupal\Core\Entity\EntityInterface
   */
  protected $sourceEntity;

  /**
   * The form submission storage.
   *
   * @var \Drupal\yamlform\YamlFormSubmissionStorageInterface
   */
  protected $submissionStorage;

  /**
   * Form request handler.
   *
   * @var \Drupal\yamlform\YamlFormRequestInterface
   */
  protected $requestHandler;

  /**
   * Constructs a new YamlFormResultsDeleteBaseForm object.
   *
   * @param \Drupal\yamlform\YamlFormSubmissionStorageInterface $yamlform_submission_storage
   *   The form submission storage.
   * @param \Drupal\yamlform\YamlFormRequestInterface $request_handler
   *   The form request handler.
   */
  public function __construct(YamlFormSubmissionStorageInterface $yamlform_submission_storage, YamlFormRequestInterface $request_handler) {
    $this->submissionStorage = $yamlform_submission_storage;
    $this->requestHandler = $request_handler;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container) {
    return new static($container
      ->get('entity.manager')
      ->getStorage('yamlform_submission'), $container
      ->get('yamlform.request'));
  }

  /**
   * {@inheritdoc}
   */
  public function getConfirmText() {
    return $this
      ->t('Clear');
  }

  /**
   * {@inheritdoc}
   */
  public function buildForm(array $form, FormStateInterface $form_state) {
    list($this->yamlform, $this->sourceEntity) = $this->requestHandler
      ->getYamlFormEntities();
    return parent::buildForm($form, $form_state);
  }

  /**
   * {@inheritdoc}
   */
  public function submitForm(array &$form, FormStateInterface $form_state) {
    $form_state
      ->setRedirectUrl($this
      ->getCancelUrl());
    if ($this->submissionStorage
      ->getTotal($this->yamlform, $this->sourceEntity) < $this
      ->getBatchLimit()) {
      $this->submissionStorage
        ->deleteAll($this->yamlform, $this->sourceEntity);
      drupal_set_message($this
        ->getFinishedMessage());
    }
    else {
      $this
        ->batchSet($this->yamlform, $this->sourceEntity);
    }
  }

  /**
   * Message to displayed after submissions are deleted.
   *
   * @return \Drupal\Core\StringTranslation\TranslatableMarkup
   *   Message to be displayed after delete has finished.
   */
  public function getFinishedMessage() {
    return $this
      ->t('Form submissions cleared.');
  }

  /**
   * Batch API; Initialize batch operations.
   *
   * @param \Drupal\yamlform\YamlFormInterface|null $yamlform
   *   The form.
   * @param \Drupal\Core\Entity\EntityInterface|null $entity
   *   The form's source entity.
   */
  public function batchSet(YamlFormInterface $yamlform = NULL, EntityInterface $entity = NULL) {
    $parameters = [
      $yamlform,
      $entity,
      $this->submissionStorage
        ->getMaxSubmissionId($yamlform, $entity),
    ];
    $batch = [
      'title' => $this
        ->t('Clear submissions'),
      'init_message' => $this
        ->t('Clearing submission data'),
      'error_message' => $this
        ->t('The submissions could not be cleared because an error occurred.'),
      'operations' => [
        [
          [
            $this,
            'batchProcess',
          ],
          $parameters,
        ],
      ],
      'finished' => [
        $this,
        'batchFinish',
      ],
    ];
    batch_set($batch);
  }

  /**
   * Get the number of submissions to be deleted with each batch.
   *
   * @return int
   *   Number of submissions to be deleted with each batch.
   */
  public function getBatchLimit() {
    return $this
      ->config('yamlform.settings')
      ->get('batch.default_batch_delete_size') ?: $this->batchLimit;
  }

  /**
   * Batch API callback; Delete submissions.
   *
   * @param \Drupal\yamlform\YamlFormInterface|null $yamlform
   *   The form.
   * @param \Drupal\Core\Entity\EntityInterface|null $entity
   *   The form's source entity.
   * @param int $max_sid
   *   The max submission ID to be delete.
   * @param mixed|array $context
   *   The batch current context.
   */
  public function batchProcess(YamlFormInterface $yamlform = NULL, EntityInterface $entity = NULL, $max_sid, &$context) {

    // ISSUE:
    // $this->submissionStorage is not being setup via
    // YamlFormSubmissionsDeleteFormBase::__construct.
    //
    // WORKAROUND:
    // Reset it for each batch process.
    $this->submissionStorage = \Drupal::entityTypeManager()
      ->getStorage('yamlform_submission');
    if (empty($context['sandbox'])) {
      $context['sandbox']['progress'] = 0;
      $context['sandbox']['max'] = $this->submissionStorage
        ->getTotal($yamlform, $entity);
      $context['results']['yamlform'] = $yamlform;
      $context['results']['entity'] = $entity;
    }

    // Track progress.
    $context['sandbox']['progress'] += $this->submissionStorage
      ->deleteAll($yamlform, $entity, $this
      ->getBatchLimit(), $max_sid);
    $context['message'] = $this
      ->t('Deleting @count of @total submissions...', [
      '@count' => $context['sandbox']['progress'],
      '@total' => $context['sandbox']['max'],
    ]);

    // Track finished.
    if ($context['sandbox']['progress'] != $context['sandbox']['max']) {
      $context['finished'] = $context['sandbox']['progress'] / $context['sandbox']['max'];
    }
  }

  /**
   * Batch API callback; Completed deletion.
   *
   * @param bool $success
   *   TRUE if batch successfully completed.
   * @param array $results
   *   Batch results.
   * @param array $operations
   *   An array of function calls (not used in this function).
   */
  public function batchFinish($success = FALSE, array $results, array $operations) {
    if (!$success) {
      drupal_set_message($this
        ->t('Finished with an error.'));
    }
    else {
      drupal_set_message($this
        ->getFinishedMessage());
    }
  }

}

Members

Namesort descending Modifiers Type Description Overrides
ConfirmFormBase::getCancelText public function Returns a caption for the link which cancels the action. Overrides ConfirmFormInterface::getCancelText 1
ConfirmFormBase::getDescription public function Returns additional text to display as a description. Overrides ConfirmFormInterface::getDescription 11
ConfirmFormBase::getFormName public function Returns the internal name used to refer to the confirmation item. Overrides ConfirmFormInterface::getFormName
ConfirmFormInterface::getCancelUrl public function Returns the route to go to if the user cancels the action. 32
ConfirmFormInterface::getQuestion public function Returns the question to ask the user. 33
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.
FormBase::validateForm public function Form validation handler. Overrides FormInterface::validateForm 62
FormInterface::getFormId public function Returns a unique string identifying the form. 236
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.
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.
YamlFormSubmissionsDeleteFormBase::$batchLimit protected property Default number of submission to be deleted during batch processing.
YamlFormSubmissionsDeleteFormBase::$requestHandler protected property Form request handler.
YamlFormSubmissionsDeleteFormBase::$sourceEntity protected property The form source entity.
YamlFormSubmissionsDeleteFormBase::$submissionStorage protected property The form submission storage.
YamlFormSubmissionsDeleteFormBase::$yamlform protected property The form entity.
YamlFormSubmissionsDeleteFormBase::batchFinish public function Batch API callback; Completed deletion.
YamlFormSubmissionsDeleteFormBase::batchProcess public function Batch API callback; Delete submissions.
YamlFormSubmissionsDeleteFormBase::batchSet public function Batch API; Initialize batch operations.
YamlFormSubmissionsDeleteFormBase::buildForm public function Form constructor. Overrides ConfirmFormBase::buildForm 1
YamlFormSubmissionsDeleteFormBase::create public static function Instantiates a new instance of this class. Overrides FormBase::create
YamlFormSubmissionsDeleteFormBase::getBatchLimit public function Get the number of submissions to be deleted with each batch.
YamlFormSubmissionsDeleteFormBase::getConfirmText public function Returns a caption for the button that confirms the action. Overrides ConfirmFormBase::getConfirmText 1
YamlFormSubmissionsDeleteFormBase::getFinishedMessage public function Message to displayed after submissions are deleted. 1
YamlFormSubmissionsDeleteFormBase::submitForm public function Form submission handler. Overrides FormInterface::submitForm
YamlFormSubmissionsDeleteFormBase::__construct public function Constructs a new YamlFormResultsDeleteBaseForm object.