class OverrideWebformVariant in Webform 6.x

Same name and namespace in other branches

8.5 src/Plugin/WebformVariant/OverrideWebformVariant.php \Drupal\webform\Plugin\WebformVariant\OverrideWebformVariant

Webform override variant.

Plugin annotation


@WebformVariant(
  id = "override",
  label = @Translation("Override"),
  category = @Translation("Override"),
  description = @Translation("Override a webform's settings, elements, and handlers."),
)

Hierarchy

class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
  - class \Drupal\webform\Plugin\WebformVariantBase implements WebformVariantInterface uses WebformEntityInjectionTrait, WebformPluginSettingsTrait
    class \Drupal\webform\Plugin\WebformVariant\OverrideWebformVariant

Expanded class hierarchy of OverrideWebformVariant

File

src/Plugin/WebformVariant/OverrideWebformVariant.php, line 23

Namespace

Drupal\webform\Plugin\WebformVariant

View source

class OverrideWebformVariant extends WebformVariantBase {

  /**
   * The current user.
   *
   * @var \Drupal\Core\Session\AccountInterface
   */
  protected $currentUser;

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
    $instance = parent::create($container, $configuration, $plugin_id, $plugin_definition);
    $instance->currentUser = $container
      ->get('current_user');
    return $instance;
  }

  /**
   * {@inheritdoc}
   */
  public function defaultConfiguration() {
    return [
      'settings' => [],
      'elements' => '',
      'handlers' => [],
      'debug' => FALSE,
    ];
  }

  /**
   * {@inheritdoc}
   */
  public function buildConfigurationForm(array $form, FormStateInterface $form_state) {
    $webform = $this
      ->getWebform();
    $form['overrides'] = [
      '#type' => 'details',
      '#title' => $this
        ->t('Overrides'),
      '#open' => TRUE,
      '#access' => $this->currentUser
        ->hasPermission('edit webform source'),
    ];

    // Settings.
    $form['overrides']['settings'] = [
      '#type' => 'webform_codemirror',
      '#mode' => 'yaml',
      '#title' => $this
        ->t('Settings (YAML)'),
      '#description' => $this
        ->t('Enter the setting name and value as YAML.'),
      '#more_title' => $this
        ->t('Default settings'),
      '#more' => [
        '#theme' => 'webform_codemirror',
        '#type' => 'yaml',
        '#code' => WebformYaml::encode($webform
          ->getSettings()),
      ],
      '#parents' => [
        'settings',
        'settings',
      ],
      '#default_value' => $this->configuration['settings'],
    ];

    // Elements.
    $form['overrides']['elements'] = [
      '#type' => 'webform_codemirror',
      '#mode' => 'yaml',
      '#title' => $this
        ->t('Elements (YAML)'),
      '#description' => $this
        ->t('Enter the element name and properties as YAML.'),
      '#more_title' => $this
        ->t('Default elements'),
      '#more' => [
        '#theme' => 'webform_codemirror',
        '#type' => 'yaml',
        '#code' => WebformYaml::encode($webform
          ->getElementsDecodedAndFlattened()),
      ],
      '#parents' => [
        'settings',
        'elements',
      ],
      '#default_value' => $this->configuration['elements'],
    ];

    // Handlers.
    $handlers = $webform
      ->get('handlers');
    foreach ($handlers as &$handler) {
      unset($handler['id'], $handler['handler_id']);
    }
    $form['overrides']['handlers'] = [
      '#type' => 'webform_codemirror',
      '#mode' => 'yaml',
      '#title' => $this
        ->t('Handlers (YAML)'),
      '#description' => $this
        ->t('Enter the handler id and settings as YAML.'),
      '#more_title' => $this
        ->t('Default handlers'),
      '#more' => [
        '#theme' => 'webform_codemirror',
        '#type' => 'yaml',
        '#code' => WebformYaml::encode($handlers),
      ],
      '#parents' => [
        'settings',
        'handlers',
      ],
      '#default_value' => $this->configuration['handlers'],
    ];

    // Development.
    $form['development'] = [
      '#type' => 'details',
      '#title' => $this
        ->t('Development settings'),
    ];
    $form['development']['debug'] = [
      '#type' => 'checkbox',
      '#title' => $this
        ->t('Enable debugging'),
      '#description' => $this
        ->t('If checked, settings will be displayed onscreen to all users.'),
      '#return_value' => TRUE,
      '#parents' => [
        'settings',
        'debug',
      ],
      '#default_value' => $this->configuration['debug'],
    ];
    return $form;
  }

  /**
   * {@inheritdoc}
   */
  public function validateConfigurationForm(array &$form, FormStateInterface $form_state) {
    $webform = $this
      ->getWebform();
    $values = $form_state
      ->getValues();

    // Validate settings names.
    $settings = $webform
      ->getSettings();
    foreach ($values['settings'] as $setting_name => $setting_value) {
      if (!isset($settings[$setting_name])) {
        $form_state
          ->setErrorByName('settings', $this
          ->t('Setting %name is not a valid setting name.', [
          '%name' => $setting_name,
        ]));
      }
    }

    // Validate element keys.
    $elements = Yaml::decode($values['elements']) ?: [];
    if ($elements) {
      foreach ($elements as $element_key => $element_properties) {

        // Skip custom form property.
        if (WebformElementHelper::property($element_key)) {
          continue;
        }
        $element = $webform
          ->getElement($element_key);
        if (!$element) {
          $form_state
            ->setErrorByName('elements', $this
            ->t('Element %key is not a valid element key.', [
            '%key' => $element_key,
          ]));
        }
      }
    }

    // Validate handler ids.
    foreach ($values['handlers'] as $handler_id => $handler_configuration) {
      if (!$webform
        ->getHandlers()
        ->has($handler_id)) {
        $form_state
          ->setErrorByName('handlers', $this
          ->t('Handler %id is not a valid handler id.', [
          '%id' => $handler_id,
        ]));
      }
    }
  }

  /**
   * {@inheritdoc}
   */
  public function submitConfigurationForm(array &$form, FormStateInterface $form_state) {
    $this->configuration = $form_state
      ->getValues();
    $this->configuration['debug'] = (bool) $this->configuration['debug'];
  }

  /**
   * {@inheritdoc}
   */
  public function applyVariant() {
    $webform = $this
      ->getWebform();

    // Override settings.
    if ($this->configuration['settings']) {
      $settings = $webform
        ->getSettings();
      foreach ($this->configuration['settings'] as $setting_name => $setting_value) {
        if (isset($settings[$setting_name])) {
          $settings[$setting_name] = $setting_value;
        }
      }
      $webform
        ->setSettings($settings);
    }

    // Override elements.
    $elements = Yaml::decode($this->configuration['elements']) ?: [];
    if ($elements) {
      foreach ($elements as $element_key => $element_properties) {
        if (WebformElementHelper::property($element_key)) {

          // Set custom form property.
          $webform
            ->setElements([
            $element_key => $element_properties,
          ] + $webform
            ->getElementsDecoded());
        }
        else {
          $element = $webform
            ->getElement($element_key);
          if (!$element) {
            continue;
          }
          $webform
            ->setElementProperties($element_key, $element_properties + $element);
        }
      }
    }

    // Override handlers.
    if ($this->configuration['handlers']) {
      foreach ($this->configuration['handlers'] as $handler_id => $handler_configuration) {
        if (!$webform
          ->getHandlers()
          ->has($handler_id)) {
          continue;
        }
        $handler = $webform
          ->getHandler($handler_id);
        $configuration = $handler
          ->getConfiguration();
        foreach ($handler_configuration as $configuration_key => $configuration_value) {
          if (!isset($configuration[$configuration_key])) {
            continue;
          }
          if ($configuration_key === 'settings') {
            $configuration[$configuration_key] = $configuration_value + $configuration[$configuration_key];
          }
          else {
            $configuration[$configuration_key] = $configuration_value;
          }
        }
        $handler
          ->setConfiguration($configuration);
      }
    }

    // Debug.
    $this
      ->debug();
    return TRUE;
  }

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

  // Debug and exception handlers.

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

  /**
   * Display debugging information.
   */
  protected function debug() {
    if (empty($this->configuration['debug'])) {
      return;
    }
    $build = [
      '#type' => 'details',
      '#title' => $this
        ->t('Debug: Override: @title', [
        '@title' => $this
          ->label(),
      ]),
    ];

    // Notes.
    if ($notes = $this
      ->getNotes()) {
      $build['notes'] = [
        '#type' => 'item',
        '#title' => $this
          ->t('Notes'),
        'notes' => WebformHtmlEditor::checkMarkup($notes),
      ];
    }

    // Settings.
    if ($this->configuration['settings']) {
      $build['settings'] = [
        '#type' => 'item',
        '#title' => $this
          ->t('Settings'),
        'yaml' => [
          '#theme' => 'webform_codemirror',
          '#type' => 'yaml',
          '#code' => WebformYaml::encode($this->configuration['settings']),
        ],
      ];
    }

    // Elements.
    if ($this->configuration['elements']) {
      $build['elements'] = [
        '#type' => 'item',
        '#title' => $this
          ->t('Elements'),
        'yaml' => [
          '#theme' => 'webform_codemirror',
          '#type' => 'yaml',
          '#code' => $this->configuration['elements'],
        ],
      ];
    }

    // Handlers.
    if ($this->configuration['handlers']) {
      $build['handlers'] = [
        '#type' => 'item',
        '#title' => $this
          ->t('Handlers'),
        'yaml' => [
          '#theme' => 'webform_codemirror',
          '#type' => 'yaml',
          '#code' => WebformYaml::encode($this->configuration['handlers']),
        ],
      ];
    }
    $this
      ->messenger()
      ->addWarning(\Drupal::service('renderer')
      ->renderPlain($build));
  }

}

