interface WebformHandlerInterface in Webform 6.x

Defines the interface for webform handlers.

Hierarchy

• interface \Drupal\Component\Plugin\PluginInspectionInterface; interface \Drupal\Component\Plugin\ConfigurableInterface; interface \Drupal\Core\Plugin\ContainerFactoryPluginInterface; interface \Drupal\Core\Plugin\PluginFormInterface; interface \Drupal\webform\Plugin\WebformEntityInjectionInterface; interface \Drupal\webform\Plugin\WebformPluginSettingsInterface
  • interface \Drupal\webform\Plugin\WebformHandlerInterface

See also

\Drupal\webform\Annotation\WebformHandler

\Drupal\webform\Plugin\WebformHandlerBase

\Drupal\webform\Plugin\WebformHandlerManager

\Drupal\webform\Plugin\WebformHandlerManagerInterface

Plugin API

10 files declare their use of WebformHandlerInterface

Webform.php in src/Entity/Webform.php

WebformEntityHandlersForm.php in src/WebformEntityHandlersForm.php

WebformEntitySettingsGeneralForm.php in src/EntitySettings/WebformEntitySettingsGeneralForm.php

WebformHandler.php in src/Annotation/WebformHandler.php

WebformHandlerFormBase.php in src/Form/WebformHandlerFormBase.php

... See full list

File

src/Plugin/WebformHandlerInterface.php, line 23

Namespace

Drupal\webform\Plugin

interface WebformHandlerInterface extends PluginInspectionInterface, ConfigurableInterface, ContainerFactoryPluginInterface, PluginFormInterface, WebformEntityInjectionInterface, WebformPluginSettingsInterface {

  /**
   * Value indicating unlimited plugin instances are permitted.
   */
  const CARDINALITY_UNLIMITED = -1;

  /**
   * Value indicating a single plugin instances are permitted.
   */
  const CARDINALITY_SINGLE = 1;

  /**
   * Value indicating webform submissions are not processed (i.e. email or saved) by the handler.
   */
  const RESULTS_IGNORED = 0;

  /**
   * Value indicating webform submissions must be stored in the database.
   */
  const SUBMISSION_REQUIRED = 1;

  /**
   * Value indicating webform submissions do not have to be stored in the database.
   */
  const SUBMISSION_OPTIONAL = 0;

  /**
   * Value indicating webform submissions are processed (i.e. email or saved) by the handler.
   */
  const RESULTS_PROCESSED = 1;

  /**
   * Returns a render array summarizing the configuration of the webform handler.
   *
   * @return array
   *   A render array.
   */
  public function getSummary();

  /**
   * Returns the webform handler label.
   *
   * @return string
   *   The webform handler label.
   */
  public function label();

  /**
   * Returns the webform handler description.
   *
   * @return string
   *   The webform handler description.
   */
  public function description();

  /**
   * Returns the webform handler cardinality settings.
   *
   * @return string
   *   The webform handler cardinality settings.
   */
  public function cardinality();

  /**
   * Determine if webform handler supports conditions.
   *
   * @return bool
   *   TRUE if the webform handler supports conditions.
   */
  public function supportsConditions();

  /**
   * Determine if webform handler supports tokens.
   *
   * @return bool
   *   TRUE if the webform handler supports tokens.
   */
  public function supportsTokens();

  /**
   * Returns the unique ID representing the webform handler.
   *
   * @return string
   *   The webform handler ID.
   */
  public function getHandlerId();

  /**
   * Sets the id for this webform handler.
   *
   * @param int $handler_id
   *   The handler_id for this webform handler.
   *
   * @return $this
   */
  public function setHandlerId($handler_id);

  /**
   * Returns the label of the webform handler.
   *
   * @return int|string
   *   Either the integer label of the webform handler, or an empty string.
   */
  public function getLabel();

  /**
   * Sets the label for this webform handler.
   *
   * @param int $label
   *   The label for this webform handler.
   *
   * @return $this
   */
  public function setLabel($label);

  /**
   * Returns notes of the webform variant.
   *
   * @return string
   *   Notes for the webform variant, or an empty string.
   */
  public function getNotes();

  /**
   * Set notes for this webform variant.
   *
   * @param string $notes
   *   Notes for this webform variant.
   *
   * @return $this
   */
  public function setNotes($notes);

  /**
   * Returns the weight of the webform handler.
   *
   * @return int|string
   *   Either the integer weight of the webform handler, or an empty string.
   */
  public function getWeight();

