migrate therinaldos.com data

wedding-pics/apps/theming/lib/AppInfo/Application.php

@@ -0,0 +1,58 @@
+<?php
+/**
+ * @copyright Copyright (c) 2019 Robin Appelman <robin@icewind.nl>
+ *
+ * @author Morris Jobke <hey@morrisjobke.de>
+ * @author Robin Appelman <robin@icewind.nl>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\AppInfo;
+
+use OCA\Theming\Capabilities;
+use OCA\Theming\Listener\BeforePreferenceListener;
+use OCA\Theming\Listener\BeforeTemplateRenderedListener;
+use OCA\Theming\SetupChecks\PhpImagickModule;
+use OCP\AppFramework\App;
+use OCP\AppFramework\Bootstrap\IBootContext;
+use OCP\AppFramework\Bootstrap\IBootstrap;
+use OCP\AppFramework\Bootstrap\IRegistrationContext;
+use OCP\AppFramework\Http\Events\BeforeLoginTemplateRenderedEvent;
+use OCP\AppFramework\Http\Events\BeforeTemplateRenderedEvent;
+use OCP\Config\BeforePreferenceDeletedEvent;
+use OCP\Config\BeforePreferenceSetEvent;
+
+class Application extends App implements IBootstrap {
+	public const APP_ID = 'theming';
+
+	public function __construct() {
+		parent::__construct(self::APP_ID);
+	}
+
+	public function register(IRegistrationContext $context): void {
+		$context->registerCapability(Capabilities::class);
+		$context->registerEventListener(BeforeTemplateRenderedEvent::class, BeforeTemplateRenderedListener::class);
+		$context->registerEventListener(BeforeLoginTemplateRenderedEvent::class, BeforeTemplateRenderedListener::class);
+		$context->registerEventListener(BeforePreferenceSetEvent::class, BeforePreferenceListener::class);
+		$context->registerEventListener(BeforePreferenceDeletedEvent::class, BeforePreferenceListener::class);
+		$context->registerSetupCheck(PhpImagickModule::class);
+	}
+
+	public function boot(IBootContext $context): void {
+	}
+}

wedding-pics/apps/theming/lib/Capabilities.php

@@ -0,0 +1,152 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016, Joas Schilling <coding@schilljs.com>
+ *
+ * @author Guillaume COMPAGNON <gcompagnon@outlook.com>
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author Julien Veyssier <eneiluj@posteo.net>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Morris Jobke <hey@morrisjobke.de>
+ * @author Kate Döen <kate.doeen@nextcloud.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming;
+
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\Service\BackgroundService;
+use OCP\Capabilities\IPublicCapability;
+use OCP\IConfig;
+use OCP\IURLGenerator;
+use OCP\IUser;
+use OCP\IUserSession;
+
+/**
+ * Class Capabilities
+ *
+ * @package OCA\Theming
+ */
+class Capabilities implements IPublicCapability {
+
+	/** @var ThemingDefaults */
+	protected $theming;
+
+	/** @var Util */
+	protected $util;
+
+	/** @var IURLGenerator */
+	protected $url;
+
+	/** @var IConfig */
+	protected $config;
+
+	protected IUserSession $userSession;
+
+	/**
+	 * @param ThemingDefaults $theming
+	 * @param Util $util
+	 * @param IURLGenerator $url
+	 * @param IConfig $config
+	 */
+	public function __construct(ThemingDefaults $theming, Util $util, IURLGenerator $url, IConfig $config, IUserSession $userSession) {
+		$this->theming = $theming;
+		$this->util = $util;
+		$this->url = $url;
+		$this->config = $config;
+		$this->userSession = $userSession;
+	}
+
+	/**
+	 * Return this classes capabilities
+	 *
+	 * @return array{
+	 *     theming: array{
+	 *         name: string,
+	 *         url: string,
+	 *         slogan: string,
+	 *         color: string,
+	 *         color-text: string,
+	 *         color-element: string,
+	 *         color-element-bright: string,
+	 *         color-element-dark: string,
+	 *         logo: string,
+	 *         background: string,
+	 *         background-plain: bool,
+	 *         background-default: bool,
+	 *         logoheader: string,
+	 *         favicon: string,
+	 *     },
+	 * }
+	 */
+	public function getCapabilities() {
+		$color = $this->theming->getDefaultColorPrimary();
+		// Same as in DefaultTheme
+		if ($color === BackgroundService::DEFAULT_COLOR) {
+			$color = BackgroundService::DEFAULT_ACCESSIBLE_COLOR;
+		}
+		$colorText = $this->util->invertTextColor($color) ? '#000000' : '#ffffff';
+
+		$backgroundLogo = $this->config->getAppValue('theming', 'backgroundMime', '');
+		$backgroundPlain = $backgroundLogo === 'backgroundColor' || ($backgroundLogo === '' && $color !== '#0082c9');
+		$background = $backgroundPlain ? $color : $this->url->getAbsoluteURL($this->theming->getBackground());
+
+		$user = $this->userSession->getUser();
+		if ($user instanceof IUser) {
+			/**
+			 * Mimics the logic of generateUserBackgroundVariables() that generates the CSS variables.
+			 * Also needs to be updated if the logic changes.
+			 * @see \OCA\Theming\Themes\CommonThemeTrait::generateUserBackgroundVariables()
+			 */
+			$color = $this->theming->getColorPrimary();
+			if ($color === BackgroundService::DEFAULT_COLOR) {
+				$color = BackgroundService::DEFAULT_ACCESSIBLE_COLOR;
+			}
+			$colorText = $this->util->invertTextColor($color) ? '#000000' : '#ffffff';
+
+			$backgroundImage = $this->config->getUserValue($user->getUID(), Application::APP_ID, 'background_image', BackgroundService::BACKGROUND_DEFAULT);
+			if ($backgroundImage === BackgroundService::BACKGROUND_CUSTOM) {
+				$backgroundPlain = false;
+				$background = $this->url->linkToRouteAbsolute('theming.userTheme.getBackground');
+			} elseif (isset(BackgroundService::SHIPPED_BACKGROUNDS[$backgroundImage])) {
+				$backgroundPlain = false;
+				$background = $this->url->linkTo(Application::APP_ID, "img/background/$backgroundImage");
+			} elseif ($backgroundImage !== BackgroundService::BACKGROUND_DEFAULT) {
+				$backgroundPlain = true;
+				$background = $color;
+			}
+		}
+
+		return [
+			'theming' => [
+				'name' => $this->theming->getName(),
+				'url' => $this->theming->getBaseUrl(),
+				'slogan' => $this->theming->getSlogan(),
+				'color' => $color,
+				'color-text' => $colorText,
+				'color-element' => $this->util->elementColor($color),
+				'color-element-bright' => $this->util->elementColor($color),
+				'color-element-dark' => $this->util->elementColor($color, false),
+				'logo' => $this->url->getAbsoluteURL($this->theming->getLogo()),
+				'background' => $background,
+				'background-plain' => $backgroundPlain,
+				'background-default' => !$this->util->isBackgroundThemed(),
+				'logoheader' => $this->url->getAbsoluteURL($this->theming->getLogo()),
+				'favicon' => $this->url->getAbsoluteURL($this->theming->getLogo()),
+			],
+		];
+	}
+}

wedding-pics/apps/theming/lib/Command/UpdateConfig.php

@@ -0,0 +1,142 @@
+<?php
+/**
+ * @copyright Copyright (c) 2020 Julius Härtl <jus@bitgrid.net>
+ *
+ * @author Julius Härtl <jus@bitgrid.net>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Command;
+
+use OCA\Theming\ImageManager;
+use OCA\Theming\ThemingDefaults;
+use OCP\IConfig;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+
+class UpdateConfig extends Command {
+	public const SUPPORTED_KEYS = [
+		'name', 'url', 'imprintUrl', 'privacyUrl', 'slogan', 'color', 'disable-user-theming'
+	];
+
+	private $themingDefaults;
+	private $imageManager;
+	private $config;
+
+	public function __construct(ThemingDefaults $themingDefaults, ImageManager $imageManager, IConfig $config) {
+		parent::__construct();
+
+		$this->themingDefaults = $themingDefaults;
+		$this->imageManager = $imageManager;
+		$this->config = $config;
+	}
+
+	protected function configure() {
+		$this
+			->setName('theming:config')
+			->setDescription('Set theming app config values')
+			->addArgument(
+				'key',
+				InputArgument::OPTIONAL,
+				'Key to update the theming app configuration (leave empty to get a list of all configured values)' . PHP_EOL .
+				'One of: ' . implode(', ', self::SUPPORTED_KEYS)
+			)
+			->addArgument(
+				'value',
+				InputArgument::OPTIONAL,
+				'Value to set (leave empty to obtain the current value)'
+			)
+			->addOption(
+				'reset',
+				'r',
+				InputOption::VALUE_NONE,
+				'Reset the given config key to default'
+			);
+	}
+
+
+	protected function execute(InputInterface $input, OutputInterface $output): int {
+		$key = $input->getArgument('key');
+		$value = $input->getArgument('value');
+		assert(is_string($value) || $value === null, 'At most one value should be provided.');
+
+		if ($key === null) {
+			$output->writeln('Current theming config:');
+			foreach (self::SUPPORTED_KEYS as $key) {
+				$value = $this->config->getAppValue('theming', $key, '');
+				$output->writeln('- ' . $key . ': ' . $value . '');
+			}
+			foreach (ImageManager::SUPPORTED_IMAGE_KEYS as $key) {
+				$value = $this->config->getAppValue('theming', $key . 'Mime', '');
+				$output->writeln('- ' . $key . ': ' . $value . '');
+			}
+			return 0;
+		}
+
+		if (!in_array($key, self::SUPPORTED_KEYS, true) && !in_array($key, ImageManager::SUPPORTED_IMAGE_KEYS, true)) {
+			$output->writeln('<error>Invalid config key provided</error>');
+			return 1;
+		}
+
+		if ($input->getOption('reset')) {
+			$defaultValue = $this->themingDefaults->undo($key);
+			$output->writeln('<info>Reset ' . $key . ' to ' . $defaultValue . '</info>');
+			return 0;
+		}
+
+		if ($value === null) {
+			$value = $this->config->getAppValue('theming', $key, '');
+			if ($value !== '') {
+				$output->writeln('<info>' . $key . ' is currently set to ' . $value . '</info>');
+			} else {
+				$output->writeln('<info>' . $key . ' is currently not set</info>');
+			}
+			return 0;
+		}
+
+		if ($key === 'background' && $value === 'backgroundColor') {
+			$this->themingDefaults->undo($key);
+			$key = $key . 'Mime';
+		}
+
+		if (in_array($key, ImageManager::SUPPORTED_IMAGE_KEYS, true)) {
+			if (!str_starts_with($value, '/')) {
+				$output->writeln('<error>The image file needs to be provided as an absolute path: ' . $value . '.</error>');
+				return 1;
+			}
+			if (!file_exists($value)) {
+				$output->writeln('<error>File could not be found: ' . $value . '.</error>');
+				return 1;
+			}
+			$value = $this->imageManager->updateImage($key, $value);
+			$key = $key . 'Mime';
+		}
+
+		if ($key === 'color' && !preg_match('/^\#([0-9a-f]{3}|[0-9a-f]{6})$/i', $value)) {
+			$output->writeln('<error>The given color is invalid: ' . $value . '</error>');
+			return 1;
+		}
+
+		$this->themingDefaults->set($key, $value);
+		$output->writeln('<info>Updated ' . $key . ' to ' . $value . '</info>');
+
+		return 0;
+	}
+}

wedding-pics/apps/theming/lib/Controller/IconController.php

@@ -0,0 +1,200 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Julius Haertl <jus@bitgrid.net>
+ *
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author Julius Haertl <jus@bitgrid.net>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Michael Weimann <mail@michael-weimann.eu>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ * @author Kate Döen <kate.doeen@nextcloud.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Controller;
+
+use OC\IntegrityCheck\Helpers\FileAccessHelper;
+use OCA\Theming\IconBuilder;
+use OCA\Theming\ImageManager;
+use OCA\Theming\ThemingDefaults;
+use OCP\App\IAppManager;
+use OCP\AppFramework\Controller;
+use OCP\AppFramework\Http;
+use OCP\AppFramework\Http\DataDisplayResponse;
+use OCP\AppFramework\Http\FileDisplayResponse;
+use OCP\AppFramework\Http\NotFoundResponse;
+use OCP\AppFramework\Http\Response;
+use OCP\Files\NotFoundException;
+use OCP\IRequest;
+
+class IconController extends Controller {
+	/** @var ThemingDefaults */
+	private $themingDefaults;
+	/** @var IconBuilder */
+	private $iconBuilder;
+	/** @var ImageManager */
+	private $imageManager;
+	/** @var FileAccessHelper */
+	private $fileAccessHelper;
+	/** @var IAppManager */
+	private $appManager;
+
+	public function __construct(
+		$appName,
+		IRequest $request,
+		ThemingDefaults $themingDefaults,
+		IconBuilder $iconBuilder,
+		ImageManager $imageManager,
+		FileAccessHelper $fileAccessHelper,
+		IAppManager $appManager
+	) {
+		parent::__construct($appName, $request);
+
+		$this->themingDefaults = $themingDefaults;
+		$this->iconBuilder = $iconBuilder;
+		$this->imageManager = $imageManager;
+		$this->fileAccessHelper = $fileAccessHelper;
+		$this->appManager = $appManager;
+	}
+
+	/**
+	 * @PublicPage
+	 * @NoCSRFRequired
+	 *
+	 * Get a themed icon
+	 *
+	 * @param string $app ID of the app
+	 * @param string $image image file name (svg required)
+	 * @return FileDisplayResponse<Http::STATUS_OK, array{Content-Type: 'image/svg+xml'}>|NotFoundResponse<Http::STATUS_NOT_FOUND, array{}>
+	 * @throws \Exception
+	 *
+	 * 200: Themed icon returned
+	 * 404: Themed icon not found
+	 */
+	public function getThemedIcon(string $app, string $image): Response {
+		if ($app !== 'core' && !$this->appManager->isEnabledForUser($app)) {
+			$app = 'core';
+			$image = 'favicon.png';
+		}
+
+		$color = $this->themingDefaults->getColorPrimary();
+		try {
+			$iconFileName = $this->imageManager->getCachedImage('icon-' . $app . '-' . $color . str_replace('/', '_', $image));
+		} catch (NotFoundException $exception) {
+			$icon = $this->iconBuilder->colorSvg($app, $image);
+			if ($icon === false || $icon === '') {
+				return new NotFoundResponse();
+			}
+			$iconFileName = $this->imageManager->setCachedImage('icon-' . $app . '-' . $color . str_replace('/', '_', $image), $icon);
+		}
+		$response = new FileDisplayResponse($iconFileName, Http::STATUS_OK, ['Content-Type' => 'image/svg+xml']);
+		$response->cacheFor(86400, false, true);
+		return $response;
+	}
+
+	/**
+	 * Return a 32x32 favicon as png
+	 *
+	 * @PublicPage
+	 * @NoCSRFRequired
+	 *
+	 * @param string $app ID of the app
+	 * @return DataDisplayResponse<Http::STATUS_OK, array{Content-Type: 'image/x-icon'}>|FileDisplayResponse<Http::STATUS_OK, array{Content-Type: 'image/x-icon'}>|NotFoundResponse<Http::STATUS_NOT_FOUND, array{}>
+	 * @throws \Exception
+	 *
+	 * 200: Favicon returned
+	 * 404: Favicon not found
+	 */
+	public function getFavicon(string $app = 'core'): Response {
+		if ($app !== 'core' && !$this->appManager->isEnabledForUser($app)) {
+			$app = 'core';
+		}
+
+		$response = null;
+		$iconFile = null;
+		try {
+			$iconFile = $this->imageManager->getImage('favicon', false);
+			$response = new FileDisplayResponse($iconFile, Http::STATUS_OK, ['Content-Type' => 'image/x-icon']);
+		} catch (NotFoundException $e) {
+		}
+		if ($iconFile === null && $this->imageManager->shouldReplaceIcons()) {
+			$color = $this->themingDefaults->getColorPrimary();
+			try {
+				$iconFile = $this->imageManager->getCachedImage('favIcon-' . $app . $color);
+			} catch (NotFoundException $exception) {
+				$icon = $this->iconBuilder->getFavicon($app);
+				if ($icon === false || $icon === '') {
+					return new NotFoundResponse();
+				}
+				$iconFile = $this->imageManager->setCachedImage('favIcon-' . $app . $color, $icon);
+			}
+			$response = new FileDisplayResponse($iconFile, Http::STATUS_OK, ['Content-Type' => 'image/x-icon']);
+		}
+		if ($response === null) {
+			$fallbackLogo = \OC::$SERVERROOT . '/core/img/favicon.png';
+			$response = new DataDisplayResponse($this->fileAccessHelper->file_get_contents($fallbackLogo), Http::STATUS_OK, ['Content-Type' => 'image/x-icon']);
+		}
+		$response->cacheFor(86400);
+		return $response;
+	}
+
+	/**
+	 * Return a 512x512 icon for touch devices
+	 *
+	 * @PublicPage
+	 * @NoCSRFRequired
+	 *
+	 * @param string $app ID of the app
+	 * @return DataDisplayResponse<Http::STATUS_OK, array{Content-Type: 'image/png'}>|FileDisplayResponse<Http::STATUS_OK, array{Content-Type: 'image/x-icon'|'image/png'}>|NotFoundResponse<Http::STATUS_NOT_FOUND, array{}>
+	 * @throws \Exception
+	 *
+	 * 200: Touch icon returned
+	 * 404: Touch icon not found
+	 */
+	public function getTouchIcon(string $app = 'core'): Response {
+		if ($app !== 'core' && !$this->appManager->isEnabledForUser($app)) {
+			$app = 'core';
+		}
+
+		$response = null;
+		try {
+			$iconFile = $this->imageManager->getImage('favicon');
+			$response = new FileDisplayResponse($iconFile, Http::STATUS_OK, ['Content-Type' => 'image/x-icon']);
+		} catch (NotFoundException $e) {
+		}
+		if ($this->imageManager->shouldReplaceIcons()) {
+			$color = $this->themingDefaults->getColorPrimary();
+			try {
+				$iconFile = $this->imageManager->getCachedImage('touchIcon-' . $app . $color);
+			} catch (NotFoundException $exception) {
+				$icon = $this->iconBuilder->getTouchIcon($app);
+				if ($icon === false || $icon === '') {
+					return new NotFoundResponse();
+				}
+				$iconFile = $this->imageManager->setCachedImage('touchIcon-' . $app . $color, $icon);
+			}
+			$response = new FileDisplayResponse($iconFile, Http::STATUS_OK, ['Content-Type' => 'image/png']);
+		}
+		if ($response === null) {
+			$fallbackLogo = \OC::$SERVERROOT . '/core/img/favicon-touch.png';
+			$response = new DataDisplayResponse($this->fileAccessHelper->file_get_contents($fallbackLogo), Http::STATUS_OK, ['Content-Type' => 'image/png']);
+		}
+		$response->cacheFor(86400);
+		return $response;
+	}
+}

wedding-pics/apps/theming/lib/Controller/ThemingController.php

