, creators: array}, array{}> * * 200: Direct editing capabilities returned */ public function info(): DataResponse { $response = new DataResponse($this->directEditingService->getDirectEditingCapabilitites()); $response->setETag($this->directEditingService->getDirectEditingETag()); return $response; } /** * @NoAdminRequired * * Create a file for direct editing * * @param string $path Path of the file * @param string $editorId ID of the editor * @param string $creatorId ID of the creator * @param ?string $templateId ID of the template * * @return DataResponse|DataResponse * * 200: URL for direct editing returned * 403: Opening file is not allowed */ public function create(string $path, string $editorId, string $creatorId, ?string $templateId = null): DataResponse { if (!$this->directEditingManager->isEnabled()) { return new DataResponse(['message' => 'Direct editing is not enabled'], Http::STATUS_INTERNAL_SERVER_ERROR); } $this->eventDispatcher->dispatchTyped(new RegisterDirectEditorEvent($this->directEditingManager)); try { $token = $this->directEditingManager->create($path, $editorId, $creatorId, $templateId); return new DataResponse([ 'url' => $this->urlGenerator->linkToRouteAbsolute('files.DirectEditingView.edit', ['token' => $token]) ]); } catch (Exception $e) { $this->logger->error( 'Exception when creating a new file through direct editing', [ 'exception' => $e ], ); return new DataResponse(['message' => 'Failed to create file: ' . $e->getMessage()], Http::STATUS_FORBIDDEN); } } /** * @NoAdminRequired * * Open a file for direct editing * * @param string $path Path of the file * @param ?string $editorId ID of the editor * @param ?int $fileId ID of the file * * @return DataResponse|DataResponse * * 200: URL for direct editing returned * 403: Opening file is not allowed */ public function open(string $path, ?string $editorId = null, ?int $fileId = null): DataResponse { if (!$this->directEditingManager->isEnabled()) { return new DataResponse(['message' => 'Direct editing is not enabled'], Http::STATUS_INTERNAL_SERVER_ERROR); } $this->eventDispatcher->dispatchTyped(new RegisterDirectEditorEvent($this->directEditingManager)); try { $token = $this->directEditingManager->open($path, $editorId, $fileId); return new DataResponse([ 'url' => $this->urlGenerator->linkToRouteAbsolute('files.DirectEditingView.edit', ['token' => $token]) ]); } catch (Exception $e) { $this->logger->error( 'Exception when opening a file through direct editing', [ 'exception' => $e ], ); return new DataResponse(['message' => 'Failed to open file: ' . $e->getMessage()], Http::STATUS_FORBIDDEN); } } /** * @NoAdminRequired * * Get the templates for direct editing * * @param string $editorId ID of the editor * @param string $creatorId ID of the creator * * @return DataResponse}, array{}>|DataResponse * * 200: Templates returned */ public function templates(string $editorId, string $creatorId): DataResponse { if (!$this->directEditingManager->isEnabled()) { return new DataResponse(['message' => 'Direct editing is not enabled'], Http::STATUS_INTERNAL_SERVER_ERROR); } $this->eventDispatcher->dispatchTyped(new RegisterDirectEditorEvent($this->directEditingManager)); try { return new DataResponse($this->directEditingManager->getTemplates($editorId, $creatorId)); } catch (Exception $e) { $this->logger->error( $e->getMessage(), [ 'exception' => $e ], ); return new DataResponse(['message' => 'Failed to obtain template list: ' . $e->getMessage()], Http::STATUS_INTERNAL_SERVER_ERROR); } } }