  /**
   * Sets the weight for this webform handler.
   *
   * @param int $weight
   *   The weight for this webform handler.
   *
   * @return $this
   */
  public function setWeight($weight);

  /**
   * Returns the status of the webform handler.
   *
   * @return bool
   *   The status of the webform handler.
   */
  public function getStatus();

  /**
   * Sets the status for this webform handler.
   *
   * @param bool $status
   *   The status for this webform handler.
   *
   * @return $this
   */
  public function setStatus($status);

  /**
   * Returns the conditions the webform handler.
   *
   * @return array
   *   The conditions of the webform handler.
   */
  public function getConditions();

  /**
   * Sets the conditions for this webform handler.
   *
   * @param array $conditions
   *   The conditional logic for this webform handler.
   *
   * @return $this
   */
  public function setConditions(array $conditions);

  /**
   * Enables the webform handler.
   *
   * @return $this
   */
  public function enable();

  /**
   * Disables the webform handler.
   *
   * @return $this
   */
  public function disable();

  /**
   * Checks if the handler is excluded via webform.settings.
   *
   * @return bool
   *   TRUE if the handler is excluded.
   */
  public function isExcluded();

  /**
   * Returns the webform handler enabled indicator.
   *
   * @return bool
   *   TRUE if the webform handler is enabled.
   */
  public function isEnabled();

  /**
   * Returns the webform handler disabled indicator.
   *
   * @return bool
   *   TRUE if the webform handler is disabled.
   */
  public function isDisabled();

  /**
   * Determine if this handle is applicable to the webform.
   *
   * @param \Drupal\webform\WebformInterface $webform
   *   A webform.
   *
   * @return bool
   *   TRUE if this handler is applicable to the webform.
   */
  public function isApplicable(WebformInterface $webform);

  /**
   * Returns the webform submission is optional indicator.
   *
   * @return bool
   *   TRUE if the webform handler does not require the webform submission to
   *   be saved to the database.
   */
  public function isSubmissionOptional();

  /**
   * Returns the webform submission is required indicator.
   *
   * @return bool
   *   TRUE if the webform handler requires the webform submission to be saved
   *   to the database.
   */
  public function isSubmissionRequired();

  /**
   * Determine if the webform handler requires anonymous submission tracking.
   *
   * @return bool
   *   TRUE if the webform handler requires anonymous submission tracking.
   *
   * @see \Drupal\webform_options_limit\Plugin\WebformHandler\OptionsLimitWebformHandler
   */
  public function hasAnonymousSubmissionTracking();

  /**
   * Check handler conditions against a webform submission.
   *
   * Note: Conditions are only applied to callbacks that require a
   * webform submissions.
   *
   * Conditions are ignored by…
   * - \Drupal\webform\Plugin\WebformHandlerInterface::alterElements
   * - \Drupal\webform\Plugin\WebformHandlerInterface::preCreate
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   *
   * @return bool
   *   TRUE if handler is disable or webform submission passes conditions.
   *   FALSE if webform submission fails conditions.
   */
  public function checkConditions(WebformSubmissionInterface $webform_submission);

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

  // Webform methods.

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

  /**
   * Alter webform submission webform elements.
   *
   * Note: This hook is ignored by conditional logic.
   *
   * @param array $elements
   *   An associative array containing the webform elements.
   * @param \Drupal\webform\WebformInterface $webform
   *   The webform.
   */
  public function alterElements(array &$elements, WebformInterface $webform);

  /**
   * Alter webform element.
   *
   * @param array $element
   *   The webform element.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   * @param array $context
   *   An associative array containing the following key-value pairs:
   *   - form: The form structure to which elements is being attached.
   *
   * @see \Drupal\webform\WebformSubmissionForm::prepareElements()
   * @see hook_webform_element_alter()
   */
  public function alterElement(array &$element, FormStateInterface $form_state, array $context);

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

  // Webform submission methods.

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

  /**
   * Alter/override a webform submission webform settings.
   *
   * IMPORTANT: Webform settings are overridden for just the webform submission.
   * Overridden settings are never saved to the Webform's configuration.
   *
   * @param array $settings
   *   An associative array containing the webform settings.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function overrideSettings(array &$settings, WebformSubmissionInterface $webform_submission);

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

  // Submission form methods.

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

  /**
   * Get configuration form's off-canvas width.
   *
   * @return string
   *   The off-canvas width.
   *
   * @see WebformDialogHelper::DIALOG_NARROW
   * @see WebformDialogHelper::DIALOG_NORMAL
   * @see WebformDialogHelper::DIALOG_WIDE
   * @see WebformDialogHelper::DIALOG_NONE
   */
  public function getOffCanvasWidth();

