LinkValidatorReport.php

Go to the documentation of this file.

<?php
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Linkvalidator\Report;
 
use ‪TYPO3\CMS\Backend\Routing\UriBuilder;
use ‪TYPO3\CMS\Backend\Template\ModuleTemplate;
use ‪TYPO3\CMS\Backend\Utility\BackendUtility;
use ‪TYPO3\CMS\Core\Authentication\BackendUserAuthentication;
use ‪TYPO3\CMS\Core\Database\ConnectionPool;
use ‪TYPO3\CMS\Core\Database\Query\QueryHelper;
use ‪TYPO3\CMS\Core\Database\Query\Restriction\DeletedRestriction;
use ‪TYPO3\CMS\Core\Imaging\Icon;
use ‪TYPO3\CMS\Core\Imaging\IconFactory;
use ‪TYPO3\CMS\Core\Localization\LanguageService;
use ‪TYPO3\CMS\Core\Messaging\FlashMessage;
use ‪TYPO3\CMS\Core\Messaging\FlashMessageService;
use ‪TYPO3\CMS\Core\Type\Bitmask\Permission;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Fluid\View\StandaloneView;
use ‪TYPO3\CMS\Info\Controller\InfoModuleController;
use ‪TYPO3\CMS\Linkvalidator\LinkAnalyzer;
use ‪TYPO3\CMS\Linkvalidator\Linktype\LinktypeInterface;
use ‪TYPO3\CMS\Linkvalidator\Repository\BrokenLinkRepository;
 
class ‪LinkValidatorReport
{
    protected ‪$pageRecord = [];
 
    protected ‪$isAccessibleForCurrentUser = false;
 
    protected ‪$linkAnalyzer;
 
    protected ‪$modTS = [];
 
    protected ‪$availableOptions = [];
 
    protected ‪$searchLevel = ['report' => 0, 'check' => 0];
 
    protected ‪$checkOpt = ['report' => [], 'check' => []];
 
    protected ‪$lastEditedRecord = [
        'uid'   => 0,
        'table' => '',
        'field' => '',
        'timestamp' => 0
    ];
 
    protected ‪$hookObjectsArr = [];
 
    protected ‪$iconFactory;
 
    protected ‪$id;
 
    protected ‪$pObj;
 
    protected ‪$searchFields = [];
 
    protected ‪$brokenLinkRepository;
 
    protected ‪$moduleTemplate;
 
    protected ‪$view;
 
    public function ‪__construct()
    {
        $this->brokenLinkRepository = GeneralUtility::makeInstance(BrokenLinkRepository::class);
    }
 
    public function ‪init(‪$pObj)
    {
        $this->pObj = ‪$pObj;
        $this->id = (int)GeneralUtility::_GP('id');
        $this->brokenLinkRepository = GeneralUtility::makeInstance(BrokenLinkRepository::class);
        $this->iconFactory = GeneralUtility::makeInstance(IconFactory::class);
        $this->moduleTemplate = GeneralUtility::makeInstance(ModuleTemplate::class);
        $this->view = $this->‪createView('InfoModule');
    }
 
    protected function ‪createView(string $templateName): ‪StandaloneView
    {
        ‪$view = GeneralUtility::makeInstance(StandaloneView::class);
        ‪$view->‪setLayoutRootPaths(['EXT:linkvalidator/Resources/Private/Layouts']);
        ‪$view->‪setPartialRootPaths(['EXT:linkvalidator/Resources/Private/Partials']);
        ‪$view->‪setTemplateRootPaths(['EXT:linkvalidator/Resources/Private/Templates/Backend']);
        ‪$view->‪setTemplate($templateName);
        ‪$view->‪assign('pageId', $this->id);
        return ‪$view;
    }
 
