* * @author Arthur Schiwon * @author Daniel Kesselberg * @author Joas Schilling * @author Julius Härtl * @author Roeland Jago Douma * * @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 . * */ 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; class HelpController extends Controller { /** @var INavigationManager */ private $navigationManager; /** @var IURLGenerator */ 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 * @NoSubAdminRequired */ public function help(string $mode = 'user'): TemplateResponse { $this->navigationManager->setActiveEntry('help'); if ($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; } }