ChangeLog 

Version 3.0.6 

Maintenance release for the TYPO3 v13 line. It carries the fixes made on the 4.x line since 3.0.5 that apply to TYPO3 13.4.

Fixes:

  • πŸ› Every action of the backend module checks the backend user's table rights and page permissions before it reads or writes TextDB records (#205)
  • πŸ› Lookups made by the backend module follow the createIfMissing extension setting (#207)
  • πŸ› A malformed translateRecord request shows an error, and the dialog saves only the record it was opened for and its translations (#209, #210)
  • πŸ› Saving from the list view shows the save messages, the filter reset clears the stored filter, and the module views use core markup (#197, #200, #201)
  • πŸ› The module, the export and the imports use the languages of the site that holds the storage page (#196)
  • πŸ› A hidden TextDB entry is not rendered in the frontend (#213)
  • πŸ› An import writes a file in one database transaction and rolls back the whole file on any error (#214)
  • πŸ› The export refuses an empty result, reads and writes 1,000 records at a time and keeps line breaks (#199, #208, #212)

Version 3.0.5 

Maintenance release for the TYPO3 v13 line. It carries the fixes made on the 4.x line since 3.0.4 that apply to TYPO3 13.4, plus two 13.4-only fixes.

Fixes:

  • πŸ› <nrtextdb:translate> no longer aborts rendering for a bare key without extensionName, and resolves every fully-qualified LLL key again (#160)
  • πŸ› Filtering translations by language no longer fails with an SQL error on TYPO3 13.4 (#160)
  • πŸ› The Netresearch module group icon draws its letter in the module menu's text colour and stays legible in the light and the dark scheme (#159)
  • πŸ› The group and module icons are registered against the right SVG files again (#149)
  • πŸ› Saving translations in the backend module rejects malformed input and unconfigured languages instead of crashing or persisting an unreachable record (#129)
  • πŸ› The backend module works for users without a stored module config, and the export no longer runs unfiltered when no filter is selected (#131)
  • πŸ› nr_textdb:import <extension> imports only the requested extension (#118)

Version 3.0.4 

Maintenance release for the TYPO3 v13 line. Version 4.0.0 requires TYPO3 v14.3, so v13 installations stay on the 3.x line and receive this fix here.

Fixes:

  • πŸ› Saving a translation in the backend module updates the existing record instead of inserting a duplicate, skips empty values and reports a persistence error as a flash message (#100)
  • πŸ› Mapped domain model properties are protected again, so the Extbase DataMapper can populate them β€” with private properties every repository query aborted with "Cannot access private property"

Version 3.0.3 

Released: 2024-11-27

Changes:

  • Use $_EXTKEY in ext_emconf.php and sanitize TER comment
  • Documentation improvements with GitHub integration for docs.typo3.org
  • Changed license to Creative Commons BY 4.0 for documentation
  • Fixed guides.xml schemaLocation and added theme attribute

Version 3.0.1 

Released: 2024-11-07

Changes:

  • Documentation improvements
  • Minor bug fixes
  • Updated GitHub Actions CI

Version 3.0.0 

Released: 2024-11-07

Breaking Changes:

  • ⚠️ PHP 8.2 minimum requirement
  • ⚠️ TYPO3 13.4 minimum requirement
  • ⚠️ Removed support for TYPO3 12 and earlier

Features:

  • ✨ TYPO3 13.4 LTS compatibility
  • ✨ PHP 8.2, 8.3, 8.4 support
  • ✨ Modern dependency injection patterns
  • ✨ Updated to PHPUnit 10+
  • ✨ Symfony Console 7.0 support
  • ✨ Improved DDEV development environment

Improvements:

  • πŸ”§ Modernized codebase architecture
  • πŸ”§ Enhanced code quality tooling
  • πŸ”§ Updated testing framework
  • πŸ”§ Improved CI/CD pipeline
  • πŸ”§ Better error handling and logging

Migration Guide:

See Upgrade Instructions in the Installation section.

Version 2.x 

TYPO3 12 LTS Support 

Version 2.x series supports TYPO3 12 LTS.

For details, see the 2.x branch.

Version 1.x 

Legacy Versions 

Version 1.x series supports TYPO3 10-11.

Note: No longer maintained. Upgrade to 3.x recommended.

Detailed Change History 

For complete commit history and detailed changes:

https://github.com/netresearch/t3x-nr-textdb/commits/main

Release Notes 

3.0.x Series 

Focus: TYPO3 13 LTS support and modernization

Key Improvements:

  • Modern PHP 8.2+ features
  • Enhanced type safety with strict types
  • Improved dependency injection
  • Better test coverage
  • Updated quality tooling (PHPStan, Rector, Fractor)
  • DDEV-based development workflow

Deprecations:

None in 3.0.x series.

Removed Features:

  • TYPO3 12 and earlier support
  • PHP 8.1 and earlier support

2.0.x Series 

Focus: TYPO3 12 LTS support

Key Features:

  • TYPO3 12 LTS compatibility
  • PHP 8.1+ support
  • Modern Extbase patterns
  • Backend module improvements

1.0.x Series 

Focus: Initial release and TYPO3 10-11 support

Key Features:

  • Translation database management
  • Import/Export functionality
  • Backend module
  • ViewHelper integration

Upgrade Path 

From 2.x to 3.x 

Prerequisites:

  • PHP 8.2 or higher installed
  • TYPO3 13.4 or higher

Steps:

  1. Backup your database and translations
  2. Update composer.json:

    composer require netresearch/nr-textdb:^3.0
    Copied!
  3. Update database schema:

    vendor/bin/typo3 database:updateschema
    Copied!
  4. Clear all caches:

    vendor/bin/typo3 cache:flush
    Copied!
  5. Test functionality thoroughly

Breaking Changes:

  • PHP 8.2 minimum (check your PHP version)
  • TYPO3 13.4 minimum (upgrade TYPO3 first if needed)
  • Some internal APIs may have changed (check custom code)

From 1.x to 3.x 

Not Directly Supported

Upgrade path: 1. Upgrade to 2.x first 2. Test thoroughly 3. Then upgrade to 3.x

Security Updates 

Version 3.0.1 

  • No security issues

Version 3.0.0 

  • Updated dependencies to address known vulnerabilities
  • Enhanced input validation
  • Improved file upload security

Backwards Compatibility 

3.0.x Series 

BC Breaks:

  • PHP 8.2 minimum
  • TYPO3 13.4 minimum

API Stability:

Public APIs (ViewHelpers, Services) maintain backwards compatibility within the 3.x series.

Database Schema:

Database schema is compatible between 2.x and 3.x (with updates).

Contributing 

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add/update tests
  5. Ensure CI passes
  6. Submit pull request

Development Setup:

# Clone repository
git clone https://github.com/netresearch/t3x-nr-textdb.git
cd t3x-nr-textdb

# Install dependencies
composer install

# Start DDEV
ddev start
ddev install-v13

# Run quality checks
composer ci:test
Copied!

Code Standards:

  • PSR-12 code style
  • PHPStan level 7+
  • 100% test coverage for new features
  • Rector/Fractor compliance

Acknowledgments 

Thanks to all contributors who have helped improve this extension!

Major Contributors:

  • Thomas SchΓΆne
  • Axel Seemann
  • Tobias Hein
  • Rico Sonntag

Community:

Thanks to the TYPO3 community for feedback and bug reports.

Netresearch DTT GmbH:

For continued development and maintenance support.

License 

This extension is licensed under GPL-3.0-or-later.

See LICENSE file for details.