@@ -0,0 +1,515 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Bjoern Schiessle <bjoern@schiessle.org>
+ * @copyright Copyright (c) 2016 Lukas Reschke <lukas@statuscode.ch>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ * @author Bjoern Schiessle <bjoern@schiessle.org>
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Daniel Calviño Sánchez <danxuliu@gmail.com>
+ * @author Jan-Christoph Borchardt <hey@jancborchardt.net>
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author Julius Haertl <jus@bitgrid.net>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Kyle Fazzari <kyrofa@ubuntu.com>
+ * @author Lukas Reschke <lukas@statuscode.ch>
+ * @author nhirokinet <nhirokinet@nhiroki.net>
+ * @author rakekniven <mark.ziegler@rakekniven.de>
+ * @author Robin Appelman <robin@icewind.nl>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ * @author Thomas Citharel <nextcloud@tcit.fr>
+ * @author Kate Döen <kate.doeen@nextcloud.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Controller;
+
+use InvalidArgumentException;
+use OCA\Theming\ImageManager;
+use OCA\Theming\Service\ThemesService;
+use OCA\Theming\ThemingDefaults;
+use OCP\App\IAppManager;
+use OCP\AppFramework\Controller;
+use OCP\AppFramework\Http;
+use OCP\AppFramework\Http\DataDisplayResponse;
+use OCP\AppFramework\Http\DataResponse;
+use OCP\AppFramework\Http\FileDisplayResponse;
+use OCP\AppFramework\Http\JSONResponse;
+use OCP\AppFramework\Http\NotFoundResponse;
+use OCP\Files\IAppData;
+use OCP\Files\NotFoundException;
+use OCP\Files\NotPermittedException;
+use OCP\IConfig;
+use OCP\IL10N;
+use OCP\IRequest;
+use OCP\ITempManager;
+use OCP\IURLGenerator;
+use ScssPhp\ScssPhp\Compiler;
+
+/**
+ * Class ThemingController
+ *
+ * handle ajax requests to update the theme
+ *
+ * @package OCA\Theming\Controller
+ */
+class ThemingController extends Controller {
+	public const VALID_UPLOAD_KEYS = ['header', 'logo', 'logoheader', 'background', 'favicon'];
+
+	private ThemingDefaults $themingDefaults;
+	private IL10N $l10n;
+	private IConfig $config;
+	private ITempManager $tempManager;
+	private IAppData $appData;
+	private IURLGenerator $urlGenerator;
+	private IAppManager $appManager;
+	private ImageManager $imageManager;
+	private ThemesService $themesService;
+
+	public function __construct(
+		$appName,
+		IRequest $request,
+		IConfig $config,
+		ThemingDefaults $themingDefaults,
+		IL10N $l,
+		ITempManager $tempManager,
+		IAppData $appData,
+		IURLGenerator $urlGenerator,
+		IAppManager $appManager,
+		ImageManager $imageManager,
+		ThemesService $themesService
+	) {
+		parent::__construct($appName, $request);
+
+		$this->themingDefaults = $themingDefaults;
+		$this->l10n = $l;
+		$this->config = $config;
+		$this->tempManager = $tempManager;
+		$this->appData = $appData;
+		$this->urlGenerator = $urlGenerator;
+		$this->appManager = $appManager;
+		$this->imageManager = $imageManager;
+		$this->themesService = $themesService;
+	}
+
+	/**
+	 * @AuthorizedAdminSetting(settings=OCA\Theming\Settings\Admin)
+	 * @param string $setting
+	 * @param string $value
+	 * @return DataResponse
+	 * @throws NotPermittedException
+	 */
+	public function updateStylesheet($setting, $value) {
+		$value = trim($value);
+		$error = null;
+		switch ($setting) {
+			case 'name':
+				if (strlen($value) > 250) {
+					$error = $this->l10n->t('The given name is too long');
+				}
+				break;
+			case 'url':
+				if (strlen($value) > 500) {
+					$error = $this->l10n->t('The given web address is too long');
+				}
+				if (!$this->isValidUrl($value)) {
+					$error = $this->l10n->t('The given web address is not a valid URL');
+				}
+				break;
+			case 'imprintUrl':
+				if (strlen($value) > 500) {
+					$error = $this->l10n->t('The given legal notice address is too long');
+				}
+				if (!$this->isValidUrl($value)) {
+					$error = $this->l10n->t('The given legal notice address is not a valid URL');
+				}
+				break;
+			case 'privacyUrl':
+				if (strlen($value) > 500) {
+					$error = $this->l10n->t('The given privacy policy address is too long');
+				}
+				if (!$this->isValidUrl($value)) {
+					$error = $this->l10n->t('The given privacy policy address is not a valid URL');
+				}
+				break;
+			case 'slogan':
+				if (strlen($value) > 500) {
+					$error = $this->l10n->t('The given slogan is too long');
+				}
+				break;
+			case 'color':
+				if (!preg_match('/^\#([0-9a-f]{3}|[0-9a-f]{6})$/i', $value)) {
+					$error = $this->l10n->t('The given color is invalid');
+				}
+				break;
+			case 'disable-user-theming':
+				if ($value !== 'yes' && $value !== 'no') {
+					$error = $this->l10n->t('Disable-user-theming should be true or false');
+				}
+				break;
+		}
+		if ($error !== null) {
+			return new DataResponse([
+				'data' => [
+					'message' => $error,
+				],
+				'status' => 'error'
+			], Http::STATUS_BAD_REQUEST);
+		}
+
+		$this->themingDefaults->set($setting, $value);
+
+		return new DataResponse([
+			'data' => [
+				'message' => $this->l10n->t('Saved'),
+			],
+			'status' => 'success'
+		]);
+	}
+
+	/**
+	 * @AuthorizedAdminSetting(settings=OCA\Theming\Settings\Admin)
+	 * @param string $setting
+	 * @param mixed $value
+	 * @return DataResponse
+	 * @throws NotPermittedException
+	 */
+	public function updateAppMenu($setting, $value) {
+		$error = null;
+		switch ($setting) {
+			case 'defaultApps':
+				if (is_array($value)) {
+					try {
+						$this->appManager->setDefaultApps($value);
+					} catch (InvalidArgumentException $e) {
+						$error = $this->l10n->t('Invalid app given');
+					}
+				} else {
+					$error = $this->l10n->t('Invalid type for setting "defaultApp" given');
+				}
+				break;
+			default:
+				$error = $this->l10n->t('Invalid setting key');
+		}
+		if ($error !== null) {
+			return new DataResponse([
+				'data' => [
+					'message' => $error,
+				],
+				'status' => 'error'
+			], Http::STATUS_BAD_REQUEST);
+		}
+
+		return new DataResponse([
+			'data' => [
+				'message' => $this->l10n->t('Saved'),
+			],
+			'status' => 'success'
+		]);
+	}
+
+	/**
+	 * Check that a string is a valid http/https url
+	 */
+	private function isValidUrl(string $url): bool {
+		return ((str_starts_with($url, 'http://') || str_starts_with($url, 'https://')) &&
+			filter_var($url, FILTER_VALIDATE_URL) !== false);
+	}
+
+	/**
+	 * @AuthorizedAdminSetting(settings=OCA\Theming\Settings\Admin)
+	 * @return DataResponse
+	 * @throws NotPermittedException
+	 */
+	public function uploadImage(): DataResponse {
+		$key = $this->request->getParam('key');
+		if (!in_array($key, self::VALID_UPLOAD_KEYS, true)) {
+			return new DataResponse(
+				[
+					'data' => [
+						'message' => 'Invalid key'
+					],
+					'status' => 'failure',
+				],
+				Http::STATUS_BAD_REQUEST
+			);
+		}
+		$image = $this->request->getUploadedFile('image');
+		$error = null;
+		$phpFileUploadErrors = [
+			UPLOAD_ERR_OK => $this->l10n->t('The file was uploaded'),
+			UPLOAD_ERR_INI_SIZE => $this->l10n->t('The uploaded file exceeds the upload_max_filesize directive in php.ini'),
+			UPLOAD_ERR_FORM_SIZE => $this->l10n->t('The uploaded file exceeds the MAX_FILE_SIZE directive that was specified in the HTML form'),
+			UPLOAD_ERR_PARTIAL => $this->l10n->t('The file was only partially uploaded'),
+			UPLOAD_ERR_NO_FILE => $this->l10n->t('No file was uploaded'),
+			UPLOAD_ERR_NO_TMP_DIR => $this->l10n->t('Missing a temporary folder'),
+			UPLOAD_ERR_CANT_WRITE => $this->l10n->t('Could not write file to disk'),
+			UPLOAD_ERR_EXTENSION => $this->l10n->t('A PHP extension stopped the file upload'),
+		];
+		if (empty($image)) {
+			$error = $this->l10n->t('No file uploaded');
+		}
+		if (!empty($image) && array_key_exists('error', $image) && $image['error'] !== UPLOAD_ERR_OK) {
+			$error = $phpFileUploadErrors[$image['error']];
+		}
+
+		if ($error !== null) {
+			return new DataResponse(
+				[
+					'data' => [
+						'message' => $error
+					],
+					'status' => 'failure',
+				],
+				Http::STATUS_UNPROCESSABLE_ENTITY
+			);
+		}
+
+		try {
+			$mime = $this->imageManager->updateImage($key, $image['tmp_name']);
+			$this->themingDefaults->set($key . 'Mime', $mime);
+		} catch (\Exception $e) {
+			return new DataResponse(
+				[
+					'data' => [
+						'message' => $e->getMessage()
+					],
+					'status' => 'failure',
+				],
+				Http::STATUS_UNPROCESSABLE_ENTITY
+			);
+		}
+
+		$name = $image['name'];
+
+		return new DataResponse(
+			[
+				'data' =>
+					[
+						'name' => $name,
+						'url' => $this->imageManager->getImageUrl($key),
+						'message' => $this->l10n->t('Saved'),
+					],
+				'status' => 'success'
+			]
+		);
+	}
+
+	/**
+	 * Revert setting to default value
+	 * @AuthorizedAdminSetting(settings=OCA\Theming\Settings\Admin)
+	 *
+	 * @param string $setting setting which should be reverted
+	 * @return DataResponse
+	 * @throws NotPermittedException
+	 */
+	public function undo(string $setting): DataResponse {
+		$value = $this->themingDefaults->undo($setting);
+
+		return new DataResponse(
+			[
+				'data' =>
+					[
+						'value' => $value,
+						'message' => $this->l10n->t('Saved'),
+					],
+				'status' => 'success'
+			]
+		);
+	}
+
+	/**
+	 * Revert all theming settings to their default values
+	 * @AuthorizedAdminSetting(settings=OCA\Theming\Settings\Admin)
+	 *
+	 * @return DataResponse
+	 * @throws NotPermittedException
+	 */
+	public function undoAll(): DataResponse {
+		$this->themingDefaults->undoAll();
+		$this->appManager->setDefaultApps([]);
+
+		return new DataResponse(
+			[
+				'data' =>
+					[
+						'message' => $this->l10n->t('Saved'),
+					],
+				'status' => 'success'
+			]
+		);
+	}
+
+	/**
+	 * @PublicPage
+	 * @NoCSRFRequired
+	 * @NoSameSiteCookieRequired
+	 *
+	 * Get an image
+	 *
+	 * @param string $key Key of the image
+	 * @param bool $useSvg Return image as SVG
+	 * @return FileDisplayResponse<Http::STATUS_OK, array{}>|NotFoundResponse<Http::STATUS_NOT_FOUND, array{}>
+	 * @throws NotPermittedException
+	 *
+	 * 200: Image returned
+	 * 404: Image not found
+	 */
+	public function getImage(string $key, bool $useSvg = true) {
+		try {
+			$file = $this->imageManager->getImage($key, $useSvg);
+		} catch (NotFoundException $e) {
+			return new NotFoundResponse();
+		}
+
+		$response = new FileDisplayResponse($file);
+		$csp = new Http\ContentSecurityPolicy();
+		$csp->allowInlineStyle();
+		$response->setContentSecurityPolicy($csp);
+		$response->cacheFor(3600);
+		$response->addHeader('Content-Type', $this->config->getAppValue($this->appName, $key . 'Mime', ''));
+		$response->addHeader('Content-Disposition', 'attachment; filename="' . $key . '"');
+		if (!$useSvg) {
+			$response->addHeader('Content-Type', 'image/png');
+		} else {
+			$response->addHeader('Content-Type', $this->config->getAppValue($this->appName, $key . 'Mime', ''));
+		}
+		return $response;
+	}
+
+	/**
+	 * @NoCSRFRequired
+	 * @PublicPage
+	 * @NoSameSiteCookieRequired
+	 * @NoTwoFactorRequired
+	 *
+	 * Get the CSS stylesheet for a theme
+	 *
+	 * @param string $themeId ID of the theme
+	 * @param bool $plain Let the browser decide the CSS priority
+	 * @param bool $withCustomCss Include custom CSS
+	 * @return DataDisplayResponse<Http::STATUS_OK, array{Content-Type: 'text/css'}>|NotFoundResponse<Http::STATUS_NOT_FOUND, array{}>
+	 *
+	 * 200: Stylesheet returned
+	 * 404: Theme not found
+	 */
+	public function getThemeStylesheet(string $themeId, bool $plain = false, bool $withCustomCss = false) {
+		$themes = $this->themesService->getThemes();
+		if (!in_array($themeId, array_keys($themes))) {
+			return new NotFoundResponse();
+		}
+
+		$theme = $themes[$themeId];
+		$customCss = $theme->getCustomCss();
+
+		// Generate variables
+		$variables = '';
+		foreach ($theme->getCSSVariables() as $variable => $value) {
+			$variables .= "$variable:$value; ";
+		};
+
+		// If plain is set, the browser decides of the css priority
+		if ($plain) {
+			$css = ":root { $variables } " . $customCss;
+		} else {
+			// If not set, we'll rely on the body class
+			$compiler = new Compiler();
+			$compiledCss = $compiler->compileString("[data-theme-$themeId] { $variables $customCss }");
+			$css = $compiledCss->getCss();
+			;
+		}
+
+		try {
+			$response = new DataDisplayResponse($css, Http::STATUS_OK, ['Content-Type' => 'text/css']);
+			$response->cacheFor(86400);
+			return $response;
+		} catch (NotFoundException $e) {
+			return new NotFoundResponse();
+		}
+	}
+
+	/**
+	 * @NoCSRFRequired
+	 * @PublicPage
+	 * @BruteForceProtection(action=manifest)
+	 *
+	 * Get the manifest for an app
+	 *
+	 * @param string $app ID of the app
+	 * @psalm-suppress LessSpecificReturnStatement The content of the Manifest doesn't need to be described in the return type
+	 * @return JSONResponse<Http::STATUS_OK, array{name: string, short_name: string, start_url: string, theme_color: string, background_color: string, description: string, icons: array{src: non-empty-string, type: string, sizes: string}[], display: string}, array{}>|JSONResponse<Http::STATUS_NOT_FOUND, array{}, array{}>
+	 *
+	 * 200: Manifest returned
+	 * 404: App not found
+	 */
+	public function getManifest(string $app): JSONResponse {
+		$cacheBusterValue = $this->config->getAppValue('theming', 'cachebuster', '0');
+		if ($app === 'core' || $app === 'settings') {
+			$name = $this->themingDefaults->getName();
+			$shortName = $this->themingDefaults->getName();
+			$startUrl = $this->urlGenerator->getBaseUrl();
+			$description = $this->themingDefaults->getSlogan();
+		} else {
+			if (!$this->appManager->isEnabledForUser($app)) {
+				$response = new JSONResponse([], Http::STATUS_NOT_FOUND);
+				$response->throttle(['action' => 'manifest', 'app' => $app]);
+				return $response;
+			}
+
+			$info = $this->appManager->getAppInfo($app, false, $this->l10n->getLanguageCode());
+			$name = $info['name'] . ' - ' . $this->themingDefaults->getName();
+			$shortName = $info['name'];
+			if (str_contains($this->request->getRequestUri(), '/index.php/')) {
+				$startUrl = $this->urlGenerator->getBaseUrl() . '/index.php/apps/' . $app . '/';
+			} else {
+				$startUrl = $this->urlGenerator->getBaseUrl() . '/apps/' . $app . '/';
+			}
+			$description = $info['summary'] ?? '';
+		}
+		/**
+		 * @var string $description
+		 * @var string $shortName
+		 */
+		$responseJS = [
+			'name' => $name,
+			'short_name' => $shortName,
+			'start_url' => $startUrl,
+			'theme_color' => $this->themingDefaults->getColorPrimary(),
+			'background_color' => $this->themingDefaults->getColorPrimary(),
+			'description' => $description,
+			'icons' =>
+				[
+					[
+						'src' => $this->urlGenerator->linkToRoute('theming.Icon.getTouchIcon',
+							['app' => $app]) . '?v=' . $cacheBusterValue,
+						'type' => 'image/png',
+						'sizes' => '512x512'
+					],
+					[
+						'src' => $this->urlGenerator->linkToRoute('theming.Icon.getFavicon',
+							['app' => $app]) . '?v=' . $cacheBusterValue,
+						'type' => 'image/svg+xml',
+						'sizes' => '16x16'
+					]
+				],
+			'display' => 'standalone'
+		];
+		$response = new JSONResponse($responseJS);
+		$response->cacheFor(3600);
+		return $response;
+	}
+}

wedding-pics/apps/theming/lib/Controller/UserThemeController.php

@@ -0,0 +1,248 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2018 John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
+ * @copyright Copyright (c) 2019 Janis Köhr <janiskoehr@icloud.com>
+ *
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Daniel Kesselberg <mail@danielkesselberg.de>
+ * @author Janis Köhr <janis.koehr@novatec-gmbh.de>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ * @author Kate Döen <kate.doeen@nextcloud.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Controller;
+
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\ITheme;
+use OCA\Theming\ResponseDefinitions;
+use OCA\Theming\Service\BackgroundService;
+use OCA\Theming\Service\ThemesService;
+use OCA\Theming\ThemingDefaults;
+use OCP\AppFramework\Http;
+use OCP\AppFramework\Http\DataResponse;
+use OCP\AppFramework\Http\FileDisplayResponse;
+use OCP\AppFramework\Http\JSONResponse;
+use OCP\AppFramework\Http\NotFoundResponse;
+use OCP\AppFramework\OCS\OCSBadRequestException;
+use OCP\AppFramework\OCS\OCSForbiddenException;
+use OCP\AppFramework\OCSController;
+use OCP\IConfig;
+use OCP\IRequest;
+use OCP\IUserSession;
+use OCP\PreConditionNotMetException;
+
+/**
+ * @psalm-import-type ThemingBackground from ResponseDefinitions
+ */
+class UserThemeController extends OCSController {
+
+	protected ?string $userId = null;
+
+	private IConfig $config;
+	private IUserSession $userSession;
+	private ThemesService $themesService;
+	private ThemingDefaults $themingDefaults;
+	private BackgroundService $backgroundService;
+
+	public function __construct(string $appName,
+		IRequest $request,
+		IConfig $config,
+		IUserSession $userSession,
+		ThemesService $themesService,
+		ThemingDefaults $themingDefaults,
+		BackgroundService $backgroundService) {
+		parent::__construct($appName, $request);
+		$this->config = $config;
+		$this->userSession = $userSession;
+		$this->themesService = $themesService;
+		$this->themingDefaults = $themingDefaults;
+		$this->backgroundService = $backgroundService;
+
+		$user = $userSession->getUser();
+		if ($user !== null) {
+			$this->userId = $user->getUID();
+		}
+	}
+
+	/**
+	 * @NoAdminRequired
+	 *
+	 * Enable theme
+	 *
+	 * @param string $themeId the theme ID
+	 * @return DataResponse<Http::STATUS_OK, array<empty>, array{}>
+	 * @throws OCSBadRequestException Enabling theme is not possible
+	 * @throws PreConditionNotMetException
+	 *
+	 * 200: Theme enabled successfully
+	 */
+	public function enableTheme(string $themeId): DataResponse {
+		$theme = $this->validateTheme($themeId);
+
+		// Enable selected theme
+		$this->themesService->enableTheme($theme);
+		return new DataResponse();
+	}
+
+	/**
+	 * @NoAdminRequired
+	 *
+	 * Disable theme
+	 *
+	 * @param string $themeId the theme ID
+	 * @return DataResponse<Http::STATUS_OK, array<empty>, array{}>
+	 * @throws OCSBadRequestException Disabling theme is not possible
+	 * @throws PreConditionNotMetException
+	 *
+	 * 200: Theme disabled successfully
+	 */
+	public function disableTheme(string $themeId): DataResponse {
+		$theme = $this->validateTheme($themeId);
+
+		// Enable selected theme
+		$this->themesService->disableTheme($theme);
+		return new DataResponse();
+	}
+
+	/**
+	 * Validate and return the matching ITheme
+	 *
+	 * Disable theme
+	 *
+	 * @param string $themeId the theme ID
+	 * @return ITheme
+	 * @throws OCSBadRequestException
+	 * @throws PreConditionNotMetException
+	 */
+	private function validateTheme(string $themeId): ITheme {
+		if ($themeId === '' || !$themeId) {
+			throw new OCSBadRequestException('Invalid theme id: ' . $themeId);
+		}
+
+		$themes = $this->themesService->getThemes();
+		if (!isset($themes[$themeId])) {
+			throw new OCSBadRequestException('Invalid theme id: ' . $themeId);
+		}
+
+		// If trying to toggle another theme but this is enforced
+		if ($this->config->getSystemValueString('enforce_theme', '') !== ''
+			&& $themes[$themeId]->getType() === ITheme::TYPE_THEME) {
+			throw new OCSForbiddenException('Theme switching is disabled');
+		}
+
+		return $themes[$themeId];
+	}
+
+	/**
+	 * @NoAdminRequired
+	 * @NoCSRFRequired
+	 *
+	 * Get the background image
+	 * @return FileDisplayResponse<Http::STATUS_OK, array{Content-Type: string}>|NotFoundResponse<Http::STATUS_NOT_FOUND, array{}>
+	 *
+	 * 200: Background image returned
+	 * 404: Background image not found
+	 */
+	public function getBackground(): Http\Response {
+		$file = $this->backgroundService->getBackground();
+		if ($file !== null) {
+			$response = new FileDisplayResponse($file, Http::STATUS_OK, ['Content-Type' => $file->getMimeType()]);
+			$response->cacheFor(24 * 60 * 60, false, true);
+			return $response;
+		}
+		return new NotFoundResponse();
+	}
+
+	/**
+	 * @NoAdminRequired
+	 *
+	 * Delete the background
+	 *
+	 * @return JSONResponse<Http::STATUS_OK, ThemingBackground, array{}>
+	 *
+	 * 200: Background deleted successfully
+	 */
+	public function deleteBackground(): JSONResponse {
+		$currentVersion = (int)$this->config->getUserValue($this->userId, Application::APP_ID, 'userCacheBuster', '0');
+		$this->backgroundService->deleteBackgroundImage();
+		return new JSONResponse([
+			'backgroundImage' => null,
+			'backgroundColor' => $this->themingDefaults->getColorPrimary(),
+			'version' => $currentVersion,
+		]);
+	}
+
+	/**
+	 * @NoAdminRequired
+	 *
+	 * Set the background
+	 *
+	 * @param string $type Type of background
+	 * @param string $value Path of the background image
+	 * @param string|null $color Color for the background
+	 * @return JSONResponse<Http::STATUS_OK, ThemingBackground, array{}>|JSONResponse<Http::STATUS_BAD_REQUEST|Http::STATUS_INTERNAL_SERVER_ERROR, array{error: string}, array{}>
+	 *
+	 * 200: Background set successfully
+	 * 400: Setting background is not possible
+	 */
+	public function setBackground(string $type = BackgroundService::BACKGROUND_DEFAULT, string $value = '', string $color = null): JSONResponse {
+		$currentVersion = (int)$this->config->getUserValue($this->userId, Application::APP_ID, 'userCacheBuster', '0');
+
+		// Set color if provided
+		if ($color) {
+			$this->backgroundService->setColorBackground($color);
+		}
+
+		// Set background image if provided
+		try {
+			switch ($type) {
+				case BackgroundService::BACKGROUND_SHIPPED:
+					$this->backgroundService->setShippedBackground($value);
+					break;
+				case BackgroundService::BACKGROUND_CUSTOM:
+					$this->backgroundService->setFileBackground($value);
+					break;
+				case BackgroundService::BACKGROUND_DEFAULT:
+					// Delete both background and color keys
+					$this->backgroundService->setDefaultBackground();
+					break;
+				default:
+					if (!$color) {
+						return new JSONResponse(['error' => 'Invalid type provided'], Http::STATUS_BAD_REQUEST);
+					}
+			}
+		} catch (\InvalidArgumentException $e) {
+			return new JSONResponse(['error' => $e->getMessage()], Http::STATUS_BAD_REQUEST);
+		} catch (\Throwable $e) {
+			return new JSONResponse(['error' => $e->getMessage()], Http::STATUS_INTERNAL_SERVER_ERROR);
+		}
+
+		$currentVersion++;
+		$this->config->setUserValue($this->userId, Application::APP_ID, 'userCacheBuster', (string)$currentVersion);
+
+		return new JSONResponse([
+			'backgroundImage' => $this->config->getUserValue($this->userId, Application::APP_ID, 'background_image', BackgroundService::BACKGROUND_DEFAULT),
+			'backgroundColor' => $this->themingDefaults->getColorPrimary(),
+			'version' => $currentVersion,
+		]);
+	}
+}