    protected function ‪validateSettings()
    {
        $prefix = 'check';
        $other = 'report';
        if (empty(GeneralUtility::_GP('updateLinkList'))) {
            $prefix = 'report';
            $other = 'check';
        }
 
        // get information for last edited record
        $this->lastEditedRecord['uid'] = GeneralUtility::_GP('last_edited_record_uid') ?? 0;
        $this->lastEditedRecord['table'] = GeneralUtility::_GP('last_edited_record_table') ?? '';
        $this->lastEditedRecord['field'] = GeneralUtility::_GP('last_edited_record_field') ?? '';
        $this->lastEditedRecord['timestamp'] = GeneralUtility::_GP('last_edited_record_timestamp') ?? 0;
 
        // get searchLevel (number of levels of pages to check / show results)
        $this->searchLevel[$prefix] = GeneralUtility::_GP($prefix . '_search_levels');
        if (isset($this->searchLevel[$prefix])) {
            $this->pObj->MOD_SETTINGS[$prefix . '_searchlevel'] = $this->searchLevel[$prefix];
        } else {
            $this->searchLevel[$prefix] = $this->pObj->MOD_SETTINGS[$prefix . '_searchlevel'];
        }
        if (isset($this->pObj->MOD_SETTINGS[$other . '_searchlevel'])) {
            $this->searchLevel[$other] = $this->pObj->MOD_SETTINGS[$other . '_searchlevel'];
        }
 
        // which linkTypes to check (internal, file, external, ...)
        $set = GeneralUtility::_GP($prefix . '_SET');
 
        foreach (‪$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['linkvalidator']['checkLinks'] ?? [] as $linkType => $value) {
            // Compile list of all available types. Used for checking with button "Check Links".
            if (strpos($this->modTS['linktypes'], $linkType) !== false) {
                $this->availableOptions[$linkType] = 1;
            }
 
            // 1) if "$prefix_values" = "1" : use POST variables
            // 2) if not set, use stored configuration in $this->>pObj->MOD_SETTINGS
            // 3) if not set, use default
            unset($this->checkOpt[$prefix][$linkType]);
            if (!empty(GeneralUtility::_GP($prefix . '_values'))) {
                if (isset($set[$linkType])) {
                    $this->checkOpt[$prefix][$linkType] = $set[$linkType];
                } else {
                    $this->checkOpt[$prefix][$linkType] = '0';
                }
                $this->pObj->MOD_SETTINGS[$prefix . '_' . $linkType] = $this->checkOpt[$prefix][$linkType];
            } elseif (isset($this->pObj->MOD_SETTINGS[$prefix . '_' . $linkType])) {
                $this->checkOpt[$prefix][$linkType] = $this->pObj->MOD_SETTINGS[$prefix . '_' . $linkType];
            } else {
                // use default
                $this->checkOpt[$prefix][$linkType] = '0';
                $this->pObj->MOD_SETTINGS[$prefix . '_' . $linkType] = $this->checkOpt[$prefix][$linkType];
            }
            if (isset($this->pObj->MOD_SETTINGS[$other . '_' . $linkType])) {
                $this->checkOpt[$other][$linkType] = $this->pObj->MOD_SETTINGS[$other . '_' . $linkType];
            }
        }
 
        // save settings
        $this->‪getBackendUser()->‪pushModuleData('web_info', $this->pObj->MOD_SETTINGS);
    }
    public function ‪main()
    {
        $this->‪getLanguageService()->‪includeLLFile('EXT:linkvalidator/Resources/Private/Language/Module/locallang.xlf');
        if (isset($this->id)) {
            $this->modTS = ‪BackendUtility::getPagesTSconfig($this->id)['mod.']['linkvalidator.'] ?? [];
        }
        $this->‪validateSettings();
        $this->‪initialize();
 
        if (GeneralUtility::_GP('updateLinkList')) {
            $this->‪updateBrokenLinks();
        } elseif ($this->lastEditedRecord['uid']) {
            if ($this->modTS['actionAfterEditRecord'] === 'recheck') {
                // recheck broken links for last edited reccord
                $this->linkAnalyzer->recheckLinks(
                    $this->checkOpt['check'],
                    $this->lastEditedRecord['uid'],
                    $this->lastEditedRecord['table'],
                    $this->lastEditedRecord['field'],
                    (int)$this->lastEditedRecord['timestamp']
                );
            } else {
                // mark broken links for last edited record as needing a recheck
                $this->brokenLinkRepository->setNeedsRecheckForRecord(
                    (int)$this->lastEditedRecord['uid'],
                    $this->lastEditedRecord['table']
                );
            }
        }
 
        $pageTitle = $this->pageRecord ? ‪BackendUtility::getRecordTitle('pages', $this->pageRecord) : '';
        $this->view->assign('title', $pageTitle);
        $this->view->assign('content', $this->‪renderContent());
        return $this->view->render();
    }
 
