mirror of
https://github.com/nextcloud/server.git
synced 2025-01-30 22:37:01 +00:00
91 lines
2.8 KiB
PHP
91 lines
2.8 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: 2019 Nextcloud GmbH and Nextcloud contributors
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
namespace OCA\Settings\Controller;
|
|
|
|
use OCP\AppFramework\Controller;
|
|
use OCP\AppFramework\Http\Attribute\NoAdminRequired;
|
|
use OCP\AppFramework\Http\Attribute\NoCSRFRequired;
|
|
use OCP\AppFramework\Http\Attribute\OpenAPI;
|
|
use OCP\AppFramework\Http\ContentSecurityPolicy;
|
|
use OCP\AppFramework\Http\TemplateResponse;
|
|
use OCP\IAppConfig;
|
|
use OCP\IConfig;
|
|
use OCP\IGroupManager;
|
|
use OCP\IL10N;
|
|
use OCP\INavigationManager;
|
|
use OCP\IRequest;
|
|
use OCP\IURLGenerator;
|
|
|
|
#[OpenAPI(scope: OpenAPI::SCOPE_IGNORE)]
|
|
class HelpController extends Controller {
|
|
|
|
public function __construct(
|
|
string $appName,
|
|
IRequest $request,
|
|
private INavigationManager $navigationManager,
|
|
private IURLGenerator $urlGenerator,
|
|
/** @var string */
|
|
private ?string $userId,
|
|
private IGroupManager $groupManager,
|
|
private IL10N $l10n,
|
|
private IConfig $config,
|
|
private IAppConfig $appConfig,
|
|
) {
|
|
parent::__construct($appName, $request);
|
|
}
|
|
|
|
/**
|
|
* @return TemplateResponse
|
|
*
|
|
* @NoSubAdminRequired
|
|
*/
|
|
#[NoCSRFRequired]
|
|
#[NoAdminRequired]
|
|
public function help(string $mode = 'user'): TemplateResponse {
|
|
$this->navigationManager->setActiveEntry('help');
|
|
$pageTitle = $this->l10n->t('Administrator documentation');
|
|
if ($mode !== 'admin') {
|
|
$pageTitle = $this->l10n->t('User documentation');
|
|
$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']);
|
|
|
|
$knowledgebaseEmbedded = $this->config->getSystemValueBool('knowledgebase.embedded', false);
|
|
if (!$knowledgebaseEmbedded) {
|
|
$pageTitle = $this->l10n->t('Nextcloud help overview');
|
|
$urlUserDocs = $this->urlGenerator->linkToDocs('user');
|
|
$urlAdminDocs = $this->urlGenerator->linkToDocs('admin');
|
|
}
|
|
|
|
$legalNoticeUrl = $this->appConfig->getValueString('theming', 'imprintUrl');
|
|
$privacyUrl = $this->appConfig->getValueString('theming', 'privacyUrl');
|
|
|
|
$response = new TemplateResponse('settings', 'help', [
|
|
'admin' => $this->groupManager->isAdmin($this->userId),
|
|
'url' => $documentationUrl,
|
|
'urlUserDocs' => $urlUserDocs,
|
|
'urlAdminDocs' => $urlAdminDocs,
|
|
'mode' => $mode,
|
|
'pageTitle' => $pageTitle,
|
|
'knowledgebaseEmbedded' => $knowledgebaseEmbedded,
|
|
'legalNoticeUrl' => $legalNoticeUrl,
|
|
'privacyUrl' => $privacyUrl,
|
|
]);
|
|
$policy = new ContentSecurityPolicy();
|
|
$policy->addAllowedFrameDomain('\'self\'');
|
|
$response->setContentSecurityPolicy($policy);
|
|
return $response;
|
|
}
|
|
}
|