wedding-pics/apps/theming/lib/ITheme.php

@@ -0,0 +1,100 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2022 John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This code is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License, version 3,
+ * as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License, version 3,
+ * along with this program. If not, see <http://www.gnu.org/licenses/>
+ *
+ */
+
+namespace OCA\Theming;
+
+/**
+ * Interface ITheme
+ *
+ * @since 25.0.0
+ */
+interface ITheme {
+
+	public const TYPE_THEME = 1;
+	public const TYPE_FONT = 2;
+
+	/**
+	 * Unique theme id
+	 * Will be used to search for ID.png in the img folder
+	 *
+	 * @since 25.0.0
+	 */
+	public function getId(): string;
+
+	/**
+	 * Theme type
+	 * TYPE_THEME or TYPE_FONT
+	 *
+	 * @since 25.0.0
+	 */
+	public function getType(): int;
+
+	/**
+	 * The theme translated title
+	 *
+	 * @since 25.0.0
+	 */
+	public function getTitle(): string;
+
+	/**
+	 * The theme enable checkbox translated label
+	 *
+	 * @since 25.0.0
+	 */
+	public function getEnableLabel(): string;
+
+	/**
+	 * The theme translated description
+	 *
+	 * @since 25.0.0
+	 */
+	public function getDescription(): string;
+
+	/**
+	 * Get the media query triggering this theme
+	 * Optional, ignored if falsy
+	 *
+	 * @return string
+	 * @since 25.0.0
+	 */
+	public function getMediaQuery(): string;
+
+	/**
+	 * Return the list of changed css variables
+	 *
+	 * @return array
+	 * @since 25.0.0
+	 */
+	public function getCSSVariables(): array;
+
+	/**
+	 * Return the custom css necessary for that app
+	 * ⚠️ Warning, should be used slightly.
+	 * Theoretically, editing the variables should be enough.
+	 *
+	 * @return string
+	 * @since 25.0.0
+	 */
+	public function getCustomCss(): string;
+}

wedding-pics/apps/theming/lib/IconBuilder.php

@@ -0,0 +1,244 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Julius Härtl <jus@bitgrid.net>
+ *
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Jan-Christoph Borchardt <hey@jancborchardt.net>
+ * @author Julius Haertl <jus@bitgrid.net>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Morris Jobke <hey@morrisjobke.de>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming;
+
+use Imagick;
+use ImagickPixel;
+use OCP\Files\SimpleFS\ISimpleFile;
+
+class IconBuilder {
+	/** @var ThemingDefaults */
+	private $themingDefaults;
+	/** @var Util */
+	private $util;
+	/** @var ImageManager */
+	private $imageManager;
+
+	/**
+	 * IconBuilder constructor.
+	 *
+	 * @param ThemingDefaults $themingDefaults
+	 * @param Util $util
+	 * @param ImageManager $imageManager
+	 */
+	public function __construct(
+		ThemingDefaults $themingDefaults,
+		Util $util,
+		ImageManager $imageManager
+	) {
+		$this->themingDefaults = $themingDefaults;
+		$this->util = $util;
+		$this->imageManager = $imageManager;
+	}
+
+	/**
+	 * @param $app string app name
+	 * @return string|false image blob
+	 */
+	public function getFavicon($app) {
+		if (!$this->imageManager->shouldReplaceIcons()) {
+			return false;
+		}
+		try {
+			$favicon = new Imagick();
+			$favicon->setFormat("ico");
+			$icon = $this->renderAppIcon($app, 128);
+			if ($icon === false) {
+				return false;
+			}
+			$icon->setImageFormat("png32");
+
+			$clone = clone $icon;
+			$clone->scaleImage(16, 0);
+			$favicon->addImage($clone);
+
+			$clone = clone $icon;
+			$clone->scaleImage(32, 0);
+			$favicon->addImage($clone);
+
+			$clone = clone $icon;
+			$clone->scaleImage(64, 0);
+			$favicon->addImage($clone);
+
+			$clone = clone $icon;
+			$clone->scaleImage(128, 0);
+			$favicon->addImage($clone);
+
+			$data = $favicon->getImagesBlob();
+			$favicon->destroy();
+			$icon->destroy();
+			$clone->destroy();
+			return $data;
+		} catch (\ImagickException $e) {
+			return false;
+		}
+	}
+
+	/**
+	 * @param $app string app name
+	 * @return string|false image blob
+	 */
+	public function getTouchIcon($app) {
+		try {
+			$icon = $this->renderAppIcon($app, 512);
+			if ($icon === false) {
+				return false;
+			}
+			$icon->setImageFormat("png32");
+			$data = $icon->getImageBlob();
+			$icon->destroy();
+			return $data;
+		} catch (\ImagickException $e) {
+			return false;
+		}
+	}
+
+	/**
+	 * Render app icon on themed background color
+	 * fallback to logo
+	 *
+	 * @param $app string app name
+	 * @param $size int size of the icon in px
+	 * @return Imagick|false
+	 */
+	public function renderAppIcon($app, $size) {
+		$appIcon = $this->util->getAppIcon($app);
+		if ($appIcon === false) {
+			return false;
+		}
+		if ($appIcon instanceof ISimpleFile) {
+			$appIconContent = $appIcon->getContent();
+			$mime = $appIcon->getMimeType();
+		} else {
+			$appIconContent = file_get_contents($appIcon);
+			$mime = mime_content_type($appIcon);
+		}
+
+		if ($appIconContent === false || $appIconContent === "") {
+			return false;
+		}
+
+		$color = $this->themingDefaults->getColorPrimary();
+
+		// generate background image with rounded corners
+		$background = '<?xml version="1.0" encoding="UTF-8"?>' .
+			'<svg xmlns="http://www.w3.org/2000/svg" version="1.1" xmlns:cc="http://creativecommons.org/ns#" width="512" height="512" xmlns:xlink="http://www.w3.org/1999/xlink">' .
+			'<rect x="0" y="0" rx="100" ry="100" width="512" height="512" style="fill:' . $color . ';" />' .
+			'</svg>';
+		// resize svg magic as this seems broken in Imagemagick
+		if ($mime === "image/svg+xml" || substr($appIconContent, 0, 4) === "<svg") {
+			if (substr($appIconContent, 0, 5) !== "<?xml") {
+				$svg = "<?xml version=\"1.0\"?>".$appIconContent;
+			} else {
+				$svg = $appIconContent;
+			}
+			$tmp = new Imagick();
+			$tmp->readImageBlob($svg);
+			$x = $tmp->getImageWidth();
+			$y = $tmp->getImageHeight();
+			$res = $tmp->getImageResolution();
+			$tmp->destroy();
+
+			if ($x > $y) {
+				$max = $x;
+			} else {
+				$max = $y;
+			}
+
+			// convert svg to resized image
+			$appIconFile = new Imagick();
+			$resX = (int)(512 * $res['x'] / $max * 2.53);
+			$resY = (int)(512 * $res['y'] / $max * 2.53);
+			$appIconFile->setResolution($resX, $resY);
+			$appIconFile->setBackgroundColor(new ImagickPixel('transparent'));
+			$appIconFile->readImageBlob($svg);
+
+			/**
+			 * invert app icons for bright primary colors
+			 * the default nextcloud logo will not be inverted to black
+			 */
+			if ($this->util->invertTextColor($color)
+				&& !$appIcon instanceof ISimpleFile
+				&& $app !== "core"
+			) {
+				$appIconFile->negateImage(false);
+			}
+			$appIconFile->scaleImage(512, 512, true);
+		} else {
+			$appIconFile = new Imagick();
+			$appIconFile->setBackgroundColor(new ImagickPixel('transparent'));
+			$appIconFile->readImageBlob($appIconContent);
+			$appIconFile->scaleImage(512, 512, true);
+		}
+		// offset for icon positioning
+		$border_w = (int)($appIconFile->getImageWidth() * 0.05);
+		$border_h = (int)($appIconFile->getImageHeight() * 0.05);
+		$innerWidth = ($appIconFile->getImageWidth() - $border_w * 2);
+		$innerHeight = ($appIconFile->getImageHeight() - $border_h * 2);
+		$appIconFile->adaptiveResizeImage($innerWidth, $innerHeight);
+		// center icon
+		$offset_w = (int)(512 / 2 - $innerWidth / 2);
+		$offset_h = (int)(512 / 2 - $innerHeight / 2);
+
+		$finalIconFile = new Imagick();
+		$finalIconFile->setBackgroundColor(new ImagickPixel('transparent'));
+		$finalIconFile->readImageBlob($background);
+		$finalIconFile->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_TRANSPARENT);
+		$finalIconFile->setImageArtifact('compose:args', "1,0,-0.5,0.5");
+		$finalIconFile->compositeImage($appIconFile, Imagick::COMPOSITE_ATOP, $offset_w, $offset_h);
+		$finalIconFile->setImageFormat('png24');
+		if (defined("Imagick::INTERPOLATE_BICUBIC") === true) {
+			$filter = Imagick::INTERPOLATE_BICUBIC;
+		} else {
+			$filter = Imagick::FILTER_LANCZOS;
+		}
+		$finalIconFile->resizeImage($size, $size, $filter, 1, false);
+
+		$appIconFile->destroy();
+		return $finalIconFile;
+	}
+
+	/**
+	 * @param $app string app name
+	 * @param $image string relative path to svg file in app directory
+	 * @return string|false content of a colorized svg file
+	 */
+	public function colorSvg($app, $image) {
+		$imageFile = $this->util->getAppImage($app, $image);
+		if ($imageFile === false || $imageFile === "") {
+			return false;
+		}
+		$svg = file_get_contents($imageFile);
+		if ($svg !== false && $svg !== "") {
+			$color = $this->util->elementColor($this->themingDefaults->getColorPrimary());
+			$svg = $this->util->colorizeSvg($svg, $color);
+			return $svg;
+		} else {
+			return false;
+		}
+	}
+}

wedding-pics/apps/theming/lib/ImageManager.php

@@ -0,0 +1,370 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Julius Härtl <jus@bitgrid.net>
+ *
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Daniel Kesselberg <mail@danielkesselberg.de>
+ * @author Gary Kim <gary@garykim.dev>
+ * @author Jacob Neplokh <me@jacobneplokh.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ * @author Julien Veyssier <eneiluj@posteo.net>
+ * @author Julius Haertl <jus@bitgrid.net>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Michael Weimann <mail@michael-weimann.eu>
+ * @author Morris Jobke <hey@morrisjobke.de>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ * @author ste101 <stephan_bauer@gmx.de>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming;
+
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\Service\BackgroundService;
+use OCP\Files\IAppData;
+use OCP\Files\NotFoundException;
+use OCP\Files\NotPermittedException;
+use OCP\Files\SimpleFS\ISimpleFile;
+use OCP\Files\SimpleFS\ISimpleFolder;
+use OCP\ICacheFactory;
+use OCP\IConfig;
+use OCP\ITempManager;
+use OCP\IURLGenerator;
+use Psr\Log\LoggerInterface;
+
+class ImageManager {
+	public const SUPPORTED_IMAGE_KEYS = ['background', 'logo', 'logoheader', 'favicon'];
+
+	public function __construct(
+		private IConfig $config,
+		private IAppData $appData,
+		private IURLGenerator $urlGenerator,
+		private ICacheFactory $cacheFactory,
+		private LoggerInterface $logger,
+		private ITempManager $tempManager,
+	) {
+	}
+
+	/**
+	 * Get a globally defined image (admin theming settings)
+	 *
+	 * @param string $key the image key
+	 * @return string the image url
+	 */
+	public function getImageUrl(string $key): string {
+		$cacheBusterCounter = $this->config->getAppValue(Application::APP_ID, 'cachebuster', '0');
+		if ($this->hasImage($key)) {
+			return $this->urlGenerator->linkToRoute('theming.Theming.getImage', [ 'key' => $key ]) . '?v=' . $cacheBusterCounter;
+		}
+
+		switch ($key) {
+			case 'logo':
+			case 'logoheader':
+			case 'favicon':
+				return $this->urlGenerator->imagePath('core', 'logo/logo.png') . '?v=' . $cacheBusterCounter;
+			case 'background':
+				return $this->urlGenerator->linkTo(Application::APP_ID, 'img/background/' . BackgroundService::DEFAULT_BACKGROUND_IMAGE);
+		}
+		return '';
+	}
+
+	/**
+	 * Get the absolute url. See getImageUrl
+	 */
+	public function getImageUrlAbsolute(string $key): string {
+		return $this->urlGenerator->getAbsoluteURL($this->getImageUrl($key));
+	}
+
+	/**
+	 * @param string $key
+	 * @param bool $useSvg
+	 * @return ISimpleFile
+	 * @throws NotFoundException
+	 * @throws NotPermittedException
+	 */
+	public function getImage(string $key, bool $useSvg = true): ISimpleFile {
+		$mime = $this->config->getAppValue('theming', $key . 'Mime', '');
+		$folder = $this->getRootFolder()->getFolder('images');
+
+		if ($mime === '' || !$folder->fileExists($key)) {
+			throw new NotFoundException();
+		}
+
+		if (!$useSvg && $this->shouldReplaceIcons()) {
+			if (!$folder->fileExists($key . '.png')) {
+				try {
+					$finalIconFile = new \Imagick();
+					$finalIconFile->setBackgroundColor('none');
+					$finalIconFile->readImageBlob($folder->getFile($key)->getContent());
+					$finalIconFile->setImageFormat('png32');
+					$pngFile = $folder->newFile($key . '.png');
+					$pngFile->putContent($finalIconFile->getImageBlob());
+					return $pngFile;
+				} catch (\ImagickException $e) {
+					$this->logger->info('The image was requested to be no SVG file, but converting it to PNG failed: ' . $e->getMessage());
+				}
+			} else {
+				return $folder->getFile($key . '.png');
+			}
+		}
+
+		return $folder->getFile($key);
+	}
+
+	public function hasImage(string $key): bool {
+		$mimeSetting = $this->config->getAppValue('theming', $key . 'Mime', '');
+		// Removing the background defines its mime as 'backgroundColor'
+		return $mimeSetting !== '' && $mimeSetting !== 'backgroundColor';
+	}
+
+	/**
+	 * @return array<string, array{mime: string, url: string}>
+	 */
+	public function getCustomImages(): array {
+		$images = [];
+		foreach (self::SUPPORTED_IMAGE_KEYS as $key) {
+			$images[$key] = [
+				'mime' => $this->config->getAppValue('theming', $key . 'Mime', ''),
+				'url' => $this->getImageUrl($key),
+			];
+		}
+		return $images;
+	}
+
+	/**
+	 * Get folder for current theming files
+	 *
+	 * @return ISimpleFolder
+	 * @throws NotPermittedException
+	 */
+	public function getCacheFolder(): ISimpleFolder {
+		$cacheBusterValue = $this->config->getAppValue('theming', 'cachebuster', '0');
+		try {
+			$folder = $this->getRootFolder()->getFolder($cacheBusterValue);
+		} catch (NotFoundException $e) {
+			$folder = $this->getRootFolder()->newFolder($cacheBusterValue);
+			$this->cleanup();
+		}
+		return $folder;
+	}
+
+	/**
+	 * Get a file from AppData
+	 *
+	 * @param string $filename
+	 * @throws NotFoundException
+	 * @return \OCP\Files\SimpleFS\ISimpleFile
+	 * @throws NotPermittedException
+	 */
+	public function getCachedImage(string $filename): ISimpleFile {
+		$currentFolder = $this->getCacheFolder();
+		return $currentFolder->getFile($filename);
+	}
+
+	/**
+	 * Store a file for theming in AppData
+	 *
+	 * @param string $filename
+	 * @param string $data
+	 * @return \OCP\Files\SimpleFS\ISimpleFile
+	 * @throws NotFoundException
+	 * @throws NotPermittedException
+	 */
+	public function setCachedImage(string $filename, string $data): ISimpleFile {
+		$currentFolder = $this->getCacheFolder();
+		if ($currentFolder->fileExists($filename)) {
+			$file = $currentFolder->getFile($filename);
+		} else {
+			$file = $currentFolder->newFile($filename);
+		}
+		$file->putContent($data);
+		return $file;
+	}
+
+	public function delete(string $key): void {
+		/* ignore exceptions, since we don't want to fail hard if something goes wrong during cleanup */
+		try {
+			$file = $this->getRootFolder()->getFolder('images')->getFile($key);
+			$file->delete();
+		} catch (NotFoundException $e) {
+		} catch (NotPermittedException $e) {
+		}
+		try {
+			$file = $this->getRootFolder()->getFolder('images')->getFile($key . '.png');
+			$file->delete();
+		} catch (NotFoundException $e) {
+		} catch (NotPermittedException $e) {
+		}
+	}
+
+	public function updateImage(string $key, string $tmpFile): string {
+		$this->delete($key);
+
+		try {
+			$folder = $this->getRootFolder()->getFolder('images');
+		} catch (NotFoundException $e) {
+			$folder = $this->getRootFolder()->newFolder('images');
+		}
+
+		$target = $folder->newFile($key);
+		$supportedFormats = $this->getSupportedUploadImageFormats($key);
+		$detectedMimeType = mime_content_type($tmpFile);
+		if (!in_array($detectedMimeType, $supportedFormats, true)) {
+			throw new \Exception('Unsupported image type: ' . $detectedMimeType);
+		}
+
+		if ($key === 'background' && $this->shouldOptimizeBackgroundImage($detectedMimeType, filesize($tmpFile))) {
+			try {
+				// Optimize the image since some people may upload images that will be
+				// either to big or are not progressive rendering.
+				$newImage = @imagecreatefromstring(file_get_contents($tmpFile));
+				if ($newImage === false) {
+					throw new \Exception('Could not read background image, possibly corrupted.');
+				}
+
+				// Preserve transparency
+				imagesavealpha($newImage, true);
+				imagealphablending($newImage, true);
+
+				$newWidth = (int)(imagesx($newImage) < 4096 ? imagesx($newImage) : 4096);
+				$newHeight = (int)(imagesy($newImage) / (imagesx($newImage) / $newWidth));
+				$outputImage = imagescale($newImage, $newWidth, $newHeight);
+				if ($outputImage === false) {
+					throw new \Exception('Could not scale uploaded background image.');
+				}
+
+				$newTmpFile = $this->tempManager->getTemporaryFile();
+				imageinterlace($outputImage, 1);
+				// Keep jpeg images encoded as jpeg
+				if (str_contains($detectedMimeType, 'image/jpeg')) {
+					if (!imagejpeg($outputImage, $newTmpFile, 90)) {
+						throw new \Exception('Could not recompress background image as JPEG');
+					}
+				} else {
+					if (!imagepng($outputImage, $newTmpFile, 8)) {
+						throw new \Exception('Could not recompress background image as PNG');
+					}
+				}
+				$tmpFile = $newTmpFile;
+				imagedestroy($outputImage);
+			} catch (\Exception $e) {
+				if (is_resource($outputImage) || $outputImage instanceof \GdImage) {
+					imagedestroy($outputImage);
+				}
+
+				$this->logger->debug($e->getMessage());
+			}
+		}
+
+		$target->putContent(file_get_contents($tmpFile));
+
+		return $detectedMimeType;
+	}
+
+	/**
+	 * Decide whether an image benefits from shrinking and reconverting
+	 *
+	 * @param string $mimeType the mime type of the image
+	 * @param int $contentSize size of the image file
+	 * @return bool
+	 */
+	private function shouldOptimizeBackgroundImage(string $mimeType, int $contentSize): bool {
+		// Do not touch SVGs
+		if (str_contains($mimeType, 'image/svg')) {
+			return false;
+		}
+		// GIF does not benefit from converting
+		if (str_contains($mimeType, 'image/gif')) {
+			return false;
+		}
+		// WebP also does not benefit from converting
+		// We could possibly try to convert to progressive image, but normally webP images are quite small
+		if (str_contains($mimeType, 'image/webp')) {
+			return false;
+		}
+		// As a rule of thumb background images should be max. 150-300 KiB, small images do not benefit from converting
+		return $contentSize > 150000;
+	}
+
+	/**
+	 * Returns a list of supported mime types for image uploads.
+	 * "favicon" images are only allowed to be SVG when imagemagick with SVG support is available.
+	 *
+	 * @param string $key The image key, e.g. "favicon"
+	 * @return string[]
+	 */
+	public function getSupportedUploadImageFormats(string $key): array {
+		$supportedFormats = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
+
+		if ($key !== 'favicon' || $this->shouldReplaceIcons() === true) {
+			$supportedFormats[] = 'image/svg+xml';
+			$supportedFormats[] = 'image/svg';
+		}
+
+		if ($key === 'favicon') {
+			$supportedFormats[] = 'image/x-icon';
+			$supportedFormats[] = 'image/vnd.microsoft.icon';
+		}
+
+		return $supportedFormats;
+	}
+
+	/**
+	 * remove cached files that are not required any longer
+	 *
+	 * @throws NotPermittedException
+	 * @throws NotFoundException
+	 */
+	public function cleanup() {
+		$currentFolder = $this->getCacheFolder();
+		$folders = $this->getRootFolder()->getDirectoryListing();
+		foreach ($folders as $folder) {
+			if ($folder->getName() !== 'images' && $folder->getName() !== $currentFolder->getName()) {
+				$folder->delete();
+			}
+		}
+	}
+
+	/**
+	 * Check if Imagemagick is enabled and if SVG is supported
+	 * otherwise we can't render custom icons
+	 *
+	 * @return bool
+	 */
+	public function shouldReplaceIcons() {
+		$cache = $this->cacheFactory->createDistributed('theming-' . $this->urlGenerator->getBaseUrl());
+		if ($value = $cache->get('shouldReplaceIcons')) {
+			return (bool)$value;
+		}
+		$value = false;
+		if (extension_loaded('imagick')) {
+			if (count(\Imagick::queryFormats('SVG')) >= 1) {
+				$value = true;
+			}
+		}
+		$cache->set('shouldReplaceIcons', $value);
+		return $value;
+	}
+
+	private function getRootFolder(): ISimpleFolder {
+		try {
+			return $this->appData->getFolder('global');
+		} catch (NotFoundException $e) {
+			return $this->appData->newFolder('global');
+		}
+	}
+}

