Files
f7support/lib/Controller/PageController.php
T
root 866a64d413 f7support: опрос доски тикетов, скролл чата, непрочитанные
- Периодический опрос списка тикетов (tickets_poll_ms, по умолчанию 3 с), пока вкладка видима.

- Параметр конфига tickets_poll_ms (3000–120000 мс) и data-messages-poll-ms в шаблоне.

- Надёжный скролл вниз при открытии чата и после загрузки вложений.

- Учёт has_unread как true/1/"1"/"true" для индикатора на карточке.
2026-05-14 14:52:02 +03:00

77 lines
3.1 KiB
PHP

<?php
declare(strict_types=1);
namespace OCA\F7Support\Controller;
use OCP\AppFramework\Controller;
use OCP\AppFramework\Http\TemplateResponse;
use OCP\IConfig;
use OCP\IRequest;
use OCP\IURLGenerator;
use OCP\IUserSession;
use OCP\Util;
class PageController extends Controller {
public function __construct(
string $AppName,
IRequest $request,
private IUserSession $userSession,
private IURLGenerator $urlGenerator,
private IConfig $config,
) {
parent::__construct($AppName, $request);
}
/**
* @NoAdminRequired
* @NoCSRFRequired
*/
public function index(): TemplateResponse {
$user = $this->userSession->getUser();
$baseUrl = $this->urlGenerator->getBaseUrl();
$serverHost = parse_url($baseUrl, PHP_URL_HOST) ?: 'localhost';
// База REST API поддержки (без завершающего слэша). Переопределение: occ config:app:set f7support support_api_base --value=https://...
$supportApiBase = trim($this->config->getAppValue('f7support', 'support_api_base', 'https://support.f7cloud.ru'));
if ($supportApiBase === '') {
$supportApiBase = 'https://support.f7cloud.ru';
}
$supportParts = parse_url($supportApiBase);
$supportApiOrigin = ($supportParts['scheme'] ?? 'https') . '://' . ($supportParts['host'] ?? '');
// Optional full WebSocket URL prefix, e.g. wss://support.f7cloud.ru/api/ws (path before /tickets/{id})
$supportWsBase = $this->config->getAppValue('f7support', 'support_ws_base', '');
// Метки «прочитано» (POST …/read на API поддержки).
// Порядок деплоя: (1) выкатить бэкенд с маршрутами POST /api/client/tickets/{id}/read и POST /api/operator/tickets/{id}/read;
// (2) на Nextcloud: occ config:app:set f7support client_read_receipts --value=1 — тогда приложение f7support начнёт слать client /read;
// панель оператора вызывает operator /read независимо от этого флага. При client_read_receipts=0 клиент не дергает client /read (нет 404 на старом API).
// Отключить вызовы с клиента: occ config:app:set f7support client_read_receipts --value=0
$clientReadReceipts = $this->config->getAppValue('f7support', 'client_read_receipts', '0');
// Интервал опроса списка тикетов (мс), чтобы подтягивать has_unread без WebSocket. occ: f7support tickets_poll_ms
$ticketsPollMs = (int)$this->config->getAppValue('f7support', 'tickets_poll_ms', '3000');
if ($ticketsPollMs < 3000) {
$ticketsPollMs = 3000;
}
if ($ticketsPollMs > 120000) {
$ticketsPollMs = 120000;
}
Util::addStyle('f7support', 'f7support');
Util::addScript('f7support', 'main');
return new TemplateResponse('f7support', 'main', [
'username' => $user ? $user->getUID() : '',
'serverAddress' => $serverHost,
'supportApiBase' => $supportApiBase,
'supportApiOrigin' => $supportApiOrigin,
'supportWsBase' => $supportWsBase,
'clientReadReceipts' => $clientReadReceipts,
'ticketsPollMs' => (string)$ticketsPollMs,
]);
}
}