---
title: "Version 5.x"
manual: "T3Extblog (T3Blog Extbase)"
version: "main"
permalink: "https://docs.typo3.org/permalink/felixnagel/t3extblog:upgrade-guide-v5@main"
source: "UpgradeGuide/Version-5.rst"
rendered: "2026-11-04T21:49:38+00:00"
---

# Version 5.x {#upgrade-guide-v5}

**Within this page**

-   [Upgrade from 5.1.0 to 5.1.1](https://docs.typo3.org/permalink/felixnagel/t3extblog:upgrade-from-5-1-0-to-5-1-1@main)
-   [Upgrade from 5.0.0 to 5.1.0](https://docs.typo3.org/permalink/felixnagel/t3extblog:upgrade-from-5-0-0-to-5-1-0@main)
-   [Upgrade from 4.x to 5.0.0](https://docs.typo3.org/permalink/felixnagel/t3extblog:upgrade-from-4-x-to-5-0-0@main)

## Upgrade from 5.1.0 to 5.1.1 {#upgrade-from-5-1-0-to-5-1-1}

### Changelog {#changelog}

[https://github.com/fnagel/t3extblog/compare/5.1.0...5.1.1](https://github.com/fnagel/t3extblog/compare/5.1.0...5.1.1)

-   Fix issues with routing in latest TYPO3 versions
-   Improve post routing error handling
-   Some minor bugfixes and improvements

### How to upgrade {#how-to-upgrade}

1.  Clear all caches

## Upgrade from 5.0.0 to 5.1.0 {#upgrade-from-5-0-0-to-5-1-0}

### Changelog {#changelog-1}

[https://github.com/fnagel/t3extblog/compare/5.0.0...5.1.0](https://github.com/fnagel/t3extblog/compare/5.0.0...5.1.0)

-   Support for Twitter Bootstrap 4.x
-   Support for PHP 7.3
-   Support of latest TYPO3 logging functionality (PSR-3 based, see FAQ)
-   Make use of latest TYPO3 BE module menu API
-   Rework dependency injection
-   Improve documentation
-   Code clean-up (removed and replaced deprecated code usage)
-   Some minor bugfixes and improvements

**Breaking changes**

-   Removed support for TYPO3 < 9.4
-   Restructured some templates and partials due to TWBS4 implementation
-   Logging has changed

### How to upgrade {#how-to-upgrade-1}

1.  Adjust your templates to structure change if needed
1.  Clear all caches

### Please note {#please-note}

Since TYPO3 9.5.15 the old post URL structure (`yyyy/mm/dd/my-post-title`) is possible again.

**Override the routing**

```
routeEnhancers:
  T3extblogBlogsystemPlugin:
    aspects:
      post_title:
        datePrefix: 'Y/m/d/'
```

**htaccess redirect**

This will work for the default routing:

```
RewriteRule ^blog/article/(\d{4})-(\d{2})-(\d{2})-(.+)$ /blog/article/$1/$2/$3/$4 [R=301,NC,L]
```

## Upgrade from 4.x to 5.0.0 {#upgrade-from-4-x-to-5-0-0}

*"TYPO3 9.5 support"*

### Changelog {#changelog-2}

[https://github.com/fnagel/t3extblog/compare/4.0.0...5.0.0](https://github.com/fnagel/t3extblog/compare/4.0.0...5.0.0)

-   Support for TYPO3 9.x
-   Support of new TYPO3 core routing functionality
-   Support of new TYPO3 core SEO sitemap functionality
-   Fixed all "strong" issues in the "Scan Extension Files"
-   Code clean-up (removed quite a lot legacy code and workarounds)
-   Lots of minor bugfixes and improvements

**Breaking changes**

-   Removed support for TYPO3 8.x
-   Post URL structure has changed (`yyyy-mm-dd-my-post-title` instead of `yyyy/mm/dd/my-post-title`)
-   Removed support for EXT:realurl
-   Removed support for EXT:dd_googlesitemap
-   Removed `blogsystem.comments.allowSomeTagAttributes` setting
-   Replaced RWD image TypoScript lib (whose functionality is no longer available) with default image VH
-   Rename TS and TSconfig files to newer file extensions
-   Split TS configuration into multiple files

### How to upgrade {#how-to-upgrade-2}

1.  Use "Compare database" in install tool to adjust changed DB fields
1.  Run "Create missing post URL slugs" update wizard in extension manager (you might need to do this multiple times!)
1.  Run "Create missing category URL slugs" update wizard in extension manager (you might need to do this multiple times!)
1.  Add extension [routing configuration](https://docs.typo3.org/permalink/felixnagel/t3extblog:configuration-speaking-url@main) to your site configuration
1.  Make sure your site configuration has an absolute URL as "Entry Point" (or base) configured (so no `/` but
    something like `https://domain.com/`. Otherwise TYPO3 will NOT RENDER ABSOLUTE URLs in email templates!
1.  Add a htaccess rule for redirecting old post URLs to the new one (see "URL redirect" below)
1.  Update your TS and TSconfig includes if needed
1.  Update your TS linkhandler configuration if needed
1.  Add "Sitemap setup" static TS to your template in order to enable [SEO sitemap support](https://docs.typo3.org/permalink/felixnagel/t3extblog:faq-sitemap@main)
1.  Clear all caches

**URL redirect**

This will work for the default routing:

```
RewriteRule ^blog/article/(\d{4})/(\d{2})/(\d{2})/(.+)$ /blog/article/$1-$2-$3-$4 [R=301,NC,L]
```

Please note that it is now possible to configure the URLs as you wish, even without a date!