wedding-pics/apps/theming/lib/Jobs/MigrateBackgroundImages.php

@@ -0,0 +1,227 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2022 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCA\Theming\Jobs;
+
+use OCA\Theming\AppInfo\Application;
+use OCP\AppFramework\Utility\ITimeFactory;
+use OCP\BackgroundJob\IJobList;
+use OCP\BackgroundJob\QueuedJob;
+use OCP\DB\QueryBuilder\IQueryBuilder;
+use OCP\Files\AppData\IAppDataFactory;
+use OCP\Files\IAppData;
+use OCP\Files\NotFoundException;
+use OCP\Files\NotPermittedException;
+use OCP\Files\SimpleFS\ISimpleFolder;
+use OCP\IDBConnection;
+use Psr\Log\LoggerInterface;
+
+class MigrateBackgroundImages extends QueuedJob {
+	public const TIME_SENSITIVE = 0;
+
+	public const STAGE_PREPARE = 'prepare';
+	public const STAGE_EXECUTE = 'execute';
+	// will be saved in appdata/theming/global/
+	protected const STATE_FILE_NAME = '25_dashboard_to_theming_migration_users.json';
+
+	private IAppDataFactory $appDataFactory;
+	private IJobList $jobList;
+	private IDBConnection $dbc;
+	private IAppData $appData;
+	private LoggerInterface $logger;
+
+	public function __construct(
+		ITimeFactory $time,
+		IAppDataFactory $appDataFactory,
+		IJobList $jobList,
+		IDBConnection $dbc,
+		IAppData $appData,
+		LoggerInterface $logger
+	) {
+		parent::__construct($time);
+		$this->appDataFactory = $appDataFactory;
+		$this->jobList = $jobList;
+		$this->dbc = $dbc;
+		$this->appData = $appData;
+		$this->logger = $logger;
+	}
+
+	protected function run(mixed $argument): void {
+		if (!is_array($argument) || !isset($argument['stage'])) {
+			throw new \Exception('Job '.self::class.' called with wrong argument');
+		}
+
+		switch ($argument['stage']) {
+			case self::STAGE_PREPARE:
+				$this->runPreparation();
+				break;
+			case self::STAGE_EXECUTE:
+				$this->runMigration();
+				break;
+			default:
+				break;
+		}
+	}
+
+	protected function runPreparation(): void {
+		try {
+			$selector = $this->dbc->getQueryBuilder();
+			$result = $selector->select('userid')
+				->from('preferences')
+				->where($selector->expr()->eq('appid', $selector->createNamedParameter('theming')))
+				->andWhere($selector->expr()->eq('configkey', $selector->createNamedParameter('background')))
+				->andWhere($selector->expr()->eq('configvalue', $selector->createNamedParameter('custom', IQueryBuilder::PARAM_STR), IQueryBuilder::PARAM_STR))
+				->executeQuery();
+
+			$userIds = $result->fetchAll(\PDO::FETCH_COLUMN);
+			$this->storeUserIdsToProcess($userIds);
+		} catch (\Throwable $t) {
+			$this->jobList->add(self::class, ['stage' => self::STAGE_PREPARE]);
+			throw $t;
+		}
+		$this->jobList->add(self::class, ['stage' => self::STAGE_EXECUTE]);
+	}
+
+	/**
+	 * @throws NotPermittedException
+	 * @throws NotFoundException
+	 */
+	protected function runMigration(): void {
+		$allUserIds = $this->readUserIdsToProcess();
+		$notSoFastMode = count($allUserIds) > 5000;
+		$dashboardData = $this->appDataFactory->get('dashboard');
+
+		$userIds = $notSoFastMode ? array_slice($allUserIds, 0, 5000) : $allUserIds;
+		foreach ($userIds as $userId) {
+			try {
+				// migration
+				$file = $dashboardData->getFolder($userId)->getFile('background.jpg');
+				$targetDir = $this->getUserFolder($userId);
+
+				if (!$targetDir->fileExists('background.jpg')) {
+					$targetDir->newFile('background.jpg', $file->getContent());
+				}
+				$file->delete();
+			} catch (NotFoundException|NotPermittedException $e) {
+			}
+		}
+
+		if ($notSoFastMode) {
+			$remainingUserIds = array_slice($allUserIds, 5000);
+			$this->storeUserIdsToProcess($remainingUserIds);
+			$this->jobList->add(self::class, ['stage' => self::STAGE_EXECUTE]);
+		} else {
+			$this->deleteStateFile();
+		}
+	}
+
+	/**
+	 * @throws NotPermittedException
+	 * @throws NotFoundException
+	 */
+	protected function readUserIdsToProcess(): array {
+		$globalFolder = $this->appData->getFolder('global');
+		if ($globalFolder->fileExists(self::STATE_FILE_NAME)) {
+			$file = $globalFolder->getFile(self::STATE_FILE_NAME);
+			try {
+				$userIds = \json_decode($file->getContent(), true);
+			} catch (NotFoundException $e) {
+				$userIds = [];
+			}
+			if ($userIds === null) {
+				$userIds = [];
+			}
+		} else {
+			$userIds = [];
+		}
+		return $userIds;
+	}
+
+	/**
+	 * @throws NotFoundException
+	 */
+	protected function storeUserIdsToProcess(array $userIds): void {
+		$storableUserIds = \json_encode($userIds);
+		$globalFolder = $this->appData->getFolder('global');
+		try {
+			if ($globalFolder->fileExists(self::STATE_FILE_NAME)) {
+				$file = $globalFolder->getFile(self::STATE_FILE_NAME);
+			} else {
+				$file = $globalFolder->newFile(self::STATE_FILE_NAME);
+			}
+			$file->putContent($storableUserIds);
+		} catch (NotFoundException $e) {
+		} catch (NotPermittedException $e) {
+			$this->logger->warning('Lacking permissions to create {file}',
+				[
+					'app' => 'theming',
+					'file' => self::STATE_FILE_NAME,
+					'exception' => $e,
+				]
+			);
+		}
+	}
+
+	/**
+	 * @throws NotFoundException
+	 */
+	protected function deleteStateFile(): void {
+		$globalFolder = $this->appData->getFolder('global');
+		if ($globalFolder->fileExists(self::STATE_FILE_NAME)) {
+			$file = $globalFolder->getFile(self::STATE_FILE_NAME);
+			try {
+				$file->delete();
+			} catch (NotPermittedException $e) {
+				$this->logger->info('Could not delete {file} due to permissions. It is safe to delete manually inside data -> appdata -> theming -> global.',
+					[
+						'app' => 'theming',
+						'file' => $file->getName(),
+						'exception' => $e,
+					]
+				);
+			}
+		}
+	}
+
+	/**
+	 * Get the root location for users theming data
+	 */
+	protected function getUserFolder(string $userId): ISimpleFolder {
+		$themingData = $this->appDataFactory->get(Application::APP_ID);
+
+		try {
+			$rootFolder = $themingData->getFolder('users');
+		} catch (NotFoundException $e) {
+			$rootFolder = $themingData->newFolder('users');
+		}
+
+		try {
+			return $rootFolder->getFolder($userId);
+		} catch (NotFoundException $e) {
+			return $rootFolder->newFolder($userId);
+		}
+	}
+}

wedding-pics/apps/theming/lib/Listener/BeforePreferenceListener.php

@@ -0,0 +1,96 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Listener;
+
+use OCA\Theming\AppInfo\Application;
+use OCP\App\IAppManager;
+use OCP\Config\BeforePreferenceDeletedEvent;
+use OCP\Config\BeforePreferenceSetEvent;
+use OCP\EventDispatcher\Event;
+use OCP\EventDispatcher\IEventListener;
+
+class BeforePreferenceListener implements IEventListener {
+	public function __construct(
+		private IAppManager $appManager,
+	) {
+	}
+
+	public function handle(Event $event): void {
+		if (!$event instanceof BeforePreferenceSetEvent
+			&& !$event instanceof BeforePreferenceDeletedEvent) {
+			// Invalid event type
+			return;
+		}
+
+		switch ($event->getAppId()) {
+			case Application::APP_ID: $this->handleThemingValues($event);
+				break;
+			case 'core': $this->handleCoreValues($event);
+				break;
+		}
+	}
+
+	private function handleThemingValues(BeforePreferenceSetEvent|BeforePreferenceDeletedEvent $event): void {
+		if ($event->getConfigKey() !== 'shortcuts_disabled') {
+			// Not allowed config key
+			return;
+		}
+
+		if ($event instanceof BeforePreferenceSetEvent) {
+			$event->setValid($event->getConfigValue() === 'yes');
+			return;
+		}
+
+		$event->setValid(true);
+	}
+
+	private function handleCoreValues(BeforePreferenceSetEvent|BeforePreferenceDeletedEvent $event): void {
+		if ($event->getConfigKey() !== 'apporder') {
+			// Not allowed config key
+			return;
+		}
+
+		if ($event instanceof BeforePreferenceDeletedEvent) {
+			$event->setValid(true);
+			return;
+		}
+
+		$value = json_decode($event->getConfigValue(), true, flags:JSON_THROW_ON_ERROR);
+		if (!is_array(($value))) {
+			// Must be an array
+			return;
+		}
+
+		foreach ($value as $id => $info) {
+			// required format: [ navigation_id: string => [ order: int, app?: string ] ]
+			if (!is_string($id) || !is_array($info) || empty($info) || !isset($info['order']) || !is_numeric($info['order']) || (isset($info['app']) && !$this->appManager->isEnabledForUser($info['app']))) {
+				// Invalid config value, refuse the change
+				return;
+			}
+		}
+		$event->setValid(true);
+	}
+}

wedding-pics/apps/theming/lib/Listener/BeforeTemplateRenderedListener.php

@@ -0,0 +1,122 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2020 Morris Jobke <hey@morrisjobke.de>
+ *
+ * @author Morris Jobke <hey@morrisjobke.de>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Listener;
+
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\Service\BackgroundService;
+use OCA\Theming\Service\JSDataService;
+use OCA\Theming\Service\ThemeInjectionService;
+use OCP\AppFramework\Http\Events\BeforeTemplateRenderedEvent;
+use OCP\AppFramework\Http\TemplateResponse;
+use OCP\AppFramework\Services\IInitialState;
+use OCP\EventDispatcher\Event;
+use OCP\EventDispatcher\IEventListener;
+use OCP\IConfig;
+use OCP\IUserSession;
+use Psr\Container\ContainerInterface;
+
+class BeforeTemplateRenderedListener implements IEventListener {
+
+	private IInitialState $initialState;
+	private ContainerInterface $container;
+	private ThemeInjectionService $themeInjectionService;
+	private IUserSession $userSession;
+	private IConfig $config;
+
+	public function __construct(
+		IInitialState $initialState,
+		ContainerInterface $container,
+		ThemeInjectionService $themeInjectionService,
+		IUserSession $userSession,
+		IConfig $config
+	) {
+		$this->initialState = $initialState;
+		$this->container = $container;
+		$this->themeInjectionService = $themeInjectionService;
+		$this->userSession = $userSession;
+		$this->config = $config;
+	}
+
+	public function handle(Event $event): void {
+		$this->initialState->provideLazyInitialState(
+			'data',
+			fn () => $this->container->get(JSDataService::class),
+		);
+
+		/** @var BeforeTemplateRenderedEvent $event */
+		if ($event->getResponse()->getRenderAs() === TemplateResponse::RENDER_AS_USER) {
+			$this->initialState->provideLazyInitialState('shortcutsDisabled', function () {
+				if ($this->userSession->getUser()) {
+					$uid = $this->userSession->getUser()->getUID();
+					return $this->config->getUserValue($uid, Application::APP_ID, 'shortcuts_disabled', 'no') === 'yes';
+				}
+				return false;
+			});
+		}
+
+		$this->themeInjectionService->injectHeaders();
+
+		$user = $this->userSession->getUser();
+
+		if (!empty($user)) {
+			$userId = $user->getUID();
+
+			/** User background */
+			$this->initialState->provideInitialState(
+				'backgroundImage',
+				$this->config->getUserValue($userId, Application::APP_ID, 'background_image', BackgroundService::BACKGROUND_DEFAULT),
+			);
+
+			/** User color */
+			$this->initialState->provideInitialState(
+				'backgroundColor',
+				$this->config->getUserValue($userId, Application::APP_ID, 'background_color', BackgroundService::DEFAULT_COLOR),
+			);
+
+			/**
+			 * Admin background. `backgroundColor` if disabled,
+			 * mime type if defined and empty by default
+			 */
+			$this->initialState->provideInitialState(
+				'themingDefaultBackground',
+				$this->config->getAppValue('theming', 'backgroundMime', ''),
+			);
+			$this->initialState->provideInitialState(
+				'defaultShippedBackground',
+				BackgroundService::DEFAULT_BACKGROUND_IMAGE,
+			);
+
+			/** List of all shipped backgrounds */
+			$this->initialState->provideInitialState(
+				'shippedBackgrounds',
+				BackgroundService::SHIPPED_BACKGROUNDS,
+			);
+		}
+
+		// Making sure to inject just after core
+		\OCP\Util::addScript('theming', 'theming', 'core');
+	}
+}

wedding-pics/apps/theming/lib/Migration/InitBackgroundImagesMigration.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2022 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCA\Theming\Migration;
+
+use OCA\Theming\Jobs\MigrateBackgroundImages;
+use OCP\BackgroundJob\IJobList;
+use OCP\Migration\IOutput;
+
+class InitBackgroundImagesMigration implements \OCP\Migration\IRepairStep {
+
+	private IJobList $jobList;
+
+	public function __construct(IJobList $jobList) {
+		$this->jobList = $jobList;
+	}
+
+	public function getName() {
+		return 'Initialize migration of background images from dashboard to theming app';
+	}
+
+	public function run(IOutput $output) {
+		$this->jobList->add(MigrateBackgroundImages::class, ['stage' => MigrateBackgroundImages::STAGE_PREPARE]);
+	}
+}

wedding-pics/apps/theming/lib/ResponseDefinitions.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2023 Kate Döen <kate.doeen@nextcloud.com>
+ *
+ * @author Kate Döen <kate.doeen@nextcloud.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCA\Theming;
+
+/**
+ * @psalm-type ThemingBackground = array{
+ *     backgroundImage: ?string,
+ *     backgroundColor: string,
+ *     version: int,
+ * }
+ */
+class ResponseDefinitions {
+}

wedding-pics/apps/theming/lib/Service/BackgroundService.php

@@ -0,0 +1,279 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2020 Julius Härtl <jus@bitgrid.net>
+ *
+ * @author Jan C. Borchardt <hey@jancborchardt.net>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Christopher Ng <chrng8@gmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Service;
+
+use InvalidArgumentException;
+use OC\User\NoUserException;
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\ThemingDefaults;
+use OCP\Files\File;
+use OCP\Files\IAppData;
+use OCP\Files\IRootFolder;
+use OCP\Files\NotFoundException;
+use OCP\Files\NotPermittedException;
+use OCP\Files\SimpleFS\ISimpleFile;
+use OCP\Files\SimpleFS\ISimpleFolder;
+use OCP\IConfig;
+use OCP\Lock\LockedException;
+use OCP\PreConditionNotMetException;
+
+class BackgroundService {
+	// true when the background is bright and need dark icons
+	public const THEMING_MODE_DARK = 'dark';
+	public const DEFAULT_COLOR = '#0082c9';
+	public const DEFAULT_ACCESSIBLE_COLOR = '#00679e';
+
+	public const BACKGROUND_SHIPPED = 'shipped';
+	public const BACKGROUND_CUSTOM = 'custom';
+	public const BACKGROUND_DEFAULT = 'default';
+	public const BACKGROUND_DISABLED = 'disabled';
+
+	public const DEFAULT_BACKGROUND_IMAGE = 'kamil-porembinski-clouds.jpg';
+	public const SHIPPED_BACKGROUNDS = [
+		'hannah-maclean-soft-floral.jpg' => [
+			'attribution' => 'Soft floral (Hannah MacLean, CC0)',
+			'description' => 'Abstract background picture in yellow and white color whith a flower on it',
+			'attribution_url' => 'https://stocksnap.io/photo/soft-floral-XOYWCCW5PA',
+			'theming' => self::THEMING_MODE_DARK,
+			'primary_color' => '#D8A06C',
+		],
+		'ted-moravec-morning-fog.jpg' => [
+			'attribution' => 'Morning fog (Ted Moravec, Public Domain)',
+			'description' => 'Background picture of a forest shrouded in fog',
+			'attribution_url' => 'https://flickr.com/photos/tmoravec/52392410261',
+			'theming' => self::THEMING_MODE_DARK,
+			'primary_color' => '#38A084',
+		],
+		'stefanus-martanto-setyo-husodo-underwater-ocean.jpg' => [
+			'attribution' => 'Underwater ocean (Stefanus Martanto Setyo Husodo, CC0)',
+			'description' => 'Background picture of an underwater ocean',
+			'attribution_url' => 'https://stocksnap.io/photo/underwater-ocean-TJA9LBH4WS',
+			'primary_color' => '#04577e',
+		],
+		'zoltan-voros-rhythm-and-blues.jpg' => [
+			'attribution' => 'Rhythm and blues (Zoltán Vörös, CC BY)',
+			'description' => 'Abstract background picture of sand dunes during night',
+			'attribution_url' => 'https://flickr.com/photos/v923z/51634409289/',
+			'primary_color' => '#1c243c',
+		],
+		'anatoly-mikhaltsov-butterfly-wing-scale.jpg' => [
+			'attribution' => 'Butterfly wing scale (Anatoly Mikhaltsov, CC BY-SA)',
+			'description' => 'Background picture of a red-ish butterfly wing under microscope',
+			'attribution_url' => 'https://commons.wikimedia.org/wiki/File:%D0%A7%D0%B5%D1%88%D1%83%D0%B9%D0%BA%D0%B8_%D0%BA%D1%80%D1%8B%D0%BB%D0%B0_%D0%B1%D0%B0%D0%B1%D0%BE%D1%87%D0%BA%D0%B8.jpg',
+			'primary_color' => '#a53c17',
+		],
+		'bernie-cetonia-aurata-take-off-composition.jpg' => [
+			'attribution' => 'Cetonia aurata take off composition (Bernie, Public Domain)',
+			'description' => 'Montage of a cetonia aurata bug that takes off with white background',
+			'attribution_url' => 'https://commons.wikimedia.org/wiki/File:Cetonia_aurata_take_off_composition_05172009.jpg',
+			'theming' => self::THEMING_MODE_DARK,
+			'primary_color' => '#869171',
+		],
+		'dejan-krsmanovic-ribbed-red-metal.jpg' => [
+			'attribution' => 'Ribbed red metal (Dejan Krsmanovic, CC BY)',
+			'description' => 'Abstract background picture of red ribbed metal with two horizontal white elements on top of it',
+			'attribution_url' => 'https://www.flickr.com/photos/dejankrsmanovic/42971456774/',
+			'primary_color' => '#9c4236',
+		],
+		'eduardo-neves-pedra-azul.jpg' => [
+			'attribution' => 'Pedra azul milky way (Eduardo Neves, CC BY-SA)',
+			'description' => 'Background picture of the milky way during night with a mountain in front of it',
+			'attribution_url' => 'https://commons.wikimedia.org/wiki/File:Pedra_Azul_Milky_Way.jpg',
+			'primary_color' => '#4f6071',
+		],
+		'european-space-agency-barents-bloom.jpg' => [
+			'attribution' => 'Barents bloom (European Space Agency, CC BY-SA)',
+			'description' => 'Abstract background picture of blooming barents in blue and green colors',
+			'attribution_url' => 'https://www.esa.int/ESA_Multimedia/Images/2016/08/Barents_bloom',
+			'primary_color' => '#396475',
+		],
+		'hannes-fritz-flippity-floppity.jpg' => [
+			'attribution' => 'Flippity floppity (Hannes Fritz, CC BY-SA)',
+			'description' => 'Abstract background picture of many pairs of flip flops hanging on a wall in multiple colors',
+			'attribution_url' => 'http://hannes.photos/flippity-floppity',
+			'primary_color' => '#98415a',
+		],
+		'hannes-fritz-roulette.jpg' => [
+			'attribution' => 'Roulette (Hannes Fritz, CC BY-SA)',
+			'description' => 'Background picture of a rotating giant wheel during night',
+			'attribution_url' => 'http://hannes.photos/roulette',
+			'primary_color' => '#845334',
+		],
+		'hannes-fritz-sea-spray.jpg' => [
+			'attribution' => 'Sea spray (Hannes Fritz, CC BY-SA)',
+			'description' => 'Background picture of a stone coast with fog and sea behind it',
+			'attribution_url' => 'http://hannes.photos/sea-spray',
+			'primary_color' => '#4f6071',
+		],
+		'kamil-porembinski-clouds.jpg' => [
+			'attribution' => 'Clouds (Kamil Porembiński, CC BY-SA)',
+			'description' => 'Background picture of white clouds on in front of a blue sky',
+			'attribution_url' => 'https://www.flickr.com/photos/paszczak000/8715851521/',
+			'primary_color' => self::DEFAULT_COLOR,
+		],
+		'bernard-spragg-new-zealand-fern.jpg' => [
+			'attribution' => 'New zealand fern (Bernard Spragg, CC0)',
+			'description' => 'Abstract background picture of fern leafes',
+			'attribution_url' => 'https://commons.wikimedia.org/wiki/File:NZ_Fern.(Blechnum_chambersii)_(11263534936).jpg',
+			'primary_color' => '#316b26',
+		],
+		'rawpixel-pink-tapioca-bubbles.jpg' => [
+			'attribution' => 'Pink tapioca bubbles (Rawpixel, CC BY)',
+			'description' => 'Abstract background picture of pink tapioca bubbles',
+			'attribution_url' => 'https://www.flickr.com/photos/byrawpixel/27665140298/in/photostream/',
+			'theming' => self::THEMING_MODE_DARK,
+			'primary_color' => '#b17ab4',
+		],
+		'nasa-waxing-crescent-moon.jpg' => [
+			'attribution' => 'Waxing crescent moon (NASA, Public Domain)',
+			'description' => 'Background picture of glowing earth in foreground and moon in the background',
+			'attribution_url' => 'https://www.nasa.gov/image-feature/a-waxing-crescent-moon',
+			'primary_color' => '#005ac1',
+		],
+		'tommy-chau-already.jpg' => [
+			'attribution' => 'Cityscape (Tommy Chau, CC BY)',
+			'description' => 'Background picture of a skyscraper city during night',
+			'attribution_url' => 'https://www.flickr.com/photos/90975693@N05/16910999368',
+			'primary_color' => '#6a2af4',
+		],
+		'tommy-chau-lion-rock-hill.jpg' => [
+			'attribution' => 'Lion rock hill (Tommy Chau, CC BY)',
+			'description' => 'Background picture of mountains during sunset or sunrise',
+			'attribution_url' => 'https://www.flickr.com/photos/90975693@N05/17136440246',
+			'theming' => self::THEMING_MODE_DARK,
+			'primary_color' => '#c074a9',
+		],
+		'lali-masriera-yellow-bricks.jpg' => [
+			'attribution' => 'Yellow bricks (Lali Masriera, CC BY)',
+			'description' => 'Background picture of yellow bricks with some yellow tubes',
+			'attribution_url' => 'https://www.flickr.com/photos/visualpanic/3982464447',
+			'theming' => self::THEMING_MODE_DARK,
+			'primary_color' => '#bc8210',
+		],
+	];
+
+	private IRootFolder $rootFolder;
+	private IAppData $appData;
+	private IConfig $config;
+	private string $userId;
+	private ThemingDefaults $themingDefaults;
+
+	public function __construct(IRootFolder $rootFolder,
+		IAppData $appData,
+		IConfig $config,
+		?string $userId,
+		ThemingDefaults $themingDefaults) {
+		if ($userId === null) {
+			return;
+		}
+
+		$this->rootFolder = $rootFolder;
+		$this->config = $config;
+		$this->userId = $userId;
+		$this->appData = $appData;
+		$this->themingDefaults = $themingDefaults;
+	}
+
+	public function setDefaultBackground(): void {
+		$this->config->deleteUserValue($this->userId, Application::APP_ID, 'background_image');
+		$this->config->deleteUserValue($this->userId, Application::APP_ID, 'background_color');
+	}
+
+	/**
+	 * @param $path
+	 * @throws NotFoundException
+	 * @throws NotPermittedException
+	 * @throws LockedException
+	 * @throws PreConditionNotMetException
+	 * @throws NoUserException
+	 */
+	public function setFileBackground($path): void {
+		$this->config->setUserValue($this->userId, Application::APP_ID, 'background_image', self::BACKGROUND_CUSTOM);
+		$userFolder = $this->rootFolder->getUserFolder($this->userId);
+
+		/** @var File $file */
+		$file = $userFolder->get($path);
+		$image = new \OCP\Image();
+
+		if ($image->loadFromFileHandle($file->fopen('r')) === false) {
+			throw new InvalidArgumentException('Invalid image file');
+		}
+
+		$this->getAppDataFolder()->newFile('background.jpg', $file->fopen('r'));
+	}
+
+	public function setShippedBackground($fileName): void {
+		if (!array_key_exists($fileName, self::SHIPPED_BACKGROUNDS)) {
+			throw new InvalidArgumentException('The given file name is invalid');
+		}
+		$this->config->setUserValue($this->userId, Application::APP_ID, 'background_image', $fileName);
+		$this->setColorBackground(self::SHIPPED_BACKGROUNDS[$fileName]['primary_color']);
+	}
+
+	public function setColorBackground(string $color): void {
+		if (!preg_match('/^#([0-9a-f]{3}|[0-9a-f]{6})$/i', $color)) {
+			throw new InvalidArgumentException('The given color is invalid');
+		}
+		$this->config->setUserValue($this->userId, Application::APP_ID, 'background_color', $color);
+	}
+
+	public function deleteBackgroundImage(): void {
+		$this->config->setUserValue($this->userId, Application::APP_ID, 'background_image', self::BACKGROUND_DISABLED);
+	}
+
+	public function getBackground(): ?ISimpleFile {
+		$background = $this->config->getUserValue($this->userId, Application::APP_ID, 'background_image', self::BACKGROUND_DEFAULT);
+		if ($background === self::BACKGROUND_CUSTOM) {
+			try {
+				return $this->getAppDataFolder()->getFile('background.jpg');
+			} catch (NotFoundException | NotPermittedException $e) {
+				return null;
+			}
+		}
+		return null;
+	}
+
+	/**
+	 * Storing the data in appdata/theming/users/USERID
+	 *
+	 * @return ISimpleFolder
+	 * @throws NotPermittedException
+	 */
+	private function getAppDataFolder(): ISimpleFolder {
+		try {
+			$rootFolder = $this->appData->getFolder('users');
+		} catch (NotFoundException $e) {
+			$rootFolder = $this->appData->newFolder('users');
+		}
+		try {
+			return $rootFolder->getFolder($this->userId);
+		} catch (NotFoundException $e) {
+			return $rootFolder->newFolder($this->userId);
+		}
+	}
+}

