.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../Includes.txt


.. _upgrade-guide-v7:

Version 7.x
-----------

.. contents:: Within this page
   :local:
   :depth: 3


Upgrade from 7.2.0
^^^^^^^^^^^^^^^^^^

*"Anti SPAM"*

Changelog
"""""""""

https://github.com/fnagel/t3extblog/compare/7.1.0...7.2.0

- Make use of page title API, see https://docs.typo3.org/m/typo3/reference-coreapi/11.5/en-us/ApiOverview/Seo/PageTitleApi.html

- Implement rate limiter for throttling requests (for new comment or blog subscriptions and subscriber authentication)

- SPAM check: count links in comment text

- Minor improvements and bug fixes

- Minor code clean-up and quality improvements


How to upgrade
""""""""""""""

#. Enable and adjust request rate limiter configuration if needed

#. Adjust templates with titleTag VH if needed

#. Clear caches



Upgrade from 7.1.0
^^^^^^^^^^^^^^^^^^

Changelog
"""""""""

https://github.com/fnagel/t3extblog/compare/7.0.0...7.1.0

- Add support for PHP 8.1

- Change post content rendering to a TypoScript RECORDS approach (and removed RenderContent VH)

- Minor improvements and bug fixes

- Minor code clean-up


How to upgrade
""""""""""""""

#. Adjust post content rendering related templates if needed (see "Content rendering templates" section below)

#. Adjust post content rendering related TypoScript (see `Configuration/TypoScript/Includes/Libraries.typoscript`) if needed

#. Clear caches


**Content rendering templates**

You need to replace the removed `<t3b:frontend.renderContent />` view helper.
Please check the following templates and partials:

- `Resources/Private/Partials/Post/Content.html`
- `Resources/Private/Partials/Post/RssItem.xml`
- `Resources/Private/Partials/Post/Teaser.html`
- `Resources/Private/TwitterBootstrap4/Partials/Post/Teaser.html`



Upgrade to 7.0.0
^^^^^^^^^^^^^^^^

*"TYPO3 11 LTS support"*

Changelog
"""""""""

https://github.com/fnagel/t3extblog/compare/6.2.0...7.0.0

- Support for TYPO3 11.5 LTS

- Support for PHP 8.0 and 8.1

- Implement custom pagination (as core VH widget is no longer available)

- Migrated EM update class to upgrade wizards

- Lots of bugfixes and other improvements

- Massive code clean-up and quality improvements


**Breaking changes**

- Removed support for TYPO3 10.x

- Routing and TCA has changed

- Page URL structure has changed (`my-blog/page-123` instead of `my-blog/page/123`)

- Template changes

- Some classes and methods have been renamed (be careful when extending EXT:t3extblog)


How to upgrade
""""""""""""""

#. "Change fields" in DB using "Analyze Database" in Install tool / Maintenance module

#. Adjust your routing configuration (pagination has changed)

#. Add a htaccess rule for redirecting old page URLs (see "URL redirect" below)

#. Adjust your templates (pagination and a few other changes)

#. Run upgrade wizards in admin tools

#. Clear all caches


**URL redirect**

This will work for the pagination URL change when using the default routing:

.. code-block::

   RewriteRule ^blog/page/(\d+)/$ /blog/page-$1 [R=301,NC,L]
   RewriteRule ^blog/(.*)/page/(\d+)/$ /blog/$1/page-$2 [R=301,NC,L]