class ConditionForm

UI form for adding/editing a Rules condition.

Hierarchy

Expanded class hierarchy of ConditionForm

File

src/Form/Expression/ConditionForm.php, line 15

Namespace

Drupal\rules\Form\Expression
View source
class ConditionForm implements ExpressionFormInterface {
    use ContextFormTrait;
    use StringTranslationTrait;
    use RulesUiHandlerTrait;
    
    /**
     * The condition plugin manager.
     *
     * @var \Drupal\rules\Core\ConditionManager
     */
    protected $conditionManager;
    
    /**
     * The condition expression that is edited in the form.
     *
     * @var \Drupal\rules\Engine\ConditionExpressionInterface
     */
    protected $conditionExpression;
    
    /**
     * Creates a new object of this class.
     */
    public function __construct(ConditionExpressionInterface $condition_expression, ConditionManager $condition_manager) {
        $this->conditionManager = $condition_manager;
        $this->conditionExpression = $condition_expression;
    }
    
    /**
     * {@inheritdoc}
     */
    public function form(array $form, FormStateInterface $form_state) {
        $condition_id = $form_state->get('condition_id');
        $configuration = $this->conditionExpression
            ->getConfiguration();
        if (empty($condition_id) && !empty($configuration['condition_id'])) {
            $condition_id = $configuration['condition_id'];
            $form_state->set('condition_id', $condition_id);
        }
        // Step 1 of the multistep form.
        if (!$condition_id) {
            $condition_definitions = $this->conditionManager
                ->getGroupedDefinitions();
            $options = [];
            foreach ($condition_definitions as $group => $definitions) {
                foreach ($definitions as $id => $definition) {
                    if ($group != $this->t('Other')) {
                        // Because core Conditions do not currently define some context
                        // values required by Rules, we need to make sure they can't be
                        // selected through the Rules UI. The Rules ConditionManager puts
                        // these core Conditions into the 'Other' group so that we can
                        // identify them and leave them off of the Condition selection
                        // form element below.
                        // @see https://www.drupal.org/project/rules/issues/2927132
                        $options[$group][$id] = $definition['label'];
                    }
                }
            }
            $form['condition_id'] = [
                '#type' => 'select',
                '#title' => $this->t('Condition'),
                '#options' => $options,
                '#required' => TRUE,
            ];
            $form['continue'] = [
                '#type' => 'submit',
                '#value' => $this->t('Continue'),
                '#name' => 'continue',
                // Only validate the selected condition in the first step.
'#limit_validation_errors' => [
                    [
                        'condition_id',
                    ],
                ],
                '#submit' => [
                    static::class . '::submitFirstStep',
                ],
            ];
            return $form;
        }
        // Step 2 of the form.
        
        /** @var \Drupal\rules\Core\RulesConditionInterface $condition */
        $condition = $this->conditionManager
            ->createInstance($condition_id);
        $form['summary'] = [
            '#type' => 'details',
            '#title' => $this->t('Summary'),
        ];
        $form['summary']['description'] = [
            '#type' => 'container',
            '#plain_text' => $this->t('Condition: @summary', [
                '@summary' => $condition->summary(),
            ]),
            '#attributes' => [
                'class' => [
                    'form-item',
                ],
            ],
        ];
        $context_definitions = $condition->getContextDefinitions();
        if (!empty($context_definitions)) {
            $form['context_definitions'] = [
                '#type' => 'details',
                '#title' => $this->t('Context variables'),
                '#open' => TRUE,
                '#tree' => TRUE,
            ];
            foreach ($context_definitions as $context_name => $context_definition) {
                $form = $this->buildContextForm($form, $form_state, $context_name, $context_definition, $configuration);
            }
        }
        $provides_definitions = $condition->getProvidedContextDefinitions();
        if (!empty($provides_definitions)) {
            $form['provides'] = [
                '#type' => 'details',
                '#title' => $this->t('Provided variables'),
                '#description' => $this->t('You may change the name of any provided variables, but note that renaming already-utilized variables invalidates the existing uses.'),
                '#open' => TRUE,
            ];
            foreach ($provides_definitions as $provides_name => $provides_definition) {
                $form = $this->buildProvidedContextForm($form, $form_state, $provides_name, $provides_definition, $configuration);
            }
        }
        $form['negate_wrapper'] = [
            '#type' => 'fieldset',
            '#title' => $this->t('Negate'),
        ];
        $form['negate_wrapper']['negate'] = [
            '#type' => 'checkbox',
            '#title' => $this->t('Negate this condition'),
            '#default_value' => $configuration['negate'] ?: 0,
            '#description' => $this->t('If checked, the condition result is negated such that it returns TRUE if it evaluates to FALSE.'),
        ];
        $form['save'] = [
            '#type' => 'submit',
            '#value' => $this->t('Save'),
            '#name' => 'save',
        ];
        return $form;
    }
    