wedding-pics/apps/theming/lib/Service/JSDataService.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2020, Roeland Jago Douma <roeland@famdouma.nl>
+ *
+ * @author Julien Veyssier <eneiluj@posteo.net>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Service;
+
+use OCA\Theming\ThemingDefaults;
+use OCA\Theming\Util;
+use OCP\IConfig;
+
+class JSDataService implements \JsonSerializable {
+	private ThemingDefaults $themingDefaults;
+	private Util $util;
+	private IConfig $appConfig;
+	private ThemesService $themesService;
+
+	public function __construct(
+		ThemingDefaults $themingDefaults,
+		Util $util,
+		IConfig $appConfig,
+		ThemesService $themesService
+	) {
+		$this->themingDefaults = $themingDefaults;
+		$this->util = $util;
+		$this->appConfig = $appConfig;
+		$this->themesService = $themesService;
+	}
+
+	public function jsonSerialize(): array {
+		return [
+			'name' => $this->themingDefaults->getName(),
+			'url' => $this->themingDefaults->getBaseUrl(),
+			'slogan' => $this->themingDefaults->getSlogan(),
+			'color' => $this->themingDefaults->getColorPrimary(),
+			'defaultColor' => $this->themingDefaults->getDefaultColorPrimary(),
+			'imprintUrl' => $this->themingDefaults->getImprintUrl(),
+			'privacyUrl' => $this->themingDefaults->getPrivacyUrl(),
+			'inverted' => $this->util->invertTextColor($this->themingDefaults->getColorPrimary()),
+			'cacheBuster' => $this->util->getCacheBuster(),
+			'enabledThemes' => $this->themesService->getEnabledThemes(),
+		];
+	}
+}

wedding-pics/apps/theming/lib/Service/ThemeInjectionService.php

@@ -0,0 +1,104 @@
+<?php
+/**
+ * @copyright Copyright (c) 2022 John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Service;
+
+use OCA\Theming\Themes\DefaultTheme;
+use OCA\Theming\Util;
+use OCP\IConfig;
+use OCP\IURLGenerator;
+use OCP\IUserSession;
+
+class ThemeInjectionService {
+
+	private IURLGenerator $urlGenerator;
+	private ThemesService $themesService;
+	private DefaultTheme $defaultTheme;
+	private Util $util;
+	private IConfig $config;
+	private ?string $userId;
+
+	public function __construct(IURLGenerator $urlGenerator,
+		ThemesService $themesService,
+		DefaultTheme $defaultTheme,
+		Util $util,
+		IConfig $config,
+		IUserSession $userSession) {
+		$this->urlGenerator = $urlGenerator;
+		$this->themesService = $themesService;
+		$this->defaultTheme = $defaultTheme;
+		$this->util = $util;
+		$this->config = $config;
+		if ($userSession->getUser() !== null) {
+			$this->userId = $userSession->getUser()->getUID();
+		} else {
+			$this->userId = null;
+		}
+	}
+
+	public function injectHeaders() {
+		$themes = $this->themesService->getThemes();
+		$defaultTheme = $themes[$this->defaultTheme->getId()];
+		$mediaThemes = array_filter($themes, function ($theme) {
+			// Check if the theme provides a media query
+			return (bool)$theme->getMediaQuery();
+		});
+
+		// Default theme fallback
+		$this->addThemeHeader($defaultTheme->getId());
+
+		// Themes applied by media queries
+		foreach($mediaThemes as $theme) {
+			$this->addThemeHeader($theme->getId(), true, $theme->getMediaQuery());
+		}
+
+		// Themes
+		foreach($this->themesService->getThemes() as $theme) {
+			// Ignore default theme as already processed first
+			if ($theme->getId() === $this->defaultTheme->getId()) {
+				continue;
+			}
+			$this->addThemeHeader($theme->getId(), false);
+		}
+	}
+
+	/**
+	 * Inject theme header into rendered page
+	 *
+	 * @param string $themeId the theme ID
+	 * @param bool $plain request the :root syntax
+	 * @param string $media media query to use in the <link> element
+	 */
+	private function addThemeHeader(string $themeId, bool $plain = true, string $media = null) {
+		$linkToCSS = $this->urlGenerator->linkToRoute('theming.Theming.getThemeStylesheet', [
+			'themeId' => $themeId,
+			'plain' => $plain,
+			'v' => $this->util->getCacheBuster(),
+		]);
+		\OCP\Util::addHeader('link', [
+			'rel' => 'stylesheet',
+			'media' => $media,
+			'href' => $linkToCSS,
+			'class' => 'theme'
+		]);
+	}
+}

wedding-pics/apps/theming/lib/Service/ThemesService.php

@@ -0,0 +1,181 @@
+<?php
+/**
+ * @copyright Copyright (c) 2022 John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Service;
+
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\ITheme;
+use OCA\Theming\Themes\DarkHighContrastTheme;
+use OCA\Theming\Themes\DarkTheme;
+use OCA\Theming\Themes\DefaultTheme;
+use OCA\Theming\Themes\DyslexiaFont;
+use OCA\Theming\Themes\HighContrastTheme;
+use OCA\Theming\Themes\LightTheme;
+use OCP\IConfig;
+use OCP\IUser;
+use OCP\IUserSession;
+
+class ThemesService {
+	private IUserSession $userSession;
+	private IConfig $config;
+
+	/** @var ITheme[] */
+	private array $themesProviders;
+
+	public function __construct(IUserSession $userSession,
+		IConfig $config,
+		DefaultTheme $defaultTheme,
+		LightTheme $lightTheme,
+		DarkTheme $darkTheme,
+		HighContrastTheme $highContrastTheme,
+		DarkHighContrastTheme $darkHighContrastTheme,
+		DyslexiaFont $dyslexiaFont) {
+		$this->userSession = $userSession;
+		$this->config = $config;
+
+		// Register themes
+		$this->themesProviders = [
+			$defaultTheme->getId() => $defaultTheme,
+			$lightTheme->getId() => $lightTheme,
+			$darkTheme->getId() => $darkTheme,
+			$highContrastTheme->getId() => $highContrastTheme,
+			$darkHighContrastTheme->getId() => $darkHighContrastTheme,
+			$dyslexiaFont->getId() => $dyslexiaFont,
+		];
+	}
+
+	/**
+	 * Get the list of all registered themes
+	 *
+	 * @return ITheme[]
+	 */
+	public function getThemes(): array {
+		return $this->themesProviders;
+	}
+
+	/**
+	 * Enable a theme for the logged-in user
+	 *
+	 * @param ITheme $theme the theme to enable
+	 * @return string[] the enabled themes
+	 */
+	public function enableTheme(ITheme $theme): array {
+		$themesIds = $this->getEnabledThemes();
+
+		// If already enabled, ignore
+		if (in_array($theme->getId(), $themesIds)) {
+			return $themesIds;
+		}
+
+		/** @var ITheme[] */
+		$themes = array_filter(array_map(function ($themeId) {
+			return $this->getThemes()[$themeId];
+		}, $themesIds));
+
+		// Filtering all themes with the same type
+		$filteredThemes = array_filter($themes, function (ITheme $t) use ($theme) {
+			return $theme->getType() === $t->getType();
+		});
+
+		// Retrieve IDs only
+		/** @var string[] */
+		$filteredThemesIds = array_map(function (ITheme $t) {
+			return $t->getId();
+		}, array_values($filteredThemes));
+
+		$enabledThemes = array_merge(array_diff($themesIds, $filteredThemesIds), [$theme->getId()]);
+		$this->setEnabledThemes($enabledThemes);
+
+		return $enabledThemes;
+	}
+
+	/**
+	 * Disable a theme for the logged-in user
+	 *
+	 * @param ITheme $theme the theme to disable
+	 * @return string[] the enabled themes
+	 */
+	public function disableTheme(ITheme $theme): array {
+		$themesIds = $this->getEnabledThemes();
+
+		// If enabled, removing it
+		if (in_array($theme->getId(), $themesIds)) {
+			$enabledThemes = array_diff($themesIds, [$theme->getId()]);
+			$this->setEnabledThemes($enabledThemes);
+			return $enabledThemes;
+		}
+		
+		return $themesIds;
+	}
+
+	/**
+	 * Check whether a theme is enabled or not
+	 * for the logged-in user
+	 *
+	 * @return bool
+	 */
+	public function isEnabled(ITheme $theme): bool {
+		$user = $this->userSession->getUser();
+		if ($user instanceof IUser) {
+			// Using keys as it's faster
+			$themes = $this->getEnabledThemes();
+			return in_array($theme->getId(), $themes);
+		}
+		return false;
+	}
+
+	/**
+	 * Get the list of all enabled themes IDs
+	 * for the logged-in user
+	 *
+	 * @return string[]
+	 */
+	public function getEnabledThemes(): array {
+		$user = $this->userSession->getUser();
+		if ($user === null) {
+			return [];
+		}
+
+		$enforcedTheme = $this->config->getSystemValueString('enforce_theme', '');
+		$enabledThemes = json_decode($this->config->getUserValue($user->getUID(), Application::APP_ID, 'enabled-themes', '[]'));
+		if ($enforcedTheme !== '') {
+			return array_merge([$enforcedTheme], $enabledThemes);
+		}
+
+		try {
+			return $enabledThemes;
+		} catch (\Exception $e) {
+			return [];
+		}
+	}
+
+	/**
+	 * Set the list of enabled themes
+	 * for the logged-in user
+	 *
+	 * @param string[] $themes the list of enabled themes IDs
+	 */
+	private function setEnabledThemes(array $themes): void {
+		$user = $this->userSession->getUser();
+		$this->config->setUserValue($user->getUID(), Application::APP_ID, 'enabled-themes', json_encode(array_values(array_unique($themes))));
+	}
+}

wedding-pics/apps/theming/lib/Settings/Admin.php

@@ -0,0 +1,125 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ * @author Bjoern Schiessle <bjoern@schiessle.org>
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Lukas Reschke <lukas@statuscode.ch>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Settings;
+
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\Controller\ThemingController;
+use OCA\Theming\ImageManager;
+use OCA\Theming\ThemingDefaults;
+use OCP\AppFramework\Http\TemplateResponse;
+use OCP\AppFramework\Services\IInitialState;
+use OCP\IConfig;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\Settings\IDelegatedSettings;
+use OCP\Util;
+
+class Admin implements IDelegatedSettings {
+
+	public function __construct(
+		private string $appName,
+		private IConfig $config,
+		private IL10N $l,
+		private ThemingDefaults $themingDefaults,
+		private IInitialState $initialState,
+		private IURLGenerator $urlGenerator,
+		private ImageManager $imageManager,
+	) {
+	}
+
+	/**
+	 * @return TemplateResponse
+	 */
+	public function getForm(): TemplateResponse {
+		$themable = true;
+		$errorMessage = '';
+		$theme = $this->config->getSystemValue('theme', '');
+		if ($theme !== '') {
+			$themable = false;
+			$errorMessage = $this->l->t('You are already using a custom theme. Theming app settings might be overwritten by that.');
+		}
+
+		$allowedMimeTypes = array_reduce(ThemingController::VALID_UPLOAD_KEYS, function ($carry, $key) {
+			$carry[$key] = $this->imageManager->getSupportedUploadImageFormats($key);
+			return $carry;
+		}, []);
+
+		$this->initialState->provideInitialState('adminThemingParameters', [
+			'isThemable' => $themable,
+			'notThemableErrorMessage' => $errorMessage,
+			'name' => $this->themingDefaults->getEntity(),
+			'url' => $this->themingDefaults->getBaseUrl(),
+			'slogan' => $this->themingDefaults->getSlogan(),
+			'color' => $this->themingDefaults->getDefaultColorPrimary(),
+			'logoMime' => $this->config->getAppValue(Application::APP_ID, 'logoMime', ''),
+			'allowedMimeTypes' => $allowedMimeTypes,
+			'backgroundMime' => $this->config->getAppValue(Application::APP_ID, 'backgroundMime', ''),
+			'logoheaderMime' => $this->config->getAppValue(Application::APP_ID, 'logoheaderMime', ''),
+			'faviconMime' => $this->config->getAppValue(Application::APP_ID, 'faviconMime', ''),
+			'legalNoticeUrl' => $this->themingDefaults->getImprintUrl(),
+			'privacyPolicyUrl' => $this->themingDefaults->getPrivacyUrl(),
+			'docUrl' => $this->urlGenerator->linkToDocs('admin-theming'),
+			'docUrlIcons' => $this->urlGenerator->linkToDocs('admin-theming-icons'),
+			'canThemeIcons' => $this->imageManager->shouldReplaceIcons(),
+			'userThemingDisabled' => $this->themingDefaults->isUserThemingDisabled(),
+			'defaultApps' => array_filter(explode(',', $this->config->getSystemValueString('defaultapp', ''))),
+		]);
+
+		Util::addScript($this->appName, 'admin-theming');
+
+		return new TemplateResponse($this->appName, 'settings-admin');
+	}
+
+	/**
+	 * @return string the section ID, e.g. 'sharing'
+	 */
+	public function getSection(): string {
+		return $this->appName;
+	}
+
+	/**
+	 * @return int whether the form should be rather on the top or bottom of
+	 * the admin section. The forms are arranged in ascending order of the
+	 * priority values. It is required to return a value between 0 and 100.
+	 *
+	 * E.g.: 70
+	 */
+	public function getPriority(): int {
+		return 5;
+	}
+
+	public function getName(): ?string {
+		return null; // Only one setting in this section
+	}
+
+	public function getAuthorizedAppConfig(): array {
+		return [
+			$this->appName => '/.*/',
+		];
+	}
+}

wedding-pics/apps/theming/lib/Settings/AdminSection.php

@@ -0,0 +1,77 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Settings;
+
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\Settings\IIconSection;
+
+class AdminSection implements IIconSection {
+	private string $appName;
+	private IL10N $l;
+	private IURLGenerator $url;
+
+	public function __construct(string $appName, IURLGenerator $url, IL10N $l) {
+		$this->appName = $appName;
+		$this->url = $url;
+		$this->l = $l;
+	}
+
+	/**
+	 * returns the ID of the section. It is supposed to be a lower case string,
+	 * e.g. 'ldap'
+	 *
+	 * @returns string
+	 */
+	public function getID() {
+		return $this->appName;
+	}
+
+	/**
+	 * returns the translated name as it should be displayed, e.g. 'LDAP / AD
+	 * integration'. Use the L10N service to translate it.
+	 *
+	 * @return string
+	 */
+	public function getName() {
+		return $this->l->t('Theming');
+	}
+
+	/**
+	 * @return int whether the form should be rather on the top or bottom of
+	 * the settings navigation. The sections are arranged in ascending order of
+	 * the priority values. It is required to return a value between 0 and 99.
+	 *
+	 * E.g.: 70
+	 */
+	public function getPriority() {
+		return 30;
+	}
+
+	/**
+	 * {@inheritdoc}
+	 */
+	public function getIcon() {
+		return $this->url->imagePath($this->appName, 'app-dark.svg');
+	}
+}

wedding-pics/apps/theming/lib/Settings/Personal.php

@@ -0,0 +1,106 @@
+<?php
+/**
+ * @copyright Copyright (c) 2018 John Molakvoæ <skjnldsv@protonmail.com>
+ * @copyright Copyright (c) 2019 Janis Köhr <janiskoehr@icloud.com>
+ *
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Settings;
+
+use OCA\Theming\ITheme;
+use OCA\Theming\Service\ThemesService;
+use OCA\Theming\ThemingDefaults;
+use OCP\App\IAppManager;
+use OCP\AppFramework\Http\TemplateResponse;
+use OCP\AppFramework\Services\IInitialState;
+use OCP\IConfig;
+use OCP\Settings\ISettings;
+use OCP\Util;
+
+class Personal implements ISettings {
+
+	public function __construct(
+		protected string $appName,
+		private string $userId,
+		private IConfig $config,
+		private ThemesService $themesService,
+		private IInitialState $initialStateService,
+		private ThemingDefaults $themingDefaults,
+		private IAppManager $appManager,
+	) {
+	}
+
+	public function getForm(): TemplateResponse {
+		$enforcedTheme = $this->config->getSystemValueString('enforce_theme', '');
+
+		$themes = array_map(function ($theme) {
+			return [
+				'id' => $theme->getId(),
+				'type' => $theme->getType(),
+				'title' => $theme->getTitle(),
+				'enableLabel' => $theme->getEnableLabel(),
+				'description' => $theme->getDescription(),
+				'enabled' => $this->themesService->isEnabled($theme),
+			];
+		}, $this->themesService->getThemes());
+
+		if ($enforcedTheme !== '') {
+			$themes = array_filter($themes, function ($theme) use ($enforcedTheme) {
+				return $theme['type'] !== ITheme::TYPE_THEME || $theme['id'] === $enforcedTheme;
+			});
+		}
+
+		// Get the default app enforced by admin
+		$forcedDefaultApp = $this->appManager->getDefaultAppForUser(null, false);
+
+		$this->initialStateService->provideInitialState('themes', array_values($themes));
+		$this->initialStateService->provideInitialState('enforceTheme', $enforcedTheme);
+		$this->initialStateService->provideInitialState('isUserThemingDisabled', $this->themingDefaults->isUserThemingDisabled());
+		$this->initialStateService->provideInitialState('navigationBar', [
+			'userAppOrder' => json_decode($this->config->getUserValue($this->userId, 'core', 'apporder', '[]'), true, flags:JSON_THROW_ON_ERROR),
+			'enforcedDefaultApp' => $forcedDefaultApp
+		]);
+
+		Util::addScript($this->appName, 'personal-theming');
+
+		return new TemplateResponse($this->appName, 'settings-personal');
+	}
+
+	/**
+	 * @return string the section ID, e.g. 'sharing'
+	 * @since 9.1
+	 */
+	public function getSection(): string {
+		return $this->appName;
+	}
+
+	/**
+	 * @return int whether the form should be rather on the top or bottom of
+	 * the admin section. The forms are arranged in ascending order of the
+	 * priority values. It is required to return a value between 0 and 100.
+	 *
+	 * E.g.: 70
+	 * @since 9.1
+	 */
+	public function getPriority(): int {
+		return 40;
+	}
+}

