ext_localconf.php

<?php

declare(strict_types=1);

use Psr\Http\Message\ServerRequestInterface;
use TYPO3\CMS\Backend\Controller\FormSlugAjaxController as CoreFormSlugAjaxController;
use TYPO3\CMS\Backend\Form\FormDataProvider\TcaColumnsProcessCommon;
use TYPO3\CMS\Core\Http\ApplicationType;
use TYPO3\CMS\Core\DataHandling\SlugHelper as CoreSlugHelper;
use Wazum\Sluggi\DataHandling\SlugHelper;
use TYPO3\CMS\Core\Page\PageRenderer;
use Wazum\Sluggi\Compatibility\Typo3Compatibility;
use TYPO3\CMS\Redirects\Controller\RecordHistoryRollbackController as CoreRecordHistoryRollbackController;
use Wazum\Sluggi\Controller\FormSlugAjaxControllerV12;
use Wazum\Sluggi\Controller\FormSlugAjaxControllerV14;
use Wazum\Sluggi\Controller\RecordHistoryRollbackControllerV12;
use Wazum\Sluggi\Controller\RecordHistoryRollbackControllerV14;
use Wazum\Sluggi\DataHandler\BypassAccessCheckForRedirectCreation;
use Wazum\Sluggi\DataHandler\ClearSlugForExcludedDoktypes;
use Wazum\Sluggi\DataHandler\HandlePageCopy;
use Wazum\Sluggi\DataHandler\HandlePageMove;
use Wazum\Sluggi\DataHandler\HandlePageUndelete;
use Wazum\Sluggi\DataHandler\HandlePageUpdate;
use Wazum\Sluggi\DataHandler\HandleRecordUndelete;
use Wazum\Sluggi\DataHandler\InitializeSyncForNewPage;
use Wazum\Sluggi\DataHandler\HandleRecordUpdate;
use Wazum\Sluggi\DataHandler\PersistRecordSyncState;
use Wazum\Sluggi\DataHandler\HandleMasiExclusionChange;
use Wazum\Sluggi\DataHandler\LockSlugOnFullPathEdit;
use Wazum\Sluggi\DataHandler\PreventLockedSlugEdit;
use Wazum\Sluggi\DataHandler\ValidateHierarchyPermission;
use Wazum\Sluggi\DataHandler\ValidateLastSegmentOnly;
use Wazum\Sluggi\DataHandler\ValidateReservedSlugPath;
use Wazum\Sluggi\Form\Element\SlugElementV12;
use Wazum\Sluggi\Form\Element\SlugElementV14;
use Wazum\Sluggi\Form\Element\SlugSourceElementV12;
use Wazum\Sluggi\Form\Element\SlugSourceElementV14;
use Wazum\Sluggi\Form\FormDataProvider\HideSlugForExcludedPageTypes;
use Wazum\Sluggi\Form\FormDataProvider\InitializeSyncField;

// XCLASS
$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects'][CoreFormSlugAjaxController::class] = [
    'className' => Typo3Compatibility::getMajorVersion() >= 14
        ? FormSlugAjaxControllerV14::class
        : FormSlugAjaxControllerV12::class,
];

$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects'][CoreSlugHelper::class] = [
    'className' => SlugHelper::class,
];

$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects'][CoreRecordHistoryRollbackController::class] = [
    'className' => Typo3Compatibility::getMajorVersion() >= 14
        ? RecordHistoryRollbackControllerV14::class
        : RecordHistoryRollbackControllerV12::class,
];

// Form elements
$GLOBALS['TYPO3_CONF_VARS']['SYS']['formEngine']['nodeRegistry'][1733600000] = [
    'nodeName' => 'sluggiSlug',
    'priority' => 50,
    'class' => Typo3Compatibility::getMajorVersion() >= 13
        ? SlugElementV14::class
        : SlugElementV12::class,
];

$GLOBALS['TYPO3_CONF_VARS']['SYS']['formEngine']['nodeRegistry'][1733600001] = [
    'nodeName' => 'slugSourceInput',
    'priority' => 50,
    'class' => Typo3Compatibility::getMajorVersion() >= 13
        ? SlugSourceElementV14::class
        : SlugSourceElementV12::class,
];

// Form data providers
$GLOBALS['TYPO3_CONF_VARS']['SYS']['formEngine']['formDataGroup']['tcaDatabaseRecord'][HideSlugForExcludedPageTypes::class] = [
    'depends' => [TcaColumnsProcessCommon::class],
];