    /**
     * {@inheritdoc}
     */
    public function validateForm(array $form, FormStateInterface $form_state) {
        // Only if there is a condition selected already we can validate something.
        if ($form_state->get('condition_id')) {
            // Invoke the submission handler which will setup the expression being
            // edited in the form. That way the expression is ready for other
            // validation handlers.
            $this->submitForm($form, $form_state);
        }
    }
    
    /**
     * Submit callback: save the selected condition in the first step.
     */
    public static function submitFirstStep(array &$form, FormStateInterface $form_state) {
        $form_state->set('condition_id', $form_state->getValue('condition_id'));
        $form_state->setRebuild();
    }
    
    /**
     * {@inheritdoc}
     */
    public function submitForm(array &$form, FormStateInterface $form_state) {
        $condition_id = $form_state->get('condition_id');
        // Nothing to do as long as the first step is not completed.
        if (!$condition_id) {
            return;
        }
        $condition_definition = $this->conditionManager
            ->getDefinition($condition_id);
        $context_config = $this->getContextConfigFromFormValues($form_state, $condition_definition['context_definitions']);
        // Rename provided variables, if any.
        if ($provided_variables = $form_state->getValue('provides')) {
            foreach ($provided_variables as $provides_name => $provides_context) {
                // Do this only on rename.
                if ($provides_name !== $provides_context['name']) {
                    \Drupal::messenger()->addWarning("providing '" . $provides_name . "' as '" . $provides_context['name'] . "'");
                    $context_config->provideAs($provides_name, $provides_context['name']);
                }
            }
        }
        $configuration = $context_config->toArray();
        $configuration['condition_id'] = $form_state->get('condition_id');
        $configuration['negate'] = $form_state->getValue('negate');
        $this->conditionExpression
            ->setConfiguration($configuration);
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
ConditionForm::$conditionExpression protected property The condition expression that is edited in the form.
ConditionForm::$conditionManager protected property The condition plugin manager.
ConditionForm::form public function Adds elements specific to the expression to the form. Overrides ExpressionFormInterface::form
ConditionForm::submitFirstStep public static function Submit callback: save the selected condition in the first step.
ConditionForm::submitForm public function Form submission callback to save changes for the expression. Overrides ExpressionFormInterface::submitForm
ConditionForm::validateForm public function Form validation callback to validate expression elements. Overrides ExpressionFormInterface::validateForm
ConditionForm::__construct public function Creates a new object of this class.
ContextFormTrait::buildContextForm public function Provides the form part for a context parameter.
ContextFormTrait::buildProvidedContextForm public function Provides the form part for a 'provided' context parameter.
ContextFormTrait::getContextConfigFromFormValues protected function Creates a context config object from the submitted form values.
ContextFormTrait::switchContextMode public static function Submit callback: switch a context to data selector or direct input mode.
DataProcessorManagerTrait::$dataProcessorManager protected property The data processor manager.
DataProcessorManagerTrait::getDataProcessorManager public function Gets the data processor manager.
DataProcessorManagerTrait::setDataProcessorManager public function Sets the data processor manager.
RulesUiHandlerTrait::$rulesUiHandler protected property The rules UI handler.
RulesUiHandlerTrait::getRulesUiHandler public function Gets the rules UI handler of the current route.
RulesUiHandlerTrait::setRulesUiHandler public function Sets the Rules UI handler.
StringTranslationTrait::$stringTranslation protected property The string translation service. 3
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.