class FormOperations

Same name in other branches
  1. 8.9.x core/modules/workspaces/src/FormOperations.php \Drupal\workspaces\FormOperations
  2. 10 core/modules/workspaces/src/FormOperations.php \Drupal\workspaces\FormOperations
  3. 11.x core/modules/workspaces/src/FormOperations.php \Drupal\workspaces\FormOperations

Defines a class for reacting to form operations.

@internal

Hierarchy

Expanded class hierarchy of FormOperations

1 file declares its use of FormOperations
workspaces.module in core/modules/workspaces/workspaces.module
Provides full-site preview functionality for content staging.

File

core/modules/workspaces/src/FormOperations.php, line 18

Namespace

Drupal\workspaces
View source
class FormOperations implements ContainerInjectionInterface {
    
    /**
     * The workspace manager service.
     *
     * @var \Drupal\workspaces\WorkspaceManagerInterface
     */
    protected $workspaceManager;
    
    /**
     * Constructs a new FormOperations instance.
     *
     * @param \Drupal\workspaces\WorkspaceManagerInterface $workspace_manager
     *   The workspace manager service.
     */
    public function __construct(WorkspaceManagerInterface $workspace_manager) {
        $this->workspaceManager = $workspace_manager;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function create(ContainerInterface $container) {
        return new static($container->get('workspaces.manager'));
    }
    
    /**
     * Alters forms to disallow editing in non-default workspaces.
     *
     * @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 string $form_id
     *   The form ID.
     *
     * @see hook_form_alter()
     */
    public function formAlter(array &$form, FormStateInterface $form_state, $form_id) {
        // No alterations are needed if we're not in a workspace context.
        if (!$this->workspaceManager
            ->hasActiveWorkspace()) {
            return;
        }
        // Add an additional validation step for every form if we are in a
        // non-default workspace.
        $this->addWorkspaceValidation($form);
        // If a form has already been marked as safe or not to submit in a
        // non-default workspace, we don't have anything else to do.
        if ($form_state->has('workspace_safe')) {
            return;
        }
        // No forms are safe to submit in a non-default workspace by default, except
        // for the whitelisted ones defined below.
        $workspace_safe = FALSE;
        // Whitelist a few forms that we know are safe to submit.
        $form_object = $form_state->getFormObject();
        $is_workspace_form = $form_object instanceof WorkspaceFormInterface;
        $is_search_form = in_array($form_object->getFormId(), [
            'search_block_form',
            'search_form',
        ], TRUE);
        $is_views_exposed_form = $form_object instanceof ViewsExposedForm;
        if ($is_workspace_form || $is_search_form || $is_views_exposed_form) {
            $workspace_safe = TRUE;
        }
        $form_state->set('workspace_safe', $workspace_safe);
    }
    
    /**
     * Adds our validation handler recursively on each element of a form.
     *
     * @param array &$element
     *   An associative array containing the structure of the form.
     */
    protected function addWorkspaceValidation(array &$element) {
        // Recurse through all children and add our validation handler if needed.
        foreach (Element::children($element) as $key) {
            if (isset($element[$key]) && $element[$key]) {
                $this->addWorkspaceValidation($element[$key]);
            }
        }
        if (isset($element['#validate'])) {
            $element['#validate'][] = [
                static::class,
                'validateDefaultWorkspace',
            ];
        }
    }
    
    /**
     * Validation handler which sets a validation error for all unsupported forms.
     */
    public static function validateDefaultWorkspace(array &$form, FormStateInterface $form_state) {
        if ($form_state->get('workspace_safe') !== TRUE) {
            $form_state->setError($form, new TranslatableMarkup('This form can only be submitted in the default workspace.'));
        }
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
FormOperations::$workspaceManager protected property The workspace manager service.
FormOperations::addWorkspaceValidation protected function Adds our validation handler recursively on each element of a form.
FormOperations::create public static function Instantiates a new instance of this class. Overrides ContainerInjectionInterface::create
FormOperations::formAlter public function Alters forms to disallow editing in non-default workspaces.
FormOperations::validateDefaultWorkspace public static function Validation handler which sets a validation error for all unsupported forms.
FormOperations::__construct public function Constructs a new FormOperations instance.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.