wedding-pics/apps/theming/lib/Settings/PersonalSection.php

@@ -0,0 +1,100 @@
+<?php
+/**
+ * @copyright Copyright (c) 2018 John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Settings;
+
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\Settings\IIconSection;
+
+class PersonalSection implements IIconSection {
+
+	/** @var string */
+	protected $appName;
+
+	/** @var IURLGenerator */
+	private $urlGenerator;
+
+	/** @var IL10N */
+	private $l;
+
+	/**
+	 * Personal Section constructor.
+	 *
+	 * @param string $appName
+	 * @param IURLGenerator $urlGenerator
+	 * @param IL10N $l
+	 */
+	public function __construct(string $appName,
+		IURLGenerator $urlGenerator,
+		IL10N $l) {
+		$this->appName = $appName;
+		$this->urlGenerator = $urlGenerator;
+		$this->l = $l;
+	}
+
+	/**
+	 * returns the relative path to an 16*16 icon describing the section.
+	 * e.g. '/core/img/places/files.svg'
+	 *
+	 * @returns string
+	 * @since 13.0.0
+	 */
+	public function getIcon() {
+		return $this->urlGenerator->imagePath($this->appName, 'accessibility-dark.svg');
+	}
+
+	/**
+	 * returns the ID of the section. It is supposed to be a lower case string,
+	 * e.g. 'ldap'
+	 *
+	 * @returns string
+	 * @since 9.1
+	 */
+	public function getID() {
+		return $this->appName;
+	}
+
+	/**
+	 * returns the translated name as it should be displayed, e.g. 'LDAP / AD
+	 * integration'. Use the L10N service to translate it.
+	 *
+	 * @return string
+	 * @since 9.1
+	 */
+	public function getName() {
+		return $this->l->t('Appearance and accessibility');
+	}
+
+	/**
+	 * @return int whether the form should be rather on the top or bottom of
+	 * the settings navigation. The sections are arranged in ascending order of
+	 * the priority values. It is required to return a value between 0 and 99.
+	 *
+	 * E.g.: 70
+	 * @since 9.1
+	 */
+	public function getPriority() {
+		return 15;
+	}
+}

wedding-pics/apps/theming/lib/SetupChecks/PhpImagickModule.php

@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2023 Côme Chilliet <come.chilliet@nextcloud.com>
+ *
+ * @author Côme Chilliet <come.chilliet@nextcloud.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\SetupChecks;
+
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\SetupCheck\ISetupCheck;
+use OCP\SetupCheck\SetupResult;
+
+class PhpImagickModule implements ISetupCheck {
+	public function __construct(
+		private IL10N $l10n,
+		private IURLGenerator $urlGenerator,
+	) {
+	}
+
+	public function getName(): string {
+		return $this->l10n->t('PHP Imagick module');
+	}
+
+	public function getCategory(): string {
+		return 'php';
+	}
+
+	public function run(): SetupResult {
+		if (!extension_loaded('imagick')) {
+			return SetupResult::info(
+				$this->l10n->t('The PHP module "imagick" is not enabled although the theming app is. For favicon generation to work correctly, you need to install and enable this module.'),
+				$this->urlGenerator->linkToDocs('admin-php-modules')
+			);
+		} elseif (count(\Imagick::queryFormats('SVG')) === 0) {
+			return SetupResult::info(
+				$this->l10n->t('The PHP module "imagick" in this instance has no SVG support. For better compatibility it is recommended to install it.'),
+				$this->urlGenerator->linkToDocs('admin-php-modules')
+			);
+		} else {
+			return SetupResult::success();
+		}
+	}
+}

wedding-pics/apps/theming/lib/Themes/CommonThemeTrait.php

@@ -0,0 +1,179 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Themes;
+
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\ImageManager;
+use OCA\Theming\Service\BackgroundService;
+use OCA\Theming\Util;
+
+trait CommonThemeTrait {
+	public Util $util;
+
+	/**
+	 * Generate primary-related variables
+	 * This is shared between multiple themes because colorMainBackground and colorMainText
+	 * will change in between.
+	 */
+	protected function generatePrimaryVariables(string $colorMainBackground, string $colorMainText, bool $highContrast = false): array {
+		$isBrightColor = $this->util->isBrightColor($colorMainBackground);
+		$colorPrimaryElement = $this->util->elementColor($this->primaryColor, $isBrightColor, $colorMainBackground, $highContrast);
+		$colorPrimaryLight = $this->util->mix($colorPrimaryElement, $colorMainBackground, -80);
+		$colorPrimaryElementLight = $this->util->mix($colorPrimaryElement, $colorMainBackground, -80);
+		$invertPrimaryTextColor = $this->util->invertTextColor($colorPrimaryElement);
+
+		// primary related colours
+		return [
+			// invert filter if primary is too bright
+			// to be used for legacy reasons only. Use inline
+			// svg with proper css variable instead or material
+			// design icons.
+			// ⚠️ Using 'no' as a value to make sure we specify an
+			// invalid one with no fallback. 'unset' could here fallback to some
+			// other theme with media queries
+			'--primary-invert-if-bright' => $this->util->invertTextColor($colorPrimaryElement) ? 'invert(100%)' : 'no',
+			'--primary-invert-if-dark' => $this->util->invertTextColor($colorPrimaryElement) ? 'no' : 'invert(100%)',
+
+			'--color-primary' => $this->primaryColor,
+			'--color-primary-default' => $this->defaultPrimaryColor,
+			'--color-primary-text' => $this->util->invertTextColor($this->primaryColor) ? '#000000' : '#ffffff',
+			'--color-primary-hover' => $this->util->mix($this->primaryColor, $colorMainBackground, 60),
+			'--color-primary-light' => $colorPrimaryLight,
+			'--color-primary-light-text' => $this->util->mix($this->primaryColor, $this->util->invertTextColor($colorPrimaryLight) ? '#000000' : '#ffffff', -20),
+			'--color-primary-light-hover' => $this->util->mix($colorPrimaryLight, $colorMainText, 90),
+
+			// used for buttons, inputs...
+			'--color-primary-element' => $colorPrimaryElement,
+			'--color-primary-element-hover' => $invertPrimaryTextColor ? $this->util->lighten($colorPrimaryElement, 4) : $this->util->darken($colorPrimaryElement, 4),
+			'--color-primary-element-text' => $invertPrimaryTextColor ? '#000000' : '#ffffff',
+			// mostly used for disabled states
+			'--color-primary-element-text-dark' => $invertPrimaryTextColor ? $this->util->lighten('#000000', 4) : $this->util->darken('#ffffff', 4),
+
+			// used for hover/focus states
+			'--color-primary-element-light' => $colorPrimaryElementLight,
+			'--color-primary-element-light-hover' => $this->util->mix($colorPrimaryElementLight, $colorMainText, 90),
+			'--color-primary-element-light-text' => $this->util->mix($colorPrimaryElement, $this->util->invertTextColor($colorPrimaryElementLight) ? '#000000' : '#ffffff', -20),
+
+			// to use like this: background-image: var(--gradient-primary-background);
+			'--gradient-primary-background' => 'linear-gradient(40deg, var(--color-primary) 0%, var(--color-primary-hover) 100%)',
+		];
+	}
+
+	/**
+	 * Generate admin theming background-related variables
+	 */
+	protected function generateGlobalBackgroundVariables(): array {
+		$backgroundDeleted = $this->config->getAppValue(Application::APP_ID, 'backgroundMime', '') === 'backgroundColor';
+		$hasCustomLogoHeader = $this->util->isLogoThemed();
+		$isPrimaryBright = $this->util->invertTextColor($this->primaryColor);
+
+		$variables = [];
+
+		// Default last fallback values
+		$variables['--image-background-default'] = "url('" . $this->themingDefaults->getBackground() . "')";
+		$variables['--color-background-plain'] = $this->primaryColor;
+
+		// Register image variables only if custom-defined
+		foreach (ImageManager::SUPPORTED_IMAGE_KEYS as $image) {
+			if ($this->imageManager->hasImage($image)) {
+				$imageUrl = $this->imageManager->getImageUrl($image);
+				// --image-background is overridden by user theming if logged in
+				$variables["--image-$image"] = "url('" . $imageUrl . "')";
+			}
+		}
+
+		// If primary as background has been request or if we have a custom primary colour
+		// let's not define the background image
+		if ($backgroundDeleted) {
+			$variables['--color-background-plain'] = $this->primaryColor;
+			$variables['--image-background-plain'] = 'yes';
+			$variables['--image-background'] = 'no';
+			// If no background image is set, we need to check against the shown primary colour
+			$variables['--background-image-invert-if-bright'] = $isPrimaryBright ? 'invert(100%)' : 'no';
+		}
+
+		if ($hasCustomLogoHeader) {
+			$variables['--image-logoheader-custom'] = 'true';
+		}
+
+		return $variables;
+	}
+
+	/**
+	 * Generate user theming background-related variables
+	 */
+	protected function generateUserBackgroundVariables(): array {
+		$user = $this->userSession->getUser();
+		if ($user !== null
+			&& !$this->themingDefaults->isUserThemingDisabled()
+			&& $this->appManager->isEnabledForUser(Application::APP_ID)) {
+			$adminBackgroundDeleted = $this->config->getAppValue(Application::APP_ID, 'backgroundMime', '') === 'backgroundColor';
+			$backgroundImage = $this->config->getUserValue($user->getUID(), Application::APP_ID, 'background_image', BackgroundService::BACKGROUND_DEFAULT);
+			$currentVersion = (int)$this->config->getUserValue($user->getUID(), Application::APP_ID, 'userCacheBuster', '0');
+			$isPrimaryBright = $this->util->invertTextColor($this->primaryColor);
+
+			// The user removed the background
+			if ($backgroundImage === BackgroundService::BACKGROUND_DISABLED) {
+				return [
+					// Might be defined already by admin theming, needs to be overridden
+					'--image-background' => 'none',
+					'--color-background-plain' => $this->primaryColor,
+					// If no background image is set, we need to check against the shown primary colour
+					'--background-image-invert-if-bright' => $isPrimaryBright ? 'invert(100%)' : 'no',
+				];
+			}
+
+			// The user uploaded a custom background
+			if ($backgroundImage === BackgroundService::BACKGROUND_CUSTOM) {
+				$cacheBuster = substr(sha1($user->getUID() . '_' . $currentVersion), 0, 8);
+				return [
+					'--image-background' => "url('" . $this->urlGenerator->linkToRouteAbsolute('theming.userTheme.getBackground') . "?v=$cacheBuster')",
+					'--color-background-plain' => $this->primaryColor,
+				];
+			}
+
+			// The user is using the default background and admin removed the background image
+			if ($backgroundImage === BackgroundService::BACKGROUND_DEFAULT && $adminBackgroundDeleted) {
+				return [
+					// --image-background is not defined in this case
+					'--color-background-plain' => $this->primaryColor,
+					'--background-image-invert-if-bright' => $isPrimaryBright ? 'invert(100%)' : 'no',
+				];
+			}
+
+			// The user picked a shipped background
+			if (isset(BackgroundService::SHIPPED_BACKGROUNDS[$backgroundImage])) {
+				return [
+					'--image-background' => "url('" . $this->urlGenerator->linkTo(Application::APP_ID, "img/background/$backgroundImage") . "')",
+					'--color-background-plain' => $this->primaryColor,
+					'--background-image-invert-if-bright' => BackgroundService::SHIPPED_BACKGROUNDS[$backgroundImage]['theming'] ?? null === BackgroundService::THEMING_MODE_DARK ? 'invert(100%)' : 'no',
+				];
+			}
+		}
+
+		return [];
+	}
+}

wedding-pics/apps/theming/lib/Themes/DarkHighContrastTheme.php

@@ -0,0 +1,142 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Themes;
+
+use OCA\Theming\ITheme;
+
+class DarkHighContrastTheme extends DarkTheme implements ITheme {
+
+	public function getId(): string {
+		return 'dark-highcontrast';
+	}
+
+	public function getMediaQuery(): string {
+		return '(prefers-color-scheme: dark) and (prefers-contrast: more)';
+	}
+
+	public function getTitle(): string {
+		return $this->l->t('Dark theme with high contrast mode');
+	}
+
+	public function getEnableLabel(): string {
+		return $this->l->t('Enable dark high contrast mode');
+	}
+
+	public function getDescription(): string {
+		return $this->l->t('Similar to the high contrast mode, but with dark colours.');
+	}
+
+	/**
+	 * Keep this consistent with other HighContrast Themes
+	 */
+	public function getCSSVariables(): array {
+		$defaultVariables = parent::getCSSVariables();
+
+		$colorMainText = '#ffffff';
+		$colorMainBackground = '#000000';
+		$colorMainBackgroundRGB = join(',', $this->util->hexToRGB($colorMainBackground));
+
+		$colorError = '#ff5252';
+		$colorWarning = '#ffcc00';
+		$colorSuccess = '#42a942';
+		$colorInfo = '#38c0ff';
+
+		return array_merge(
+			$defaultVariables,
+			$this->generatePrimaryVariables($colorMainBackground, $colorMainText, true),
+			[
+				'--color-main-background' => $colorMainBackground,
+				'--color-main-background-rgb' => $colorMainBackgroundRGB,
+				'--color-main-background-translucent' => 'rgba(var(--color-main-background-rgb), 1)',
+				'--color-main-text' => $colorMainText,
+
+				'--color-background-dark' => $this->util->lighten($colorMainBackground, 25),
+				'--color-background-darker' => $this->util->lighten($colorMainBackground, 25),
+
+				'--color-main-background-blur' => $colorMainBackground,
+				'--filter-background-blur' => 'none',
+
+				'--color-placeholder-light' => $this->util->lighten($colorMainBackground, 30),
+				'--color-placeholder-dark' => $this->util->lighten($colorMainBackground, 45),
+
+				'--color-text-maxcontrast' => $colorMainText,
+				'--color-text-maxcontrast-background-blur' => $colorMainText,
+				'--color-text-light' => $colorMainText,
+				'--color-text-lighter' => $colorMainText,
+
+				'--color-error' => $colorError,
+				'--color-error-rgb' => join(',', $this->util->hexToRGB($colorError)),
+				'--color-error-hover' => $this->util->lighten($colorError, 10),
+				'--color-error-text' => $this->util->lighten($colorError, 25),
+
+				'--color-warning' => $colorWarning,
+				'--color-warning-rgb' => join(',', $this->util->hexToRGB($colorWarning)),
+				'--color-warning-hover' => $this->util->lighten($colorWarning, 10),
+				'--color-warning-text' => $this->util->lighten($colorWarning, 10),
+
+				'--color-success' => $colorSuccess,
+				'--color-success-rgb' => join(',', $this->util->hexToRGB($colorSuccess)),
+				'--color-success-hover' => $this->util->lighten($colorSuccess, 10),
+				'--color-success-text' => $this->util->lighten($colorSuccess, 35),
+
+				'--color-info' => $colorInfo,
+				'--color-info-rgb' => join(',', $this->util->hexToRGB($colorInfo)),
+				'--color-info-hover' => $this->util->lighten($colorInfo, 10),
+				'--color-info-text' => $this->util->lighten($colorInfo, 20),
+
+				'--color-scrollbar' => $this->util->lighten($colorMainBackground, 35),
+
+				// used for the icon loading animation
+				'--color-loading-light' => '#000000',
+				'--color-loading-dark' => '#dddddd',
+
+				'--color-box-shadow-rgb' => $colorMainText,
+				'--color-box-shadow' => $colorMainText,
+
+				'--color-border' => $this->util->lighten($colorMainBackground, 50),
+				'--color-border-dark' => $this->util->lighten($colorMainBackground, 50),
+				'--color-border-maxcontrast' => $this->util->lighten($colorMainBackground, 55),
+			]
+		);
+	}
+
+	public function getCustomCss(): string {
+		return "
+		[class^='icon-'], [class*=' icon-'],
+			.action,
+			#appmenu li a,
+			.menutoggle {
+				opacity: 1 !important;
+			}
+			#app-navigation {
+				border-right: 1px solid var(--color-border);
+			}
+			div.crumb {
+				filter: brightness(150%);
+			}
+		";
+	}
+}

wedding-pics/apps/theming/lib/Themes/DarkTheme.php

@@ -0,0 +1,125 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Themes;
+
+use OCA\Theming\ITheme;
+
+class DarkTheme extends DefaultTheme implements ITheme {
+
+	public function getId(): string {
+		return 'dark';
+	}
+
+	public function getMediaQuery(): string {
+		return '(prefers-color-scheme: dark)';
+	}
+
+	public function getTitle(): string {
+		return $this->l->t('Dark theme');
+	}
+
+	public function getEnableLabel(): string {
+		return $this->l->t('Enable dark theme');
+	}
+
+	public function getDescription(): string {
+		return $this->l->t('A dark theme to ease your eyes by reducing the overall luminosity and brightness.');
+	}
+
+	public function getCSSVariables(): array {
+		$defaultVariables = parent::getCSSVariables();
+
+		$colorMainText = '#EBEBEB';
+		$colorMainBackground = '#171717';
+		$colorMainBackgroundRGB = join(',', $this->util->hexToRGB($colorMainBackground));
+		$colorTextMaxcontrast = $this->util->darken($colorMainText, 32);
+
+		$colorBoxShadow = $this->util->darken($colorMainBackground, 70);
+		$colorBoxShadowRGB = join(',', $this->util->hexToRGB($colorBoxShadow));
+
+		$colorError = '#FF3333';
+		$colorWarning = '#FFCC00';
+		$colorSuccess = '#3B973B';
+		$colorInfo = '#00AEFF';
+
+		return array_merge(
+			$defaultVariables,
+			$this->generatePrimaryVariables($colorMainBackground, $colorMainText),
+			[
+				'--color-main-text' => $colorMainText,
+				'--color-main-background' => $colorMainBackground,
+				'--color-main-background-rgb' => $colorMainBackgroundRGB,
+				'--color-main-background-blur' => 'rgba(var(--color-main-background-rgb), .85)',
+
+				'--color-scrollbar' => $this->util->lighten($colorMainBackground, 15),
+
+				'--color-background-hover' => $this->util->lighten($colorMainBackground, 4),
+				'--color-background-dark' => $this->util->lighten($colorMainBackground, 7),
+				'--color-background-darker' => $this->util->lighten($colorMainBackground, 14),
+
+				'--color-placeholder-light' => $this->util->lighten($colorMainBackground, 10),
+				'--color-placeholder-dark' => $this->util->lighten($colorMainBackground, 20),
+
+				'--color-text-maxcontrast' => $colorTextMaxcontrast,
+				'--color-text-maxcontrast-default' => $colorTextMaxcontrast,
+				'--color-text-maxcontrast-background-blur' => $this->util->lighten($colorTextMaxcontrast, 6),
+				'--color-text-light' => 'var(--color-main-text)', // deprecated
+				'--color-text-lighter' => 'var(--color-text-maxcontrast)', // deprecated
+
+				'--color-error' => $colorError,
+				'--color-error-rgb' => join(',', $this->util->hexToRGB($colorError)),
+				'--color-error-hover' => $this->util->lighten($colorError, 10),
+				'--color-error-text' => $this->util->lighten($colorError, 15),
+				'--color-warning' => $colorWarning,
+				'--color-warning-rgb' => join(',', $this->util->hexToRGB($colorWarning)),
+				'--color-warning-hover' => $this->util->lighten($colorWarning, 10),
+				'--color-warning-text' => $colorWarning,
+				'--color-success' => $colorSuccess,
+				'--color-success-rgb' => join(',', $this->util->hexToRGB($colorSuccess)),
+				'--color-success-hover' => $this->util->lighten($colorSuccess, 10),
+				'--color-success-text' => $this->util->lighten($colorSuccess, 15),
+				'--color-info' => $colorInfo,
+				'--color-info-rgb' => join(',', $this->util->hexToRGB($colorInfo)),
+				'--color-info-hover' => $this->util->lighten($colorInfo, 10),
+				'--color-info-text' => $colorInfo,
+
+				// used for the icon loading animation
+				'--color-loading-light' => '#777',
+				'--color-loading-dark' => '#CCC',
+
+				'--color-box-shadow' => $colorBoxShadow,
+				'--color-box-shadow-rgb' => $colorBoxShadowRGB,
+
+				'--color-border' => $this->util->lighten($colorMainBackground, 7),
+				'--color-border-dark' => $this->util->lighten($colorMainBackground, 14),
+				'--color-border-maxcontrast' => $this->util->lighten($colorMainBackground, 40),
+
+				'--background-invert-if-dark' => 'invert(100%)',
+				'--background-invert-if-bright' => 'no',
+			]
+		);
+	}
+}

wedding-pics/apps/theming/lib/Themes/DefaultTheme.php

