QuickEditController.php

Same filename in other branches
  1. 8.9.x core/modules/quickedit/src/QuickEditController.php

Namespace

Drupal\quickedit

File

core/modules/quickedit/src/QuickEditController.php

View source
<?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\Session\AccountInterface;
use Drupal\Core\TempStore\PrivateTempStoreFactory;
use Drupal\filter\Plugin\FilterInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
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;
use Drupal\quickedit\Ajax\GetUntransformedTextCommand;

/**
 * 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;
        $this->entityDisplayRepository = $entity_display_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) {
            [
                $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);
    }
    
    /**
     * Throws an AccessDeniedHttpException if the request fails CSRF validation.
     *
     * This is used instead of \Drupal\Core\Access\CsrfAccessCheck, in order to
     * allow access for anonymous users.
     *
     * @todo Refactor this to an access checker.
     */
    private static function checkCsrf(Request $request, AccountInterface $account) {
        $header = 'X-Drupal-Quickedit-CSRF-Token';
        if (!$request->headers
            ->has($header)) {
            throw new AccessDeniedHttpException();
        }
        if ($account->isAnonymous()) {
            // For anonymous users, just the presence of the custom header is
            // sufficient protection.
            return;
        }
        // For authenticated users, validate the token value.
        $token = $request->headers
            ->get($header);
        if (!\Drupal::csrfToken()->validate($token, $header)) {
            throw new AccessDeniedHttpException();
        }
    }
    
    /**
     * 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) {
        self::checkCsrf(\Drupal::request(), \Drupal::currentUser());
        // 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;
    }
    
    /**
     * Returns Ajax response to render text field without transformation filters.
     *
     * @param \Drupal\Core\Entity\EntityInterface $entity
     *   The entity of which a formatted text field is being rerendered.
     * @param string $field_name
     *   The name of the (formatted text) field that is being rerendered.
     * @param string $langcode
     *   The name of the language for which the formatted text field is being
     *   rerendered.
     * @param string $view_mode_id
     *   The view mode the formatted text field should be rerendered in.
     *
     * @return \Drupal\Core\Ajax\AjaxResponse
     *   The Ajax response.
     */
    public function getUntransformedText(EntityInterface $entity, $field_name, $langcode, $view_mode_id) {
        $response = new AjaxResponse();
        // Direct text editing is only supported for single-valued fields.
        $field = $entity->getTranslation($langcode)->{$field_name};
        $editable_text = check_markup($field->value, $field->format, $langcode, [
            FilterInterface::TYPE_TRANSFORM_REVERSIBLE,
            FilterInterface::TYPE_TRANSFORM_IRREVERSIBLE,
        ]);
        $response->addCommand(new GetUntransformedTextCommand($editable_text));
        return $response;
    }

}

Classes

Title Deprecated Summary
QuickEditController Returns responses for Quick Edit module routes.

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