From 8a3bef5a3474dff6ad6ccb77ceefd904cdcaebef Mon Sep 17 00:00:00 2001 From: Sven Wappler Date: Mon, 10 Aug 2026 22:31:34 +0200 Subject: [PATCH] TYPO3 v15 dev-main snapshot () --- .gitignore | 1 + .../ContentStatisticsController.php | 87 +++++ .../Controller/RecordStatisticsController.php | 68 ++++ Classes/Controller/StatusReportController.php | 84 +++++ Classes/ExtendedStatusProviderInterface.php | 29 ++ Classes/Integrity/DatabaseIntegrityCheck.php | 215 +++++++++++ Classes/Registry/StatusRegistry.php | 54 +++ Classes/Report/Status/ConfigurationStatus.php | 356 ++++++++++++++++++ Classes/Report/Status/FalStatus.php | 254 +++++++++++++ .../Report/Status/ImageProcessingStatus.php | 111 ++++++ Classes/Report/Status/SecurityStatus.php | 247 ++++++++++++ Classes/Report/Status/SystemStatus.php | 95 +++++ Classes/Report/Status/Typo3Status.php | 94 +++++ Classes/Report/WarningsForAboutModule.php | 73 ++++ .../RequestAwareStatusProviderInterface.php | 34 ++ Classes/Service/ContentStatisticsService.php | 184 +++++++++ Classes/Service/RecordStatisticsService.php | 161 ++++++++ Classes/Service/StatusService.php | 190 ++++++++++ Classes/Status.php | 108 ++++++ Classes/StatusProviderInterface.php | 34 ++ Classes/Task/SystemStatusUpdateTask.php | 164 ++++++++ Configuration/Backend/Modules.php | 60 +++ Configuration/Services.php | 12 + Configuration/Services.yaml | 14 + .../scheduler_system_status_update_task.php | 57 +++ .../Api/ExtendedStatusProviderInterface.rst | 13 + Documentation/Api/Index.rst | 16 + .../RequestAwareStatusProviderInterface.rst | 13 + Documentation/Api/StatusProviderInterface.rst | 32 ++ .../ExtendedStatusProviderInterface.rst.txt | 10 + ...equestAwareStatusProviderInterface.rst.txt | 19 + .../Generated/StatusProviderInterface.rst.txt | 18 + .../CodeSnippets/Manual/Autoconfigure.rst.txt | 6 + Documentation/CodeSnippets/codesnippets.php | 25 ++ Documentation/CustomReports/Index.rst | 108 ++++++ Documentation/Images/InstallActivate.png | Bin 0 -> 13486 bytes Documentation/Images/ModuleReports.png | Bin 0 -> 43914 bytes Documentation/Images/RecordStatistics.png | Bin 0 -> 40367 bytes Documentation/Images/SchedulerTask.png | Bin 0 -> 12507 bytes Documentation/Images/Security.png | Bin 0 -> 48430 bytes Documentation/Includes.rst.txt | 1 + Documentation/Index.rst | 85 +++++ Documentation/Installation/Index.rst | 56 +++ Documentation/Introduction/Index.rst | 69 ++++ Documentation/Scheduler/Index.rst | 45 +++ Documentation/Sitemap.rst | 11 + Documentation/guides.xml | 21 ++ LICENSE.txt | 339 +++++++++++++++++ README.rst | 11 + .../Private/Language/Modules/overview.xlf | 17 + .../Private/Language/Modules/statistics.xlf | 53 +++ Resources/Private/Language/Modules/status.xlf | 17 + Resources/Private/Language/locallang.xlf | 86 +++++ .../Private/Language/locallang_reports.xlf | 260 +++++++++++++ .../Templates/ContentStatistics.fluid.html | 113 ++++++ .../ContentStatisticsDetail.fluid.html | 174 +++++++++ .../Private/Templates/Email/Report.fluid.txt | 2 + .../Templates/RecordStatistics.fluid.html | 98 +++++ .../Private/Templates/StatusReport.fluid.html | 40 ++ Resources/Public/Icons/Extension.png | Bin 0 -> 733 bytes composer.json | 59 +++ 61 files changed, 4603 insertions(+) create mode 100644 .gitignore create mode 100644 Classes/Controller/ContentStatisticsController.php create mode 100644 Classes/Controller/RecordStatisticsController.php create mode 100644 Classes/Controller/StatusReportController.php create mode 100644 Classes/ExtendedStatusProviderInterface.php create mode 100644 Classes/Integrity/DatabaseIntegrityCheck.php create mode 100644 Classes/Registry/StatusRegistry.php create mode 100644 Classes/Report/Status/ConfigurationStatus.php create mode 100644 Classes/Report/Status/FalStatus.php create mode 100644 Classes/Report/Status/ImageProcessingStatus.php create mode 100644 Classes/Report/Status/SecurityStatus.php create mode 100644 Classes/Report/Status/SystemStatus.php create mode 100644 Classes/Report/Status/Typo3Status.php create mode 100644 Classes/Report/WarningsForAboutModule.php create mode 100644 Classes/RequestAwareStatusProviderInterface.php create mode 100644 Classes/Service/ContentStatisticsService.php create mode 100644 Classes/Service/RecordStatisticsService.php create mode 100644 Classes/Service/StatusService.php create mode 100644 Classes/Status.php create mode 100644 Classes/StatusProviderInterface.php create mode 100644 Classes/Task/SystemStatusUpdateTask.php create mode 100644 Configuration/Backend/Modules.php create mode 100644 Configuration/Services.php create mode 100644 Configuration/Services.yaml create mode 100644 Configuration/TCA/Overrides/scheduler_system_status_update_task.php create mode 100644 Documentation/Api/ExtendedStatusProviderInterface.rst create mode 100644 Documentation/Api/Index.rst create mode 100644 Documentation/Api/RequestAwareStatusProviderInterface.rst create mode 100644 Documentation/Api/StatusProviderInterface.rst create mode 100644 Documentation/CodeSnippets/Generated/ExtendedStatusProviderInterface.rst.txt create mode 100644 Documentation/CodeSnippets/Generated/RequestAwareStatusProviderInterface.rst.txt create mode 100644 Documentation/CodeSnippets/Generated/StatusProviderInterface.rst.txt create mode 100644 Documentation/CodeSnippets/Manual/Autoconfigure.rst.txt create mode 100644 Documentation/CodeSnippets/codesnippets.php create mode 100644 Documentation/CustomReports/Index.rst create mode 100644 Documentation/Images/InstallActivate.png create mode 100644 Documentation/Images/ModuleReports.png create mode 100644 Documentation/Images/RecordStatistics.png create mode 100644 Documentation/Images/SchedulerTask.png create mode 100644 Documentation/Images/Security.png create mode 100644 Documentation/Includes.rst.txt create mode 100644 Documentation/Index.rst create mode 100644 Documentation/Installation/Index.rst create mode 100644 Documentation/Introduction/Index.rst create mode 100644 Documentation/Scheduler/Index.rst create mode 100644 Documentation/Sitemap.rst create mode 100644 Documentation/guides.xml create mode 100644 LICENSE.txt create mode 100644 README.rst create mode 100644 Resources/Private/Language/Modules/overview.xlf create mode 100644 Resources/Private/Language/Modules/statistics.xlf create mode 100644 Resources/Private/Language/Modules/status.xlf create mode 100644 Resources/Private/Language/locallang.xlf create mode 100644 Resources/Private/Language/locallang_reports.xlf create mode 100644 Resources/Private/Templates/ContentStatistics.fluid.html create mode 100644 Resources/Private/Templates/ContentStatisticsDetail.fluid.html create mode 100644 Resources/Private/Templates/Email/Report.fluid.txt create mode 100644 Resources/Private/Templates/RecordStatistics.fluid.html create mode 100644 Resources/Private/Templates/StatusReport.fluid.html create mode 100644 Resources/Public/Icons/Extension.png create mode 100644 composer.json diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..57872d0 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +/vendor/ diff --git a/Classes/Controller/ContentStatisticsController.php b/Classes/Controller/ContentStatisticsController.php new file mode 100644 index 0000000..49ae6af --- /dev/null +++ b/Classes/Controller/ContentStatisticsController.php @@ -0,0 +1,87 @@ +getLanguageService(); + $view = $this->moduleTemplateFactory->create($request); + $view->setLayout(ModuleLayout::NORMAL); + $view->setTitle( + $languageService->sL('reports.messages:mlang_tabs_tab'), + $languageService->sL('reports.messages:contentStatistics.title') + ); + $view->makeDocHeaderModuleMenu(); + + $buttonBar = $view->getDocHeaderComponent()->getButtonBar(); + + $cType = $request->getQueryParams()['ctype'] ?? ''; + if ($this->contentStatisticsService->isValidCtype($cType)) { + $backButton = $this->componentFactory->createBackButton((string)$this->uriBuilder->buildUriFromRoute('system_reports_contentstatistics')); + $buttonBar->addButton($backButton); + + $shortcutButton = $this->componentFactory->createShortcutButton() + ->setRouteIdentifier('system_reports_contentstatistics') + ->setArguments(['ctype' => $cType]) + ->setDisplayName($languageService->sL('reports.messages:contentStatistics.title')); + $buttonBar->addButton($shortcutButton, ButtonBar::BUTTON_POSITION_RIGHT); + + return $view->assignMultiple( + $this->contentStatisticsService->collectStatisticForCtype($cType, (int)($request->getQueryParams()['page'] ?? 1)), + )->renderResponse('ContentStatisticsDetail'); + } + + $shortcutButton = $this->componentFactory->createShortcutButton() + ->setRouteIdentifier('system_reports_contentstatistics') + ->setDisplayName($languageService->sL('reports.messages:contentStatistics.title')); + $buttonBar->addButton($shortcutButton, ButtonBar::BUTTON_POSITION_RIGHT); + + return $view->assignMultiple([ + 'data' => $this->contentStatisticsService->collectStatistic(), + ])->renderResponse('ContentStatistics'); + } + + private function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Controller/RecordStatisticsController.php b/Classes/Controller/RecordStatisticsController.php new file mode 100644 index 0000000..37e29af --- /dev/null +++ b/Classes/Controller/RecordStatisticsController.php @@ -0,0 +1,68 @@ +getLanguageService(); + $view = $this->moduleTemplateFactory->create($request); + $view->setLayout(ModuleLayout::NORMAL); + $view->setTitle( + $languageService->translate('title', 'reports.modules.overview'), + $languageService->translate('title', 'reports.modules.statistics') + ); + $view->makeDocHeaderModuleMenu(); + $view->getDocHeaderComponent()->setShortcutContext( + 'system_reports_statistics', + $languageService->translate('title', 'reports.modules.statistics') + ); + + return $view->assignMultiple([ + 'pages' => $this->recordStatisticsService->collectPageStatistics(), + 'doktypes' => $this->recordStatisticsService->collectDoktypeStatistics(), + 'tables' => $this->recordStatisticsService->collectTableStatistics(), + ])->renderResponse('RecordStatistics'); + } + + private function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Controller/StatusReportController.php b/Classes/Controller/StatusReportController.php new file mode 100644 index 0000000..9e9ccf8 --- /dev/null +++ b/Classes/Controller/StatusReportController.php @@ -0,0 +1,84 @@ +statusService->getSystemStatus($request); + $this->statusService->collectAndStoreSystemStatus($request); + + // Apply sorting to collection and the providers + $statusCollection = $this->statusService->sortStatusProviders($statusCollection); + foreach ($statusCollection as &$statuses) { + $statuses = $this->statusService->sortStatuses($statuses); + } + unset($statuses); + + $languageService = $this->getLanguageService(); + $view = $this->moduleTemplateFactory->create($request); + $view->setLayout(ModuleLayout::NORMAL); + $view->setTitle( + $languageService->translate('title', 'reports.modules.overview'), + $languageService->translate('title', 'reports.modules.status') + ); + $view->makeDocHeaderModuleMenu(); + $view->getDocHeaderComponent()->setShortcutContext( + 'system_reports_status', + $languageService->translate('title', 'reports.modules.status') + ); + + return $view->assignMultiple([ + 'statusCollection' => $statusCollection, + 'severityIconMapping' => [ + ContextualFeedbackSeverity::NOTICE->value => 'actions-info', + ContextualFeedbackSeverity::INFO->value => 'actions-info', + ContextualFeedbackSeverity::OK->value => 'actions-check', + ContextualFeedbackSeverity::WARNING->value => 'actions-exclamation', + ContextualFeedbackSeverity::ERROR->value => 'actions-exclamation', + ], + ])->renderResponse('StatusReport'); + } + + private function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/ExtendedStatusProviderInterface.php b/Classes/ExtendedStatusProviderInterface.php new file mode 100644 index 0000000..134d6dc --- /dev/null +++ b/Classes/ExtendedStatusProviderInterface.php @@ -0,0 +1,29 @@ + [], + 'published_versions' => [], + 'deleted' => [], + ]; + + protected array $lRecords = []; + + public function __construct( + protected readonly TcaSchemaFactory $tcaSchemaFactory, + protected readonly ConnectionPool $connectionPool, + ) {} + + /** + * Generates a list of Page-uid's that corresponds to the tables in the tree. + * This list should ideally include all records in the pages-table. + * + * @param int $theID a pid (page-record id) from which to start making the tree + * @param bool $versions Internal variable, don't set from outside! + */ + public function genTree(int $theID, bool $versions = false): void + { + $queryBuilder = $this->connectionPool->getQueryBuilderForTable('pages'); + $queryBuilder->getRestrictions()->removeAll(); + $queryBuilder->select('uid', 'title', 'doktype', 'deleted', 'hidden', 'sys_language_uid') + ->from('pages') + ->orderBy('sorting'); + if ($versions) { + $queryBuilder->addSelect('t3ver_wsid'); + $queryBuilder->where( + $queryBuilder->expr()->eq('t3ver_oid', $queryBuilder->createNamedParameter($theID, Connection::PARAM_INT)) + ); + } else { + $queryBuilder->where( + $queryBuilder->expr()->eq('pid', $queryBuilder->createNamedParameter($theID, Connection::PARAM_INT)) + ); + } + $result = $queryBuilder->executeQuery(); + // Traverse the records selected + while ($row = $result->fetchAssociative()) { + $newID = $row['uid']; + // Register various data for this item: + if ($row['language_tag'] === 0) { + $this->pageIdArray[$newID] = $row; + } else { + $this->pageTranslatedPageIDArray[$newID] = $row; + } + $this->recStats['all_valid']['pages'][$newID] = $newID; + if ($row['deleted']) { + $this->recStats['deleted']['pages'][$newID] = $newID; + } + + if (!isset($this->recStats['hidden'])) { + $this->recStats['hidden'] = 0; + } + + if ($row['hidden']) { + $this->recStats['hidden']++; + } + + $this->recStats['doktype'][$row['doktype']] ??= 0; + $this->recStats['doktype'][$row['doktype']]++; + // Add sub pages: + $this->genTree($newID); + // If versions are included in the tree, add those now: + $this->genTree($newID, true); + } + } + + /** + * Fills $this->lRecords with the records from all tc-tables that are not attached to a PID in the pid-list. + * + * @param array $pageIds list of pid's (page-record uid's). This list is probably made by genTree() + */ + public function lostRecords(array $pageIds): array + { + /** @var TcaSchema $schema */ + foreach ($this->tcaSchemaFactory->all() as $table => $schema) { + $queryBuilder = $this->connectionPool->getQueryBuilderForTable($table); + $queryBuilder->getRestrictions()->removeAll(); + $queryResult = $queryBuilder + ->select('*') + ->from($table) + ->where( + $queryBuilder->expr()->notIn( + 'pid', + $queryBuilder->createNamedParameter($pageIds, Connection::PARAM_INT_ARRAY) + ) + ) + ->executeQuery(); + while ($row = $queryResult->fetchAssociative()) { + $recordId = (int)$row['uid']; + $this->lRecords[$table][$recordId] = [ + 'uid' => $recordId, + 'pid' => $row['pid'], + 'title' => strip_tags(BackendUtility::getRecordTitle($table, $row)), + ]; + } + } + return $this->lRecords; + } + + /** + * Counts records from $GLOBALS['TCA']-tables that ARE attached to an existing page. + * + * @param array $pageIds list of pid's (page-record uid's). This list is probably made by genTree() + * @return array an array with the number of records from all $GLOBALS['TCA']-tables that are attached to a PID in the pid-list. + */ + public function countRecords(array $pageIds): array + { + $list = []; + $list_n = []; + /** @var TcaSchema $schema */ + foreach ($this->tcaSchemaFactory->all() as $table => $schema) { + $pageIdsForTable = $pageIds; + $queryBuilder = $this->connectionPool->getQueryBuilderForTable($table); + $queryBuilder->getRestrictions()->removeAll(); + $count = $queryBuilder->count('uid') + ->from($table) + ->where( + $queryBuilder->expr()->in( + 'pid', + $queryBuilder->createNamedParameter($pageIds, Connection::PARAM_INT_ARRAY) + ) + ) + ->executeQuery() + ->fetchOne(); + if ($count) { + $list[$table] = $count; + } + + // same query excluding all deleted records + $queryBuilder = $this->connectionPool->getQueryBuilderForTable($table); + $queryBuilder->getRestrictions() + ->removeAll() + ->add(GeneralUtility::makeInstance(DeletedRestriction::class)); + $count = $queryBuilder->count('uid') + ->from($table) + ->where( + $queryBuilder->expr()->in( + 'pid', + $queryBuilder->createNamedParameter($pageIdsForTable, Connection::PARAM_INT_ARRAY) + ) + ) + ->executeQuery() + ->fetchOne(); + if ($count) { + $list_n[$table] = $count; + } + } + return ['all' => $list, 'non_deleted' => $list_n]; + } + + public function getPageIdArray(): array + { + return $this->pageIdArray; + } + + public function getPageTranslatedPageIDArray(): array + { + return $this->pageTranslatedPageIDArray; + } + + public function getRecStats(): array + { + return $this->recStats; + } +} diff --git a/Classes/Registry/StatusRegistry.php b/Classes/Registry/StatusRegistry.php new file mode 100644 index 0000000..3d6aa31 --- /dev/null +++ b/Classes/Registry/StatusRegistry.php @@ -0,0 +1,54 @@ + $providers + */ + public function __construct(iterable $providers) + { + foreach ($providers as $item) { + $this->providers[] = $item; + } + } + + /** + * Get all registered status providers + * + * @return StatusProviderInterface[] + */ + public function getProviders(): array + { + return $this->providers; + } +} diff --git a/Classes/Report/Status/ConfigurationStatus.php b/Classes/Report/Status/ConfigurationStatus.php new file mode 100644 index 0000000..b89f9e1 --- /dev/null +++ b/Classes/Report/Status/ConfigurationStatus.php @@ -0,0 +1,356 @@ + $this->getReferenceIndexStatus(), + ]; + if ($this->isMemcachedUsed()) { + $statuses['memcachedConnection'] = $this->getMemcachedConnectionStatus(); + } + if (!Environment::isWindows()) { + $statuses['createdFilesWorldWritable'] = $this->getCreatedFilesWorldWritableStatus(); + $statuses['createdDirectoriesWorldWritable'] = $this->getCreatedDirectoriesWorldWritableStatus(); + } + if ($this->isMysqlUsed()) { + $statuses['mysqlDatabaseUsesUtf8'] = $this->getMysqlDatabaseUtf8Status(); + } + return $statuses; + } + + public function getLabel(): string + { + return 'configuration'; + } + + /** + * Checks if sys_refindex is empty. + * + * @return \TYPO3\CMS\Reports\Status An object representing whether the reference index is empty or not + */ + protected function getReferenceIndexStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + + $queryBuilder = $this->connectionPool->getQueryBuilderForTable('sys_refindex'); + $count = $queryBuilder + ->count('*') + ->from('sys_refindex') + ->executeQuery() + ->fetchOne(); + + $lastRefIndexUpdate = $this->registry->get('core', 'sys_refindex_lastUpdate'); + + if (!$count && $lastRefIndexUpdate) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_empty'); + $severity = ContextualFeedbackSeverity::WARNING; + $url = (string)$this->uriBuilder->buildUriFromRoute('system_maintenance'); + $message = sprintf($this->getLanguageService()->sL('LLL:EXT:core/Resources/Private/Language/locallang_core.xlf:warning.backend_reference_index'), '', '', BackendUtility::datetime($lastRefIndexUpdate)); + } + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_referenceIndex'), $value, $message, $severity); + } + + /** + * Checks whether memcached is configured, if that's the case we assume it's also used. + * + * @return bool TRUE if memcached is used, FALSE otherwise. + */ + protected function isMemcachedUsed(): bool + { + $memcachedUsed = false; + $memcachedServers = $this->getConfiguredMemcachedServers(); + if (!empty($memcachedServers)) { + $memcachedUsed = true; + } + return $memcachedUsed; + } + + /** + * Gets the configured memcached server connections. + * + * @return array An array of configured memcached server connections. + */ + protected function getConfiguredMemcachedServers(): array + { + $configurations = $GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations'] ?? []; + $memcachedServers = []; + foreach ($configurations as $table => $conf) { + if (is_array($conf)) { + foreach ($conf as $value) { + if ($value === MemcachedBackend::class && is_array($configurations[$table]['options']['servers'])) { + $memcachedServers = $configurations[$table]['options']['servers']; + break; + } + } + } + } + return $memcachedServers; + } + + /** + * Checks whether TYPO3 can connect to the configured memcached servers. + * + * @return \TYPO3\CMS\Reports\Status An object representing whether TYPO3 can connect to the configured memcached servers + */ + protected function getMemcachedConnectionStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + $failedConnections = []; + $defaultMemcachedPort = ini_get('memcache.default_port'); + $defaultMemcachedPort = MathUtility::canBeInterpretedAsInteger($defaultMemcachedPort) ? (int)$defaultMemcachedPort : 11211; + $memcachedServers = $this->getConfiguredMemcachedServers(); + if (function_exists('memcache_connect') && $memcachedServers !== []) { + foreach ($memcachedServers as $testServer) { + $configuredServer = $testServer; + if (str_starts_with($testServer, 'unix://')) { + $host = $testServer; + $port = 0; + } else { + if (str_starts_with($testServer, 'tcp://')) { + $testServer = substr($testServer, 6); + } + if (str_contains($testServer, ':')) { + [$host, $port] = explode(':', $testServer, 2); + $port = (int)$port; + } else { + $host = $testServer; + $port = $defaultMemcachedPort; + } + } + $memcachedConnection = @memcache_connect($host, $port); + if ($memcachedConnection != null) { + @memcache_close($memcachedConnection); + } else { + $failedConnections[] = $configuredServer; + } + } + } + if (!empty($failedConnections)) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_connectionFailed'); + $severity = ContextualFeedbackSeverity::WARNING; + $message = $this->getLanguageService()->sL('LLL:EXT:core/Resources/Private/Language/locallang_core.xlf:warning.memcache_not_usable') . '

'; + } + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_memcachedConfiguration'), $value, $message, $severity); + } + + /** + * Warning, if fileCreateMask has write bit for 'others' set. + * + * @return \TYPO3\CMS\Reports\Status The writable status for 'others' + */ + protected function getCreatedFilesWorldWritableStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + if ((int)$GLOBALS['TYPO3_CONF_VARS']['SYS']['fileCreateMask'] % 10 & 2) { + $value = $GLOBALS['TYPO3_CONF_VARS']['SYS']['fileCreateMask']; + $severity = ContextualFeedbackSeverity::WARNING; + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_CreatedFilePermissions.writable'); + } + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_CreatedFilePermissions'), $value, $message, $severity); + } + + /** + * Warning, if folderCreateMask has write bit for 'others' set. + * + * @return \TYPO3\CMS\Reports\Status The writable status for 'others' + */ + protected function getCreatedDirectoriesWorldWritableStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + if ((int)$GLOBALS['TYPO3_CONF_VARS']['SYS']['folderCreateMask'] % 10 & 2) { + $value = $GLOBALS['TYPO3_CONF_VARS']['SYS']['folderCreateMask']; + $severity = ContextualFeedbackSeverity::WARNING; + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_CreatedDirectoryPermissions.writable'); + } + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_CreatedDirectoryPermissions'), $value, $message, $severity); + } + + /** + * Checks if the default connection is a MySQL compatible database instance. + */ + protected function isMysqlUsed(): bool + { + $platform = $this->connectionPool + ->getConnectionByName(ConnectionPool::DEFAULT_CONNECTION_NAME) + ->getDatabasePlatform(); + + return $platform instanceof DoctrineMariaDBPlatform || $platform instanceof DoctrineMySQLPlatform; + } + + /** + * Checks the character set of the default database and reports an error if it is not utf-8. + */ + protected function getMysqlDatabaseUtf8Status(): ReportStatus + { + $collationConstraint = null; + $charset = ''; + $connection = $this->connectionPool + ->getConnectionByName(ConnectionPool::DEFAULT_CONNECTION_NAME); + $connectionParams = $connection->getParams(); + $queryBuilder = $connection->createQueryBuilder(); + $defaultDatabaseCharset = (string)$queryBuilder->select('DEFAULT_CHARACTER_SET_NAME') + ->from('information_schema.SCHEMATA') + ->where( + $queryBuilder->expr()->eq( + 'SCHEMA_NAME', + $queryBuilder->createNamedParameter($connection->getDatabase()) + ) + ) + ->setMaxResults(1) + ->executeQuery() + ->fetchOne(); + + $severity = ContextualFeedbackSeverity::OK; + $statusValue = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + // also allow utf8mb3 and utf8mb4 + if (!str_starts_with($defaultDatabaseCharset, 'utf8')) { + // If the default character set is e.g. latin1, BUT all tables in the system are UTF-8, + // we assume that TYPO3 has the correct charset for adding tables, and everything is fine + $queryBuilder = $connection->createQueryBuilder(); + $nonUtf8TableCollationsFound = $queryBuilder->select('table_collation') + ->from('information_schema.tables') + ->where( + $queryBuilder->expr()->and( + $queryBuilder->expr()->eq('table_schema', $queryBuilder->quote((string)$connection->getDatabase())), + $queryBuilder->expr()->notLike('table_collation', $queryBuilder->quote('utf8%')) + ) + ) + ->setMaxResults(1) + ->executeQuery(); + + if ($nonUtf8TableCollationsFound->rowCount() > 0) { + $message = sprintf($this->getLanguageService() + ->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_MysqlDatabaseCharacterSet_Unsupported'), $defaultDatabaseCharset); + $severity = ContextualFeedbackSeverity::ERROR; + $statusValue = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_wrongValue'); + } else { + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_MysqlDatabaseCharacterSet_Info'); + $severity = ContextualFeedbackSeverity::INFO; + $statusValue = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_info'); + } + } elseif (isset($connectionParams['defaultTableOptions'])) { + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_MysqlDatabaseCharacterSet_Ok'); + + $tableOptions = $connectionParams['defaultTableOptions']; + if (isset($tableOptions['collation'])) { + $collationConstraint = $queryBuilder->expr()->neq('table_collation', $queryBuilder->quote($tableOptions['collation'])); + $charset = $tableOptions['collation']; + } elseif (isset($tableOptions['charset'])) { + $collationConstraint = $queryBuilder->expr()->notLike('table_collation', $queryBuilder->quote($tableOptions['charset'] . '%')); + $charset = $tableOptions['charset']; + } + + if (isset($collationConstraint)) { + $queryBuilder = $connection->createQueryBuilder(); + $wrongCollationTablesFound = $queryBuilder->select('table_collation') + ->from('information_schema.tables') + ->where( + $queryBuilder->expr()->and( + $queryBuilder->expr()->eq('table_schema', $queryBuilder->quote($connection->getDatabase())), + $collationConstraint + ) + ) + ->setMaxResults(1) + ->executeQuery(); + + if ($wrongCollationTablesFound->rowCount() > 0) { + $message = sprintf($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_MysqlDatabaseCharacterSet_MixedCollations'), $charset); + $severity = ContextualFeedbackSeverity::ERROR; + $statusValue = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_checkFailed'); + } else { + if (isset($tableOptions['collation'])) { + $collationConstraint = $queryBuilder->expr()->neq('collation_name', $queryBuilder->quote($tableOptions['collation'])); + } elseif (isset($tableOptions['charset'])) { + $collationConstraint = $queryBuilder->expr()->notLike('collation_name', $queryBuilder->quote($tableOptions['charset'] . '%')); + } + + $queryBuilder = $connection->createQueryBuilder(); + $wrongCollationColumnsFound = $queryBuilder->select('collation_name') + ->from('information_schema.columns') + ->where( + $queryBuilder->expr()->and( + $queryBuilder->expr()->eq('table_schema', $queryBuilder->quote($connection->getDatabase())), + $collationConstraint + ) + ) + ->setMaxResults(1) + ->executeQuery(); + + if ($wrongCollationColumnsFound->rowCount() > 0) { + $message = sprintf($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_MysqlDatabaseCharacterSet_MixedCollations'), $charset); + $severity = ContextualFeedbackSeverity::ERROR; + $statusValue = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_checkFailed'); + } + } + } + } else { + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_MysqlDatabaseCharacterSet_Ok'); + } + + return new ReportStatus( + $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_MysqlDatabaseCharacterSet'), + $statusValue, + $message, + $severity + ); + } + + protected function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Report/Status/FalStatus.php b/Classes/Report/Status/FalStatus.php new file mode 100644 index 0000000..692cd57 --- /dev/null +++ b/Classes/Report/Status/FalStatus.php @@ -0,0 +1,254 @@ + $this->getMissingFilesStatus(), + 'ConsistencyCheck' => $this->getConsistencyCheckStatus(), + ]; + } + + public function getDetailedStatus(): array + { + return [ + 'ConsistencyCheck' => $this->getConsistencyCheckStatus(), + ]; + } + + public function getLabel(): string + { + return 'fal'; + } + + /** + * Checks if there are files marked as missed. + * + * @return \TYPO3\CMS\Reports\Status An object representing whether there are files marked as missed or not + */ + protected function getMissingFilesStatus() + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_none'); + $count = 0; + $maxFilesToShow = 100; + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + + $storages = $this->getBrowsableStorages(); + if (!empty($storages)) { + $queryBuilder = $this->connectionPool->getQueryBuilderForTable('sys_file'); + $count = $queryBuilder + ->count('*') + ->from('sys_file') + ->where( + $queryBuilder->expr()->eq( + 'missing', + $queryBuilder->createNamedParameter(1, Connection::PARAM_INT) + ), + $queryBuilder->expr()->in( + 'storage', + $queryBuilder->createNamedParameter(array_keys($storages), Connection::PARAM_INT_ARRAY) + ) + ) + ->executeQuery() + ->fetchOne(); + } + + if ($count) { + $value = sprintf($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_missingFilesCount'), $count); + $severity = ContextualFeedbackSeverity::WARNING; + + $queryBuilder = $this->connectionPool->getQueryBuilderForTable('sys_file'); + $files = $queryBuilder + ->select('identifier', 'storage') + ->from('sys_file') + ->where( + $queryBuilder->expr()->eq( + 'missing', + $queryBuilder->createNamedParameter(1, Connection::PARAM_INT) + ), + $queryBuilder->expr()->in( + 'storage', + $queryBuilder->createNamedParameter(array_keys($storages), Connection::PARAM_INT_ARRAY) + ) + ) + ->setMaxResults($maxFilesToShow) + ->executeQuery() + ->fetchAllAssociative(); + + $message = '

' . $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_missingFilesMessage') . '

