You are here

Home » API reference » Webform 6.x » WebformSubmissionsDeleteFormBase.php

abstract class WebformSubmissionsDeleteFormBase in Webform 6.x

Same name and namespace in other branches
  1. 8.5 src/Form/WebformSubmissionsDeleteFormBase.php \Drupal\webform\Form\WebformSubmissionsDeleteFormBase

Base webform for deleting webform submission.

Hierarchy

Expanded class hierarchy of WebformSubmissionsDeleteFormBase

File

src/Form/WebformSubmissionsDeleteFormBase.php, line 14

Namespace

Drupal\webform\Form
View source 
abstract class WebformSubmissionsDeleteFormBase extends WebformDeleteFormBase {
  use WebformEntityStorageTrait;

  /**
   * Total number of submissions.
   *
   * @var int
   */
  protected $submissionTotal;

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

  /**
   * The webform entity.
   *
   * @var \Drupal\webform\WebformInterface
   */
  protected $webform;

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

  /**
   * The entity type manager.
   *
   * @var \Drupal\Core\Entity\EntityTypeManagerInterface
   */
  protected $entityTypeManager;

  /**
   * The webform request handler.
   *
   * @var \Drupal\webform\WebformRequestInterface
   */
  protected $requestHandler;

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container) {
    $instance = parent::create($container);
    $instance->entityTypeManager = $container
      ->get('entity_type.manager');
    $instance->requestHandler = $container
      ->get('webform.request');
    list($instance->webform, $instance->sourceEntity) = $instance->requestHandler
      ->getWebformEntities();
    return $instance;
  }

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

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

  /**
   * Get webform or source entity label.
   *
   * @return null|string
   *   Webform or source entity label.
   */
  public function getLabel() {
    if ($this->sourceEntity) {
      return $this->sourceEntity
        ->label();
    }
    elseif ($this->webform
      ->label()) {
      return $this->webform
        ->label();
    }
    else {
      return '';
    }
  }

  /**
   * 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('Webform submissions cleared.');
  }

  /****************************************************************************/

  // Batch API.

  /****************************************************************************/

  /**
   * Batch API; Initialize batch operations.
   *
   * @param \Drupal\webform\WebformInterface|null $webform
   *   The webform.
   * @param \Drupal\Core\Entity\EntityInterface|null $entity
   *   The webform's source entity.
   */
  public function batchSet(WebformInterface $webform = NULL, EntityInterface $entity = NULL) {
    $parameters = [
      $webform,
      $entity,
      $this
        ->getSubmissionStorage()
        ->getMaxSubmissionId($webform, $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('webform.settings')
      ->get('batch.default_batch_delete_size') ?: $this->batchLimit;
  }

  /**
   * Batch API callback; Delete submissions.
   *
   * @param \Drupal\webform\WebformInterface|null $webform
   *   The webform.
   * @param \Drupal\Core\Entity\EntityInterface|null $entity
   *   The webform'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(WebformInterface $webform = NULL, EntityInterface $entity = NULL, $max_sid, &$context) {
    if (empty($context['sandbox'])) {
      $context['sandbox']['progress'] = 0;
      $context['sandbox']['max'] = $this
        ->getSubmissionStorage()
        ->getTotal($webform, $entity, NULL, [
        'in_draft' => NULL,
      ]);
      $context['results']['webform'] = $webform;
      $context['results']['entity'] = $entity;
    }

    // Track progress.
    $context['sandbox']['progress'] += $this
      ->getSubmissionStorage()
      ->deleteAll($webform, $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) {
      $this
        ->messenger()
        ->addStatus($this
        ->t('Finished with an error.'));
    }
    else {
      $this
        ->messenger()
        ->addStatus($this
        ->getFinishedMessage());
    }
  }

  /**
   * Get total number of submissions.
   *
   * @return int
   *   Total number of submissions.
   */
  protected function getSubmissionTotal() {
    if (!isset($this->submissionTotal)) {
      $this->submissionTotal = $this
        ->getSubmissionStorage()
        ->getTotal($this->webform, $this->sourceEntity, NULL, [
        'in_draft' => NULL,
      ]);
    }
    return $this->submissionTotal;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
ConfirmFormBase::getCancelText public function Returns a caption for the link which cancels the action. Overrides ConfirmFormInterface::getCancelText 2
ConfirmFormInterface::getCancelUrl public function Returns the route to go to if the user cancels the action. 38
ConfirmFormInterface::getQuestion public function Returns the question to ask the user. 39
DependencySerializationTrait::$_entityStorages protected property
DependencySerializationTrait::$_serviceIds protected property
DependencySerializationTrait::__sleep public function 2
DependencySerializationTrait::__wakeup public function 2
FormBase::$configFactory protected property The config factory. 3
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. 3
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.
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 72
FormInterface::getFormId public function Returns a unique string identifying the form. 264
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. 27
MessengerTrait::messenger public function Gets the messenger. 27
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. 4
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.
WebformAjaxFormTrait::announce protected function Queue announcement with Ajax response.
WebformAjaxFormTrait::buildAjaxForm protected function Add Ajax support to a form.
WebformAjaxFormTrait::createAjaxResponse protected function Create an AjaxResponse or WebformAjaxResponse object.
WebformAjaxFormTrait::getAnnouncements protected function Get announcements.
WebformAjaxFormTrait::getDefaultAjaxSettings protected function Get default ajax callback settings. 1
WebformAjaxFormTrait::getFormStateRedirectUrl protected function Get redirect URL from the form's state.
WebformAjaxFormTrait::getWrapperId protected function Get the form's Ajax wrapper id. 1
WebformAjaxFormTrait::isCallableAjaxCallback protected function Determine if Ajax callback is callable.
WebformAjaxFormTrait::isDialog protected function Is the current request for an Ajax modal/dialog.
WebformAjaxFormTrait::isOffCanvasDialog protected function Is the current request for an off canvas dialog.
WebformAjaxFormTrait::missingAjaxCallback protected function Handle missing Ajax callback.
WebformAjaxFormTrait::replaceForm protected function Replace form via an Ajax response. 1
WebformAjaxFormTrait::resetAnnouncements protected function Reset announcements.
WebformAjaxFormTrait::setAnnouncements protected function Set announcements.
WebformAjaxFormTrait::submitAjaxForm public function Submit form #ajax callback. 1
WebformAjaxFormTrait::validateAjaxForm public function Validate form #ajax callback. 1
WebformDeleteFormBase::buildForm public function Form constructor. Overrides ConfirmFormBase::buildForm 6
WebformDeleteFormBase::getConfirmInput public function Returns confirm input to display. Overrides WebformDeleteFormInterface::getConfirmInput 3
WebformDeleteFormBase::getDescription public function Returns additional text to display as a description. Overrides ConfirmFormBase::getDescription 6
WebformDeleteFormBase::getDetails public function Returns details to display. Overrides WebformDeleteFormInterface::getDetails 1
WebformDeleteFormBase::getFormName public function Returns the internal name used to refer to the confirmation item. Overrides ConfirmFormBase::getFormName
WebformDeleteFormBase::getWarning public function Returns warning message to display. Overrides WebformDeleteFormInterface::getWarning 6
WebformDialogFormTrait::buildDialogConfirmForm protected function Add modal dialog support to a confirm form.
WebformDialogFormTrait::buildDialogDeleteAction protected function Build webform dialog delete link.
WebformDialogFormTrait::buildDialogForm protected function Add modal dialog support to a form.
WebformDialogFormTrait::cancelAjaxForm public function Cancel form #ajax callback. Overrides WebformAjaxFormTrait::cancelAjaxForm 1
WebformDialogFormTrait::closeDialog public function Close dialog.
WebformDialogFormTrait::isAjax protected function Returns if webform is using Ajax. Overrides WebformAjaxFormTrait::isAjax 1
WebformDialogFormTrait::noSubmit public function Empty submit callback used to only have the submit button to use an #ajax submit callback. Overrides WebformAjaxFormTrait::noSubmit
WebformDialogFormTrait::noValidate public function Validate callback to clear validation errors. 2
WebformEntityStorageTrait::$entityStorageToTypeMappings protected property An associate array of entity type storage aliases.
WebformEntityStorageTrait::getEntityStorage protected function Retrieves the entity storage.
WebformEntityStorageTrait::getSubmissionStorage protected function Retrieves the webform submission storage.
WebformEntityStorageTrait::getWebformStorage protected function Retrieves the webform storage.
WebformEntityStorageTrait::__get public function Implements the magic __get() method.
WebformSubmissionsDeleteFormBase::$batchLimit protected property Default number of submission to be deleted during batch processing.
WebformSubmissionsDeleteFormBase::$entityTypeManager protected property The entity type manager. Overrides WebformEntityStorageTrait::$entityTypeManager
WebformSubmissionsDeleteFormBase::$requestHandler protected property The webform request handler.
WebformSubmissionsDeleteFormBase::$sourceEntity protected property The webform source entity.
WebformSubmissionsDeleteFormBase::$submissionTotal protected property Total number of submissions.
WebformSubmissionsDeleteFormBase::$webform protected property The webform entity.
WebformSubmissionsDeleteFormBase::batchFinish public function Batch API callback; Completed deletion.
WebformSubmissionsDeleteFormBase::batchProcess public function Batch API callback; Delete submissions.
WebformSubmissionsDeleteFormBase::batchSet public function Batch API; Initialize batch operations.
WebformSubmissionsDeleteFormBase::create public static function Instantiates a new instance of this class. Overrides FormBase::create
WebformSubmissionsDeleteFormBase::getBatchLimit public function Get the number of submissions to be deleted with each batch.
WebformSubmissionsDeleteFormBase::getConfirmText public function Returns a caption for the button that confirms the action. Overrides WebformDeleteFormBase::getConfirmText 1
WebformSubmissionsDeleteFormBase::getFinishedMessage public function Message to displayed after submissions are deleted. 1
WebformSubmissionsDeleteFormBase::getLabel public function Get webform or source entity label.
WebformSubmissionsDeleteFormBase::getSubmissionTotal protected function Get total number of submissions. 1
WebformSubmissionsDeleteFormBase::submitForm public function Form submission handler. Overrides FormInterface::submitForm