@@ -0,0 +1,222 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Themes;
+
+use OCA\Theming\ImageManager;
+use OCA\Theming\ITheme;
+use OCA\Theming\Service\BackgroundService;
+use OCA\Theming\ThemingDefaults;
+use OCA\Theming\Util;
+use OCP\App\IAppManager;
+use OCP\IConfig;
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\IUserSession;
+
+class DefaultTheme implements ITheme {
+	use CommonThemeTrait;
+
+	public Util $util;
+	public ThemingDefaults $themingDefaults;
+	public IUserSession $userSession;
+	public IURLGenerator $urlGenerator;
+	public ImageManager $imageManager;
+	public IConfig $config;
+	public IL10N $l;
+	public IAppManager $appManager;
+
+	public string $defaultPrimaryColor;
+	public string $primaryColor;
+
+	public function __construct(Util $util,
+		ThemingDefaults $themingDefaults,
+		IUserSession $userSession,
+		IURLGenerator $urlGenerator,
+		ImageManager $imageManager,
+		IConfig $config,
+		IL10N $l,
+		IAppManager $appManager) {
+		$this->util = $util;
+		$this->themingDefaults = $themingDefaults;
+		$this->userSession = $userSession;
+		$this->urlGenerator = $urlGenerator;
+		$this->imageManager = $imageManager;
+		$this->config = $config;
+		$this->l = $l;
+		$this->appManager = $appManager;
+
+		$this->defaultPrimaryColor = $this->themingDefaults->getDefaultColorPrimary();
+		$this->primaryColor = $this->themingDefaults->getColorPrimary();
+
+		// Override primary colors (if set) to improve accessibility
+		if ($this->primaryColor === BackgroundService::DEFAULT_COLOR) {
+			$this->primaryColor = BackgroundService::DEFAULT_ACCESSIBLE_COLOR;
+		}
+	}
+
+	public function getId(): string {
+		return 'default';
+	}
+
+	public function getType(): int {
+		return ITheme::TYPE_THEME;
+	}
+
+	public function getTitle(): string {
+		return $this->l->t('System default theme');
+	}
+
+	public function getEnableLabel(): string {
+		return $this->l->t('Enable the system default');
+	}
+
+	public function getDescription(): string {
+		return $this->l->t('Using the default system appearance.');
+	}
+
+	public function getMediaQuery(): string {
+		return '';
+	}
+
+	public function getCSSVariables(): array {
+		$colorMainText = '#222222';
+		$colorMainTextRgb = join(',', $this->util->hexToRGB($colorMainText));
+		// Color that still provides enough contrast for text, so we need a ratio of 4.5:1 on main background AND hover
+		$colorTextMaxcontrast = '#6b6b6b'; // 4.5 : 1 for hover background and background dark
+		$colorMainBackground = '#ffffff';
+		$colorMainBackgroundRGB = join(',', $this->util->hexToRGB($colorMainBackground));
+		$colorBoxShadow = $this->util->darken($colorMainBackground, 70);
+		$colorBoxShadowRGB = join(',', $this->util->hexToRGB($colorBoxShadow));
+
+		$colorError = '#DB0606';
+		$colorWarning = '#A37200';
+		$colorSuccess = '#2d7b41';
+		$colorInfo = '#0071ad';
+
+		$variables = [
+			'--color-main-background' => $colorMainBackground,
+			'--color-main-background-rgb' => $colorMainBackgroundRGB,
+			'--color-main-background-translucent' => 'rgba(var(--color-main-background-rgb), .97)',
+			'--color-main-background-blur' => 'rgba(var(--color-main-background-rgb), .8)',
+			'--filter-background-blur' => 'blur(25px)',
+
+			// to use like this: background-image: linear-gradient(0, var('--gradient-main-background));
+			'--gradient-main-background' => 'var(--color-main-background) 0%, var(--color-main-background-translucent) 85%, transparent 100%',
+
+			// used for different active/hover/focus/disabled states
+			'--color-background-hover' => $this->util->darken($colorMainBackground, 4),
+			'--color-background-dark' => $this->util->darken($colorMainBackground, 7),
+			'--color-background-darker' => $this->util->darken($colorMainBackground, 14),
+
+			'--color-placeholder-light' => $this->util->darken($colorMainBackground, 10),
+			'--color-placeholder-dark' => $this->util->darken($colorMainBackground, 20),
+
+			// max contrast for WCAG compliance
+			'--color-main-text' => $colorMainText,
+			'--color-text-maxcontrast' => $colorTextMaxcontrast,
+			'--color-text-maxcontrast-default' => $colorTextMaxcontrast,
+			'--color-text-maxcontrast-background-blur' => $this->util->darken($colorTextMaxcontrast, 7),
+			'--color-text-light' => 'var(--color-main-text)', // deprecated
+			'--color-text-lighter' => 'var(--color-text-maxcontrast)', // deprecated
+
+			'--color-scrollbar' => 'rgba(' . $colorMainTextRgb . ', .15)',
+
+			// error/warning/success/info feedback colours
+			'--color-error' => $colorError,
+			'--color-error-rgb' => join(',', $this->util->hexToRGB($colorError)),
+			'--color-error-hover' => $this->util->mix($colorError, $colorMainBackground, 75),
+			'--color-error-text' => $this->util->darken($colorError, 5),
+			'--color-warning' => $colorWarning,
+			'--color-warning-rgb' => join(',', $this->util->hexToRGB($colorWarning)),
+			'--color-warning-hover' => $this->util->darken($colorWarning, 5),
+			'--color-warning-text' => $this->util->darken($colorWarning, 7),
+			'--color-success' => $colorSuccess,
+			'--color-success-rgb' => join(',', $this->util->hexToRGB($colorSuccess)),
+			'--color-success-hover' => $this->util->mix($colorSuccess, $colorMainBackground, 80),
+			'--color-success-text' => $this->util->darken($colorSuccess, 4),
+			'--color-info' => $colorInfo,
+			'--color-info-rgb' => join(',', $this->util->hexToRGB($colorInfo)),
+			'--color-info-hover' => $this->util->mix($colorInfo, $colorMainBackground, 80),
+			'--color-info-text' => $this->util->darken($colorInfo, 4),
+
+			// used for the icon loading animation
+			'--color-loading-light' => '#cccccc',
+			'--color-loading-dark' => '#444444',
+
+			'--color-box-shadow-rgb' => $colorBoxShadowRGB,
+			'--color-box-shadow' => "rgba(var(--color-box-shadow-rgb), 0.5)",
+
+			'--color-border' => $this->util->darken($colorMainBackground, 7),
+			'--color-border-dark' => $this->util->darken($colorMainBackground, 14),
+			'--color-border-maxcontrast' => $this->util->darken($colorMainBackground, 51),
+
+			'--font-face' => "system-ui, -apple-system, 'Segoe UI', Roboto, Oxygen-Sans, Cantarell, Ubuntu, 'Helvetica Neue', 'Noto Sans', 'Liberation Sans', Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji'",
+			'--default-font-size' => '15px',
+
+			// TODO: support "(prefers-reduced-motion)"
+			'--animation-quick' => '100ms',
+			'--animation-slow' => '300ms',
+
+			// Default variables --------------------------------------------
+			'--border-radius' => '3px',
+			'--border-radius-large' => '10px',
+			'--border-radius-rounded' => '28px',
+			// pill-style button, value is large so big buttons also have correct roundness
+			'--border-radius-pill' => '100px',
+
+			'--default-clickable-area' => '44px',
+			'--default-line-height' => '24px',
+			'--default-grid-baseline' => '4px',
+
+			// various structure data
+			'--header-height' => '50px',
+			'--navigation-width' => '300px',
+			'--sidebar-min-width' => '300px',
+			'--sidebar-max-width' => '500px',
+			'--list-min-width' => '200px',
+			'--list-max-width' => '300px',
+			'--header-menu-item-height' => '44px',
+			'--header-menu-profile-item-height' => '66px',
+
+			// mobile. Keep in sync with core/js/js.js
+			'--breakpoint-mobile' => '1024px',
+			'--background-invert-if-dark' => 'no',
+			'--background-invert-if-bright' => 'invert(100%)',
+			'--background-image-invert-if-bright' => 'no',
+		];
+
+		// Primary variables
+		$variables = array_merge($variables, $this->generatePrimaryVariables($colorMainBackground, $colorMainText));
+		$variables = array_merge($variables, $this->generateGlobalBackgroundVariables());
+		$variables = array_merge($variables, $this->generateUserBackgroundVariables());
+
+		return $variables;
+	}
+
+	public function getCustomCss(): string {
+		return '';
+	}
+}

wedding-pics/apps/theming/lib/Themes/DyslexiaFont.php

@@ -0,0 +1,91 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Themes;
+
+use OCA\Theming\ITheme;
+
+class DyslexiaFont extends DefaultTheme implements ITheme {
+
+	public function getId(): string {
+		return 'opendyslexic';
+	}
+
+	public function getType(): int {
+		return ITheme::TYPE_FONT;
+	}
+
+	public function getTitle(): string {
+		return $this->l->t('Dyslexia font');
+	}
+
+	public function getEnableLabel(): string {
+		return $this->l->t('Enable dyslexia font');
+	}
+
+	public function getDescription(): string {
+		return $this->l->t('OpenDyslexic is a free typeface/font designed to mitigate some of the common reading errors caused by dyslexia.');
+	}
+
+	public function getCSSVariables(): array {
+		$variables = parent::getCSSVariables();
+		$originalFontFace = $variables['--font-face'];
+
+		$variables = [
+			'--font-face' => 'OpenDyslexic, ' . $originalFontFace
+		];
+
+		return $variables;
+	}
+
+	public function getCustomCss(): string {
+		$fontPathWoff = $this->urlGenerator->linkTo('theming', 'fonts/OpenDyslexic-Regular.woff');
+		$fontPathOtf = $this->urlGenerator->linkTo('theming', 'fonts/OpenDyslexic-Regular.otf');
+		$fontPathTtf = $this->urlGenerator->linkTo('theming', 'fonts/OpenDyslexic-Regular.ttf');
+		$boldFontPathWoff = $this->urlGenerator->linkTo('theming', 'fonts/OpenDyslexic-Bold.woff');
+		$boldFontPathOtf = $this->urlGenerator->linkTo('theming', 'fonts/OpenDyslexic-Bold.otf');
+		$boldFontPathTtf = $this->urlGenerator->linkTo('theming', 'fonts/OpenDyslexic-Bold.ttf');
+
+		return "
+			@font-face {
+				font-family: 'OpenDyslexic';
+				font-style: normal;
+				font-weight: 400;
+				src: url('$fontPathWoff') format('woff'),
+					 url('$fontPathOtf') format('opentype'),
+					 url('$fontPathTtf') format('truetype');
+			}
+			
+			@font-face {
+				font-family: 'OpenDyslexic';
+				font-style: normal;
+				font-weight: 700;
+				src: url('$boldFontPathWoff') format('woff'),
+					 url('$boldFontPathOtf') format('opentype'),
+					 url('$boldFontPathTtf') format('truetype');
+			}
+		";
+	}
+}

wedding-pics/apps/theming/lib/Themes/HighContrastTheme.php

@@ -0,0 +1,142 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Themes;
+
+use OCA\Theming\ITheme;
+
+class HighContrastTheme extends DefaultTheme implements ITheme {
+
+	public function getId(): string {
+		return 'light-highcontrast';
+	}
+
+	public function getMediaQuery(): string {
+		return '(prefers-contrast: more)';
+	}
+
+	public function getTitle(): string {
+		return $this->l->t('High contrast mode');
+	}
+
+	public function getEnableLabel(): string {
+		return $this->l->t('Enable high contrast mode');
+	}
+
+	public function getDescription(): string {
+		return $this->l->t('A high contrast mode to ease your navigation. Visual quality will be reduced but clarity will be increased.');
+	}
+
+	/**
+	 * Keep this consistent with other HighContrast Themes
+	 */
+	public function getCSSVariables(): array {
+		$defaultVariables = parent::getCSSVariables();
+
+		$colorMainText = '#000000';
+		$colorMainBackground = '#ffffff';
+		$colorMainBackgroundRGB = join(',', $this->util->hexToRGB($colorMainBackground));
+
+		$colorError = '#D10000';
+		$colorWarning = '#995900';
+		$colorSuccess = '#207830';
+		$colorInfo = '#006DA8';
+
+		$primaryVariables = $this->generatePrimaryVariables($colorMainBackground, $colorMainText, true);
+		return array_merge(
+			$defaultVariables,
+			$primaryVariables,
+			[
+				'--color-primary-element-text-dark' => $primaryVariables['--color-primary-element-text'],
+
+				'--color-main-background' => $colorMainBackground,
+				'--color-main-background-rgb' => $colorMainBackgroundRGB,
+				'--color-main-background-translucent' => 'rgba(var(--color-main-background-rgb), 1)',
+				'--color-main-text' => $colorMainText,
+
+				'--color-background-dark' => $this->util->darken($colorMainBackground, 20),
+				'--color-background-darker' => $this->util->darken($colorMainBackground, 20),
+
+				'--color-main-background-blur' => $colorMainBackground,
+				'--filter-background-blur' => 'none',
+
+				'--color-placeholder-light' => $this->util->darken($colorMainBackground, 30),
+				'--color-placeholder-dark' => $this->util->darken($colorMainBackground, 45),
+
+				'--color-text-maxcontrast' => $colorMainText,
+				'--color-text-maxcontrast-background-blur' => $colorMainText,
+				'--color-text-light' => $colorMainText,
+				'--color-text-lighter' => $colorMainText,
+
+				'--color-error' => $colorError,
+				'--color-error-rgb' => join(',', $this->util->hexToRGB($colorError)),
+				'--color-error-hover' => $this->util->darken($colorError, 8),
+				'--color-error-text' => $this->util->darken($colorError, 17),
+
+				'--color-warning' => $colorWarning,
+				'--color-warning-rgb' => join(',', $this->util->hexToRGB($colorWarning)),
+				'--color-warning-hover' => $this->util->darken($colorWarning, 7),
+				'--color-warning-text' => $this->util->darken($colorWarning, 13),
+
+				'--color-info' => $colorInfo,
+				'--color-info-rgb' => join(',', $this->util->hexToRGB($colorInfo)),
+				'--color-info-hover' => $this->util->darken($colorInfo, 7),
+				'--color-info-text' => $this->util->darken($colorInfo, 15),
+
+				'--color-success' => $colorSuccess,
+				'--color-success-rgb' => join(',', $this->util->hexToRGB($colorSuccess)),
+				'--color-success-hover' => $this->util->darken($colorSuccess, 7),
+				'--color-success-text' => $this->util->darken($colorSuccess, 14),
+
+				'--color-scrollbar' => $this->util->darken($colorMainBackground, 25),
+
+				// used for the icon loading animation
+				'--color-loading-light' => '#dddddd',
+				'--color-loading-dark' => '#000000',
+
+				'--color-box-shadow-rgb' => $colorMainText,
+				'--color-box-shadow' => $colorMainText,
+
+				'--color-border' => $this->util->darken($colorMainBackground, 50),
+				'--color-border-dark' => $this->util->darken($colorMainBackground, 50),
+				'--color-border-maxcontrast' => $this->util->darken($colorMainBackground, 56),
+			]
+		);
+	}
+
+	public function getCustomCss(): string {
+		return "
+			[class^='icon-'], [class*=' icon-'],
+			.action,
+			#appmenu li a,
+			.menutoggle {
+				opacity: 1 !important;
+			}
+			#app-navigation {
+				border-right: 1px solid var(--color-border);
+			}
+		";
+	}
+}

wedding-pics/apps/theming/lib/Themes/LightTheme.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2022 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming\Themes;
+
+use OCA\Theming\ITheme;
+
+class LightTheme extends DefaultTheme implements ITheme {
+
+	public function getId(): string {
+		return 'light';
+	}
+
+	public function getType(): int {
+		return ITheme::TYPE_THEME;
+	}
+
+	public function getTitle(): string {
+		return $this->l->t('Light theme');
+	}
+
+	public function getEnableLabel(): string {
+		return $this->l->t('Enable the default light theme');
+	}
+
+	public function getDescription(): string {
+		return $this->l->t('The default light appearance.');
+	}
+
+	public function getMediaQuery(): string {
+		return '(prefers-color-scheme: light)';
+	}
+}

wedding-pics/apps/theming/lib/ThemingDefaults.php

