123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337 |
- <?php
- namespace Drupal\quickedit;
- use Drupal\Core\Controller\ControllerBase;
- use Drupal\Core\Entity\EntityRepositoryInterface;
- use Drupal\Core\Form\FormState;
- use Drupal\Core\Render\RendererInterface;
- use Drupal\Core\TempStore\PrivateTempStoreFactory;
- use Symfony\Component\DependencyInjection\ContainerInterface;
- use Symfony\Component\HttpFoundation\JsonResponse;
- use Symfony\Component\HttpFoundation\Request;
- use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
- use Drupal\Core\Ajax\AjaxResponse;
- use Drupal\Core\Entity\EntityInterface;
- use Drupal\Core\Entity\EntityDisplayRepositoryInterface;
- use Drupal\quickedit\Ajax\FieldFormCommand;
- use Drupal\quickedit\Ajax\FieldFormSavedCommand;
- use Drupal\quickedit\Ajax\FieldFormValidationErrorsCommand;
- use Drupal\quickedit\Ajax\EntitySavedCommand;
- /**
- * Returns responses for Quick Edit module routes.
- */
- class QuickEditController extends ControllerBase {
- /**
- * The PrivateTempStore factory.
- *
- * @var \Drupal\Core\TempStore\PrivateTempStoreFactory
- */
- protected $tempStoreFactory;
- /**
- * The in-place editing metadata generator.
- *
- * @var \Drupal\quickedit\MetadataGeneratorInterface
- */
- protected $metadataGenerator;
- /**
- * The in-place editor selector.
- *
- * @var \Drupal\quickedit\EditorSelectorInterface
- */
- protected $editorSelector;
- /**
- * The renderer.
- *
- * @var \Drupal\Core\Render\RendererInterface
- */
- protected $renderer;
- /**
- * The entity display repository service.
- *
- * @var \Drupal\Core\Entity\EntityDisplayRepositoryInterface
- */
- protected $entityDisplayRepository;
- /**
- * The entity repository.
- *
- * @var \Drupal\Core\Entity\EntityRepositoryInterface
- */
- protected $entityRepository;
- /**
- * Constructs a new QuickEditController.
- *
- * @param \Drupal\Core\TempStore\PrivateTempStoreFactory $temp_store_factory
- * The PrivateTempStore factory.
- * @param \Drupal\quickedit\MetadataGeneratorInterface $metadata_generator
- * The in-place editing metadata generator.
- * @param \Drupal\quickedit\EditorSelectorInterface $editor_selector
- * The in-place editor selector.
- * @param \Drupal\Core\Render\RendererInterface $renderer
- * The renderer.
- * @param \Drupal\Core\Entity\EntityDisplayRepositoryInterface $entity_display_repository
- * The entity display repository service.
- * @param \Drupal\Core\Entity\EntityRepositoryInterface $entity_repository
- * The entity repository.
- */
- public function __construct(PrivateTempStoreFactory $temp_store_factory, MetadataGeneratorInterface $metadata_generator, EditorSelectorInterface $editor_selector, RendererInterface $renderer, EntityDisplayRepositoryInterface $entity_display_repository, EntityRepositoryInterface $entity_repository) {
- $this->tempStoreFactory = $temp_store_factory;
- $this->metadataGenerator = $metadata_generator;
- $this->editorSelector = $editor_selector;
- $this->renderer = $renderer;
- if (!$entity_display_repository) {
- @trigger_error('The entity_display.repository service must be passed to QuickEditController::__construct(), it is required before Drupal 9.0.0. See https://www.drupal.org/node/2549139.', E_USER_DEPRECATED);
- $entity_display_repository = \Drupal::service('entity_display.repository');
- }
- $this->entityDisplayRepository = $entity_display_repository;
- if (!$entity_repository) {
- @trigger_error('The entity.repository service must be passed to QuickEditController::__construct(), it is required before Drupal 9.0.0. See https://www.drupal.org/node/2549139.', E_USER_DEPRECATED);
- $entity_repository = \Drupal::service('entity.repository');
- }
- $this->entityRepository = $entity_repository;
- }
- /**
- * {@inheritdoc}
- */
- public static function create(ContainerInterface $container) {
- return new static(
- $container->get('tempstore.private'),
- $container->get('quickedit.metadata.generator'),
- $container->get('quickedit.editor.selector'),
- $container->get('renderer'),
- $container->get('entity_display.repository'),
- $container->get('entity.repository')
- );
- }
- /**
- * Returns the metadata for a set of fields.
- *
- * Given a list of field quick edit IDs as POST parameters, run access checks
- * on the entity and field level to determine whether the current user may
- * edit them. Also retrieves other metadata.
- *
- * @return \Symfony\Component\HttpFoundation\JsonResponse
- * The JSON response.
- */
- public function metadata(Request $request) {
- $fields = $request->request->get('fields');
- if (!isset($fields)) {
- throw new NotFoundHttpException();
- }
- $entities = $request->request->get('entities');
- $metadata = [];
- foreach ($fields as $field) {
- list($entity_type, $entity_id, $field_name, $langcode, $view_mode) = explode('/', $field);
- // Load the entity.
- if (!$entity_type || !$this->entityTypeManager()->getDefinition($entity_type)) {
- throw new NotFoundHttpException();
- }
- $entity = $this->entityTypeManager()->getStorage($entity_type)->load($entity_id);
- if (!$entity) {
- throw new NotFoundHttpException();
- }
- // Validate the field name and language.
- if (!$field_name || !$entity->hasField($field_name)) {
- throw new NotFoundHttpException();
- }
- if (!$langcode || !$entity->hasTranslation($langcode)) {
- throw new NotFoundHttpException();
- }
- $entity = $entity->getTranslation($langcode);
- // If the entity information for this field is requested, include it.
- $entity_id = $entity->getEntityTypeId() . '/' . $entity_id;
- if (is_array($entities) && in_array($entity_id, $entities) && !isset($metadata[$entity_id])) {
- $metadata[$entity_id] = $this->metadataGenerator->generateEntityMetadata($entity);
- }
- $metadata[$field] = $this->metadataGenerator->generateFieldMetadata($entity->get($field_name), $view_mode);
- }
- return new JsonResponse($metadata);
- }
- /**
- * Returns AJAX commands to load in-place editors' attachments.
- *
- * Given a list of in-place editor IDs as POST parameters, render AJAX
- * commands to load those in-place editors.
- *
- * @return \Drupal\Core\Ajax\AjaxResponse
- * The Ajax response.
- */
- public function attachments(Request $request) {
- $response = new AjaxResponse();
- $editors = $request->request->get('editors');
- if (!isset($editors)) {
- throw new NotFoundHttpException();
- }
- $response->setAttachments($this->editorSelector->getEditorAttachments($editors));
- return $response;
- }
- /**
- * Returns a single field edit form as an Ajax response.
- *
- * @param \Drupal\Core\Entity\EntityInterface $entity
- * The entity being edited.
- * @param string $field_name
- * The name of the field that is being edited.
- * @param string $langcode
- * The name of the language for which the field is being edited.
- * @param string $view_mode_id
- * The view mode the field should be rerendered in.
- * @param \Symfony\Component\HttpFoundation\Request $request
- * The current request object containing the search string.
- *
- * @return \Drupal\Core\Ajax\AjaxResponse
- * The Ajax response.
- */
- public function fieldForm(EntityInterface $entity, $field_name, $langcode, $view_mode_id, Request $request) {
- $response = new AjaxResponse();
- // Replace entity with PrivateTempStore copy if available and not resetting,
- // init PrivateTempStore copy otherwise.
- $tempstore_entity = $this->tempStoreFactory->get('quickedit')->get($entity->uuid());
- if ($tempstore_entity && $request->request->get('reset') !== 'true') {
- $entity = $tempstore_entity;
- }
- else {
- $this->tempStoreFactory->get('quickedit')->set($entity->uuid(), $entity);
- }
- $form_state = (new FormState())
- ->set('langcode', $langcode)
- ->disableRedirect()
- ->addBuildInfo('args', [$entity, $field_name]);
- $form = $this->formBuilder()->buildForm('Drupal\quickedit\Form\QuickEditFieldForm', $form_state);
- if ($form_state->isExecuted()) {
- // The form submission saved the entity in PrivateTempStore. Return the
- // updated view of the field from the PrivateTempStore copy.
- $entity = $this->tempStoreFactory->get('quickedit')->get($entity->uuid());
- // Closure to render the field given a view mode.
- $render_field_in_view_mode = function ($view_mode_id) use ($entity, $field_name, $langcode) {
- return $this->renderField($entity, $field_name, $langcode, $view_mode_id);
- };
- // Re-render the updated field.
- $output = $render_field_in_view_mode($view_mode_id);
- // Re-render the updated field for other view modes (i.e. for other
- // instances of the same logical field on the user's page).
- $other_view_mode_ids = $request->request->get('other_view_modes') ?: [];
- $other_view_modes = array_map($render_field_in_view_mode, array_combine($other_view_mode_ids, $other_view_mode_ids));
- $response->addCommand(new FieldFormSavedCommand($output, $other_view_modes));
- }
- else {
- $output = $this->renderer->renderRoot($form);
- // When working with a hidden form, we don't want its CSS/JS to be loaded.
- if ($request->request->get('nocssjs') !== 'true') {
- $response->setAttachments($form['#attached']);
- }
- $response->addCommand(new FieldFormCommand($output));
- $errors = $form_state->getErrors();
- if (count($errors)) {
- $status_messages = [
- '#type' => 'status_messages',
- ];
- $response->addCommand(new FieldFormValidationErrorsCommand($this->renderer->renderRoot($status_messages)));
- }
- }
- return $response;
- }
- /**
- * Renders a field.
- *
- * If the view mode ID is not an Entity Display view mode ID, then the field
- * was rendered using a custom render pipeline (not the Entity/Field API
- * render pipeline).
- *
- * An example could be Views' render pipeline. In that case, the view mode ID
- * would probably contain the View's ID, display and the row index.
- *
- * @param \Drupal\Core\Entity\EntityInterface $entity
- * The entity being edited.
- * @param string $field_name
- * The name of the field that is being edited.
- * @param string $langcode
- * The name of the language for which the field is being edited.
- * @param string $view_mode_id
- * The view mode the field should be rerendered in. Either an Entity Display
- * view mode ID, or a custom one. See hook_quickedit_render_field().
- *
- * @return \Drupal\Component\Render\MarkupInterface
- * Rendered HTML.
- *
- * @see hook_quickedit_render_field()
- */
- protected function renderField(EntityInterface $entity, $field_name, $langcode, $view_mode_id) {
- $entity_view_mode_ids = array_keys($this->entityDisplayRepository->getViewModes($entity->getEntityTypeId()));
- if (in_array($view_mode_id, $entity_view_mode_ids)) {
- $entity = $this->entityRepository->getTranslationFromContext($entity, $langcode);
- $output = $entity->get($field_name)->view($view_mode_id);
- }
- else {
- // Each part of a custom (non-Entity Display) view mode ID is separated
- // by a dash; the first part must be the module name.
- $mode_id_parts = explode('-', $view_mode_id, 2);
- $module = reset($mode_id_parts);
- $args = [$entity, $field_name, $view_mode_id, $langcode];
- $output = $this->moduleHandler()->invoke($module, 'quickedit_render_field', $args);
- }
- return $this->renderer->renderRoot($output);
- }
- /**
- * Saves an entity into the database, from PrivateTempStore.
- *
- * @param \Drupal\Core\Entity\EntityInterface $entity
- * The entity being edited.
- *
- * @return \Drupal\Core\Ajax\AjaxResponse
- * The Ajax response.
- */
- public function entitySave(EntityInterface $entity) {
- // Take the entity from PrivateTempStore and save in entity storage.
- // fieldForm() ensures that the PrivateTempStore copy exists ahead.
- $tempstore = $this->tempStoreFactory->get('quickedit');
- $tempstore->get($entity->uuid())->save();
- $tempstore->delete($entity->uuid());
- // Return information about the entity that allows a front end application
- // to identify it.
- $output = [
- 'entity_type' => $entity->getEntityTypeId(),
- 'entity_id' => $entity->id(),
- ];
- // Respond to client that the entity was saved properly.
- $response = new AjaxResponse();
- $response->addCommand(new EntitySavedCommand($output));
- return $response;
- }
- }
|