    protected function ‪renderContent(): string
    {
        if (!$this->isAccessibleForCurrentUser) {
            // If no access or if ID == zero
            $this->moduleTemplate->addFlashMessage(
                $this->‪getLanguageService()->getLL('no.access'),
                $this->‪getLanguageService()->getLL('no.access.title'),
                ‪FlashMessage::ERROR
            );
            return '';
        }
 
        $groupedBrokenLinkCounts = $this->linkAnalyzer->getLinkCounts();
 
        $reportsTabView = $this->‪createViewForBrokenLinksTab($groupedBrokenLinkCounts);
        $menuItems = [
            0 => [
                'label' => $this->‪getLanguageService()->‪getLL('Report'),
                'content' => $reportsTabView->render()
            ],
        ];
 
        if ((bool)$this->modTS['showCheckLinkTab']) {
            $reportsTabView = $this->‪createView('CheckLinksTab');
            $reportsTabView->assignMultiple([
                'prefix' => 'check',
                'selectedLevel' => $this->searchLevel['check'],
                'options' => $this->‪getCheckOptions($groupedBrokenLinkCounts, 'check'),
            ]);
            $menuItems[1] = [
                'label' => $this->‪getLanguageService()->‪getLL('CheckLink'),
                'content' => $reportsTabView->render()
            ];
        }
        return $this->moduleTemplate->getDynamicTabMenu($menuItems, 'report-linkvalidator');
    }
 
    protected function ‪initialize()
    {
        foreach (‪$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['linkvalidator']['checkLinks'] ?? [] as $linkType => $className) {
            $this->hookObjectsArr[$linkType] = GeneralUtility::makeInstance($className);
        }
 
        $this->pageRecord = ‪BackendUtility::readPageAccess($this->id, $this->‪getBackendUser()->getPagePermsClause(‪Permission::PAGE_SHOW));
        if (($this->id && is_array($this->pageRecord)) || (!$this->id && $this->‪getBackendUser()->isAdmin())) {
            $this->isAccessibleForCurrentUser = true;
        }
        // Don't access in workspace
        if ($this->‪getBackendUser()->workspace !== 0) {
            $this->isAccessibleForCurrentUser = false;
        }
 
        $pageRenderer = $this->moduleTemplate->getPageRenderer();
        $pageRenderer->addCssFile('EXT:linkvalidator/Resources/Public/Css/linkvalidator.css', 'stylesheet', 'screen');
        $pageRenderer->loadRequireJsModule('TYPO3/CMS/Linkvalidator/Linkvalidator');
        $pageRenderer->addInlineLanguageLabelFile('EXT:linkvalidator/Resources/Private/Language/Module/locallang.xlf');
 
        $this->‪initializeLinkAnalyzer();
    }
 
    protected function ‪initializeLinkAnalyzer()
    {
        $this->linkAnalyzer = GeneralUtility::makeInstance(LinkAnalyzer::class);
        // Get the searchFields from TSconfig
        foreach ($this->modTS['searchFields.'] as $table => $fieldList) {
            ‪$fields = ‪GeneralUtility::trimExplode(',', $fieldList, true);
            foreach (‪$fields as $field) {
                if (!$this->searchFields || !is_array($this->searchFields[$table]) || !in_array(
                    $field,
                    $this->searchFields[$table],
                    true
                )) {
                    $this->searchFields[$table][] = $field;
                }
            }
        }
 
        $rootLineHidden = $this->linkAnalyzer->getRootLineIsHidden($this->pObj->pageinfo);
        if (!$rootLineHidden || $this->modTS['checkhidden'] == 1) {
            $this->linkAnalyzer->init(
                $this->searchFields,
                $this->‪getPageList(),
                $this->modTS
            );
        }
    }
 
    protected function ‪updateBrokenLinks()
    {
        $this->linkAnalyzer->getLinkStatistics($this->checkOpt['check'], $this->modTS['checkhidden']);
    }
 
    protected function ‪createViewForBrokenLinksTab(array $amountOfBrokenLinks)
    {
        ‪$view = $this->‪createView('ReportTab');
        ‪$view->‪assignMultiple([
            'prefix' => 'report',
            'selectedLevel' => $this->searchLevel['report'],
            'options' => $this->‪getCheckOptions($amountOfBrokenLinks, 'report'),
        ]);
        // Table header
        ‪$view->‪assignMultiple($this->‪getVariablesForTableHeader());
 
        $linkTypes = [];
        if (is_array($this->checkOpt['report'])) {
            $linkTypes = array_keys($this->checkOpt['report'], '1');
        }
        $items = [];
        $rootLineHidden = $this->linkAnalyzer->getRootLineIsHidden($this->pObj->pageinfo);
        if (!$rootLineHidden || (bool)$this->modTS['checkhidden'] && !empty($linkTypes)) {
            $brokenLinks = $this->brokenLinkRepository->getAllBrokenLinksForPages(
                $this->‪getPageList(),
                $linkTypes,
                $this->searchFields
            );
            foreach ($brokenLinks as $row) {
                $items[] = $this->‪renderTableRow($row['table_name'], $row);
            }
        }
        if (empty($items)) {
            $this->‪createFlashMessagesForNoBrokenLinks();
        }
        ‪$view->‪assign('brokenLinks', $items);
        return ‪$view;
    }
 