$GLOBALS['TYPO3_CONF_VARS']['SYS']['formEngine']['formDataGroup']['tcaDatabaseRecord'][InitializeSyncField::class] = [
    'depends' => [TcaColumnsProcessCommon::class],
];

// PageRenderer hook
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_pagerenderer.php']['render-preProcess']['sluggi'] =
    static function (array &$params, PageRenderer $pageRenderer): void {
        $request = $GLOBALS['TYPO3_REQUEST'] ?? null;
        if ($request instanceof ServerRequestInterface && ApplicationType::fromRequest($request)->isBackend()) {
            $pageRenderer->addCssFile('EXT:sluggi/Resources/Public/Css/sluggi-source-field.css');
            $pageRenderer->addInlineLanguageLabelFile('EXT:sluggi/Resources/Private/Language/locallang.xlf', 'contextMenu.');

            // Load redirect notification handler when redirect control is enabled
            try {
                $redirectControlEnabled = (bool)(\TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(
                    \TYPO3\CMS\Core\Configuration\ExtensionConfiguration::class
                )->get('sluggi', 'redirect_control') ?? true);
            } catch (\Exception) {
                $redirectControlEnabled = true;
            }
            if ($redirectControlEnabled) {
                $pageRenderer->loadJavaScriptModule('@wazum/sluggi/redirect-notification-handler.js');
                if (Typo3Compatibility::getMajorVersion() >= 14) {
                    $pageRenderer->addInlineLanguageLabelFile(
                        'EXT:redirects/Resources/Private/Language/locallang_slug_service.xlf'
                    );
                }
            }
        }
    };

// DataHandler hooks — order matters. Registration order determines execution order within each hook phase.
// processDatamap_beforeStart:
//   - BypassAccessCheckForRedirectCreation: grant redirect storage write for nested DataHandler calls.
// processDatamap_preProcessFieldArray:
//   - ValidateHierarchyPermission and PreventLockedSlugEdit guard submitted slugs before field processing.
//   - PersistRecordSyncState captures tx_sluggi_sync from non-page table forms before HandleRecordUpdate reads it later.
//   - ValidateLastSegmentOnly validates submitted slugs before field processing; nested slug cascades are skipped by correlation id.
// processDatamap_postProcessFieldArray:
//   - ClearSlugForExcludedDoktypes strips slug/sync for excluded page types before page regeneration.
//   - HandlePageUpdate auto-regenerates page slugs when source fields changed.
//   - HandleRecordUpdate auto-regenerates non-page table slugs configured in synchronize_tables.
//   - ValidateReservedSlugPath rejects reserved final page slugs on update and rewrites reserved slugs on create.
// processCmdmap hooks (copy/undelete) and moveRecord (move) run independently per operation.
// Sync/lock field initialisers are registered last because they only seed defaults on new records.
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_redirect_access'] =
    BypassAccessCheckForRedirectCreation::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_exclude_doktypes'] =
    ClearSlugForExcludedDoktypes::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_hierarchy'] =
    ValidateHierarchyPermission::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_lock'] =
    PreventLockedSlugEdit::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_update'] =
    HandlePageUpdate::class;

// Must run before HandleRecordUpdate to intercept and persist tx_sluggi_sync
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_record_sync_persist'] =
    PersistRecordSyncState::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_record_update'] =
    HandleRecordUpdate::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_validate'] =
    ValidateLastSegmentOnly::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_reserved_path'] =
    ValidateReservedSlugPath::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processCmdmapClass']['sluggi_copy'] =
    HandlePageCopy::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processCmdmapClass']['sluggi_undelete'] =
    HandlePageUndelete::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processCmdmapClass']['sluggi_record_undelete'] =
    HandleRecordUndelete::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['moveRecordClass']['sluggi_move'] =
    HandlePageMove::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_sync_new'] =
    InitializeSyncForNewPage::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_lock_full_path'] =
    LockSlugOnFullPathEdit::class;

$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']['processDatamapClass']['sluggi_masi'] =
    HandleMasiExclusionChange::class;

// Override core "URL Segment" label to "URL Path"
$GLOBALS['TYPO3_CONF_VARS']['SYS']['locallangXMLOverride']['EXT:core/Resources/Private/Language/locallang_tca.xlf'][] =
    'EXT:sluggi/Resources/Private/Language/Overrides/locallang_tca.xlf';
$GLOBALS['TYPO3_CONF_VARS']['SYS']['locallangXMLOverride']['de']['EXT:core/Resources/Private/Language/locallang_tca.xlf'][] =
    'EXT:sluggi/Resources/Private/Language/Overrides/de.locallang_tca.xlf';