From a307bb285ee6f01982dbc7fde05ff34d038cf1d6 Mon Sep 17 00:00:00 2001 From: Julius Härtl Date: Thu, 17 Oct 2019 10:54:46 +0200 Subject: Move help to controller MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Julius Härtl --- apps/settings/lib/Controller/HelpController.php | 97 +++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 apps/settings/lib/Controller/HelpController.php (limited to 'apps/settings/lib/Controller/HelpController.php') diff --git a/apps/settings/lib/Controller/HelpController.php b/apps/settings/lib/Controller/HelpController.php new file mode 100644 index 00000000000..eaad0be6709 --- /dev/null +++ b/apps/settings/lib/Controller/HelpController.php @@ -0,0 +1,97 @@ + + * + * @author Julius Härtl + * + * @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 . + * + */ +declare(strict_types=1); + +namespace OCA\Settings\Controller; + +use OCP\AppFramework\Controller; +use OCP\AppFramework\Http\ContentSecurityPolicy; +use OCP\AppFramework\Http\TemplateResponse; +use OCP\IGroupManager; +use OCP\INavigationManager; +use OCP\IRequest; +use OCP\IURLGenerator; +use OCP\IUserSession; + +class HelpController extends Controller { + + /** @var INavigationManager */ + private $navigationManager; + /** @var IUserSession */ + private $urlGenerator; + /** @var IGroupManager */ + private $groupManager; + + /** @var string */ + private $userId; + + public function __construct( + string $appName, + IRequest $request, + INavigationManager $navigationManager, + IURLGenerator $urlGenerator, + string $userId, + IGroupManager $groupManager + ) { + parent::__construct($appName, $request); + $this->navigationManager = $navigationManager; + $this->urlGenerator = $urlGenerator; + $this->userId = $userId; + $this->groupManager = $groupManager; + } + + /** + * @return TemplateResponse + * + * @NoCSRFRequired + * @NoAdminRequired + */ + public function help(string $mode = 'user'): TemplateResponse { + $this->navigationManager->setActiveEntry('help'); + + if(!isset($mode) || $mode !== 'admin') { + $mode = 'user'; + } + + $documentationUrl = $this->urlGenerator->getAbsoluteURL( + $this->urlGenerator->linkTo('core', 'doc/' . $mode . '/index.html') + ); + + $urlUserDocs = $this->urlGenerator->linkToRoute('settings.Help.help', ['mode' => 'user']); + $urlAdminDocs = $this->urlGenerator->linkToRoute('settings.Help.help', ['mode' => 'admin']); + + $response = new TemplateResponse('settings', 'help', [ + 'admin' => $this->groupManager->isAdmin($this->userId), + 'url' => $documentationUrl, + 'urlUserDocs' => $urlUserDocs, + 'urlAdminDocs' => $urlAdminDocs, + 'mode' => $mode, + ]); + $policy = new ContentSecurityPolicy(); + $policy->addAllowedFrameDomain('\'self\''); + $response->setContentSecurityPolicy($policy); + return $response; + + } + +} -- cgit v1.2.3