Hi guys,<\/p>\n
In my PIT Solutions days, a backend module meant a call to I still see old tutorials ranking high in search, so here is a complete small module that runs on v13 and v14. It lists the redirects of the installation, read-only, so editors can look up where an old URL goes without opening the Redirects module with full rights. The extension key is A few keys need a word:<\/p>\n The label file is the classic XLIFF:<\/p>\n Things I like here. The controller needs DI, so the extension must have a For non-Extbase modules, the view looks for templates in Note the plain Admins see the module right away after a cache flush. Editors do not, and that is correct. In the backend, open the editor’s backend user group, go to the tab with module permissions and tick “Redirect overview”. The permission lands in One more thing to think about: the module shows the whole Then log in once as admin and once as a test editor. The admin should see “Redirect overview” below the Web (v13) or Content (v14) main module, the editor only after the group got the permission. If opening the module gives an error that the controller cannot be created, the attribute was not picked up. In my experience that is almost always a missing or wrong That is all. No Module registration in ext_tables.php is gone. A small backend module for TYPO3 v13 and v14 with Modules.php, #[AsController], ModuleTemplateFactory and editor access.<\/p>\n","protected":false},"author":1,"featured_media":83,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[17],"tags":[30,32,33,24],"class_list":["post-82","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-typo3","tag-extension-development","tag-php-8","tag-typo3-v13","tag-typo3-v14"],"yoast_head":"\nExtensionUtility::registerModule()<\/code> in ext_tables.php<\/code>, a long array of options, and a bit of hope. That way was removed in TYPO3 v12, when the new module registration API arrived (Feature-96733<\/code>). Today a module is a plain PHP array in Configuration\/Backend\/Modules.php<\/code> plus a controller that the dependency injection container knows about.<\/p>\nsitepackage<\/code> and the namespace HarvisoftSitepackage<\/code>; change both for your project.<\/p>\nStep 1: register the module<\/h2>\n
<?php\n\n\/\/ EXT:sitepackage\/Configuration\/Backend\/Modules.php\nuse HarvisoftSitepackageControllerRedirectOverviewController;\n\nreturn [\n 'sitepackage_redirects' => [\n 'parent' => 'web',\n 'position' => ['after' => '*'],\n 'access' => 'user',\n 'workspaces' => 'live',\n 'path' => '\/module\/sitepackage\/redirects',\n 'iconIdentifier' => 'mimetypes-x-sys_redirect',\n 'labels' => 'LLL:EXT:sitepackage\/Resources\/Private\/Language\/locallang_mod_redirects.xlf',\n 'routes' => [\n '_default' => [\n 'target' => RedirectOverviewController::class . '::handleRequest',\n ],\n ],\n ],\n];<\/code><\/pre>\n\n
parent<\/code>: in v14 the main module “Web” was renamed to “Content”, with the identifier content<\/code> (Feature-107628<\/code>). The old identifier web<\/code> is registered as an alias, and the module factory resolves aliases in parent<\/code>. I checked that in the v14.3 source. So web<\/code> works on both versions. For a v14-only extension, write content<\/code>.<\/li>\naccess<\/code>: user<\/code> means editors can get it through their group rights. admin<\/code> and systemMaintainer<\/code> are the stricter values. Since v14.2 these checks are “access gates”, and you can even add your own with #[AsModuleAccessGate]<\/code> (Feature-109365<\/code>), but that does not exist in v13.<\/li>\nlabels<\/code>: an LLL:<\/code> path to a file with the keys mlang_tabs_tab<\/code>, mlang_labels_tabdescr<\/code> and mlang_labels_tablabel<\/code>. v14 also understands the new translation domain syntax like sitepackage.module<\/code>, but the file path works on both.<\/li>\nroutes<\/code>: for a non-Extbase module you point _default<\/code> to a controller method. Extbase modules use extensionName<\/code> and controllerActions<\/code> instead.<\/li>\n<\/ul>\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<xliff version=\"1.2\" xmlns=\"urn:oasis:names:tc:xliff:document:1.2\">\n <file source-language=\"en\" datatype=\"plaintext\" original=\"EXT:sitepackage\/Resources\/Private\/Language\/locallang_mod_redirects.xlf\" date=\"2026-10-15T00:00:00Z\" product-name=\"sitepackage\">\n <body>\n <trans-unit id=\"mlang_tabs_tab\">\n <source>Redirect overview<\/source>\n <\/trans-unit>\n <trans-unit id=\"mlang_labels_tablabel\">\n <source>Where old URLs go<\/source>\n <\/trans-unit>\n <trans-unit id=\"mlang_labels_tabdescr\">\n <source>Read-only list of all active redirects.<\/source>\n <\/trans-unit>\n <\/body>\n <\/file>\n<\/xliff><\/code><\/pre>\nStep 2: the controller<\/h2>\n
<?php\n\ndeclare(strict_types=1);\n\nnamespace HarvisoftSitepackageController;\n\nuse PsrHttpMessageResponseInterface;\nuse PsrHttpMessageServerRequestInterface;\nuse TYPO3CMSBackendAttributeAsController;\nuse TYPO3CMSBackendTemplateModuleTemplateFactory;\nuse TYPO3CMSCoreDatabaseConnectionPool;\n\n#[AsController]\nfinal readonly class RedirectOverviewController\n{\n public function __construct(\n private ModuleTemplateFactory $moduleTemplateFactory,\n private ConnectionPool $connectionPool,\n ) {}\n\n public function handleRequest(ServerRequestInterface $request): ResponseInterface\n {\n $queryBuilder = $this->connectionPool->getQueryBuilderForTable('sys_redirect');\n $redirects = $queryBuilder\n ->select('source_host', 'source_path', 'target', 'target_statuscode', 'hitcount')\n ->from('sys_redirect')\n ->orderBy('source_host')\n ->addOrderBy('source_path')\n ->executeQuery()\n ->fetchAllAssociative();\n\n $view = $this->moduleTemplateFactory->create($request);\n $view->setTitle('Redirect overview');\n $view->assign('redirects', $redirects);\n\n return $view->renderResponse('RedirectOverview\/Index');\n }\n}<\/code><\/pre>\n#[AsController]<\/code> tags the class so the backend can create it with its dependencies; it came in v13.0 and replaced the v12 #[Controller]<\/code> attribute (Feature-102631<\/code>). The query builder applies the default restrictions, so deleted and disabled redirects are not listed. And ModuleTemplateFactory::create()<\/code> gives you the full backend frame: doc header, flash messages, the right CSS. The core’s own About module is built the same way, if you want a reference to read.<\/p>\nConfiguration\/Services.yaml<\/code> with autowire: true<\/code>, autoconfigure: true<\/code> and the Classes\/<\/code> folder as resource. Most sitepackages have it already.<\/p>\nStep 3: the template<\/h2>\n
Resources\/Private\/Templates<\/code> of the extension that registered the route, and the layout Module<\/code> comes from EXT:backend. So the file is Resources\/Private\/Templates\/RedirectOverview\/Index.html<\/code>:<\/p>\n<html xmlns:f=\"http:\/\/typo3.org\/ns\/TYPO3\/CMS\/Fluid\/ViewHelpers\" data-namespace-typo3-fluid=\"true\">\n\n<f:layout name=\"Module\" \/>\n\n<f:section name=\"Content\">\n <h1>Redirect overview<\/h1>\n <f:if condition=\"{redirects}\">\n <f:then>\n <div class=\"table-fit\">\n <table class=\"table table-striped table-hover\">\n <thead>\n <tr>\n <th>Host<\/th>\n <th>Old path<\/th>\n <th>Target<\/th>\n <th>Status<\/th>\n <th>Hits<\/th>\n <\/tr>\n <\/thead>\n <tbody>\n <f:for each=\"{redirects}\" as=\"redirect\">\n <tr>\n <td>{redirect.source_host}<\/td>\n <td><code>{redirect.source_path}<\/code><\/td>\n <td>{redirect.target}<\/td>\n <td>{redirect.target_statuscode}<\/td>\n <td>{redirect.hitcount}<\/td>\n <\/tr>\n <\/f:for>\n <\/tbody>\n <\/table>\n <\/div>\n <\/f:then>\n <f:else>\n <f:be.infobox title=\"No redirects\" state=\"-1\">There are no active redirects.<\/f:be.infobox>\n <\/f:else>\n <\/f:if>\n<\/f:section>\n<\/html><\/code><\/pre>\n.html<\/code> name. v14 also accepts Index.fluid.html<\/code> and prefers it, but v13 does not know that extension. For a module that must run on both, stay with .html<\/code>.<\/p>\nStep 4: access for editors<\/h2>\n
be_groups.groupMods<\/code>. If you deploy groups as code, add the module identifier sitepackage_redirects<\/code> there.<\/p>\nsys_redirect<\/code> table, across all sites. The table definition of EXT:redirects ignores web mounts on purpose, and my query does too. For a multi-site installation where editors should only see their own site, filter by source_host<\/code> using the sites the editor can access. Do not hand out data just because the module was easy to build.<\/p>\nCheck it<\/h2>\n
ddev exec vendor\/bin\/typo3 cache:flush<\/code><\/pre>\nServices.yaml<\/code>, or a cache that was not flushed after adding it.<\/p>\next_tables.php<\/code>, no magic strings for the module key, and a controller you can unit test. If this post saved you an evening, I will be really happy.<\/p>\nFurther reading<\/h2>\n
\n