Members

Name	Modifiers	Type	Description	Overrides
DependencySerializationTrait::$_entityStorages	protected	property
DependencySerializationTrait::$_serviceIds	protected	property
DependencySerializationTrait::__sleep	public	function		2
DependencySerializationTrait::__wakeup	public	function		2
MessengerTrait::$messenger	protected	property	The messenger.	27
MessengerTrait::messenger	public	function	Gets the messenger.	27
MessengerTrait::setMessenger	public	function	Sets the messenger.
OverrideWebformVariant::$currentUser	protected	property	The current user.
OverrideWebformVariant::applyVariant	public	function	Apply variant to the webform. Overrides WebformVariantBase::applyVariant
OverrideWebformVariant::buildConfigurationForm	public	function	Form constructor. Overrides WebformVariantBase::buildConfigurationForm
OverrideWebformVariant::create	public static	function	IMPORTANT: Webform handlers are initialized and serialized when they are attached to a webform. Make sure not include any services as a dependency injection that directly connect to the database. This will prevent "LogicException: The database… Overrides WebformVariantBase::create
OverrideWebformVariant::debug	protected	function	Display debugging information.
OverrideWebformVariant::defaultConfiguration	public	function	Gets default configuration for this plugin. Overrides WebformVariantBase::defaultConfiguration
OverrideWebformVariant::submitConfigurationForm	public	function	Form submission handler. Overrides WebformVariantBase::submitConfigurationForm
OverrideWebformVariant::validateConfigurationForm	public	function	Form validation handler. Overrides WebformVariantBase::validateConfigurationForm
PluginBase::$configuration	protected	property	Configuration information passed into the plugin.	1
PluginBase::$pluginDefinition	protected	property	The plugin implementation definition.	1
PluginBase::$pluginId	protected	property	The plugin_id.
PluginBase::DERIVATIVE_SEPARATOR		constant	A string which is used to separate base plugin IDs from the derivative ID.
PluginBase::getBaseId	public	function	Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface::getBaseId
PluginBase::getDerivativeId	public	function	Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface::getDerivativeId
PluginBase::getPluginDefinition	public	function	Gets the definition of the plugin implementation. Overrides PluginInspectionInterface::getPluginDefinition	2
PluginBase::getPluginId	public	function	Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface::getPluginId
PluginBase::isConfigurable	public	function	Determines if the plugin is configurable.
PluginBase::__construct	public	function	Constructs a \Drupal\Component\Plugin\PluginBase object.	98
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.
WebformEntityInjectionTrait::$webform	protected	property	The webform.	1
WebformEntityInjectionTrait::$webformSubmission	protected	property	The webform submission.	1
WebformEntityInjectionTrait::getWebform	public	function	Get the webform that this handler is attached to.
WebformEntityInjectionTrait::getWebformSubmission	public	function	Set webform and webform submission entity.
WebformEntityInjectionTrait::resetEntities	public	function	Reset webform and webform submission entity.
WebformEntityInjectionTrait::setEntities	public	function
WebformEntityInjectionTrait::setWebform	public	function	Set the webform that this is handler is attached to.
WebformEntityInjectionTrait::setWebformSubmission	public	function	Get the webform submission that this handler is handling.
WebformPluginSettingsTrait::getSetting	public	function
WebformPluginSettingsTrait::getSettings	public	function
WebformPluginSettingsTrait::setSetting	public	function
WebformPluginSettingsTrait::setSettings	public	function
WebformVariantBase::$configFactory	protected	property	The configuration factory.
WebformVariantBase::$element_key	protected	property	The element key of the webform variant.
WebformVariantBase::$label	protected	property	The webform variant label.
WebformVariantBase::$notes	protected	property	The webform variant notes.
WebformVariantBase::$status	protected	property	The webform variant status.
WebformVariantBase::$variant_id	protected	property	The webform variant ID.
WebformVariantBase::$weight	protected	property	The weight of the webform variant.
WebformVariantBase::calculateDependencies	public	function
WebformVariantBase::description	public	function	Returns the webform variant description. Overrides WebformVariantInterface::description
WebformVariantBase::disable	public	function	Disables the webform variant. Overrides WebformVariantInterface::disable
WebformVariantBase::enable	public	function	Enables the webform variant. Overrides WebformVariantInterface::enable
WebformVariantBase::getConfiguration	public	function	Gets this plugin's configuration. Overrides ConfigurableInterface::getConfiguration
WebformVariantBase::getElementKey	public	function	Returns the element key of the webform variant. Overrides WebformVariantInterface::getElementKey
WebformVariantBase::getLabel	public	function	Returns the label of the webform variant. Overrides WebformVariantInterface::getLabel
WebformVariantBase::getMachineNameReplace	public	function	Returns the webform variant machine name replacement character. Overrides WebformVariantInterface::getMachineNameReplace
WebformVariantBase::getMachineNameReplacePattern	public	function	Returns the webform variant machine name replacement pattern. Overrides WebformVariantInterface::getMachineNameReplacePattern
WebformVariantBase::getNotes	public	function	Returns notes of the webform variant. Overrides WebformVariantInterface::getNotes
WebformVariantBase::getOffCanvasWidth	public	function	Get configuration form's off-canvas width. Overrides WebformVariantInterface::getOffCanvasWidth	1
WebformVariantBase::getStatus	public	function	Returns the status of the webform variant. Overrides WebformVariantInterface::getStatus
WebformVariantBase::getSummary	public	function	Returns a render array summarizing the configuration of the webform variant. Overrides WebformVariantInterface::getSummary	1
WebformVariantBase::getVariantId	public	function	Returns the unique ID representing the webform variant. Overrides WebformVariantInterface::getVariantId
WebformVariantBase::getWeight	public	function	Returns the weight of the webform variant. Overrides WebformVariantInterface::getWeight
WebformVariantBase::isApplicable	public	function	Determine if this variant is applicable to the webform. Overrides WebformVariantInterface::isApplicable	2
WebformVariantBase::isDisabled	public	function	Returns the webform variant disabled indicator. Overrides WebformVariantInterface::isDisabled
WebformVariantBase::isEnabled	public	function	Returns the webform variant enabled indicator. Overrides WebformVariantInterface::isEnabled	1
WebformVariantBase::isExcluded	public	function	Checks if the variant is excluded via webform.settings. Overrides WebformVariantInterface::isExcluded
WebformVariantBase::label	public	function	Returns the webform variant label. Overrides WebformVariantInterface::label
WebformVariantBase::setConfiguration	public	function	Sets the configuration for this plugin instance. Overrides ConfigurableInterface::setConfiguration
WebformVariantBase::setElementKey	public	function	Sets the element key of this webform variant. Overrides WebformVariantInterface::setElementKey
WebformVariantBase::setLabel	public	function	Sets the label for this webform variant. Overrides WebformVariantInterface::setLabel
WebformVariantBase::setNotes	public	function	Set notes for this webform variant. Overrides WebformVariantInterface::setNotes
WebformVariantBase::setStatus	public	function	Sets the status for this webform variant. Overrides WebformVariantInterface::setStatus
WebformVariantBase::setVariantId	public	function	Sets the id for this webform variant. Overrides WebformVariantInterface::setVariantId
WebformVariantBase::setWeight	public	function	Sets the weight for this webform variant. Overrides WebformVariantInterface::setWeight

You are here

class OverrideWebformVariant in Webform 6.x

Plugin annotation

Hierarchy

File

Namespace

Members

API Navigation