  /**
   * Acts on an webform submission about to be shown on a webform submission form.
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   * @param string $operation
   *   The current operation.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   */
  public function prepareForm(WebformSubmissionInterface $webform_submission, $operation, FormStateInterface $form_state);

  /**
   * Alter webform submission form.
   *
   * @param array $form
   *   An associative array containing the structure of the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function alterForm(array &$form, FormStateInterface $form_state, WebformSubmissionInterface $webform_submission);

  /**
   * Validate webform submission form.
   *
   * @param array $form
   *   An associative array containing the structure of the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function validateForm(array &$form, FormStateInterface $form_state, WebformSubmissionInterface $webform_submission);

  /**
   * Submit webform submission form.
   *
   * @param array $form
   *   An associative array containing the structure of the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function submitForm(array &$form, FormStateInterface $form_state, WebformSubmissionInterface $webform_submission);

  /**
   * Confirm webform submission form.
   *
   * @param array $form
   *   An associative array containing the structure of the form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The current state of the form.
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function confirmForm(array &$form, FormStateInterface $form_state, WebformSubmissionInterface $webform_submission);

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

  // Submission methods.

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

  /**
   * Changes the values of an entity before it is created.
   *
   * Note: This hook is ignored by conditional logic.
   *
   * @param mixed[] $values
   *   An array of values to set, keyed by property name.
   */
  public function preCreate(array &$values);

  /**
   * Acts on a webform submission after it is created.
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function postCreate(WebformSubmissionInterface $webform_submission);

  /**
   * Acts on loaded webform submission.
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function postLoad(WebformSubmissionInterface $webform_submission);

  /**
   * Acts on a webform submission before the presave hook is invoked.
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function preSave(WebformSubmissionInterface $webform_submission);

  /**
   * Acts on a saved webform submission before the insert or update hook is invoked.
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   * @param bool $update
   *   TRUE if the entity has been updated, or FALSE if it has been inserted.
   */
  public function postSave(WebformSubmissionInterface $webform_submission, $update = TRUE);

  /**
   * Acts on webform submissions before they are purged.
   *
   * Used before the entities are purged and before they are deleted.
   *
   * @param \Drupal\webform\WebformSubmissionInterface[] $webform_submissions
   *   The webform submissions to be purged.
   */
  public function prePurge(array $webform_submissions);

  /**
   * Acts on webform submissions after they are purged.
   *
   * Used after the entities are purged and after they are deleted..
   *
   * @param \Drupal\webform\WebformSubmissionInterface[] $webform_submissions
   *   The webform submissions that were purged.
   */
  public function postPurge(array $webform_submissions);

  /**
   * Acts on a webform submission before they are deleted and before hooks are invoked.
   *
   * Used before the entities are deleted and before invoking the delete hook.
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function preDelete(WebformSubmissionInterface $webform_submission);

  /**
   * Acts on deleted a webform submission before the delete hook is invoked.
   *
   * Used after the entities are deleted but before invoking the delete hook.
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   */
  public function postDelete(WebformSubmissionInterface $webform_submission);

  /**
   * Controls entity operation access to webform submission.
   *
   * @param \Drupal\webform\WebformSubmissionInterface $webform_submission
   *   A webform submission.
   * @param string $operation
   *   The operation that is to be performed on $entity.
   * @param \Drupal\Core\Session\AccountInterface $account
   *   The account trying to access the entity.
   *
   * @return \Drupal\Core\Core\AccessResultInterface
   *   The result of the access check. No option returns a nuetral result.
   */
  public function access(WebformSubmissionInterface $webform_submission, $operation, AccountInterface $account = NULL);

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

  // Preprocessing methods.

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

  /**
   * Prepares variables for webform confirmation templates.
   *
   * Default template: webform-confirmation.html.twig.
   *
   * @param array $variables
   *   An associative array containing the following key:
   *   - webform: A webform.
   *   - webform_submission: A webform submission.
   *   - source_entity: A webform submission source entity.
   */
  public function preprocessConfirmation(array &$variables);

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

  // Handler methods.

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

  /**
   * Acts on handler after it has been created and added to webform.
   */
  public function createHandler();

  /**
   * Acts on handler after it has been updated.
   */
  public function updateHandler();

  /**
   * Acts on handler after it has been removed.
   */
  public function deleteHandler();

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

  // Element methods.

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