@@ -0,0 +1,527 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Bjoern Schiessle <bjoern@schiessle.org>
+ * @copyright Copyright (c) 2017 Lukas Reschke <lukas@statuscode.ch>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ * @author Bjoern Schiessle <bjoern@schiessle.org>
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Daniel Kesselberg <mail@danielkesselberg.de>
+ * @author Guillaume COMPAGNON <gcompagnon@outlook.com>
+ * @author Jan-Christoph Borchardt <hey@jancborchardt.net>
+ * @author Joachim Bauch <bauch@struktur.de>
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author John Molakvoæ <skjnldsv@protonmail.com>
+ * @author Julien Veyssier <eneiluj@posteo.net>
+ * @author Julius Haertl <jus@bitgrid.net>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Lukas Reschke <lukas@statuscode.ch>
+ * @author Michael Weimann <mail@michael-weimann.eu>
+ * @author Morris Jobke <hey@morrisjobke.de>
+ * @author Patrik Kernstock <info@pkern.at>
+ * @author Robin Appelman <robin@icewind.nl>
+ * @author Roeland Jago Douma <roeland@famdouma.nl>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming;
+
+use OCA\Theming\AppInfo\Application;
+use OCA\Theming\Service\BackgroundService;
+use OCP\App\AppPathNotFoundException;
+use OCP\App\IAppManager;
+use OCP\Files\NotFoundException;
+use OCP\Files\SimpleFS\ISimpleFile;
+use OCP\ICacheFactory;
+use OCP\IConfig;
+use OCP\IL10N;
+use OCP\INavigationManager;
+use OCP\IURLGenerator;
+use OCP\IUserSession;
+
+class ThemingDefaults extends \OC_Defaults {
+
+	private IConfig $config;
+	private IL10N $l;
+	private ImageManager $imageManager;
+	private IUserSession $userSession;
+	private IURLGenerator $urlGenerator;
+	private ICacheFactory $cacheFactory;
+	private Util $util;
+	private IAppManager $appManager;
+	private INavigationManager $navigationManager;
+
+	private string $name;
+	private string $title;
+	private string $entity;
+	private string $productName;
+	private string $url;
+	private string $color;
+	private string $docBaseUrl;
+
+	private string $iTunesAppId;
+	private string $iOSClientUrl;
+	private string $AndroidClientUrl;
+	private string $FDroidClientUrl;
+
+	/**
+	 * ThemingDefaults constructor.
+	 *
+	 * @param IConfig $config
+	 * @param IL10N $l
+	 * @param ImageManager $imageManager
+	 * @param IUserSession $userSession
+	 * @param IURLGenerator $urlGenerator
+	 * @param ICacheFactory $cacheFactory
+	 * @param Util $util
+	 * @param IAppManager $appManager
+	 */
+	public function __construct(IConfig $config,
+		IL10N $l,
+		IUserSession $userSession,
+		IURLGenerator $urlGenerator,
+		ICacheFactory $cacheFactory,
+		Util $util,
+		ImageManager $imageManager,
+		IAppManager $appManager,
+		INavigationManager $navigationManager
+	) {
+		parent::__construct();
+		$this->config = $config;
+		$this->l = $l;
+		$this->imageManager = $imageManager;
+		$this->userSession = $userSession;
+		$this->urlGenerator = $urlGenerator;
+		$this->cacheFactory = $cacheFactory;
+		$this->util = $util;
+		$this->appManager = $appManager;
+		$this->navigationManager = $navigationManager;
+
+		$this->name = parent::getName();
+		$this->title = parent::getTitle();
+		$this->entity = parent::getEntity();
+		$this->productName = parent::getProductName();
+		$this->url = parent::getBaseUrl();
+		$this->color = parent::getColorPrimary();
+		$this->iTunesAppId = parent::getiTunesAppId();
+		$this->iOSClientUrl = parent::getiOSClientUrl();
+		$this->AndroidClientUrl = parent::getAndroidClientUrl();
+		$this->FDroidClientUrl = parent::getFDroidClientUrl();
+		$this->docBaseUrl = parent::getDocBaseUrl();
+	}
+
+	public function getName() {
+		return strip_tags($this->config->getAppValue('theming', 'name', $this->name));
+	}
+
+	public function getHTMLName() {
+		return $this->config->getAppValue('theming', 'name', $this->name);
+	}
+
+	public function getTitle() {
+		return strip_tags($this->config->getAppValue('theming', 'name', $this->title));
+	}
+
+	public function getEntity() {
+		return strip_tags($this->config->getAppValue('theming', 'name', $this->entity));
+	}
+
+	public function getProductName() {
+		return strip_tags($this->config->getAppValue('theming', 'productName', $this->productName));
+	}
+
+	public function getBaseUrl() {
+		return $this->config->getAppValue('theming', 'url', $this->url);
+	}
+
+	/**
+	 * We pass a string and sanitizeHTML will return a string too in that case
+	 * @psalm-suppress InvalidReturnStatement
+	 * @psalm-suppress InvalidReturnType
+	 */
+	public function getSlogan(?string $lang = null) {
+		return \OCP\Util::sanitizeHTML($this->config->getAppValue('theming', 'slogan', parent::getSlogan($lang)));
+	}
+
+	public function getImprintUrl() {
+		return (string)$this->config->getAppValue('theming', 'imprintUrl', '');
+	}
+
+	public function getPrivacyUrl() {
+		return (string)$this->config->getAppValue('theming', 'privacyUrl', '');
+	}
+
+	public function getDocBaseUrl() {
+		return (string)$this->config->getAppValue('theming', 'docBaseUrl', $this->docBaseUrl);
+	}
+
+	public function getShortFooter() {
+		$slogan = $this->getSlogan();
+		$baseUrl = $this->getBaseUrl();
+		$entity = $this->getEntity();
+		$footer = '';
+
+		if ($entity !== '') {
+			if ($baseUrl !== '') {
+				$footer = '<a href="' . $baseUrl . '" target="_blank"' .
+					' rel="noreferrer noopener" class="entity-name">' . $entity . '</a>';
+			} else {
+				$footer = '<span class="entity-name">' .$entity . '</span>';
+			}
+		}
+		$footer .= ($slogan !== '' ? ' – ' . $slogan : '');
+
+		$links = [
+			[
+				'text' => $this->l->t('Legal notice'),
+				'url' => (string)$this->getImprintUrl()
+			],
+			[
+				'text' => $this->l->t('Privacy policy'),
+				'url' => (string)$this->getPrivacyUrl()
+			],
+		];
+
+		$navigation = $this->navigationManager->getAll(INavigationManager::TYPE_GUEST);
+		$guestNavigation = array_map(function ($nav) {
+			return [
+				'text' => $nav['name'],
+				'url' => $nav['href']
+			];
+		}, $navigation);
+		$links = array_merge($links, $guestNavigation);
+
+		$legalLinks = '';
+		$divider = '';
+		foreach ($links as $link) {
+			if ($link['url'] !== ''
+				&& filter_var($link['url'], FILTER_VALIDATE_URL)
+			) {
+				$legalLinks .= $divider . '<a href="' . $link['url'] . '" class="legal" target="_blank"' .
+					' rel="noreferrer noopener">' . $link['text'] . '</a>';
+				$divider = ' · ';
+			}
+		}
+		if ($legalLinks !== '') {
+			$footer .= '<br/>' . $legalLinks;
+		}
+
+		return $footer;
+	}
+
+	/**
+	 * Color that is used for the header as well as for mail headers
+	 */
+	public function getColorPrimary(): string {
+		$user = $this->userSession->getUser();
+
+		// admin-defined primary color
+		$defaultColor = $this->getDefaultColorPrimary();
+
+		if ($this->isUserThemingDisabled()) {
+			return $defaultColor;
+		}
+
+		// user-defined primary color
+		if (!empty($user)) {
+			$themingBackgroundColor = $this->config->getUserValue($user->getUID(), Application::APP_ID, 'background_color', '');
+			// If the user selected a specific colour
+			if (preg_match('/^\#([0-9a-f]{3}|[0-9a-f]{6})$/i', $themingBackgroundColor)) {
+				return $themingBackgroundColor;
+			}
+		}
+
+		// If the default color is not valid, return the default background one
+		if (!preg_match('/^\#([0-9a-f]{3}|[0-9a-f]{6})$/i', $defaultColor)) {
+			return BackgroundService::DEFAULT_COLOR;
+		}
+
+		// Finally, return the system global primary color
+		return $defaultColor;
+	}
+
+	/**
+	 * Return the default color primary
+	 */
+	public function getDefaultColorPrimary(): string {
+		$color = $this->config->getAppValue(Application::APP_ID, 'color', '');
+		if (!preg_match('/^\#([0-9a-f]{3}|[0-9a-f]{6})$/i', $color)) {
+			return BackgroundService::DEFAULT_COLOR;
+		}
+
+		return $color;
+	}
+
+	/**
+	 * Themed logo url
+	 *
+	 * @param bool $useSvg Whether to point to the SVG image or a fallback
+	 * @return string
+	 */
+	public function getLogo($useSvg = true): string {
+		$logo = $this->config->getAppValue('theming', 'logoMime', '');
+
+		// short cut to avoid setting up the filesystem just to check if the logo is there
+		//
+		// explanation: if an SVG is requested and the app config value for logoMime is set then the logo is there.
+		// otherwise we need to check it and maybe also generate a PNG from the SVG (that's done in getImage() which
+		// needs to be called then)
+		if ($useSvg === true && $logo !== false) {
+			$logoExists = true;
+		} else {
+			try {
+				$this->imageManager->getImage('logo', $useSvg);
+				$logoExists = true;
+			} catch (\Exception $e) {
+				$logoExists = false;
+			}
+		}
+
+		$cacheBusterCounter = $this->config->getAppValue('theming', 'cachebuster', '0');
+
+		if (!$logo || !$logoExists) {
+			if ($useSvg) {
+				$logo = $this->urlGenerator->imagePath('core', 'logo/logo.svg');
+			} else {
+				$logo = $this->urlGenerator->imagePath('core', 'logo/logo.png');
+			}
+			return $logo . '?v=' . $cacheBusterCounter;
+		}
+
+		return $this->urlGenerator->linkToRoute('theming.Theming.getImage', [ 'key' => 'logo', 'useSvg' => $useSvg, 'v' => $cacheBusterCounter ]);
+	}
+
+	/**
+	 * Themed background image url
+	 *
+	 * @return string
+	 */
+	public function getBackground(): string {
+		return $this->imageManager->getImageUrl('background');
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getiTunesAppId() {
+		return $this->config->getAppValue('theming', 'iTunesAppId', $this->iTunesAppId);
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getiOSClientUrl() {
+		return $this->config->getAppValue('theming', 'iOSClientUrl', $this->iOSClientUrl);
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getAndroidClientUrl() {
+		return $this->config->getAppValue('theming', 'AndroidClientUrl', $this->AndroidClientUrl);
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getFDroidClientUrl() {
+		return $this->config->getAppValue('theming', 'FDroidClientUrl', $this->FDroidClientUrl);
+	}
+
+	/**
+	 * @return array scss variables to overwrite
+	 */
+	public function getScssVariables() {
+		$cacheBuster = $this->config->getAppValue('theming', 'cachebuster', '0');
+		$cache = $this->cacheFactory->createDistributed('theming-' . $cacheBuster . '-' . $this->urlGenerator->getBaseUrl());
+		if ($value = $cache->get('getScssVariables')) {
+			return $value;
+		}
+
+		$variables = [
+			'theming-cachebuster' => "'" . $cacheBuster . "'",
+			'theming-logo-mime' => "'" . $this->config->getAppValue('theming', 'logoMime') . "'",
+			'theming-background-mime' => "'" . $this->config->getAppValue('theming', 'backgroundMime') . "'",
+			'theming-logoheader-mime' => "'" . $this->config->getAppValue('theming', 'logoheaderMime') . "'",
+			'theming-favicon-mime' => "'" . $this->config->getAppValue('theming', 'faviconMime') . "'"
+		];
+
+		$variables['image-logo'] = "url('".$this->imageManager->getImageUrl('logo')."')";
+		$variables['image-logoheader'] = "url('".$this->imageManager->getImageUrl('logoheader')."')";
+		$variables['image-favicon'] = "url('".$this->imageManager->getImageUrl('favicon')."')";
+		$variables['image-login-background'] = "url('".$this->imageManager->getImageUrl('background')."')";
+		$variables['image-login-plain'] = 'false';
+
+		if ($this->config->getAppValue('theming', 'color', '') !== '') {
+			$variables['color-primary'] = $this->getColorPrimary();
+			$variables['color-primary-text'] = $this->getTextColorPrimary();
+			$variables['color-primary-element'] = $this->util->elementColor($this->getColorPrimary());
+		}
+
+		if ($this->config->getAppValue('theming', 'backgroundMime', '') === 'backgroundColor') {
+			$variables['image-login-plain'] = 'true';
+		}
+
+		$variables['has-legal-links'] = 'false';
+		if ($this->getImprintUrl() !== '' || $this->getPrivacyUrl() !== '') {
+			$variables['has-legal-links'] = 'true';
+		}
+
+		$cache->set('getScssVariables', $variables);
+		return $variables;
+	}
+
+	/**
+	 * Check if the image should be replaced by the theming app
+	 * and return the new image location then
+	 *
+	 * @param string $app name of the app
+	 * @param string $image filename of the image
+	 * @return bool|string false if image should not replaced, otherwise the location of the image
+	 */
+	public function replaceImagePath($app, $image) {
+		if ($app === '' || $app === 'files_sharing') {
+			$app = 'core';
+		}
+		$cacheBusterValue = $this->config->getAppValue('theming', 'cachebuster', '0');
+
+		$route = false;
+		if ($image === 'favicon.ico' && ($this->imageManager->shouldReplaceIcons() || $this->getCustomFavicon() !== null)) {
+			$route = $this->urlGenerator->linkToRoute('theming.Icon.getFavicon', ['app' => $app]);
+		}
+		if (($image === 'favicon-touch.png' || $image === 'favicon-fb.png') && ($this->imageManager->shouldReplaceIcons() || $this->getCustomFavicon() !== null)) {
+			$route = $this->urlGenerator->linkToRoute('theming.Icon.getTouchIcon', ['app' => $app]);
+		}
+		if ($image === 'manifest.json') {
+			try {
+				$appPath = $this->appManager->getAppPath($app);
+				if (file_exists($appPath . '/img/manifest.json')) {
+					return false;
+				}
+			} catch (AppPathNotFoundException $e) {
+			}
+			$route = $this->urlGenerator->linkToRoute('theming.Theming.getManifest', ['app' => $app ]);
+		}
+		if (str_starts_with($image, 'filetypes/') && file_exists(\OC::$SERVERROOT . '/core/img/' . $image)) {
+			$route = $this->urlGenerator->linkToRoute('theming.Icon.getThemedIcon', ['app' => $app, 'image' => $image]);
+		}
+
+		if ($route) {
+			return $route . '?v=' . $this->util->getCacheBuster();
+		}
+
+		return false;
+	}
+
+	protected function getCustomFavicon(): ?ISimpleFile {
+		try {
+			return $this->imageManager->getImage('favicon');
+		} catch (NotFoundException $e) {
+			return null;
+		}
+	}
+
+	/**
+	 * Increases the cache buster key
+	 */
+	public function increaseCacheBuster(): void {
+		$cacheBusterKey = (int)$this->config->getAppValue('theming', 'cachebuster', '0');
+		$this->config->setAppValue('theming', 'cachebuster', (string)($cacheBusterKey + 1));
+		$this->cacheFactory->createDistributed('theming-')->clear();
+		$this->cacheFactory->createDistributed('imagePath')->clear();
+	}
+
+	/**
+	 * Update setting in the database
+	 *
+	 * @param string $setting
+	 * @param string $value
+	 */
+	public function set($setting, $value): void {
+		$this->config->setAppValue('theming', $setting, $value);
+		$this->increaseCacheBuster();
+	}
+
+	/**
+	 * Revert all settings to the default value
+	 */
+	public function undoAll(): void {
+		$this->config->deleteAppValues('theming');
+		$this->increaseCacheBuster();
+	}
+
+	/**
+	 * Revert settings to the default value
+	 *
+	 * @param string $setting setting which should be reverted
+	 * @return string default value
+	 */
+	public function undo($setting): string {
+		$this->config->deleteAppValue('theming', $setting);
+		$this->increaseCacheBuster();
+
+		$returnValue = '';
+		switch ($setting) {
+			case 'name':
+				$returnValue = $this->getEntity();
+				break;
+			case 'url':
+				$returnValue = $this->getBaseUrl();
+				break;
+			case 'slogan':
+				$returnValue = $this->getSlogan();
+				break;
+			case 'color':
+				$returnValue = $this->getDefaultColorPrimary();
+				break;
+			case 'logo':
+			case 'logoheader':
+			case 'background':
+			case 'favicon':
+				$this->imageManager->delete($setting);
+				$this->config->deleteAppValue('theming', $setting . 'Mime');
+				break;
+		}
+
+		return $returnValue;
+	}
+
+	/**
+	 * Color of text in the header and primary buttons
+	 *
+	 * @return string
+	 */
+	public function getTextColorPrimary() {
+		return $this->util->invertTextColor($this->getColorPrimary()) ? '#000000' : '#ffffff';
+	}
+
+	/**
+	 * Color of text in the header and primary buttons
+	 *
+	 * @return string
+	 */
+	public function getDefaultTextColorPrimary() {
+		return $this->util->invertTextColor($this->getDefaultColorPrimary()) ? '#000000' : '#ffffff';
+	}
+
+	/**
+	 * Has the admin disabled user customization
+	 */
+	public function isUserThemingDisabled(): bool {
+		return $this->config->getAppValue('theming', 'disable-user-theming', 'no') === 'yes';
+	}
+}

wedding-pics/apps/theming/lib/Util.php

@@ -0,0 +1,345 @@
+<?php
+/**
+ * @copyright Copyright (c) 2016 Julius Härtl <jus@bitgrid.net>
+ *
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Daniel Kesselberg <mail@danielkesselberg.de>
+ * @author Joas Schilling <coding@schilljs.com>
+ * @author Julien Veyssier <eneiluj@posteo.net>
+ * @author Julius Haertl <jus@bitgrid.net>
+ * @author Julius Härtl <jus@bitgrid.net>
+ * @author Michael Weimann <mail@michael-weimann.eu>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\Theming;
+
+use Mexitek\PHPColors\Color;
+use OCP\App\AppPathNotFoundException;
+use OCP\App\IAppManager;
+use OCP\Files\IAppData;
+use OCP\Files\NotFoundException;
+use OCP\Files\SimpleFS\ISimpleFile;
+use OCP\IConfig;
+use OCP\IUserSession;
+
+class Util {
+
+	private IConfig $config;
+	private IAppManager $appManager;
+	private IAppData $appData;
+	private ImageManager $imageManager;
+
+	public function __construct(IConfig $config, IAppManager $appManager, IAppData $appData, ImageManager $imageManager) {
+		$this->config = $config;
+		$this->appManager = $appManager;
+		$this->appData = $appData;
+		$this->imageManager = $imageManager;
+	}
+
+	/**
+	 * Should we invert the text on this background color?
+	 * @param string $color rgb color value
+	 * @return bool
+	 */
+	public function invertTextColor(string $color): bool {
+		return $this->colorContrast($color, '#ffffff') < 4.5;
+	}
+
+	/**
+	 * Is this color too bright ?
+	 * @param string $color rgb color value
+	 * @return bool
+	 */
+	public function isBrightColor(string $color): bool {
+		$l = $this->calculateLuma($color);
+		if ($l > 0.6) {
+			return true;
+		} else {
+			return false;
+		}
+	}
+
+	/**
+	 * get color for on-page elements:
+	 * theme color by default, grey if theme color is to bright
+	 * @param string $color
+	 * @param ?bool $brightBackground
+	 * @return string
+	 */
+	public function elementColor($color, ?bool $brightBackground = null, ?string $backgroundColor = null, bool $highContrast = false) {
+		if ($backgroundColor !== null) {
+			$brightBackground = $brightBackground ?? $this->isBrightColor($backgroundColor);
+			// Minimal amount that is possible to change the luminance
+			$epsilon = 1.0 / 255.0;
+			// Current iteration to prevent infinite loops
+			$iteration = 0;
+			// We need to keep blurred backgrounds in mind which might be mixed with the background
+			$blurredBackground = $this->mix($backgroundColor, $brightBackground ? $color : '#ffffff', 66);
+			$contrast = $this->colorContrast($color, $blurredBackground);
+
+			// Min. element contrast is 3:1 but we need to keep hover states in mind -> min 3.2:1
+			$minContrast = $highContrast ? 5.5 : 3.2;
+
+			while ($contrast < $minContrast && $iteration++ < 100) {
+				$hsl = Color::hexToHsl($color);
+				$hsl['L'] = max(0, min(1, $hsl['L'] + ($brightBackground ? -$epsilon : $epsilon)));
+				$color = '#' . Color::hslToHex($hsl);
+				$contrast = $this->colorContrast($color, $blurredBackground);
+			}
+			return $color;
+		}
+
+		// Fallback for legacy calling
+		$luminance = $this->calculateLuminance($color);
+
+		if ($brightBackground !== false && $luminance > 0.8) {
+			// If the color is too bright in bright mode, we fall back to a darkened color
+			return $this->darken($color, 30);
+		}
+
+		if ($brightBackground !== true && $luminance < 0.2) {
+			// If the color is too dark in dark mode, we fall back to a brightened color
+			return $this->lighten($color, 30);
+		}
+
+		return $color;
+	}
+
+	public function mix(string $color1, string $color2, int $factor): string {
+		$color = new Color($color1);
+		return '#' . $color->mix($color2, $factor);
+	}
+
+	public function lighten(string $color, int $factor): string {
+		$color = new Color($color);
+		return '#' . $color->lighten($factor);
+	}
+
+	public function darken(string $color, int $factor): string {
+		$color = new Color($color);
+		return '#' . $color->darken($factor);
+	}
+
+	/**
+	 * Convert RGB to HSL
+	 *
+	 * Copied from cssphp, copyright Leaf Corcoran, licensed under MIT
+	 *
+	 * @param int $red
+	 * @param int $green
+	 * @param int $blue
+	 *
+	 * @return float[]
+	 */
+	public function toHSL(int $red, int $green, int $blue): array {
+		$color = new Color(Color::rgbToHex(['R' => $red, 'G' => $green, 'B' => $blue]));
+		return array_values($color->getHsl());
+	}
+
+	/**
+	 * @param string $color rgb color value
+	 * @return float
+	 */
+	public function calculateLuminance(string $color): float {
+		[$red, $green, $blue] = $this->hexToRGB($color);
+		$hsl = $this->toHSL($red, $green, $blue);
+		return $hsl[2];
+	}
+
+	/**
+	 * Calculate the Luma according to WCAG 2
+	 * http://www.w3.org/TR/WCAG20/#relativeluminancedef
+	 * @param string $color rgb color value
+	 * @return float
+	 */
+	public function calculateLuma(string $color): float {
+		$rgb = $this->hexToRGB($color);
+
+		// Normalize the values by converting to float and applying the rules from WCAG2.0
+		$rgb = array_map(function (int $color) {
+			$color = $color / 255.0;
+			if ($color <= 0.03928) {
+				return $color / 12.92;
+			} else {
+				return pow((($color + 0.055) / 1.055), 2.4);
+			}
+		}, $rgb);
+
+		[$red, $green, $blue] = $rgb;
+		return (0.2126 * $red + 0.7152 * $green + 0.0722 * $blue);
+	}
+
+	/**
+	 * Calculat the color contrast according to WCAG 2
+	 * http://www.w3.org/TR/WCAG20/#contrast-ratiodef
+	 * @param string $color1 The first color
+	 * @param string $color2 The second color
+	 */
+	public function colorContrast(string $color1, string $color2): float {
+		$luminance1 = $this->calculateLuma($color1) + 0.05;
+		$luminance2 = $this->calculateLuma($color2) + 0.05;
+		return max($luminance1, $luminance2) / min($luminance1, $luminance2);
+	}
+
+	/**
+	 * @param string $color rgb color value
+	 * @return int[]
+	 * @psalm-return array{0: int, 1: int, 2: int}
+	 */
+	public function hexToRGB(string $color): array {
+		$color = new Color($color);
+		return array_values($color->getRgb());
+	}
+
+	/**
+	 * @param $color
+	 * @return string base64 encoded radio button svg
+	 */
+	public function generateRadioButton($color) {
+		$radioButtonIcon = '<svg xmlns="http://www.w3.org/2000/svg" height="16" width="16">' .
+			'<path d="M8 1a7 7 0 0 0-7 7 7 7 0 0 0 7 7 7 7 0 0 0 7-7 7 7 0 0 0-7-7zm0 1a6 6 0 0 1 6 6 6 6 0 0 1-6 6 6 6 0 0 1-6-6 6 6 0 0 1 6-6zm0 2a4 4 0 1 0 0 8 4 4 0 0 0 0-8z" fill="'.$color.'"/></svg>';
+		return base64_encode($radioButtonIcon);
+	}
+
+
+	/**
+	 * @param $app string app name
+	 * @return string|ISimpleFile path to app icon / file of logo
+	 */
+	public function getAppIcon($app) {
+		$app = str_replace(['\0', '/', '\\', '..'], '', $app);
+		try {
+			$appPath = $this->appManager->getAppPath($app);
+			$icon = $appPath . '/img/' . $app . '.svg';
+			if (file_exists($icon)) {
+				return $icon;
+			}
+			$icon = $appPath . '/img/app.svg';
+			if (file_exists($icon)) {
+				return $icon;
+			}
+		} catch (AppPathNotFoundException $e) {
+		}
+
+		if ($this->config->getAppValue('theming', 'logoMime', '') !== '') {
+			$logoFile = null;
+			try {
+				$folder = $this->appData->getFolder('global/images');
+				return $folder->getFile('logo');
+			} catch (NotFoundException $e) {
+			}
+		}
+		return \OC::$SERVERROOT . '/core/img/logo/logo.svg';
+	}
+
+	/**
+	 * @param $app string app name
+	 * @param $image string relative path to image in app folder
+	 * @return string|false absolute path to image
+	 */
+	public function getAppImage($app, $image) {
+		$app = str_replace(['\0', '/', '\\', '..'], '', $app);
+		$image = str_replace(['\0', '\\', '..'], '', $image);
+		if ($app === "core") {
+			$icon = \OC::$SERVERROOT . '/core/img/' . $image;
+			if (file_exists($icon)) {
+				return $icon;
+			}
+		}
+
+		try {
+			$appPath = $this->appManager->getAppPath($app);
+		} catch (AppPathNotFoundException $e) {
+			return false;
+		}
+
+		$icon = $appPath . '/img/' . $image;
+		if (file_exists($icon)) {
+			return $icon;
+		}
+		$icon = $appPath . '/img/' . $image . '.svg';
+		if (file_exists($icon)) {
+			return $icon;
+		}
+		$icon = $appPath . '/img/' . $image . '.png';
+		if (file_exists($icon)) {
+			return $icon;
+		}
+		$icon = $appPath . '/img/' . $image . '.gif';
+		if (file_exists($icon)) {
+			return $icon;
+		}
+		$icon = $appPath . '/img/' . $image . '.jpg';
+		if (file_exists($icon)) {
+			return $icon;
+		}
+
+		return false;
+	}
+
+	/**
+	 * replace default color with a custom one
+	 *
+	 * @param $svg string content of a svg file
+	 * @param $color string color to match
+	 * @return string
+	 */
+	public function colorizeSvg($svg, $color) {
+		$svg = preg_replace('/#0082c9/i', $color, $svg);
+		return $svg;
+	}
+
+	/**
+	 * Check if a custom theme is set in the server configuration
+	 *
+	 * @return bool
+	 */
+	public function isAlreadyThemed() {
+		$theme = $this->config->getSystemValue('theme', '');
+		if ($theme !== '') {
+			return true;
+		}
+		return false;
+	}
+
+	public function isBackgroundThemed() {
+		$backgroundLogo = $this->config->getAppValue('theming', 'backgroundMime', '');
+		return $backgroundLogo !== '' && $backgroundLogo !== 'backgroundColor';
+	}
+
+	public function isLogoThemed() {
+		return $this->imageManager->hasImage('logo')
+			|| $this->imageManager->hasImage('logoheader');
+	}
+
+	public function getCacheBuster(): string {
+		$userSession = \OC::$server->get(IUserSession::class);
+		$userId = '';
+		$user = $userSession->getUser();
+		if (!is_null($user)) {
+			$userId = $user->getUID();
+		}
+		$userCacheBuster = '';
+		if ($userId) {
+			$userCacheBusterValue = (int)$this->config->getUserValue($userId, 'theming', 'userCacheBuster', '0');
+			$userCacheBuster = $userId . '_' . $userCacheBusterValue;
+		}
+		$systemCacheBuster = $this->config->getAppValue('theming', 'cachebuster', '0');
+		return substr(sha1($userCacheBuster . $systemCacheBuster), 0, 8);
+	}
+}