    protected function ‪getPageList(): array
    {
        $permsClause = $this->‪getBackendUser()->‪getPagePermsClause(‪Permission::PAGE_SHOW);
        $pageList = $this->linkAnalyzer->extGetTreeList(
            $this->id,
            $this->searchLevel['report'],
            0,
            $permsClause,
            $this->modTS['checkhidden']
        );
        // Always add the current page, because we are just displaying the results
        $pageList .= ‪$this->id;
        $pageList = $this->‪addPageTranslationsToPageList($pageList, $permsClause);
        return ‪GeneralUtility::intExplode(',', $pageList, true);
    }
 
    protected function ‪createFlashMessagesForNoBrokenLinks(): void
    {
        $message = GeneralUtility::makeInstance(
            FlashMessage::class,
            $this->‪getLanguageService()->getLL('list.no.broken.links'),
            $this->‪getLanguageService()->getLL('list.no.broken.links.title'),
            ‪FlashMessage::OK,
            false
        );
        $flashMessageService = GeneralUtility::makeInstance(FlashMessageService::class);
        $defaultFlashMessageQueue = $flashMessageService->getMessageQueueByIdentifier('linkvalidator');
        $defaultFlashMessageQueue->enqueue($message);
    }
 
    protected function ‪getVariablesForTableHeader(): array
    {
        $languageService = $this->‪getLanguageService();
        $variables = [
            'tableheadPath' => $languageService->getLL('list.tableHead.path'),
            'tableheadElement' => $languageService->getLL('list.tableHead.element'),
            'tableheadHeadlink' => $languageService->getLL('list.tableHead.headlink'),
            'tableheadLinktarget' => $languageService->getLL('list.tableHead.linktarget'),
            'tableheadLinkmessage' => $languageService->getLL('list.tableHead.linkmessage'),
            'tableheadLastcheck' => $languageService->getLL('list.tableHead.lastCheck'),
        ];
 
        // Add CSH to the header of each column
        foreach ($variables as $column => $label) {
            $variables[$column] = ‪BackendUtility::wrapInHelp('linkvalidator', $column, $label);
        }
        return $variables;
    }
 