  /**
   * Controls entity operation access to webform submission element.
   *
   * @param array $element
   *   The element's properties.
   * @param string $operation
   *   The operation that is to be performed on $entity.
   * @param \Drupal\Core\Session\AccountInterface $account
   *   The account trying to access the entity.
   *
   * @return \Drupal\Core\Access\AccessResultInterface
   *   The result of the access check. Defaults to neutral.
   */
  public function accessElement(array &$element, $operation, AccountInterface $account = NULL);

  /**
   * Acts on a element after it has been created.
   *
   * @param string $key
   *   The element's key.
   * @param array $element
   *   The element's properties.
   */
  public function createElement($key, array $element);

  /**
   * Acts on a element after it has been updated.
   *
   * @param string $key
   *   The element's key.
   * @param array $element
   *   The element's properties.
   * @param array $original_element
   *   The original element's properties.
   */
  public function updateElement($key, array $element, array $original_element);

  /**
   * Acts on a element after it has been deleted.
   *
   * @param string $key
   *   The element's key.
   * @param array $element
   *   The element's properties.
   */
  public function deleteElement($key, array $element);

}

Members

Name	Modifiers	Type	Description	Overrides
ConfigurableInterface::defaultConfiguration	public	function	Gets default configuration for this plugin.	14
ConfigurableInterface::getConfiguration	public	function	Gets this plugin's configuration.	15
ConfigurableInterface::setConfiguration	public	function	Sets the configuration for this plugin instance.	15
ContainerFactoryPluginInterface::create	public static	function	Creates an instance of the plugin.	120
PluginFormInterface::buildConfigurationForm	public	function	Form constructor.	37
PluginFormInterface::submitConfigurationForm	public	function	Form submission handler.	32
PluginFormInterface::validateConfigurationForm	public	function	Form validation handler.	18
PluginInspectionInterface::getPluginDefinition	public	function	Gets the definition of the plugin implementation.	4
PluginInspectionInterface::getPluginId	public	function	Gets the plugin_id of the plugin instance.	2
WebformEntityInjectionInterface::getWebform	public	function	Get the webform that this handler is attached to.
WebformEntityInjectionInterface::getWebformSubmission	public	function	Get the webform submission that this handler is handling.
WebformEntityInjectionInterface::resetEntities	public	function	Reset webform and webform submission entity.
WebformEntityInjectionInterface::setEntities	public	function	Set webform and webform submission entity.
WebformEntityInjectionInterface::setWebform	public	function	Set the webform that this is handler is attached to.
WebformEntityInjectionInterface::setWebformSubmission	public	function	Set the webform submission that this handler is handling.
WebformHandlerInterface::access	public	function	Controls entity operation access to webform submission.	1
WebformHandlerInterface::accessElement	public	function	Controls entity operation access to webform submission element.	1
WebformHandlerInterface::alterElement	public	function	Alter webform element.	1
WebformHandlerInterface::alterElements	public	function	Alter webform submission webform elements.	1
WebformHandlerInterface::alterForm	public	function	Alter webform submission form.	1
WebformHandlerInterface::cardinality	public	function	Returns the webform handler cardinality settings.	1
WebformHandlerInterface::CARDINALITY_SINGLE		constant	Value indicating a single plugin instances are permitted.
WebformHandlerInterface::CARDINALITY_UNLIMITED		constant	Value indicating unlimited plugin instances are permitted.
WebformHandlerInterface::checkConditions	public	function	Check handler conditions against a webform submission.	1
WebformHandlerInterface::confirmForm	public	function	Confirm webform submission form.	1
WebformHandlerInterface::createElement	public	function	Acts on a element after it has been created.	1
WebformHandlerInterface::createHandler	public	function	Acts on handler after it has been created and added to webform.	1
WebformHandlerInterface::deleteElement	public	function	Acts on a element after it has been deleted.	1
WebformHandlerInterface::deleteHandler	public	function	Acts on handler after it has been removed.	1
WebformHandlerInterface::description	public	function	Returns the webform handler description.	1
WebformHandlerInterface::disable	public	function	Disables the webform handler.	1
WebformHandlerInterface::enable	public	function	Enables the webform handler.	1
WebformHandlerInterface::getConditions	public	function	Returns the conditions the webform handler.	1
WebformHandlerInterface::getHandlerId	public	function	Returns the unique ID representing the webform handler.	1
WebformHandlerInterface::getLabel	public	function	Returns the label of the webform handler.	1
WebformHandlerInterface::getNotes	public	function	Returns notes of the webform variant.	1
WebformHandlerInterface::getOffCanvasWidth	public	function	Get configuration form's off-canvas width.	1
WebformHandlerInterface::getStatus	public	function	Returns the status of the webform handler.	1
WebformHandlerInterface::getSummary	public	function	Returns a render array summarizing the configuration of the webform handler.	1
WebformHandlerInterface::getWeight	public	function	Returns the weight of the webform handler.	1
WebformHandlerInterface::hasAnonymousSubmissionTracking	public	function	Determine if the webform handler requires anonymous submission tracking.	1
WebformHandlerInterface::isApplicable	public	function	Determine if this handle is applicable to the webform.	1
WebformHandlerInterface::isDisabled	public	function	Returns the webform handler disabled indicator.	1
WebformHandlerInterface::isEnabled	public	function	Returns the webform handler enabled indicator.	1
WebformHandlerInterface::isExcluded	public	function	Checks if the handler is excluded via webform.settings.	1
WebformHandlerInterface::isSubmissionOptional	public	function	Returns the webform submission is optional indicator.	1
WebformHandlerInterface::isSubmissionRequired	public	function	Returns the webform submission is required indicator.	1
WebformHandlerInterface::label	public	function	Returns the webform handler label.	1
WebformHandlerInterface::overrideSettings	public	function	Alter/override a webform submission webform settings.	1
WebformHandlerInterface::postCreate	public	function	Acts on a webform submission after it is created.	1
WebformHandlerInterface::postDelete	public	function	Acts on deleted a webform submission before the delete hook is invoked.	1
WebformHandlerInterface::postLoad	public	function	Acts on loaded webform submission.	1
WebformHandlerInterface::postPurge	public	function	Acts on webform submissions after they are purged.	1
WebformHandlerInterface::postSave	public	function	Acts on a saved webform submission before the insert or update hook is invoked.	1
WebformHandlerInterface::preCreate	public	function	Changes the values of an entity before it is created.	1
WebformHandlerInterface::preDelete	public	function	Acts on a webform submission before they are deleted and before hooks are invoked.	1
WebformHandlerInterface::prepareForm	public	function	Acts on an webform submission about to be shown on a webform submission form.	1
WebformHandlerInterface::preprocessConfirmation	public	function	Prepares variables for webform confirmation templates.	1
WebformHandlerInterface::prePurge	public	function	Acts on webform submissions before they are purged.	1
WebformHandlerInterface::preSave	public	function	Acts on a webform submission before the presave hook is invoked.	1
WebformHandlerInterface::RESULTS_IGNORED		constant	Value indicating webform submissions are not processed (i.e. email or saved) by the handler.
WebformHandlerInterface::RESULTS_PROCESSED		constant	Value indicating webform submissions are processed (i.e. email or saved) by the handler.
WebformHandlerInterface::setConditions	public	function	Sets the conditions for this webform handler.	1
WebformHandlerInterface::setHandlerId	public	function	Sets the id for this webform handler.	1
WebformHandlerInterface::setLabel	public	function	Sets the label for this webform handler.	1
WebformHandlerInterface::setNotes	public	function	Set notes for this webform variant.	1
WebformHandlerInterface::setStatus	public	function	Sets the status for this webform handler.	1
WebformHandlerInterface::setWeight	public	function	Sets the weight for this webform handler.	1
WebformHandlerInterface::SUBMISSION_OPTIONAL		constant	Value indicating webform submissions do not have to be stored in the database.
WebformHandlerInterface::SUBMISSION_REQUIRED		constant	Value indicating webform submissions must be stored in the database.
WebformHandlerInterface::submitForm	public	function	Submit webform submission form.	1
WebformHandlerInterface::supportsConditions	public	function	Determine if webform handler supports conditions.	1
WebformHandlerInterface::supportsTokens	public	function	Determine if webform handler supports tokens.	1
WebformHandlerInterface::updateElement	public	function	Acts on a element after it has been updated.	1
WebformHandlerInterface::updateHandler	public	function	Acts on handler after it has been updated.	1
WebformHandlerInterface::validateForm	public	function	Validate webform submission form.	1
WebformPluginSettingsInterface::getSetting	public	function	Returns the plugin setting for given key
WebformPluginSettingsInterface::getSettings	public	function	Returns the plugin's settings.
WebformPluginSettingsInterface::setSetting	public	function	Sets a plugin setting for a given key.
WebformPluginSettingsInterface::setSettings	public	function	Update a plugin's settings.