entityEmbedDisplayManager = $entity_embed_display_manager;
$this->formBuilder = $form_builder;
$this->entityTypeManager = $entity_type_manager;
$this->eventDispatcher = $event_dispatcher;
$this->entityFieldManager = $entity_field_manager;
$this->moduleHandler = $module_handler;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container) {
return new static(
$container->get('plugin.manager.entity_embed.display'),
$container->get('form_builder'),
$container->get('entity_type.manager'),
$container->get('event_dispatcher'),
$container->get('entity_field.manager'),
$container->get('module_handler')
);
}
/**
* {@inheritdoc}
*/
public function getFormId() {
return 'entity_embed_dialog';
}
/**
* {@inheritdoc}
*
* @param \Drupal\editor\EditorInterface $editor
* The editor to which this dialog corresponds.
* @param \Drupal\embed\EmbedButtonInterface $embed_button
* The URL button to which this dialog corresponds.
*/
public function buildForm(array $form, FormStateInterface $form_state, EditorInterface $editor = NULL, EmbedButtonInterface $embed_button = NULL) {
$values = $form_state->getValues();
$input = $form_state->getUserInput();
// Set embed button element in form state, so that it can be used later in
// validateForm() function.
$form_state->set('embed_button', $embed_button);
$form_state->set('editor', $editor);
// Initialize entity element with form attributes, if present.
$entity_element = empty($values['attributes']) ? array() : $values['attributes'];
$entity_element += empty($input['attributes']) ? array() : $input['attributes'];
// The default values are set directly from \Drupal::request()->request,
// provided by the editor plugin opening the dialog.
if (!$form_state->get('entity_element')) {
$form_state->set('entity_element', isset($input['editor_object']) ? $input['editor_object'] : array());
}
$entity_element += $form_state->get('entity_element');
$entity_element += [
'data-entity-type' => $embed_button->getTypeSetting('entity_type'),
'data-entity-uuid' => '',
'data-entity-embed-display' => 'entity_reference:entity_reference_entity_view',
'data-entity-embed-display-settings' => isset($form_state->get('entity_element')['data-entity-embed-settings']) ? $form_state->get('entity_element')['data-entity-embed-settings'] : [],
];
$form_state->set('entity_element', $entity_element);
$entity = $this->entityTypeManager->getStorage($entity_element['data-entity-type'])
->loadByProperties(['uuid' => $entity_element['data-entity-uuid']]);
$form_state->set('entity', current($entity) ?: NULL);
if (!$form_state->get('step')) {
// If an entity has been selected, then always skip to the embed options.
if ($form_state->get('entity')) {
$form_state->set('step', 'embed');
}
else {
$form_state->set('step', 'select');
}
}
$form['#tree'] = TRUE;
$form['#attached']['library'][] = 'editor/drupal.editor.dialog';
$form['#attached']['library'][] = 'entity_embed/drupal.entity_embed.dialog';
$form['#prefix'] = '
';
$form['#suffix'] = '
';
$form['#attributes']['class'][] = 'entity-embed-dialog-step--' . $form_state->get('step');
$this->loadEntityBrowser($form_state);
if ($form_state->get('step') == 'select') {
$form = $this->buildSelectStep($form, $form_state);
}
elseif ($form_state->get('step') == 'review') {
$form = $this->buildReviewStep($form, $form_state);
}
elseif ($form_state->get('step') == 'embed') {
$form = $this->buildEmbedStep($form, $form_state);
}
return $form;
}
/**
* Form constructor for the entity selection step.
*
* @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.
*
* @return array
* The form structure.
*/
public function buildSelectStep(array &$form, FormStateInterface $form_state) {
// Entity element is calculated on every AJAX request/submit. See ::buildForm().
$entity_element = $form_state->get('entity_element');
/** @var \Drupal\embed\EmbedButtonInterface $embed_button */
$embed_button = $form_state->get('embed_button');
$entity = $form_state->get('entity');
$form['attributes']['data-entity-type'] = array(
'#type' => 'value',
'#value' => $entity_element['data-entity-type'],
);
$label = $this->t('Label');
// Attempt to display a better label if we can by getting it from
// the label field definition.
$entity_type = $this->entityTypeManager->getDefinition($entity_element['data-entity-type']);
if ($entity_type->isSubclassOf('\Drupal\Core\Entity\FieldableEntityInterface') && $entity_type->hasKey('label')) {
$field_definitions = $this->entityFieldManager->getBaseFieldDefinitions($entity_type->id());
if (isset($field_definitions[$entity_type->getKey('label')])) {
$label = $field_definitions[$entity_type->getKey('label')]->getLabel();
}
}
$form['#title'] = $this->t('Select @type to embed', array('@type' => $entity_type->getLowercaseLabel()));
if ($this->entityBrowser) {
$this->eventDispatcher->addListener(Events::REGISTER_JS_CALLBACKS, [$this, 'registerJSCallback']);
$form['entity_browser'] = [
'#type' => 'entity_browser',
'#entity_browser' => $this->entityBrowser->id(),
'#cardinality' => 1,
'#entity_browser_validators' => [
'entity_type' => ['type' => $entity_element['data-entity-type']],
],
];
}
else {
$form['entity_id'] = array(
'#type' => 'entity_autocomplete',
'#target_type' => $entity_element['data-entity-type'],
'#title' => $label,
'#default_value' => $entity,
'#required' => TRUE,
'#description' => $this->t('Type label and pick the right one from suggestions. Note that the unique ID will be saved.'),
);
if ($bundles = $embed_button->getTypeSetting('bundles')) {
$form['entity_id']['#selection_settings']['target_bundles'] = $bundles;
}
}
$form['attributes']['data-entity-uuid'] = array(
'#type' => 'value',
'#title' => $entity_element['data-entity-uuid'],
);
$form['actions'] = array(
'#type' => 'actions',
);
$form['actions']['save_modal'] = array(
'#type' => 'submit',
'#value' => $this->t('Next'),
'#button_type' => 'primary',
// No regular submit-handler. This form only works via JavaScript.
'#submit' => array(),
'#ajax' => array(
'callback' => '::submitSelectStep',
'event' => 'click',
),
'#attributes' => [
'class' => [
'js-button-next',
],
],
);
return $form;
}
/**
* Form constructor for the entity review step.
*
* @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.
*
* @return array
* The form structure.
*/
public function buildReviewStep(array &$form, FormStateInterface $form_state) {
/** @var \Drupal\Core\Entity\EntityInterface $entity */
$entity = $form_state->get('entity');
$form['#title'] = $this->t('Review selected @type', array('@type' => $entity->getEntityType()->getLowercaseLabel()));
$form['selection'] = [
'#markup' => $entity->label(),
];
$form['actions'] = array(
'#type' => 'actions',
);
$form['actions']['back'] = array(
'#type' => 'submit',
'#value' => $this->t('Replace selection'),
// No regular submit-handler. This form only works via JavaScript.
'#submit' => array(),
'#ajax' => array(
'callback' => '::submitAndShowSelect',
'event' => 'click',
),
);
$form['actions']['save_modal'] = array(
'#type' => 'submit',
'#value' => $this->t('Next'),
'#button_type' => 'primary',
// No regular submit-handler. This form only works via JavaScript.
'#submit' => array(),
'#ajax' => array(
'callback' => '::submitAndShowEmbed',
'event' => 'click',
),
'#attributes' => [
'class' => [
'js-button-next',
],
],
);
return $form;
}
/**
* Form constructor for the entity embedding step.
*
* @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.
*
* @return array
* The form structure.
*/
public function buildEmbedStep(array $form, FormStateInterface $form_state) {
// Entity element is calculated on every AJAX request/submit. See ::buildForm().
$entity_element = $form_state->get('entity_element');
/** @var \Drupal\embed\EmbedButtonInterface $embed_button */
$embed_button = $form_state->get('embed_button');
/** @var \Drupal\editor\EditorInterface $editor */
$editor = $form_state->get('editor');
/** @var \Drupal\Core\Entity\EntityInterface $entity */
$entity = $form_state->get('entity');
$values = $form_state->getValues();
$form['#title'] = $this->t('Embed @type', array('@type' => $entity->getEntityType()->getLowercaseLabel()));
$entity_label = '';
try {
$entity_label = $entity->link();
}
catch (\Exception $e) {
// Construct markup of the link to the entity manually if link() fails.
// @see https://www.drupal.org/node/2402533
$entity_label = '' . $entity->label() . '';
}
$form['entity'] = array(
'#type' => 'item',
'#title' => $this->t('Selected entity'),
'#markup' => $entity_label,
);
$form['attributes']['data-entity-type'] = array(
'#type' => 'hidden',
'#value' => $entity_element['data-entity-type'],
);
$form['attributes']['data-entity-uuid'] = array(
'#type' => 'hidden',
'#value' => $entity_element['data-entity-uuid'],
);
// Build the list of allowed Entity Embed Display plugins.
$display_plugin_options = $this->getDisplayPluginOptions($embed_button, $entity);
// If the currently selected display is not in the available options,
// use the first from the list instead. This can happen if an alter
// hook customizes the list based on the entity.
if (!isset($display_plugin_options[$entity_element['data-entity-embed-display']])) {
$entity_element['data-entity-embed-display'] = key($display_plugin_options);
}
// The default Entity Embed Display plugin has been deprecated by the
// rendered entity field formatter.
if ($entity_element['data-entity-embed-display'] === 'default') {
$entity_element['data-entity-embed-display'] = 'entity_reference:entity_reference_entity_view';
}
$form['attributes']['data-entity-embed-display'] = array(
'#type' => 'select',
'#title' => $this->t('Display as'),
'#options' => $display_plugin_options,
'#default_value' => $entity_element['data-entity-embed-display'],
'#required' => TRUE,
'#ajax' => array(
'callback' => '::updatePluginConfigurationForm',
'wrapper' => 'data-entity-embed-display-settings-wrapper',
'effect' => 'fade',
),
// Hide the selection if only one option is available.
'#access' => count($display_plugin_options) > 1,
);
$form['attributes']['data-entity-embed-display-settings'] = array(
'#type' => 'container',
'#prefix' => '',
'#suffix' => '
',
);
$form['attributes']['data-embed-button'] = array(
'#type' => 'value',
'#value' => $embed_button->id(),
);
$plugin_id = !empty($values['attributes']['data-entity-embed-display']) ? $values['attributes']['data-entity-embed-display'] : $entity_element['data-entity-embed-display'];
if (!empty($plugin_id)) {
if (is_string($entity_element['data-entity-embed-display-settings'])) {
$entity_element['data-entity-embed-display-settings'] = Json::decode($entity_element['data-entity-embed-display-settings']);
}
$display = $this->entityEmbedDisplayManager->createInstance($plugin_id, $entity_element['data-entity-embed-display-settings']);
$display->setContextValue('entity', $entity);
$display->setAttributes($entity_element);
$form['attributes']['data-entity-embed-display-settings'] += $display->buildConfigurationForm($form, $form_state);
}
// When Drupal core's filter_align is being used, the text editor may
// offer the ability to change the alignment.
if ($editor->getFilterFormat()->filters('filter_align')->status) {
$form['attributes']['data-align'] = array(
'#title' => $this->t('Align'),
'#type' => 'radios',
'#options' => array(
'' => $this->t('None'),
'left' => $this->t('Left'),
'center' => $this->t('Center'),
'right' => $this->t('Right'),
),
'#default_value' => isset($entity_element['data-align']) ? $entity_element['data-align'] : '',
'#wrapper_attributes' => array('class' => array('container-inline')),
'#attributes' => array('class' => array('container-inline')),
);
}
// When Drupal core's filter_caption is being used, the text editor may
// offer the ability to add a caption.
if ($editor->getFilterFormat()->filters('filter_caption')->status) {
$form['attributes']['data-caption'] = array(
'#title' => $this->t('Caption'),
'#type' => 'textfield',
'#default_value' => isset($entity_element['data-caption']) ? Html::decodeEntities($entity_element['data-caption']) : '',
'#element_validate' => array('::escapeValue'),
);
}
$form['actions'] = array(
'#type' => 'actions',
);
$form['actions']['back'] = array(
'#type' => 'submit',
'#value' => $this->t('Back'),
// No regular submit-handler. This form only works via JavaScript.
'#submit' => array(),
'#ajax' => array(
'callback' => !empty($this->entityBrowserSettings['display_review']) ? '::submitAndShowReview' : '::submitAndShowSelect',
'event' => 'click',
),
);
$form['actions']['save_modal'] = array(
'#type' => 'submit',
'#value' => $this->t('Embed'),
'#button_type' => 'primary',
// No regular submit-handler. This form only works via JavaScript.
'#submit' => array(),
'#ajax' => array(
'callback' => '::submitEmbedStep',
'event' => 'click',
),
);
return $form;
}
/**
* {@inheritdoc}
*/
public function validateForm(array &$form, FormStateInterface $form_state) {
parent::validateForm($form, $form_state);
if ($form_state->get('step') == 'select') {
$this->validateSelectStep($form, $form_state);
}
elseif ($form_state->get('step') == 'embed') {
$this->validateEmbedStep($form, $form_state);
}
}
/**
* Form validation handler for the entity selection step.
*
* @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.
*/
public function validateSelectStep(array $form, FormStateInterface $form_state) {
if ($form_state->hasValue(['entity_browser', 'entities'])) {
$id = $form_state->getValue(['entity_browser', 'entities', 0])->id();
$element = $form['entity_browser'];
}
else {
$id = trim($form_state->getValue(['entity_id']));
$element = $form['entity_id'];
}
$entity_type = $form_state->getValue(['attributes', 'data-entity-type']);
if ($entity = $this->entityTypeManager->getStorage($entity_type)->load($id)) {
if (!$entity->access('view')) {
$form_state->setError($element, $this->t('Unable to access @type entity @id.', array('@type' => $entity_type, '@id' => $id)));
}
else {
if ($uuid = $entity->uuid()) {
$form_state->setValueForElement($form['attributes']['data-entity-uuid'], $uuid);
}
else {
$form_state->setError($element, $this->t('Cannot embed @type entity @id because it does not have a UUID.', array('@type' => $entity_type, '@id' => $id)));
}
// Ensure that at least one Entity Embed Display plugin is present
// before proceeding to the next step. Raise an error otherwise.
$embed_button = $form_state->get('embed_button');
$display_plugin_options = $this->getDisplayPluginOptions($embed_button, $entity);
// If no plugin is available after taking the intersection, raise error.
// Also log an exception.
if (empty($display_plugin_options)) {
$form_state->setError($element, $this->t('No display options available for the selected entity. Please select another entity.'));
$this->logger('entity_embed')->warning('No display options available for "@type:" entity "@id" while embedding using button "@button". Please ensure that at least one Entity Embed Display plugin is allowed for this embed button which is available for this entity.', array('@type' => $entity_type, '@id' => $entity->id(), '@button' => $embed_button->id()));
}
}
}
else {
$form_state->setError($element, $this->t('Unable to load @type entity @id.', array('@type' => $entity_type, '@id' => $id)));
}
}
/**
* Form validation handler for the entity embedding step.
*
* @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.
*/
public function validateEmbedStep(array $form, FormStateInterface $form_state) {
// Validate configuration forms for the Entity Embed Display plugin used.
$entity_element = $form_state->getValue('attributes');
$entity = $this->entityTypeManager->getStorage($entity_element['data-entity-type'])
->loadByProperties(['uuid' => $entity_element['data-entity-uuid']]);
$entity = current($entity) ?: NULL;
$plugin_id = $entity_element['data-entity-embed-display'];
$plugin_settings = !empty($entity_element['data-entity-embed-display-settings']) ? $entity_element['data-entity-embed-display-settings'] : array();
$display = $this->entityEmbedDisplayManager->createInstance($plugin_id, $plugin_settings);
$display->setContextValue('entity', $entity);
$display->setAttributes($entity_element);
$display->validateConfigurationForm($form, $form_state);
}
/**
* {@inheritdoc}
*/
public function submitForm(array &$form, FormStateInterface $form_state) {}
/**
* Form submission handler to update the plugin configuration form.
*
* @param array $form
* The form array.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The form state.
*/
public function updatePluginConfigurationForm(array &$form, FormStateInterface $form_state) {
return $form['attributes']['data-entity-embed-display-settings'];
}
/**
* Form submission handler to to another step of the form.
*
* @param array $form
* The form array.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The form state.
*
* @return \Drupal\Core\Ajax\AjaxResponse
* The ajax response.
*/
public function submitStep(array &$form, FormStateInterface $form_state, $step) {
$response = new AjaxResponse();
$form_state->set('step', $step);
$form_state->setRebuild(TRUE);
$rebuild_form = $this->formBuilder->rebuildForm('entity_embed_dialog', $form_state, $form);
unset($rebuild_form['#prefix'], $rebuild_form['#suffix']);
$response->addCommand(new HtmlCommand('#entity-embed-dialog-form', $rebuild_form));
$response->addCommand(new SetDialogTitleCommand('', $rebuild_form['#title']));
return $response;
}
/**
* Form submission handler for the entity selection step.
*
* On success will send the user to the next step of the form to select the
* embed display settings. On form errors, this will rebuild the form and
* display the error messages.
*
* @param array $form
* The form array.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The form state.
*
* @return \Drupal\Core\Ajax\AjaxResponse
* The ajax response.
*/
public function submitSelectStep(array &$form, FormStateInterface $form_state) {
$response = new AjaxResponse();
// Display errors in form, if any.
if ($form_state->hasAnyErrors()) {
unset($form['#prefix'], $form['#suffix']);
$form['status_messages'] = array(
'#type' => 'status_messages',
'#weight' => -10,
);
$response->addCommand(new HtmlCommand('#entity-embed-dialog-form', $form));
}
else {
$form_state->set('step', !empty($this->entityBrowserSettings['display_review']) ? 'review' : 'embed');
$form_state->setRebuild(TRUE);
$rebuild_form = $this->formBuilder->rebuildForm('entity_embed_dialog', $form_state, $form);
unset($rebuild_form['#prefix'], $rebuild_form['#suffix']);
$response->addCommand(new HtmlCommand('#entity-embed-dialog-form', $rebuild_form));
$response->addCommand(new SetDialogTitleCommand('', $rebuild_form['#title']));
}
return $response;
}
/**
* Submit and show select step after submit.
*
* @param array $form
* The form array.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The form state.
*
* @return \Drupal\Core\Ajax\AjaxResponse
* The ajax response.
*/
public function submitAndShowSelect(array &$form, FormStateInterface $form_state) {
return $this->submitStep($form, $form_state, 'select');
}
/**
* Submit and show review step after submit.
*
* @param array $form
* The form array.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The form state.
*
* @return \Drupal\Core\Ajax\AjaxResponse
* The ajax response.
*/
public function submitAndShowReview(array &$form, FormStateInterface $form_state) {
return $this->submitStep($form, $form_state, 'review');
}
/**
* Submit and show embed step after submit.
*
* @param array $form
* The form array.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The form state.
*
* @return \Drupal\Core\Ajax\AjaxResponse
* The ajax response.
*/
public function submitAndShowEmbed(array $form, FormStateInterface $form_state) {
return $this->submitStep($form, $form_state, 'embed');
}
/**
* Form submission handler for the entity embedding step.
*
* On success this will submit the command to save the embedded entity with
* the configured display settings to the WYSIWYG element, and then close the
* modal dialog. On form errors, this will rebuild the form and display the
* error messages.
*
* @param array $form
* An associative array containing the structure of the form.
* @param FormStateInterface $form_state
* An associative array containing the current state of the form.
*
* @return \Drupal\Core\Ajax\AjaxResponse
* The ajax response.
*/
public function submitEmbedStep(array &$form, FormStateInterface $form_state) {
$response = new AjaxResponse();
// Submit configuration form the selected Entity Embed Display plugin.
$entity_element = $form_state->getValue('attributes');
$entity = $this->entityTypeManager->getStorage($entity_element['data-entity-type'])
->loadByProperties(['uuid' => $entity_element['data-entity-uuid']]);
$entity = current($entity);
$plugin_id = $entity_element['data-entity-embed-display'];
$plugin_settings = !empty($entity_element['data-entity-embed-display-settings']) ? $entity_element['data-entity-embed-display-settings'] : array();
$display = $this->entityEmbedDisplayManager->createInstance($plugin_id, $plugin_settings);
$display->setContextValue('entity', $entity);
$display->setAttributes($entity_element);
$display->submitConfigurationForm($form, $form_state);
$values = $form_state->getValues();
// Display errors in form, if any.
if ($form_state->hasAnyErrors()) {
unset($form['#prefix'], $form['#suffix']);
$form['status_messages'] = array(
'#type' => 'status_messages',
'#weight' => -10,
);
$response->addCommand(new HtmlCommand('#entity-embed-dialog-form', $form));
}
else {
// Serialize entity embed settings to JSON string.
if (!empty($values['attributes']['data-entity-embed-display-settings'])) {
$values['attributes']['data-entity-embed-display-settings'] = Json::encode($values['attributes']['data-entity-embed-display-settings']);
}
// Filter out empty attributes.
$values['attributes'] = array_filter($values['attributes'], function($value) {
return (bool) Unicode::strlen((string) $value);
});
// Allow other modules to alter the values before getting submitted to the WYSIWYG.
$this->moduleHandler->alter('entity_embed_values', $values, $entity, $display, $form_state);
$response->addCommand(new EditorDialogSave($values));
$response->addCommand(new CloseModalDialogCommand());
}
return $response;
}
/**
* Form element validation handler; Escapes the value an element.
*
* This should be used for any element in the embed form which may contain
* HTML that should be serialized as an attribute element on the embed.
*/
public static function escapeValue($element, FormStateInterface $form_state) {
if ($value = trim($element['#value'])) {
$form_state->setValueForElement($element, Html::escape($value));
}
}
/**
* Returns the allowed Entity Embed Display plugins given an embed button and
* an entity.
*
* @param \Drupal\embed\EmbedButtonInterface $embed_button
* The embed button.
* @param \Drupal\Core\Entity\EntityInterface $entity
* The entity.
*
* @return array
* List of allowed Entity Embed Display plugins.
*/
public function getDisplayPluginOptions(EmbedButtonInterface $embed_button, EntityInterface $entity) {
$plugins = $this->entityEmbedDisplayManager->getDefinitionOptionsForEntity($entity);
if ($allowed_plugins = $embed_button->getTypeSetting('display_plugins')) {
$plugins = array_intersect_key($plugins, array_flip($allowed_plugins));
}
natsort($plugins);
return $plugins;
}
/**
* Registers JS callback that gets entities from entity browser and updates
* form values accordingly.
*/
public function registerJSCallback(RegisterJSCallbacks $event) {
if ($event->getBrowserID() == $this->entityBrowser->id()) {
$event->registerCallback('Drupal.entityEmbedDialog.selectionCompleted');
}
}
/**
* Load the current entity browser and its settings from the form state.
*
* @param \Drupal\Core\Form\FormStateInterface $form_state
*/
protected function loadEntityBrowser(FormStateInterface $form_state) {
$this->entityBrowser = NULL;
$this->entityBrowserSettings = [];
/** @var \Drupal\embed\EmbedButtonInterface $embed_button */
$embed_button = $form_state->get('embed_button');
if ($embed_button && $entity_browser_id = $embed_button->getTypePlugin()->getConfigurationValue('entity_browser')) {
$this->entityBrowser = $this->entityTypeManager->getStorage('entity_browser')->load($entity_browser_id);
$this->entityBrowserSettings = $embed_button->getTypePlugin()->getConfigurationValue('entity_browser_settings');
}
}
}