'; + foreach ($files as $file) { + $message .= $storages[$file['storage']]->getName() . ' ' . $file['identifier'] . '
'; + } + + if ($count > $maxFilesToShow) { + $message .= '...
'; + } + } + + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_missingFiles'), $value, $message, $severity); + } + + protected function getConsistencyCheckStatus(): ReportStatus + { + // @todo for performance reasons, consider using this only in CLI context as `ExtendedStatusProviderInterface` + + $storages = $this->getBrowsableStorages(); + $inconsistenciesMessage = ''; + foreach ($storages as $storage) { + $inconsistencies = $this->checkFolderConsistency($storage->getRootLevelFolder()); + if ($inconsistencies !== []) { + $inconsistenciesMessage .= sprintf( + '
%s
%s', + htmlspecialchars(sprintf( + 'Storage "%s" (id:%d)', + $storage->getName(), + $storage->getUid() + )), + $this->wrapInHtmlUnorderedList($inconsistencies) + ); + } + } + if ($inconsistenciesMessage === '') { + return new ReportStatus( + 'Consistency check', + 'No inconsistencies found in these storages', + // make sure we have a list of strings (0… index) with `array_values` to ensure correct rendering + $this->wrapInHtmlUnorderedList(array_values(array_map( + static fn(ResourceStorage $storage): string => sprintf( + '%s (id: %d)', + $storage->getName(), + $storage->getUid() + ), + $storages, + ))), + ContextualFeedbackSeverity::OK, + ); + } + return new ReportStatus( + 'Consistency Status', + 'Inconsistent files have been found', + $inconsistenciesMessage, + ContextualFeedbackSeverity::ERROR, + ); + } + + private function checkFolderConsistency(FolderInterface $folder): array + { + $inconsistencies = []; + foreach ($folder->getFiles() as $file) { + if (!$file instanceof File) { + continue; + } + try { + $this->resourceConsistencyService->validate($file->getStorage(), $file); + } catch (ResultException $exception) { + $inconsistencies[$file->getCombinedIdentifier()] = $this->compileResultMessages( + $exception->messages, + $this->getLanguageService() + ); + } + } + foreach ($folder->getSubfolders() as $subFolder) { + $inconsistencies = [...$inconsistencies, ...$this->checkFolderConsistency($subFolder)]; + } + return $inconsistencies; + } + + /** + * @param list|array> $items + */ + protected function wrapInHtmlUnorderedList(array $items): string + { + if (array_is_list($items)) { + return sprintf( + '
    %s
', + implode('', array_map( + static fn(string $item): string => '
  • ' . htmlspecialchars($item) . '
    • ', + $items + )) + ); + } + return sprintf( + '
      %s
    ', + implode('', array_map( + fn(string $key, array $values): string => sprintf( + '
  • %s%s
    • ', + htmlspecialchars($key), + $this->wrapInHtmlUnorderedList($values) + ), + array_keys($items), + array_values($items) + )) + ); + } + + /** + * Filter available storages that are actually browsable + * + * @return array + */ + protected function getBrowsableStorages(): array + { + $storages = []; + foreach ($this->storageRepository->findAll() as $storageObject) { + if ($storageObject->isBrowsable()) { + $storages[$storageObject->getUid()] = $storageObject; + } + } + + return $storages; + } + + protected function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Report/Status/ImageProcessingStatus.php b/Classes/Report/Status/ImageProcessingStatus.php new file mode 100644 index 0000000..fa11199 --- /dev/null +++ b/Classes/Report/Status/ImageProcessingStatus.php @@ -0,0 +1,111 @@ + $this->getMissingFilesStatus('webp'), + 'avif' => $this->getMissingFilesStatus('avif'), + ]; + } + + public function getLabel(): string + { + return 'imageprocessing'; + } + + /** + * Checks if webp | avif support is activated, but webp | avif is not enabled in ImageMagick / GraphicsMagick + */ + protected function getMissingFilesStatus(string $fileFormat = 'webp'): Status + { + switch ($fileFormat) { + case 'avif': + $messageNotConfigured = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_avif_not_configured'; + $messageAvailable = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_avif_available'; + $messageNotAvailable = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_avif_not_available'; + $messageAvailableAndConfigured = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_avif_available_and_configured'; + $messageTitle = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_avif'; + break; + + case 'webp': + default: + $messageNotConfigured = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_webp_not_configured'; + $messageAvailable = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_webp_available'; + $messageNotAvailable = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_webp_not_available'; + $messageAvailableAndConfigured = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_webp_available_and_configured'; + $messageTitle = 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_webp'; + break; + } + + $imageProcessing = GeneralUtility::makeInstance(GraphicalFunctions::class); + if (!$imageProcessing->isProcessingEnabled()) { + $severity = ContextualFeedbackSeverity::INFO; + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_disabled'); + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_imageprocessing_disabled'); + // ImageMagick / GraphicsMagick is not enabled, all good + } elseif (!in_array($fileFormat, $imageProcessing->getImageFileExt(), true)) { + // webp | avif is not enabled in TYPO3's Configuration + $severity = ContextualFeedbackSeverity::INFO; + $message = $this->getLanguageService()->sL($messageNotConfigured); + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_disabled'); + // But ImageMagick can do it, maybe it could be activated + if ($imageProcessing->isConvertSupportAvailableForFormat(strtoupper($fileFormat))) { + $message = $this->getLanguageService()->sL($messageAvailable); + } + } elseif (!$imageProcessing->isConvertSupportAvailableForFormat(strtoupper($fileFormat))) { + // webp | avif is configured to be available, but ImageMagick/GraphicsMagick does not support this. + $severity = ContextualFeedbackSeverity::WARNING; + $message = $this->getLanguageService()->sL($messageNotAvailable); + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_enabled'); + } else { + // webp | avif is configured to be available, and ImageMagick/GraphicsMagick supports this. + $severity = ContextualFeedbackSeverity::OK; + $message = $this->getLanguageService()->sL($messageAvailableAndConfigured); + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_enabled'); + } + + return new Status( + $this->getLanguageService()->sL($messageTitle), + $value, + $message, + $severity + ); + } + + protected function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Report/Status/SecurityStatus.php b/Classes/Report/Status/SecurityStatus.php new file mode 100644 index 0000000..2d59d57 --- /dev/null +++ b/Classes/Report/Status/SecurityStatus.php @@ -0,0 +1,247 @@ + $this->getTrustedHostsPatternStatus(), + 'fileDenyPattern' => $this->getFileDenyPatternStatus(), + 'htaccessUpload' => $this->getHtaccessUploadStatus(), + 'exceptionHandler' => $this->getExceptionHandlerStatus(), + 'exportedFiles' => $this->getExportedFilesStatus(), + ]; + + if ($request !== null) { + $statuses['encryptedConnectionStatus'] = $this->getEncryptedConnectionStatus($request); + $lockSslStatus = $this->getLockSslStatus($request); + if ($lockSslStatus) { + $statuses['getLockSslStatus'] = $lockSslStatus; + } + } + + return $statuses; + } + + public function getLabel(): string + { + return 'security'; + } + + /** + * Checks if the current connection is encrypted (HTTPS) + */ + protected function getEncryptedConnectionStatus(ServerRequestInterface $request): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + + $normalizedParams = $request->getAttribute('normalizedParams'); + + if (!$normalizedParams->isHttps()) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_insecure'); + $severity = ContextualFeedbackSeverity::WARNING; + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_encryptedConnectionStatus_insecure'); + } + + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_encryptedConnectionStatus'), $value, $message, $severity); + } + + /** + * @return ReportStatus + */ + protected function getLockSslStatus(ServerRequestInterface $request): ?ReportStatus + { + $normalizedParams = $request->getAttribute('normalizedParams'); + + if ($normalizedParams->isHttps()) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + + if (!$GLOBALS['TYPO3_CONF_VARS']['BE']['lockSSL']) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_insecure'); + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_lockSslStatus_insecure'); + $severity = ContextualFeedbackSeverity::WARNING; + } + + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_lockSslStatus'), $value, $message, $severity); + } + + return null; + } + + /** + * Checks if the trusted hosts pattern check is disabled. + * + * @return ReportStatus An object representing whether the check is disabled + */ + protected function getTrustedHostsPatternStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + + if ($GLOBALS['TYPO3_CONF_VARS']['SYS']['trustedHostsPattern'] === VerifyHostHeader::ENV_TRUSTED_HOSTS_PATTERN_ALLOW_ALL) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_insecure'); + $severity = ContextualFeedbackSeverity::ERROR; + $message = $this->getLanguageService()->sL('LLL:EXT:core/Resources/Private/Language/locallang_core.xlf:warning.install_trustedhosts'); + } + + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_trustedHostsPattern'), $value, $message, $severity); + } + + /** + * Checks if fileDenyPattern was changed which is dangerous on Apache + * + * @return ReportStatus An object representing whether the file deny pattern has changed + */ + protected function getFileDenyPatternStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + + $fileAccessCheck = GeneralUtility::makeInstance(FileNameValidator::class); + if ($fileAccessCheck->missingImportantPatterns()) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_insecure'); + $severity = ContextualFeedbackSeverity::ERROR; + $message = sprintf( + $this->getLanguageService()->sL('LLL:EXT:core/Resources/Private/Language/locallang_core.xlf:warning.file_deny_pattern_partsNotPresent'), + '
    ' . htmlspecialchars($fileAccessCheck::DEFAULT_FILE_DENY_PATTERN) . '

    ' + ); + } + + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_fileDenyPattern'), $value, $message, $severity); + } + + /** + * Checks if fileDenyPattern allows to upload .htaccess files which is + * dangerous on Apache. + * + * @return ReportStatus An object representing whether it's possible to upload .htaccess files + */ + protected function getHtaccessUploadStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + + $fileNameAccess = GeneralUtility::makeInstance(FileNameValidator::class); + if ($fileNameAccess->customFileDenyPatternConfigured() + && $fileNameAccess->isValid('.htaccess')) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_insecure'); + $severity = ContextualFeedbackSeverity::ERROR; + $message = $this->getLanguageService()->sL('LLL:EXT:core/Resources/Private/Language/locallang_core.xlf:warning.file_deny_htaccess'); + } + + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_htaccessUploadProtection'), $value, $message, $severity); + } + + protected function getExceptionHandlerStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + if ( + str_contains($GLOBALS['TYPO3_CONF_VARS']['SYS']['productionExceptionHandler'], 'Debug') + || (Environment::getContext()->isProduction() && (int)$GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] === 1) + ) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_insecure'); + $severity = ContextualFeedbackSeverity::ERROR; + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_exceptionHandler_errorMessage'); + } elseif ((int)$GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] === 1) { + $severity = ContextualFeedbackSeverity::WARNING; + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_exceptionHandler_warningMessage'); + } + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_exceptionHandler'), $value, $message, $severity); + } + + protected function getExportedFilesStatus(): ReportStatus + { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_ok'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + + $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)->getQueryBuilderForTable('sys_file'); + $exportedFiles = $queryBuilder + ->select('storage', 'identifier') + ->from('sys_file') + ->where( + $queryBuilder->expr()->like( + 'identifier', + $queryBuilder->createNamedParameter('%/_temp_/importexport/%') + ), + $queryBuilder->expr()->or( + $queryBuilder->expr()->like( + 'identifier', + $queryBuilder->createNamedParameter('%.xml') + ), + $queryBuilder->expr()->like( + 'identifier', + $queryBuilder->createNamedParameter('%.t3d') + ) + ), + ) + ->executeQuery() + ->fetchAllAssociative(); + + if (count($exportedFiles) > 0) { + $files = []; + foreach ($exportedFiles as $exportedFile) { + $files[] = '
  • ' . htmlspecialchars($exportedFile['storage'] . ':' . $exportedFile['identifier']) . '
    • '; + } + + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_insecure'); + $severity = ContextualFeedbackSeverity::WARNING; + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_exportedFiles_warningMessage'); + $message .= '
      ' . implode(PHP_EOL, $files) . '
    '; + $message .= $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_exportedFiles_warningRecommendation'); + } + + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_exportedFiles'), $value, $message, $severity); + } + + protected function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Report/Status/SystemStatus.php b/Classes/Report/Status/SystemStatus.php new file mode 100644 index 0000000..75b7ed3 --- /dev/null +++ b/Classes/Report/Status/SystemStatus.php @@ -0,0 +1,95 @@ + $this->getMissingPhpModulesOfExtensions(), + ]; + return $statuses; + } + + public function getLabel(): string + { + return 'system'; + } + + /** + * Reports whether extensions need additional PHP modules different from standard core requirements + * + * @return \TYPO3\CMS\Reports\Status A status of missing PHP modules + */ + protected function getMissingPhpModulesOfExtensions() + { + $modules = []; + if (is_array($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install/mod/class.tx_install.php']['requiredPhpModules'] ?? null)) { + foreach ($GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['ext/install/mod/class.tx_install.php']['requiredPhpModules'] as $className) { + $hookObject = GeneralUtility::makeInstance($className); + $modules = $hookObject->setRequiredPhpModules($modules, $this); + } + } + $missingPhpModules = []; + foreach ($modules as $module) { + if (is_array($module)) { + $detectedSubmodules = false; + foreach ($module as $submodule) { + if (extension_loaded($submodule)) { + $detectedSubmodules = true; + } + } + if ($detectedSubmodules === false) { + $missingPhpModules[] = sprintf($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_phpModulesGroup'), '(' . implode(', ', $module) . ')'); + } + } elseif (!extension_loaded($module)) { + $missingPhpModules[] = $module; + } + } + if (!empty($missingPhpModules)) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_phpModulesMissing'); + $message = sprintf($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_phpModulesList'), implode(', ', $missingPhpModules)); + $message .= ' ' . $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_phpModulesInfo'); + $severity = ContextualFeedbackSeverity::ERROR; + } else { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_phpModulesPresent'); + $message = ''; + $severity = ContextualFeedbackSeverity::OK; + } + return new ReportStatus($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_phpModules'), $value, $message, $severity); + } + + protected function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Report/Status/Typo3Status.php b/Classes/Report/Status/Typo3Status.php new file mode 100644 index 0000000..db672ed --- /dev/null +++ b/Classes/Report/Status/Typo3Status.php @@ -0,0 +1,94 @@ + $this->getRegisteredXclassStatus(), + ]; + return $statuses; + } + + public function getLabel(): string + { + return 'typo3'; + } + + /** + * List any Xclasses registered in the system + * + * @return \TYPO3\CMS\Reports\Status + */ + protected function getRegisteredXclassStatus() + { + $message = ''; + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_none'); + $severity = ContextualFeedbackSeverity::OK; + + $xclassFoundArray = []; + if (array_key_exists('Objects', $GLOBALS['TYPO3_CONF_VARS']['SYS'])) { + foreach ($GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects'] as $originalClass => $override) { + if (array_key_exists('className', $override)) { + $xclassFoundArray[$originalClass] = $override['className']; + } + } + } + if (!empty($xclassFoundArray)) { + $value = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_xclassUsageFound'); + $message = $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_xclassUsageFound_message') . '
    '; + $message .= '
      '; + foreach ($xclassFoundArray as $originalClass => $xClassName) { + $messageDetail = sprintf( + (string)($this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_xclassUsageFound_message_detail')), + '' . htmlspecialchars((string)$originalClass) . '', + '' . htmlspecialchars((string)$xClassName) . '' + ); + $message .= '
    1. ' . $messageDetail . '
      2. '; + } + $message .= '
    '; + $severity = ContextualFeedbackSeverity::NOTICE; + } + + return new ReportStatus( + $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_xclassUsage'), + $value, + $message, + $severity + ); + } + + protected function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Report/WarningsForAboutModule.php b/Classes/Report/WarningsForAboutModule.php new file mode 100644 index 0000000..95c178d --- /dev/null +++ b/Classes/Report/WarningsForAboutModule.php @@ -0,0 +1,73 @@ +context->getAspect('backend.user')->isAdmin()) { + return; + } + // Get the highest severity + $highestSeverity = $this->registry->get('tx_reports', 'status.highestSeverity'); + if ($highestSeverity === null || $highestSeverity <= ContextualFeedbackSeverity::OK->value) { + return; + } + // Display a message that there's something wrong and that + // the administrator should take a look at the detailed status report + $event->addMessage(new FlashMessage(sprintf( + $this->getLanguageService()->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_problemNotification'), + '', + '' + ))); + } + + private function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/RequestAwareStatusProviderInterface.php b/Classes/RequestAwareStatusProviderInterface.php new file mode 100644 index 0000000..2d1ba68 --- /dev/null +++ b/Classes/RequestAwareStatusProviderInterface.php @@ -0,0 +1,34 @@ +getCountInformation(); + + $schema = $this->tcaSchemaFactory->get('tt_content'); + try { + $typeField = $schema->getSubSchemaTypeInformation()->getFieldName(); + } catch (InvalidSchemaTypeException) { + return ['error' => true]; + } + $fieldConfig = $schema->hasField($typeField) ? $schema->getField($typeField)->getConfiguration() : []; + $itemGroups = $fieldConfig['itemGroups'] ?? []; + $groupedWizardItems = []; + foreach (array_keys($itemGroups) as $groupIdentifier) { + $groupedWizardItems['exists'][$groupIdentifier]['header'] = $itemGroups[$groupIdentifier]; + $groupedWizardItems['unused'][$groupIdentifier]['header'] = $itemGroups[$groupIdentifier]; + } + + foreach ($fieldConfig['items'] ?? [] as $item) { + $selectItem = SelectItem::fromTcaItemArray($item); + if ($selectItem->isDivider()) { + continue; + } + $recordType = $selectItem->getValue(); + $groupIdentifier = $selectItem->getGroup(); + if (!isset($countInformation[$recordType]) + || ($countInformation[$recordType]['visible'] === 0 && $countInformation[$recordType]['hidden'] === 0) + ) { + $usageIdentifier = 'unused'; + } else { + $usageIdentifier = 'exists'; + } + + $groupedWizardItems[$usageIdentifier][$groupIdentifier]['elements'] ??= []; + + // In case this group is not defined in itemGroups, use the group identifier as label. + $groupedWizardItems[$usageIdentifier][$groupIdentifier]['header'] ??= $groupIdentifier; + $itemDescription = $selectItem->getDescription(); + $wizardEntry = [ + 'iconIdentifier' => $selectItem->getIcon(), + 'iconOverlay' => $selectItem->getIconOverlay(), + 'title' => $selectItem->getLabel(), + 'description' => $itemDescription['description'] ?? ($itemDescription ?? ''), + ]; + $groupedWizardItems[$usageIdentifier][$groupIdentifier]['elements'][$recordType] = $wizardEntry; + $groupedWizardItems[$usageIdentifier][$groupIdentifier]['elements'][$recordType]['count'] = $countInformation[$recordType] ?? []; + try { + $subschema = $schema->getSubSchema($recordType); + $groupedWizardItems[$usageIdentifier][$groupIdentifier]['elements'][$recordType]['fields'] + = $subschema->getFields(fn($field) => !in_array($field->getName(), $defaultFields, true)); + } catch (UndefinedSchemaException) { + } + } + return $groupedWizardItems; + } + + public function collectStatisticForCtype(string $cType, int $currentPage): array + { + $paginator = new QueryBuilderPaginator($this->buildQueryBuilderForCtype($cType), $currentPage, 10); + $pagination = new SimplePagination($paginator); + + $rows = $paginator->getPaginatedItems(); + foreach ($rows as &$row) { + $row['path'] = BackendUtility::getRecordPath($row['pid'], '', 0); + $row['tstamp_formatted'] = BackendUtility::datetime($row['tstamp']); + } + + return [ + 'ctype' => $cType, + 'label' => $this->schemaLabelResolver->getLabelForFieldValue('tt_content', 'CType', $cType), + 'count' => $this->getCountInformation($cType)[$cType] ?? [], + 'rows' => $rows, + 'paginator' => $paginator, + 'pagination' => $pagination, + ]; + } + + public function isValidCtype(string $cType): bool + { + if ($cType === '') { + return false; + } + return $this->tcaSchemaFactory->get('tt_content')->hasSubSchema($cType); + } + + private function buildQueryBuilderForCtype(string $cType): QueryBuilder + { + $queryBuilder = $this->connectionPool->getQueryBuilderForTable('tt_content'); + $queryBuilder->getRestrictions() + ->removeAll() + ->add(GeneralUtility::makeInstance(DeletedRestriction::class)); + return $queryBuilder + ->select('uid', 'pid', 'header', 'tstamp', 'crdate', 'hidden', 'fe_group') + ->from('tt_content') + ->where( + $queryBuilder->expr()->eq('CType', $queryBuilder->createNamedParameter($cType)), + ) + ->orderBy('uid', 'desc'); + } + + private function getCountInformation(string $cType = ''): array + { + $queryBuilder = $this->connectionPool->getQueryBuilderForTable('tt_content'); + $queryBuilder->getRestrictions()->removeAll(); + $queryBuilder = $queryBuilder + ->select('CType', 'deleted', 'hidden') + ->addSelectLiteral('COUNT(*) as count') + ->from('tt_content') + ->groupBy('CType') + ->addGroupBy('hidden') + ->addGroupBy('deleted'); + + if ($cType !== '') { + $queryBuilder = $queryBuilder->where($queryBuilder->expr()->eq('CType', $queryBuilder->createNamedParameter($cType))); + } + + $counts = []; + foreach ($queryBuilder->executeQuery()->fetchAllAssociative() as $row) { + $cType = $row['CType']; + $deleted = (int)$row['deleted']; + $hidden = (int)$row['hidden']; + $count = (int)$row['count']; + if (!isset($counts[$cType])) { + $counts[$cType] = ['deleted' => 0, 'hidden' => 0, 'visible' => 0]; + } + + $key = match (true) { + $deleted === 1 => 'deleted', + $hidden === 1 => 'hidden', + default => 'visible', + }; + + $counts[$cType][$key] += $count; + } + + return $counts; + } +} diff --git a/Classes/Service/RecordStatisticsService.php b/Classes/Service/RecordStatisticsService.php new file mode 100644 index 0000000..d73a3b2 --- /dev/null +++ b/Classes/Service/RecordStatisticsService.php @@ -0,0 +1,161 @@ + + */ + public function collectPageStatistics(): array + { + $databaseIntegrityCheck = GeneralUtility::makeInstance(DatabaseIntegrityCheck::class); + $databaseIntegrityCheck->genTree(0); + + return [ + 'total_pages' => [ + 'icon' => $this->iconFactory->getIconForRecord('pages', [], IconSize::SMALL)->render(), + 'count' => count($databaseIntegrityCheck->getPageIdArray()), + ], + 'translated_pages' => [ + 'icon' => $this->iconFactory->getIconForRecord('pages', [], IconSize::SMALL)->render(), + 'count' => count($databaseIntegrityCheck->getPageTranslatedPageIDArray()), + ], + 'hidden_pages' => [ + 'icon' => $this->iconFactory->getIconForRecord('pages', ['hidden' => 1], IconSize::SMALL)->render(), + 'count' => $databaseIntegrityCheck->getRecStats()['hidden'] ?? 0, + ], + 'deleted_pages' => [ + 'icon' => $this->iconFactory->getIconForRecord('pages', ['deleted' => 1], IconSize::SMALL)->render(), + 'count' => isset($databaseIntegrityCheck->getRecStats()['deleted']['pages']) ? count($databaseIntegrityCheck->getRecStats()['deleted']['pages']) : 0, + ], + ]; + } + + /** + * Collects statistics for different page doktypes + * + * @return array + */ + public function collectDoktypeStatistics(): array + { + $languageService = $this->getLanguageService(); + $databaseIntegrityCheck = GeneralUtility::makeInstance(DatabaseIntegrityCheck::class); + $databaseIntegrityCheck->genTree(0); + + $doktypes = []; + foreach ($this->pageDoktypeRegistry->getAllDoktypes() as $doktype) { + if ($doktype->isDivider()) { + continue; + } + $doktypes[] = [ + 'icon' => $this->iconFactory->getIconForRecord('pages', ['doktype' => $doktype->getValue()], IconSize::SMALL)->render(), + 'title' => $languageService->sL($doktype->getLabel()) . ' (' . $doktype->getValue() . ')', + 'count' => (int)($databaseIntegrityCheck->getRecStats()['doktype'][$doktype->getValue()] ?? 0), + ]; + } + + return $doktypes; + } + + /** + * Collects statistics for all TCA tables including lost records + * + * @return array + */ + public function collectTableStatistics(): array + { + $languageService = $this->getLanguageService(); + $databaseIntegrityCheck = GeneralUtility::makeInstance(DatabaseIntegrityCheck::class); + $databaseIntegrityCheck->genTree(0); + + // Tables and lost records + $pageIds = array_merge([0], array_keys($databaseIntegrityCheck->getPageIdArray())); + $lostRecords = $databaseIntegrityCheck->lostRecords($pageIds); + + $tableStatistic = []; + $countArr = $databaseIntegrityCheck->countRecords($pageIds); + $lostPageIds = isset($lostRecords['pages']) ? array_keys($lostRecords['pages']) : []; + + /** @var TcaSchema $schema */ + foreach ($this->tcaSchemaFactory->all() as $table => $schema) { + if ($schema->hasCapability(TcaSchemaCapability::HideInUi)) { + continue; + } + $lostRecordCount = isset($lostRecords[$table]) ? count($lostRecords[$table]) : 0; + $recordCount = 0; + if ($countArr['all'][$table] ?? false) { + $recordCount = (int)($countArr['non_deleted'][$table] ?? 0) . '/' . $lostRecordCount; + } + $lostRecordList = []; + foreach ($lostRecords[$table] ?? [] as $data) { + if (!in_array((int)$data['pid'], $lostPageIds, true)) { + $lostRecordList[] + = '
    ' + . $this->iconFactory->getIcon('status-dialog-error', IconSize::SMALL)->render() + . 'uid:' . $data['uid'] . ', pid:' . $data['pid'] . ', ' . htmlspecialchars(GeneralUtility::fixed_lgd_cs(strip_tags($data['title']), 20)) + . '
    '; + } else { + $lostRecordList[] + = '
    ' + . 'uid:' . $data['uid'] . ', pid:' . $data['pid'] . ', ' . htmlspecialchars(GeneralUtility::fixed_lgd_cs(strip_tags($data['title']), 20)) + . '
    '; + } + } + $tableStatistic[$table] = [ + 'icon' => $this->iconFactory->getIconForRecord($table, [], IconSize::SMALL)->render(), + 'title' => $schema->getTitle($languageService->sL(...)), + 'count' => $recordCount, + 'lostRecords' => implode(LF, $lostRecordList), + ]; + } + ksort($tableStatistic); + + return $tableStatistic; + } + + private function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Service/StatusService.php b/Classes/Service/StatusService.php new file mode 100644 index 0000000..65f1f54 --- /dev/null +++ b/Classes/Service/StatusService.php @@ -0,0 +1,190 @@ +statusRegistry->getProviders() as $statusProvider) { + $statusProviderId = $statusProvider->getLabel(); + $status[$statusProviderId] ??= []; + if ($statusProvider instanceof RequestAwareStatusProviderInterface) { + $statuses = $statusProvider->getStatus($request); + } else { + $statuses = $statusProvider->getStatus(); + } + $status[$statusProviderId] = array_merge($status[$statusProviderId], $statuses); + } + return $status; + } + + /** + * Runs through all status providers and returns all statuses collected, which are detailed. + * + * @return Status[][] + */ + public function getDetailedSystemStatus(): array + { + $status = []; + foreach ($this->statusRegistry->getProviders() as $statusProvider) { + $statusProviderId = $statusProvider->getLabel(); + if ($statusProvider instanceof ExtendedStatusProviderInterface) { + $statuses = $statusProvider->getDetailedStatus(); + $status[$statusProviderId] = array_merge($status[$statusProviderId] ?? [], $statuses); + } + } + return $status; + } + + /** + * Determines the highest severity from the given statuses. + * + * @param array> $statusCollection An array of Status objects. + * @return int The highest severity found from the statuses. + */ + public function getHighestSeverity(array $statusCollection): int + { + $highestSeverity = ContextualFeedbackSeverity::NOTICE; + foreach ($statusCollection as $providerStatuses) { + foreach ($providerStatuses as $status) { + if ($status->getSeverity()->value > $highestSeverity->value) { + $highestSeverity = $status->getSeverity(); + } + // Reached the highest severity level, no need to go on + if ($highestSeverity === ContextualFeedbackSeverity::ERROR) { + break; + } + } + } + return $highestSeverity->value; + } + + /** + * Collects system status and stores the highest severity in the registry. + * This is useful for displaying warnings at login or in the backend. + * + * @param ServerRequestInterface|null $request + */ + public function collectAndStoreSystemStatus(?ServerRequestInterface $request = null): void + { + $status = $this->getSystemStatus($request); + $this->registry->set('tx_reports', 'status.highestSeverity', $this->getHighestSeverity($status)); + } + + /** + * Sorts the status providers (alphabetically and puts primary status providers at the beginning) + * + * @param array> $statusCollection A collection of statuses (with providers) + * @return array> The collection of statuses sorted by provider + */ + public function sortStatusProviders(array $statusCollection): array + { + $languageService = $this->getLanguageService(); + + // Extract the primary status collections, i.e. the status groups + // that must appear on top of the status report + // Change their keys to localized collection titles + $primaryStatuses = [ + $languageService->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_typo3') => $statusCollection['typo3'] ?? [], + $languageService->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_system') => $statusCollection['system'] ?? [], + $languageService->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_security') => $statusCollection['security'] ?? [], + $languageService->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_configuration') => $statusCollection['configuration'] ?? [], + ]; + unset($statusCollection['typo3'], $statusCollection['system'], $statusCollection['security'], $statusCollection['configuration']); + + // Assemble list of secondary status collections with left-over collections + // Change their keys using localized labels if available + $secondaryStatuses = []; + foreach ($statusCollection as $statusProviderId => $collection) { + if (str_starts_with($statusProviderId, 'LLL:')) { + // Label provided by extension + $label = $languageService->sL($statusProviderId); + } else { + // Generic label + // @todo phase this out + $label = $languageService->sL('LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_' . $statusProviderId); + } + $providerLabel = empty($label) ? $statusProviderId : $label; + $secondaryStatuses[$providerLabel] = $collection; + } + // Sort the secondary status collections alphabetically + ksort($secondaryStatuses); + return array_merge($primaryStatuses, $secondaryStatuses); + } + + /** + * Sorts the statuses by severity + * + * @param array $statusCollection A collection of statuses per provider + * @return list The collection of statuses sorted by severity + */ + public function sortStatuses(array $statusCollection): array + { + $statuses = []; + $sortTitle = []; + $header = null; + foreach ($statusCollection as $status) { + if ($status->getTitle() === 'TYPO3') { + $header = $status; + continue; + } + $statuses[] = $status; + $sortTitle[] = $status->getSeverity(); + } + array_multisort($sortTitle, SORT_DESC, $statuses); + // Making sure that the core version information is always on the top + if (is_object($header)) { + array_unshift($statuses, $header); + } + return $statuses; + } + + private function getLanguageService(): LanguageService + { + return $GLOBALS['LANG']; + } +} diff --git a/Classes/Status.php b/Classes/Status.php new file mode 100644 index 0000000..a300362 --- /dev/null +++ b/Classes/Status.php @@ -0,0 +1,108 @@ +title = (string)$title; + $this->value = (string)$value; + $this->message = (string)$message; + $this->severity = $severity; + } + + /** + * Gets the status' title + * + * @return string + */ + public function getTitle() + { + return $this->title; + } + + /** + * Gets the status' value + * + * @return string + */ + public function getValue() + { + return $this->value; + } + + /** + * Gets the status' message (if any) + * + * @return string + */ + public function getMessage() + { + return $this->message; + } + + public function getSeverity(): ContextualFeedbackSeverity + { + return $this->severity; + } + + /** + * Creates a string representation of a status. + * + * @return string String representation of this status. + */ + public function __toString() + { + // Max length 80 characters + $stringRepresentation = str_pad('[' . $this->severity->name . ']', 7) . str_pad($this->title, 40) . ' - ' . substr($this->value, 0, 30); + return $stringRepresentation; + } +} diff --git a/Classes/StatusProviderInterface.php b/Classes/StatusProviderInterface.php new file mode 100644 index 0000000..bb5fa88 --- /dev/null +++ b/Classes/StatusProviderInterface.php @@ -0,0 +1,34 @@ +getDetailedSystemStatus(); + $highestSeverity = $statusService->getHighestSeverity($systemStatus); + $registry = GeneralUtility::makeInstance(Registry::class); + $registry->set('tx_reports', 'status.highestSeverity', $highestSeverity); + if (($highestSeverity > ContextualFeedbackSeverity::OK->value) || $this->notificationAll) { + $this->sendNotificationEmail($systemStatus); + } + return true; + } + + /** + * Sends a notification email, reporting system issues. + * + * @param Status[][] $systemStatus Array of statuses + */ + protected function sendNotificationEmail(array $systemStatus): void + { + $systemIssues = []; + foreach ($systemStatus as $statusProvider) { + foreach ($statusProvider as $status) { + if ($this->notificationAll || ($status->getSeverity()->value > ContextualFeedbackSeverity::OK->value)) { + $systemIssues[] = (string)$status . CRLF . $status->getMessage() . CRLF . CRLF; + } + } + } + $notificationEmails = GeneralUtility::trimExplode(LF, $this->notificationEmail, true); + $sendEmailsTo = []; + foreach ($notificationEmails as $notificationEmail) { + $sendEmailsTo[] = new Address($notificationEmail); + } + $subject = sprintf($this->getLanguageService()->sL('reports.reports:status_updateTask_email_subject'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['sitename']); + $message = sprintf($this->getLanguageService()->sL('reports.reports:' . ($this->notificationAll ? 'status_allNotification' : 'status_problemNotification')), '', ''); + if (Environment::isCli()) { + $message .= CRLF . CRLF; + $message .= $this->getLanguageService()->sL('reports.reports:status_problem_notification_cli_disclaimer'); + } + $message .= CRLF . CRLF; + $message .= $this->getLanguageService()->sL('reports.reports:status_updateTask_email_site') . ': ' . $GLOBALS['TYPO3_CONF_VARS']['SYS']['sitename']; + $message .= CRLF . CRLF; + $message .= $this->getLanguageService()->sL('reports.reports:status_updateTask_email_issues') . ': ' . CRLF; + $message .= implode(CRLF, $systemIssues); + $message .= CRLF . CRLF; + + $request = ($GLOBALS['TYPO3_REQUEST'] ?? null) instanceof ServerRequestInterface ? $GLOBALS['TYPO3_REQUEST'] : null; + // @todo DI should be used to inject the MailerInterface in v15.0 + $email = GeneralUtility::makeInstance(TemplatedEmailFactory::class)->createWithOverrides( + [20 => 'EXT:reports/Resources/Private/Templates/Email/'], + [], + [], + $request, + ); + $email + ->to(...$sendEmailsTo) + ->format('plain') + ->subject($subject) + ->setTemplate('Report') + ->assign('message', $message); + + // @todo DI should be used to inject the MailerInterface in v15.0 + GeneralUtility::makeInstance(MailerInterface::class)->send($email); + } + + public function getAdditionalInformation() + { + return sprintf($this->getLanguageService()->sL('reports.reports:status_updateAdditionalInformation'), preg_replace('#\s+#', ', ', trim($this->notificationEmail))); + } + + public function getTaskParameters(): array + { + return [ + 'tx_reports_notification_email' => $this->notificationEmail, + 'tx_reports_notification_all' => $this->notificationAll, + ]; + } + + public function setTaskParameters(array $parameters): void + { + $this->notificationEmail = $parameters['notificationEmail'] ?? $parameters['tx_reports_notification_email'] ?? ''; + $this->notificationAll = (bool)($parameters['notificationAll'] ?? $parameters['tx_reports_notification_all'] ?? false); + } + + public function validateTaskParameters(array $parameters): bool + { + $validInput = true; + $notificationEmails = GeneralUtility::trimExplode(LF, $parameters['tx_reports_notification_email'] ?? '', true); + foreach ($notificationEmails as $notificationEmail) { + if (!GeneralUtility::validEmail($notificationEmail)) { + $validInput = false; + break; + } + } + if (!$validInput || empty($parameters['tx_reports_notification_email'] ?? '')) { + GeneralUtility::makeInstance(FlashMessageService::class)->getMessageQueueByIdentifier()->addMessage( + new FlashMessage($this->getLanguageService()->sL('reports.reports:status_updateTaskField_notificationEmails_invalid'), '', ContextualFeedbackSeverity::ERROR) + ); + $validInput = false; + } + return $validInput; + } +} diff --git a/Configuration/Backend/Modules.php b/Configuration/Backend/Modules.php new file mode 100644 index 0000000..a8755a0 --- /dev/null +++ b/Configuration/Backend/Modules.php @@ -0,0 +1,60 @@ + [ + 'parent' => 'admin', + 'position' => ['after' => 'system_log'], + 'access' => 'admin', + 'path' => '/module/system/reports', + 'iconIdentifier' => 'module-reports', + 'labels' => 'reports.modules.overview', + 'showSubmoduleOverview' => true, + ], + 'system_reports_status' => [ + 'parent' => 'system_reports', + 'access' => 'admin', + 'path' => '/module/system/reports/status', + 'iconIdentifier' => 'module-reports', + 'labels' => 'reports.modules.status', + 'routes' => [ + '_default' => [ + 'target' => StatusReportController::class . '::handleRequest', + ], + ], + ], + 'system_reports_statistics' => [ + 'parent' => 'system_reports', + 'access' => 'admin', + 'path' => '/module/system/reports/statistics', + 'iconIdentifier' => 'module-reports', + 'labels' => 'reports.modules.statistics', + 'routes' => [ + '_default' => [ + 'target' => RecordStatisticsController::class . '::handleRequest', + ], + ], + ], + 'system_reports_contentstatistics' => [ + 'parent' => 'system_reports', + 'access' => 'admin', + 'path' => '/module/system/reports/content-statistics', + 'iconIdentifier' => 'module-reports', + 'labels' => [ + 'title' => 'reports.messages:contentStatistics.title', + 'shortDescription' => 'reports.messages:contentStatistics.shortDescription', + 'description' => 'reports.messages:contentStatistics.description', + ], + 'routes' => [ + '_default' => [ + 'target' => ContentStatisticsController::class . '::handleRequest', + ], + ], + ], +]; diff --git a/Configuration/Services.php b/Configuration/Services.php new file mode 100644 index 0000000..9fd77a0 --- /dev/null +++ b/Configuration/Services.php @@ -0,0 +1,12 @@ +registerForAutoconfiguration(StatusProviderInterface::class)->addTag('reports.status'); +}; diff --git a/Configuration/Services.yaml b/Configuration/Services.yaml new file mode 100644 index 0000000..0e5169e --- /dev/null +++ b/Configuration/Services.yaml @@ -0,0 +1,14 @@ +services: + _defaults: + autowire: true + autoconfigure: true + public: false + + TYPO3\CMS\Reports\: + resource: '../Classes/*' + # Tasks require EXT:scheduler to be installed, ignore for now. + exclude: '../Classes/Task' + + TYPO3\CMS\Reports\Registry\StatusRegistry: + arguments: + - !tagged_iterator reports.status diff --git a/Configuration/TCA/Overrides/scheduler_system_status_update_task.php b/Configuration/TCA/Overrides/scheduler_system_status_update_task.php new file mode 100644 index 0000000..3e75221 --- /dev/null +++ b/Configuration/TCA/Overrides/scheduler_system_status_update_task.php @@ -0,0 +1,57 @@ + [ + 'label' => 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_updateTaskField_notificationEmails', + 'config' => [ + 'type' => 'text', + 'rows' => 3, + 'cols' => 50, + 'required' => true, + 'placeholder' => 'admin@example.com', + ], + ], + 'tx_reports_notification_all' => [ + 'label' => 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_updateTaskField_notificationAll', + 'config' => [ + 'type' => 'check', + 'renderType' => 'checkboxToggle', + 'default' => 0, + ], + ], + ] + ); + + ExtensionManagementUtility::addRecordType( + [ + 'label' => 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_updateTaskTitle', + 'description' => 'LLL:EXT:reports/Resources/Private/Language/locallang_reports.xlf:status_updateTaskDescription', + 'value' => SystemStatusUpdateTask::class, + 'icon' => 'mimetypes-x-tx_scheduler_task_group', + 'group' => 'reports', + ], + ' + --div--;core.form.tabs:general, + tasktype, + task_group, + description, + tx_reports_notification_email, + tx_reports_notification_all, + --div--;core.form.tabs:timing, + --palette--;;execution, + --div--;core.form.tabs:access, + disable, + --div--;core.form.tabs:extended,', + [], + '', + 'tx_scheduler_task' + ); +} diff --git a/Documentation/Api/ExtendedStatusProviderInterface.rst b/Documentation/Api/ExtendedStatusProviderInterface.rst new file mode 100644 index 0000000..5c0184f --- /dev/null +++ b/Documentation/Api/ExtendedStatusProviderInterface.rst @@ -0,0 +1,13 @@ +.. include:: /Includes.rst.txt + +.. _ExtendedStatusProviderInterface: + +=============================== +ExtendedStatusProviderInterface +=============================== + +This interface extends +:php:interface:`TYPO3\\CMS\\Reports\\StatusProviderInterface`. It can be used +to provide detailed status reports. + +.. include:: /CodeSnippets/Generated/ExtendedStatusProviderInterface.rst.txt diff --git a/Documentation/Api/Index.rst b/Documentation/Api/Index.rst new file mode 100644 index 0000000..778f466 --- /dev/null +++ b/Documentation/Api/Index.rst @@ -0,0 +1,16 @@ +.. include:: /Includes.rst.txt + +.. _api: + +=== +API +=== + +**Contents:** + +.. toctree:: + :titlesonly: + :glob: + + StatusProviderInterface + * diff --git a/Documentation/Api/RequestAwareStatusProviderInterface.rst b/Documentation/Api/RequestAwareStatusProviderInterface.rst new file mode 100644 index 0000000..195c4e9 --- /dev/null +++ b/Documentation/Api/RequestAwareStatusProviderInterface.rst @@ -0,0 +1,13 @@ +.. include:: /Includes.rst.txt + +.. _RequestAwareStatusProviderInterface: + +=================================== +RequestAwareStatusProviderInterface +=================================== + +This interface extends +:php:interface:`TYPO3\\CMS\\Reports\\StatusProviderInterface`. It can be used +if information from the current request is required for the status message. + +.. include:: /CodeSnippets/Generated/RequestAwareStatusProviderInterface.rst.txt diff --git a/Documentation/Api/StatusProviderInterface.rst b/Documentation/Api/StatusProviderInterface.rst new file mode 100644 index 0000000..463d5b9 --- /dev/null +++ b/Documentation/Api/StatusProviderInterface.rst @@ -0,0 +1,32 @@ +.. include:: /Includes.rst.txt + +.. _StatusProviderInterfaceAPI: + +======================= +StatusProviderInterface +======================= + +Classes implementing this interface are registered automatically as status +in the module :guilabel:`Reports > Status` if :yaml:`autoconfigure` is enabled in +:file:`Services.yaml` or if it was registered manually by the tag +:ref:`reports.status `. + +If information from the current request is required for the status report implement +:php:interface:`TYPO3\\CMS\\Reports\\RequestAwareStatusProviderInterface`. + +If you need to provide extended information implement +:php:interface:`TYPO3\\CMS\\Reports\\ExtendedStatusProviderInterface`. + +.. note:: + In PHP it is possible to implement several interfaces, so you can + give detailed status reports that are request-aware: + + .. code-block:: php + :caption: EXT:my_extension/Classes/Status/MyStatus.php + + class MyStatus implements RequestAwareStatusProviderInterface, ExtendedStatusProviderInterface + { + // ... + } + +.. include:: /CodeSnippets/Generated/StatusProviderInterface.rst.txt diff --git a/Documentation/CodeSnippets/Generated/ExtendedStatusProviderInterface.rst.txt b/Documentation/CodeSnippets/Generated/ExtendedStatusProviderInterface.rst.txt new file mode 100644 index 0000000..c28d6ff --- /dev/null +++ b/Documentation/CodeSnippets/Generated/ExtendedStatusProviderInterface.rst.txt @@ -0,0 +1,10 @@ +.. Generated by https://github.com/linawolf/t3docs_restructured_api_tools +.. php:namespace:: TYPO3\CMS\Reports + +.. php:interface:: ExtendedStatusProviderInterface + + Interface for classes which provide a status report entry. + + .. php:method:: getDetailedStatus() + + Returns the detailed status of an extension or (sub)system diff --git a/Documentation/CodeSnippets/Generated/RequestAwareStatusProviderInterface.rst.txt b/Documentation/CodeSnippets/Generated/RequestAwareStatusProviderInterface.rst.txt new file mode 100644 index 0000000..b1542d4 --- /dev/null +++ b/Documentation/CodeSnippets/Generated/RequestAwareStatusProviderInterface.rst.txt @@ -0,0 +1,19 @@ +.. Generated by https://github.com/linawolf/t3docs_restructured_api_tools +.. php:namespace:: TYPO3\CMS\Reports + +.. php:interface:: RequestAwareStatusProviderInterface + + Interface for classes which provide a status report entry using information from the current request + + .. php:method:: getStatus(Psr\\Http\\Message\\ServerRequestInterface request = NULL) + + Returns the status of an extension or (sub)system + + :param Psr\\Http\\Message\\ServerRequestInterface $request: the request, default: NULL + :returntype: array + + .. php:method:: getLabel() + + Return label of this status + + :returntype: string diff --git a/Documentation/CodeSnippets/Generated/StatusProviderInterface.rst.txt b/Documentation/CodeSnippets/Generated/StatusProviderInterface.rst.txt new file mode 100644 index 0000000..ec6e8f8 --- /dev/null +++ b/Documentation/CodeSnippets/Generated/StatusProviderInterface.rst.txt @@ -0,0 +1,18 @@ +.. Generated by https://github.com/linawolf/t3docs_restructured_api_tools +.. php:namespace:: TYPO3\CMS\Reports + +.. php:interface:: StatusProviderInterface + + Interface for classes which provide a status report entry. + + .. php:method:: getStatus() + + Returns the status of an extension or (sub)system + + :returntype: array + + .. php:method:: getLabel() + + Return label of this status + + :returntype: string diff --git a/Documentation/CodeSnippets/Manual/Autoconfigure.rst.txt b/Documentation/CodeSnippets/Manual/Autoconfigure.rst.txt new file mode 100644 index 0000000..7602062 --- /dev/null +++ b/Documentation/CodeSnippets/Manual/Autoconfigure.rst.txt @@ -0,0 +1,6 @@ +.. code-block:: yaml + :caption: EXT:my_extension/Configuration/Services.yaml + + services: + _defaults: + autoconfigure: true diff --git a/Documentation/CodeSnippets/codesnippets.php b/Documentation/CodeSnippets/codesnippets.php new file mode 100644 index 0000000..2fd3e4e --- /dev/null +++ b/Documentation/CodeSnippets/codesnippets.php @@ -0,0 +1,25 @@ + 'createPhpClassDocs', + 'class' => \TYPO3\CMS\Reports\StatusProviderInterface::class, + 'targetFileName' => 'Generated/StatusProviderInterface.rst.txt', + 'withCode' => false, + ], + [ + 'action' => 'createPhpClassDocs', + 'class' => \TYPO3\CMS\Reports\RequestAwareStatusProviderInterface::class, + 'targetFileName' => 'Generated/RequestAwareStatusProviderInterface.rst.txt', + 'withCode' => false, + ], + [ + 'action' => 'createPhpClassDocs', + 'class' => \TYPO3\CMS\Reports\ExtendedStatusProviderInterface::class, + 'targetFileName' => 'Generated/ExtendedStatusProviderInterface.rst.txt', + 'withCode' => false, + ], +]; diff --git a/Documentation/CustomReports/Index.rst b/Documentation/CustomReports/Index.rst new file mode 100644 index 0000000..f678668 --- /dev/null +++ b/Documentation/CustomReports/Index.rst @@ -0,0 +1,108 @@ +.. include:: /Includes.rst.txt + +.. _custom-reports-more: +.. _custom-reports: + +============================ +Custom reports registration +============================ + +The only report provided by the TYPO3 core is the one +called :guilabel:`Status`. + +The status report itself is extendable and shows status messages like a system +environment check and the status of the installed extensions. + +Reports and status are automatically registered through the service +configuration, based on the implemented interface. + +.. _register-custom-report: + +Register a custom report +======================== + +Create a custom submodule extending the reports module. + +.. code-block:: php + + [ + 'parent' => 'system_reports', + 'access' => 'admin', + 'path' => '/module/system/reports/myreport', + 'iconIdentifier' => 'my-report-icon', + 'labels' => [ + 'title' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:myreport.title', + 'description' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:myreport.description', + ], + 'routes' => [ + '_default' => [ + 'target' => \Vendor\MyExtension\Controller\MyReportController::class . '::handleRequest', + ], + ], + ], + ]; + +Implement the logic into your class: + +.. code-block:: php + + moduleTemplateFactory->create($request); + $view->makeDocHeaderModuleMenu(); + $view->assign('data', $this->collectReportData()); + return $view->renderResponse('MyReport'); + } + } + +Use a template like below: + +.. code-block:: html + + + + + +

    My report

    +

    Report it!

    +     + + +.. _register-custom-status: + +Register a custom status +======================== + +All status providers must implement +:php:interface:`TYPO3\\CMS\\Reports\\StatusProviderInterface`. +If :yaml:`autoconfigure` is enabled in :file:`Services.yaml`, +the status providers implementing this interface will be automatically +registered. + +.. include:: /CodeSnippets/Manual/Autoconfigure.rst.txt + +Alternatively, one can manually tag a custom report with the +:yaml:`reports.status` tag: diff --git a/Documentation/Images/InstallActivate.png b/Documentation/Images/InstallActivate.png new file mode 100644 index 0000000000000000000000000000000000000000..881fe508b2202c1498b93571aaf95412156a97d2 GIT binary patch literal 13486 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 v39ob>XJuCdiW^U)#>jUYS5`r~+RUDd{qo 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 literal 0 HcmV?d00001 diff --git a/Documentation/Includes.rst.txt b/Documentation/Includes.rst.txt new file mode 100644 index 0000000..2362507 --- /dev/null +++ b/Documentation/Includes.rst.txt @@ -0,0 +1 @@ +.. You can put central messages to display on all pages here diff --git a/Documentation/Index.rst b/Documentation/Index.rst new file mode 100644 index 0000000..0c271f9 --- /dev/null +++ b/Documentation/Index.rst @@ -0,0 +1,85 @@ +.. include:: /Includes.rst.txt + +.. _start: + +=============== +TYPO3 Reports +=============== + +:Extension key: + reports + +:Package name: + typo3/cms-reports + +:Version: + |release| + +:Language: + en + +:Author: + TYPO3 contributors + +:License: + This document is published under the + `Creative Commons BY 4.0 `__ + license. + +:Rendered: + |today| + +---- + +This extension shows status reports and installed services in the +:guilabel:`Administration > Reports` backend module. + +---- + +.. card-grid:: + :columns: 1 + :columns-md: 2 + :gap: 4 + :class: pb-4 + :card-height: 100 + + .. card:: :ref:`Introduction ` + + Written for new users, this chapter introduces the module + :guilabel:`Reports` and what it does. + + .. card:: :ref:`Installation ` + + Explains how to install the extension if it is not installed yet. + + .. card:: :ref:`API Reference ` + + Explains the underlying API and its interfaces. + + .. card:: :ref:`Custom reports ` + + Introduction into developing your own custom reports or status + messages. + + .. card:: :ref:`Scheduler task ` + + Use the system extension scheduler to configure automatic + status reports sent via email. + +.. Table of Contents + +.. toctree:: + :hidden: + + Introduction/Index + Installation/Index + Api/Index + CustomReports/Index + Scheduler/Index + +.. Meta Menu + +.. toctree:: + :hidden: + + Sitemap diff --git a/Documentation/Installation/Index.rst b/Documentation/Installation/Index.rst new file mode 100644 index 0000000..c99b208 --- /dev/null +++ b/Documentation/Installation/Index.rst @@ -0,0 +1,56 @@ +.. include:: /Includes.rst.txt + +.. _installation: + +============ +Installation +============ + +This extension is part of the TYPO3 Core, but not installed by default. + +.. contents:: Table of contents + :local: + +.. _installation-composer: + +Installation with Composer +========================== + +Check whether you are already using the extension with: + +.. code-block:: bash + + composer show | grep reports + +This should either give you no result or something similar to: + +.. code-block:: none + + typo3/cms-reports v12.4.11 + +If it is not installed yet, use the ``composer require`` command to install +the extension: + +.. code-block:: bash + + composer require typo3/cms-reports + +The given version depends on the version of the TYPO3 Core you are using. + +.. _installation-no-composer: + +Installation without Composer +============================= + +In an installation without Composer, the extension is already shipped but might +not be activated yet. Activate it as follows: + +#. In the backend, navigate to the :guilabel:`System > Extensions` + module. +#. Click the :guilabel:`Activate` icon for the Reports extension. + +.. figure:: /Images/InstallActivate.png + :class: with-border + :alt: Extension manager showing Reports extension + + Extension manager showing Reports extension diff --git a/Documentation/Introduction/Index.rst b/Documentation/Introduction/Index.rst new file mode 100644 index 0000000..bc7c74d --- /dev/null +++ b/Documentation/Introduction/Index.rst @@ -0,0 +1,69 @@ +.. include:: /Includes.rst.txt + +.. _introduction: + +============ +Introduction +============ + +.. contents:: Table of contents + +.. _what-does-it-do: + +What does it do? +================ + +.. figure:: /Images/ModuleReports.png + :class: with-shadow + + The backend module :guilabel:`Administration > Reports` + +The TYPO3 system extension EXT:reports displays the extendable backend module +:guilabel:`Administration > Reports` for users with administrator role. + +The Reports module groups several system reports and gives you a quick +overview about important system statuses and site parameters. + +.. _check-security: + +Section "Security" +================== + +.. figure:: /Images/Security.png + :class: with-shadow + + Regularly check the section :guilabel:`Security` + +From a security perspective, the section :guilabel:`Security` should be checked +regularly: it provides information about the administrator user +account, encryption key, file deny pattern, module :guilabel:`System > Environment` +checks and more. + +.. warning:: + In case of a compromised system, the information displayed here may + have been manipulated by the attacker. + + Thus, if no problems are pointed out - it does not necessarily mean + that there are no security issues. But, on the other hand, if security + problems are pointed out, you most certainly should fix them. + +.. _record-statistics: + +Record Statistics +================= + +.. versionchanged:: 14.0 + The record statistics have been moved from module :guilabel:`System > Database`, + provided by the system extension :composer:`typo3/cms-lowlevel` into the + module :guilabel:`Administration > Reports` of this extension :composer:`typo3/cms-reports`. + +Backend users with administrator permissions can find this module at +:guilabel:`Administration > Reports > Records Statistics`. + +This module gives an overview of the count of records of different types. + +.. figure:: /Images/RecordStatistics.png + :alt: The TYPO3 backend module "Reports" with submodule "Record Statistics" + +The records are counted installation-wide. Soft-deleted (flag `deleted = 1`) +records are ignored. diff --git a/Documentation/Scheduler/Index.rst b/Documentation/Scheduler/Index.rst new file mode 100644 index 0000000..471b6b7 --- /dev/null +++ b/Documentation/Scheduler/Index.rst @@ -0,0 +1,45 @@ +:navigation-title: Scheduler task + +.. include:: /Includes.rst.txt +.. _scheduler-task: + +===================================== +Scheduler task "System Status Update" +===================================== + +If the system extension :composer:`typo3/cms-scheduler` is installed, +you can create automatic reports with the help of a scheduler task. + +To create a task for the reports functionality go to +:guilabel:`Administration > Scheduler`, click on :guilabel:`+ (add Task)` and chose +:guilabel:`System Status Update (reports)` as :guilabel:`Class`. + +Enter :guilabel:`Notification Email Addresses` where the reports should be sent +and chose whether you want to be informed with each run. + +The remaining settings are standard task settings provided by the scheduler +extension. + +.. figure:: /Images/SchedulerTask.png + :alt: TYPO3 Backend module "Scheduler", "New task" popup, Category "Reports" + + Create a :guilabel:`System Status Update` task in module :guilabel:`Administration > Scheduler` + +.. _scheduler-task-mail: + +System status notification mail +=============================== + +You will receive mails looking like this: + +.. code-block:: text + :caption: Example mail from the System status notification + + This report contains all System Status Notifications from your TYPO3 + installation. Please check the status report for more information. + + Site: [DDEV] TYPO3 + + Issues: + [WARN] System environment check - 1 Test(s) + ### Trusted hosts pattern is insecure: 1 diff --git a/Documentation/Sitemap.rst b/Documentation/Sitemap.rst new file mode 100644 index 0000000..c809724 --- /dev/null +++ b/Documentation/Sitemap.rst @@ -0,0 +1,11 @@ +:template: sitemap.html + +.. include:: /Includes.rst.txt + +.. _sitemap: + +======= +Sitemap +======= + +.. The sitemap.html template will insert here the page tree automatically. diff --git a/Documentation/guides.xml b/Documentation/guides.xml new file mode 100644 index 0000000..4dabe82 --- /dev/null +++ b/Documentation/guides.xml @@ -0,0 +1,21 @@ + + + + + diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000..d159169 --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 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 General Public License for more details. + + You should have received a copy of the GNU General Public License along + with this program; if not, write to the Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..3de0ce9 --- /dev/null +++ b/README.rst @@ -0,0 +1,11 @@ +=========================== +TYPO3 extension ``reports`` +=========================== + +This extension shows status reports and installed services in the +(System>Reports) backend module. + +:Repository: https://github.com/typo3/typo3 +:Issues: https://forge.typo3.org/ +:Read online: https://docs.typo3.org/c/typo3/cms-reports/main/en-us/ +:Packagist: https://packagist.org/packages/typo3/cms-reports diff --git a/Resources/Private/Language/Modules/overview.xlf b/Resources/Private/Language/Modules/overview.xlf new file mode 100644 index 0000000..9aa1529 --- /dev/null +++ b/Resources/Private/Language/Modules/overview.xlf @@ -0,0 +1,17 @@ + + + +
    + + + System monitoring and analysis reports + + + Access reports for monitoring and analyzing the TYPO3 installation including system status checks, database statistics, and custom reports provided by extensions. + + + Reports + + + + diff --git a/Resources/Private/Language/Modules/statistics.xlf b/Resources/Private/Language/Modules/statistics.xlf new file mode 100644 index 0000000..d948592 --- /dev/null +++ b/Resources/Private/Language/Modules/statistics.xlf @@ -0,0 +1,53 @@ + + + +
    + + + Shows database record statistics + + + Get statistics for database records, including total, translated, hidden, and deleted pages, page type distribution, and and detailed table records with lost record detection. The report analyzes the entire page tree. + + + Record Statistics + + + Document types + + + Document types (value) + + + Count + + + Pages + + + Total number of default language pages + + + Total number of translated pages + + + Marked-deleted pages + + + Hidden pages + + + Tables + + + Label + + + Table name + + + Records total / lost + + + + diff --git a/Resources/Private/Language/Modules/status.xlf b/Resources/Private/Language/Modules/status.xlf new file mode 100644 index 0000000..f1d3f48 --- /dev/null +++ b/Resources/Private/Language/Modules/status.xlf @@ -0,0 +1,17 @@ + + + +
    + + + Get a status report about your site's operation and any detected problems. + + + Review key site parameters and installation issues. You can copy this information into TYPO3 support requests or project issue trackers. + + + Status Report + + + + diff --git a/Resources/Private/Language/locallang.xlf b/Resources/Private/Language/locallang.xlf new file mode 100644 index 0000000..5540b39 --- /dev/null +++ b/Resources/Private/Language/locallang.xlf @@ -0,0 +1,86 @@ + + + +
    + + + Reports overview + + + Report + + + No registered reports + + + There are no reports registered in the system and default reports have been disabled. + + + Open + + + Open %1s + + + Content Statistics + + + Shows statistics about used content elements + + + Provides an overview of all content element types, showing how often each appears across the site. Includes summaries per type. + + + Statistics + + + Existing Content Element Types + + + The listed content elements include both visible and hidden records. + + + Keep in mind that some elements may not appear on any page, and others might be rendered by alternative methods (TypoScript, ViewHelpers, etc.). As a result, it is not technically possible to determine actual usage. + + + The content element database table's schema ("tt_content") could not be analyzed due to a missing or disabled schema type. + + + Unused content elements + + + This list includes content element types that are not used anywhere, or whose existing instances are all flagged as deleted. + + + %d fields + + + Type + + + Excluded + + + Always visible + + + Required + + + %d active / %d hidden + + + %d deleted + + + Deleted + + + Records + + + No records found + + + + diff --git a/Resources/Private/Language/locallang_reports.xlf b/Resources/Private/Language/locallang_reports.xlf new file mode 100644 index 0000000..4aea7c8 --- /dev/null +++ b/Resources/Private/Language/locallang_reports.xlf @@ -0,0 +1,260 @@ + + + +
    + + + OK + + + Wrong value detected + + + Information + + + Insecure + + + Disabled + + + Enabled + + + Enabled permanently + + + Enabled temporarily + + + Empty + + + None + + + Connection Failed + + + Check Failed + + + Update Complete + + + Update Incomplete + + + One or more problems were detected with your TYPO3 installation. Please check the %sstatus report%s for more information. + + + This report contains all System Status Notifications from your TYPO3 installation. Please check the %sstatus report%s for more information. + + + TYPO3 System + + + System + + + Security + + + Configuration + + + Reference Index + + + File Abstraction Layer + + + Files flagged as missing + + + %1$s files + + + These files are flagged as missing. Restore the files and run the indexer to reset the missing flag. + + + Memcached Configuration + + + Permissions of created files + + + Files created by TYPO3 are configured to be world writable. Depending on your server configuration, this can be a security risk. It is usually better to configure the create mask to not allow writing to files by "others". A sane default is often '0660' for $GLOBALS['TYPO3_CONF_VARS']['SYS']['fileCreateMask']. This can be set in the install tool. + + + Permissions of created directories + + + Directories created by TYPO3 are configured to be world writable. Depending on your server configuration, this can be a security risk. It is usually better to configure the create mask to not allow writing to directories by "others". A sane default is often '2770' for $GLOBALS['TYPO3_CONF_VARS']['SYS']['folderCreateMask']. This can be set in the install tool. + + + MySQL Database Character Set + + + Checking database character set failed, got key "%1$s" instead of "character_set_database" + + + Your default database uses character set "%1$s", but only "utf8", "utf8mb3" or "utf8mb4" is supported with TYPO3. + + + Your default database uses utf-8. All good. + + + Your default database uses a different charset, but all tables uses utf-8. All good. But consider fixing your database collation and check the table creation settings. + + + Your default database is set to create tables with character set "%1$s", but contains tables or columns with different collations. Please fix these tables to avoid "illegal mix of collations" errors. + + + Encrypted backend connection (HTTPS) + + + Your backend access is not secured using HTTPS but relies on HTTP which sends all your data (including login passwords) over an insecure connection. All modern web sites should rely on HTTPS and only sites secured differently, for instance some intranet installations may use HTTP only. + + + Backend only accessible through HTTPS + + + $GLOBALS['TYPO3_CONF_VARS']['BE']['lockSSL']).]]> + + + Trusted Hosts Pattern + + + Encryption Key + + + File Deny Pattern + + + .htaccess Upload Protection + + + Exception Handler / Error Reporting + + + XML/T3D export files + + + Display Errors is set to 1 - errors will be displayed with the DebugExceptionHandler including stack traces. + + + Debug Exception Handler enabled in Production Context - will show full error messages including stack traces. + + + The following exported files were found: + + + It is recommended to delete exported files to avoid possible disclosure of exported data to backend users with lower/different access rights than user(s) who originally created the export(s). + + + Install Tool + + + PHP Modules + + + One or more modules are missing. + + + The following PHP module(s) is/are missing: %s. + + + You need to install and enable these modules to let TYPO3 function correctly. + + + one of: %s + + + All required modules are installed. + + + The Install Tool is temporarily enabled. Delete the file "%s" when you have finished setting up TYPO3. If not used the Install Tool will be disabled automatically in %s minutes. + + + System Status Update + + + Runs a system status check and sends notifications if problems have been found. + + + Send notification to: %s + + + Notification Email Addresses (one per line) + + + Empty or invalid notification email addresses. + + + Always send notification mail (not only on errors or warnings) + + + System Status Notification for site %s + + + Site + + + Issues + + + XCLASS used + + + Your system registers XCLASS + + + XCLASS can overwrite methods or classes of the core or other extensions. This is not necessarily a bad thing, but those XCLASS might break during extension or core upgrades. You should keep an eye on extension compatibility and make sure the intended functionality is still given after updates. + + + %2$s registers an XCLASS of %1$s + + + Image Processing + + + WebP support and availability + + + Image processing via ImageMagick/GraphicsMagick is disabled + + + WebP image generation is not enabled in $TYPO3_CONF_VARS[GFX][imagefile_ext]. No WebP image files will be generated. + + + WebP image generation is not enabled in $TYPO3_CONF_VARS[GFX][imagefile_ext], but it is supported by ImageMagick/GraphicsMagick. + + + WebP image generation is enabled in $TYPO3_CONF_VARS[GFX][imagefile_ext], but it is NOT supported by ImageMagick/GraphicsMagick. Please update your system environment or disable webp support in TYPO3 Configuration. + + + WebP image generation is enabled in $TYPO3_CONF_VARS[GFX][imagefile_ext] and supported by ImageMagick/GraphicsMagick — Everything is configured correctly. + + + AVIF support and availability + + + AVIF image generation is not enabled in $TYPO3_CONF_VARS[GFX][imagefile_ext]. No AVIF image files will be generated. + + + AVIF image generation is not enabled in $TYPO3_CONF_VARS[GFX][imagefile_ext], but it is supported by ImageMagick/GraphicsMagick. + + + AVIF image generation is enabled in $TYPO3_CONF_VARS[GFX][imagefile_ext], but it is NOT supported by ImageMagick/GraphicsMagick. Please update your system environment or disable AVIF support in TYPO3 Configuration. + + + AVIF image generation is enabled in $TYPO3_CONF_VARS[GFX][imagefile_ext] and supported by ImageMagick/GraphicsMagick — Everything is configured correctly. + + + This report was generated from the Command Line Interface (CLI) context. The PHP settings and modules might differ from the ones defined for the webserver process, for example when using a different php.ini file. In case of problems, always compare the report with the one generated via the backend report module. + + + + diff --git a/Resources/Private/Templates/ContentStatistics.fluid.html b/Resources/Private/Templates/ContentStatistics.fluid.html new file mode 100644 index 0000000..9fb8772 --- /dev/null +++ b/Resources/Private/Templates/ContentStatistics.fluid.html @@ -0,0 +1,113 @@ + + + + +

    {f:translate(key:'reports.messages:contentStatistics.title')}

    +

    {f:translate(key:'reports.messages:contentStatistics.description')}

    + + + {f:translate(key:'reports.messages:contentStatistics.existingElements.error')} + + + +

    {f:translate(key:'reports.messages:contentStatistics.existingElements.header')}

    +

    {f:translate(key:'reports.messages:contentStatistics.existingElements.description')}

    + {f:translate(key:'reports.messages:contentStatistics.existingElements.explanation')} + + + +

    {f:translate(key:groupItem.header, default:groupItem.header)} ({groupItem.elements -> f:count()})

    +     + + + +     +     +     + + +

    {f:translate(key:'reports.messages:contentStatistics.unusedElements.header')}

    +

    {f:translate(key:'reports.messages:contentStatistics.unusedElements.description')}

    + + + +

    {f:translate(key:groupItem.header, default:groupItem.header)} ({groupItem.elements -> f:count()})

    +     +
    + + + +
    +     +     +     +     + + +
    +

    +
    + +
    + + + + + + + + +
    + +
    + + + {f:translate(key:'core.common:details')} + +
    +     +
    +

    + +
    +     + + diff --git a/Resources/Private/Templates/ContentStatisticsDetail.fluid.html b/Resources/Private/Templates/ContentStatisticsDetail.fluid.html new file mode 100644 index 0000000..f309444 --- /dev/null +++ b/Resources/Private/Templates/ContentStatisticsDetail.fluid.html @@ -0,0 +1,174 @@ + + + + +

    {f:translate(key:label, default:label)} [{ctype}]

    +

    {f:translate(key:'reports.messages:contentStatistics.statistic')}

    +
    + + + + + + + + + + + + + +
    {f:translate(key:'core.general:LGL.enabled')}{count.visible}
    {f:translate(key:'core.general:LGL.disabled')}{count.hidden}
    {f:translate(key:'reports.messages:contentStatistics.statistic.deleted')}{count.deleted}
    +
    + +

    {f:translate(key:'reports.messages:contentStatistics.records')}

    + + +
    + + + + + + + + + + + + + + + + + + + + + + + +
    UID{f:translate(key:'frontend.db.tt_content:header')}{f:translate(key:'core.core:labels.pid')}{f:translate(key:'core.core:labels.tstamp')}{f:translate(key:'core.core:labels.path')}
    {row.uid} + + + {row.header} + + {row.pid}{row.tstamp_formatted}{row.path} +
    + + + +
    +
    +
    + + + + +     + + {f:translate(key:'reports.messages:contentStatistics.noRecords')} + +     +     + diff --git a/Resources/Private/Templates/Email/Report.fluid.txt b/Resources/Private/Templates/Email/Report.fluid.txt new file mode 100644 index 0000000..7f77d14 --- /dev/null +++ b/Resources/Private/Templates/Email/Report.fluid.txt @@ -0,0 +1,2 @@ + +{message -> f:format.raw()} diff --git a/Resources/Private/Templates/RecordStatistics.fluid.html b/Resources/Private/Templates/RecordStatistics.fluid.html new file mode 100644 index 0000000..45dfeb6 --- /dev/null +++ b/Resources/Private/Templates/RecordStatistics.fluid.html @@ -0,0 +1,98 @@ + + + + + +

    {f:translate(key:'title', domain:'reports.modules.statistics')}

    +

    {f:translate(key:'description', domain:'reports.modules.statistics')}

    + + +

    {f:translate(key:'pages', domain: 'reports.modules.statistics')}

    +
    + + + + + + + + + + + + + + + + + + + + + +
    {f:translate(key:'count', domain: 'reports.modules.statistics')}
    {item.icon}{f:translate(key:'{name}', domain: 'reports.modules.statistics')}{item.count}
    +
    + +

    {f:translate(key:'doktype', domain: 'reports.modules.statistics')}

    +
    + + + + + + + + + + + + + + + + + + + + + + +
    {f:translate(key:'doktype_value', domain: 'reports.modules.statistics')}{f:translate(key:'count', domain: 'reports.modules.statistics')}
    {item.icon}{item.title}{item.count}
    +
    + +

    {f:translate(key:'tables', domain: 'reports.modules.statistics')}

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {f:translate(domain:'reports.modules.statistics', key:'label')}{f:translate(domain:'reports.modules.statistics', key:'tablename')}{f:translate(domain:'reports.modules.statistics', key:'total_lost')}
    {item.icon}{item.title}{name}{item.count}{item.lostRecords}
    +
    +     + + diff --git a/Resources/Private/Templates/StatusReport.fluid.html b/Resources/Private/Templates/StatusReport.fluid.html new file mode 100644 index 0000000..d4b6944 --- /dev/null +++ b/Resources/Private/Templates/StatusReport.fluid.html @@ -0,0 +1,40 @@ + + + + + +

    + +

    +

    + +

    + + +

    {title}

    +
    + +
    +
    +
    + +
    +
    +
    + {status.title} +
    +
    + {status.value}
    + {status.message -> f:format.raw()} +
    +
    +     +
    +     +     + + diff --git a/Resources/Public/Icons/Extension.png b/Resources/Public/Icons/Extension.png new file mode 100644 index 0000000000000000000000000000000000000000..0e72907a5e5d4cf5a2106545cf9ec2de1446fe38 GIT binary patch literal 733 zcmV<30wVp1P)*5b?8;>_6N%-H48+vnBa>Db}w+2ZTl+tpL@%8QT_3rZa@ALNX^Y`)e`11Am^Y;4n`1<$x`}q0$`1<_$`~3R* z{rmj={Qds@{r>&_|Nj2}|NlS2=*j>90ZK_kK~z}7?bhc`0znjp;Xz?-GEC)@#CwaWCd zJiGwxN%U=x@CGo#0|`(-itR^10);RK9MAw3m_AZqfFuLVg8@vXuh0d6K?4~UV9t{5 z0Myo`_<`_>OhtO3L@_j52IHQCmiPIRl_Z05-8)VLN&$S!y&@Dt%@@j-m zo&9-KReports) backend module.", + "homepage": "https://typo3.community/", + "funding": [ + { + "type": "membership", + "url": "https://typo3.org/membership" + } + ], + "license": [ + "GPL-2.0-or-later" + ], + "authors": [ + { + "name": "TYPO3 Core Team", + "email": "typo3cms@typo3.org", + "role": "Developer" + } + ], + "support": { + "issues": "https://forge.typo3.org/issues/", + "forum": "https://talk.typo3.org/", + "source": "https://github.com/TYPO3/typo3/", + "docs": "https://docs.typo3.org/", + "rss": "https://news.typo3.com/rss/", + "chat": "https://typo3.community/meet/slack/", + "security": "https://typo3.org/security/" + }, + "config": { + "sort-packages": true + }, + "require": { + "typo3/cms-core": "15.0.*@dev" + }, + "suggest": { + "typo3/cms-scheduler": "Determine system's status and send it via email" + }, + "conflict": { + "typo3/cms": "*" + }, + "extra": { + "branch-alias": { + "dev-main": "15.0.x-dev" + }, + "typo3/cms": { + "Package": { + "partOfFactoryDefault": true + }, + "extension-key": "reports" + } + }, + "autoload": { + "psr-4": { + "TYPO3\\CMS\\Reports\\": "Classes/" + } + } +}