aboutsummaryrefslogtreecommitdiffstats
path: root/lib/private/RichObjectStrings/RichTextFormatter.php
blob: 9c9ddf94fa96aecb97f6b9b39f1497c81d58ac8a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<?php

declare(strict_types=1);

/**
 * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */

namespace OC\RichObjectStrings;

use OCP\RichObjectStrings\IRichTextFormatter;

class RichTextFormatter implements IRichTextFormatter {
	/**
	 * @throws \InvalidArgumentException if a parameter has no name or no type
	 */
	public function richToParsed(string $message, array $parameters): string {
		$placeholders = [];
		$replacements = [];
		foreach ($parameters as $placeholder => $parameter) {
			$placeholders[] = '{' . $placeholder . '}';
			foreach (['name','type'] as $requiredField) {
				if (!isset($parameter[$requiredField]) || !is_string($parameter[$requiredField])) {
					throw new \InvalidArgumentException("Invalid rich object, {$requiredField} field is missing");
				}
			}
			$replacements[] = match($parameter['type']) {
				'user' => '@' . $parameter['name'],
				'file' => $parameter['path'] ?? $parameter['name'],
				default => $parameter['name'],
			};
		}
		return str_replace($placeholders, $replacements, $message);
	}
}
$appName, $request); } /** * Get the apps navigation * * @param bool $absolute Rewrite URLs to absolute ones * @return DataResponse<Http::STATUS_OK, CoreNavigationEntry[], array{}>|DataResponse<Http::STATUS_NOT_MODIFIED, array<empty>, array{}> * * 200: Apps navigation returned * 304: No apps navigation changed */ #[NoAdminRequired] #[NoCSRFRequired] #[ApiRoute(verb: 'GET', url: '/navigation/apps', root: '/core')] public function getAppsNavigation(bool $absolute = false): DataResponse { $navigation = $this->navigationManager->getAll(); if ($absolute) { $navigation = $this->rewriteToAbsoluteUrls($navigation); } $navigation = array_values($navigation); $etag = $this->generateETag($navigation); if ($this->request->getHeader('If-None-Match') === $etag) { return new DataResponse([], Http::STATUS_NOT_MODIFIED); } $response = new DataResponse($navigation); $response->setETag($etag); return $response; } /** * Get the settings navigation * * @param bool $absolute Rewrite URLs to absolute ones * @return DataResponse<Http::STATUS_OK, CoreNavigationEntry[], array{}>|DataResponse<Http::STATUS_NOT_MODIFIED, array<empty>, array{}> * * 200: Apps navigation returned * 304: No apps navigation changed */ #[NoAdminRequired] #[NoCSRFRequired] #[ApiRoute(verb: 'GET', url: '/navigation/settings', root: '/core')] public function getSettingsNavigation(bool $absolute = false): DataResponse { $navigation = $this->navigationManager->getAll('settings'); if ($absolute) { $navigation = $this->rewriteToAbsoluteUrls($navigation); } $navigation = array_values($navigation); $etag = $this->generateETag($navigation); if ($this->request->getHeader('If-None-Match') === $etag) { return new DataResponse([], Http::STATUS_NOT_MODIFIED); } $response = new DataResponse($navigation); $response->setETag($etag); return $response; } /** * Generate an ETag for a list of navigation entries */ private function generateETag(array $navigation): string { foreach ($navigation as &$nav) { if ($nav['id'] === 'logout') { $nav['href'] = 'logout'; } } return md5(json_encode($navigation)); } /** * Rewrite href attribute of navigation entries to an absolute URL */ private function rewriteToAbsoluteUrls(array $navigation): array { foreach ($navigation as &$entry) { /* If parse_url finds no host it means the URL is not absolute */ if (!isset(\parse_url($entry['href'])['host'])) { $entry['href'] = $this->urlGenerator->getAbsoluteURL($entry['href']); } if (!str_starts_with($entry['icon'], $this->urlGenerator->getBaseUrl())) { $entry['icon'] = $this->urlGenerator->getAbsoluteURL($entry['icon']); } } return $navigation; } }