function PluginFormFactory::createInstance

Same name in other branches
  1. 9 core/lib/Drupal/Core/Plugin/PluginFormFactory.php \Drupal\Core\Plugin\PluginFormFactory::createInstance()
  2. 8.9.x core/lib/Drupal/Core/Plugin/PluginFormFactory.php \Drupal\Core\Plugin\PluginFormFactory::createInstance()
  3. 10 core/lib/Drupal/Core/Plugin/PluginFormFactory.php \Drupal\Core\Plugin\PluginFormFactory::createInstance()

Overrides PluginFormFactoryInterface::createInstance

File

core/lib/Drupal/Core/Plugin/PluginFormFactory.php, line 34

Class

PluginFormFactory
Provides form discovery capabilities for plugins.

Namespace

Drupal\Core\Plugin

Code

public function createInstance(PluginWithFormsInterface $plugin, $operation, $fallback_operation = NULL) {
    if (!$plugin->hasFormClass($operation)) {
        // Use the default form class if no form is specified for this operation.
        if ($fallback_operation && $plugin->hasFormClass($fallback_operation)) {
            $operation = $fallback_operation;
        }
        else {
            throw new InvalidPluginDefinitionException($plugin->getPluginId(), sprintf('The "%s" plugin did not specify a "%s" form class', $plugin->getPluginId(), $operation));
        }
    }
    $form_class = $plugin->getFormClass($operation);
    // If the form specified is the plugin itself, use it directly.
    if (ltrim(get_class($plugin), '\\') === ltrim($form_class, '\\')) {
        $form_object = $plugin;
    }
    else {
        $form_object = $this->classResolver
            ->getInstanceFromDefinition($form_class);
    }
    // Ensure the resulting object is a plugin form.
    if (!$form_object instanceof PluginFormInterface) {
        throw new InvalidPluginDefinitionException($plugin->getPluginId(), sprintf('The "%s" plugin did not specify a valid "%s" form class, must implement \\Drupal\\Core\\Plugin\\PluginFormInterface', $plugin->getPluginId(), $operation));
    }
    if ($form_object instanceof PluginAwareInterface) {
        $form_object->setPlugin($plugin);
    }
    return $form_object;
}

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