    protected function ‪renderTableRow($table, array $row)
    {
        $languageService = $this->‪getLanguageService();
        $variables = [];
        $fieldName = '';
        // Restore the linktype object
        $hookObj = $this->hookObjectsArr[$row['link_type']];
 
        // Construct link to edit the content element
        $requestUri = GeneralUtility::getIndpEnv('REQUEST_URI') .
            '&id=' . $this->id .
            '&search_levels=' . $this->searchLevel['report'] .
            // add record_uid as query parameter for rechecking after edit
            '&last_edited_record_uid=' . $row['record_uid'] .
            '&last_edited_record_table=' . $row['table_name'] .
            '&last_edited_record_field=' . $row['field'] .
            '&last_edited_record_timestamp=' . ‪$GLOBALS['EXEC_TIME'];
 
        $uriBuilder = GeneralUtility::makeInstance(UriBuilder::class);
        $url = (string)$uriBuilder->buildUriFromRoute('record_edit', [
            'edit' => [
                $table => [
                    $row['record_uid'] => 'edit'
                ]
            ],
            'columnsOnly' => $row['field'],
            'returnUrl' => $requestUri
        ]);
        $variables['editUrl'] = $url;
        $elementHeadline = $row['headline'];
        // Get the language label for the field from TCA
        if (‪$GLOBALS['TCA'][$table]['columns'][$row['field']]['label']) {
            $fieldName = $languageService->sL(‪$GLOBALS['TCA'][$table]['columns'][$row['field']]['label']);
            // Crop colon from end if present
            if (substr($fieldName, -1, 1) === ':') {
                $fieldName = substr($fieldName, 0, strlen($fieldName) - 1);
            }
        }
        // Fallback, if there is no label
        $fieldName = !empty($fieldName) ? $fieldName : $row['field'];
        // column "Element"
        $element = '<span title="' . htmlspecialchars($table . ':' . $row['record_uid']) . '">' . $this->iconFactory->getIconForRecord($table, $row, ‪Icon::SIZE_SMALL)->render() . '</span>';
        if (empty($elementHeadline)) {
            $element .= '<i>' . htmlspecialchars($languageService->getLL('list.no.headline')) . '</i>';
        } else {
            $element .= htmlspecialchars($elementHeadline);
        }
        $element .= ' ' . htmlspecialchars(sprintf($languageService->getLL('list.field'), $fieldName));
        $variables['element'] = $element;
        $variables['path'] = ‪BackendUtility::getRecordPath($row['record_pid'], '', 0, 0);
        $variables['link_title'] = $row['link_title'];
        $variables['linktarget'] = $hookObj->getBrokenUrl($row);
        $response = $row['url_response'];
        if ($response['valid']) {
            $linkMessage = '<span class="valid">' . htmlspecialchars($languageService->getLL('list.msg.ok')) . '</span>';
        } else {
            $linkMessage = '<span class="error">'
                . nl2br(
                // Encode for output
                    htmlspecialchars(
                        $hookObj->getErrorMessage($response['errorParams']),
                        ENT_QUOTES,
                        'UTF-8',
                        false
                    )
                )
                . '</span>';
        }
        $variables['linkmessage'] = $linkMessage;
        $lastRunDate = date(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['ddmmyy'], $row['last_check']);
        $lastRunTime = date(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['hhmm'], $row['last_check']);
        $variables['lastcheck'] = htmlspecialchars(sprintf($languageService->getLL('list.msg.lastRun'), $lastRunDate, $lastRunTime));
        $variables['needs_recheck'] = (bool)$row['needs_recheck'];
        return $variables;
    }
 
    protected function ‪getCheckOptions(array $brokenLinkOverView, $prefix)
    {
        $variables = [];
        $variables['totalCountLabel'] = ‪BackendUtility::wrapInHelp('linkvalidator', 'checkboxes', $this->‪getLanguageService()->getLL('overviews.nbtotal'));
        $variables['totalCount'] = $brokenLinkOverView['total'] ?: '0';
        $variables['optionsByType'] = [];
        $linkTypes = ‪GeneralUtility::trimExplode(',', $this->modTS['linktypes'] ?? '', true);
        $availableLinkTypes = array_keys($this->hookObjectsArr);
        foreach ($availableLinkTypes as $type) {
            if (!in_array($type, $linkTypes, true)) {
                continue;
            }
            $label = $this->‪getLanguageService()->‪getLL('hooks.' . $type) ?: $type;
            $variables['optionsByType'][$type] = [
                'count' => $brokenLinkOverView[$type] ?: '0',
                'checkbox' => '<input type="checkbox" class="' . $prefix . '"'
                    . ' id="' . $prefix . '_SET_' . $type
                    . '" name="' . $prefix . '_SET[' . $type . ']" value="1"'
                    . ' ' . ($this->checkOpt[$prefix][$type] ? 'checked="checked"' : '') . '/>',
                'label' => '<label for="' . $prefix . '_SET_' . $type . '">&nbsp;' . htmlspecialchars($label) . '</label>'
            ];
        }
        return $variables;
    }
 
    protected function ‪getLanguageService(): ‪LanguageService
    {
        return ‪$GLOBALS['LANG'];
    }
 
    protected function ‪getBackendUser(): BackendUserAuthentication
    {
        return ‪$GLOBALS['BE_USER'];
    }
 
    protected function ‪addPageTranslationsToPageList(string $theList, string $permsClause): string
    {
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)->getQueryBuilderForTable('pages');
        $queryBuilder->getRestrictions()
            ->removeAll()
            ->add(GeneralUtility::makeInstance(DeletedRestriction::class));
 
        $result = $queryBuilder
            ->select('uid', 'title', 'hidden')
            ->from('pages')
            ->where(
                $queryBuilder->expr()->eq(
                    'l10n_parent',
                    $queryBuilder->createNamedParameter($this->id, \PDO::PARAM_INT)
                ),
                ‪QueryHelper::stripLogicalOperatorPrefix($permsClause)
            )
            ->execute();
 
        while ($row = $result->fetch()) {
            if ($row['hidden'] === 0 || $this->modTS['checkhidden']) {
                $theList .= ',' . $row['uid'];
            }
        }
 
        return $theList;
    }
}