Known Problems 

Current Limitations 

TYPO3 Version Support 

  • Minimum TYPO3: 13.4.0
  • Earlier versions: Not supported (use version 2.x for TYPO3 12)

PHP Version Requirements 

  • Minimum PHP: 8.2
  • Earlier PHP versions: Not supported

Reported Issues 

Import Performance 

Issue: Large XLIFF files (>10MB) may timeout during import

Workaround:
  • Split large files into smaller chunks

  • Increase PHP max_execution_time:

    max_execution_time = 300
    Copied!
  • Use CLI import command instead of backend module

Status: Under investigation

Pagination with Large Datasets 

Issue: Initial page load slow with >10,000 translation records

Workaround:
  • Use filters to narrow results
  • Implement custom caching layer
  • Consider database indexing optimization

Status: Performance improvements planned for 3.1.0

Language Fallback 

Issue: No automatic fallback to default language if translation missing

Workaround:
  • Enable createIfMissing to auto-create translations
  • Manually ensure all languages have translations
  • Use default parameter in ViewHelpers

Status: Feature request for 3.2.0

Compatibility Issues 

Extension Conflicts 

No known conflicts with other TYPO3 extensions.

If you experience issues, please:

  1. Disable other extensions temporarily
  2. Test TextDB functionality
  3. Re-enable extensions one by one
  4. Report findings to: https://github.com/netresearch/t3x-nr-textdb/issues

Database Engines 

Tested:
  • MariaDB 10.11+
  • MySQL 8.0+
Not tested:
  • PostgreSQL
  • SQLite

Note: PostgreSQL and SQLite may work but are not officially supported.

Browser Support 

Backend Module 

The TextDB backend module is tested with:

  • ✅ Chrome/Chromium (latest)
  • ✅ Firefox (latest)
  • ✅ Safari (latest)
  • ✅ Edge (Chromium-based)
  • ⚠️ Internet Explorer (not supported)

Workarounds & Solutions 

Problem: Module Not Visible 

Symptoms:
  • TextDB module doesn't appear in backend menu
  • User has correct permissions

Solution:

# Clear all caches
vendor/bin/typo3 cache:flush

# Rebuild backend modules
vendor/bin/typo3 backend:listmodules

# Check module registration
ls -la typo3conf/ext/nr_textdb/Configuration/Backend/Modules.php
Copied!

Problem: Translations Not Updating 

Symptoms:
  • Changes in backend don't reflect on frontend
  • Old translations still showing

Solution:

# Clear frontend page cache
vendor/bin/typo3 cache:flush

# Clear specific page cache via backend:
# Page > Clear Cache > Clear cache for this page

# Verify correct storage PID in extension configuration
Copied!

Problem: Import Fails Silently 

Symptoms:
  • Import appears to complete but no records created
  • No error messages shown

Solution:

  1. Check TYPO3 logs:

    tail -f var/log/typo3_*.log
    Copied!

  2. Verify XLIFF format:

    <?xml version="1.0" encoding="utf-8"?>
<xliff version="1.0">
    <file source-language="en" datatype="plaintext" original="messages">
        <body>
            <trans-unit id="component|type|placeholder">
                <source>Value</source>
            </trans-unit>
        </body>
    </file>
</xliff>
    Copied!

  3. Check file permissions:

    ls -la /path/to/upload/directory
    Copied!

  4. Validate XML:

    xmllint --noout yourfile.xlf
    Copied!

Problem: Memory Exhaustion on Export 

Symptoms:
  • Export fails with memory limit error
  • Large datasets cause timeout

Solution:

  1. Increase PHP memory limit temporarily:

    ; php.ini
memory_limit = 512M
    Copied!
  2. Export smaller subsets using filters

  3. Use CLI for large exports:

    # Create custom export command
vendor/bin/typo3 textdb:export --component=website
    Copied!

Reporting Bugs 

If you encounter issues not listed here:

  1. Check existing issues:

    https://github.com/netresearch/t3x-nr-textdb/issues

  2. Gather information:

    • TYPO3 version
    • PHP version
    • Extension version
    • Error messages / stack traces
    • Steps to reproduce

  3. Create detailed report:

    Issue Title: Brief description

Environment:
- TYPO3: 13.4.5
- PHP: 8.3.2
- Extension: 3.0.1
- Database: MariaDB 10.11

Description:
Detailed description of the problem

Steps to Reproduce:
1. Go to...
2. Click on...
3. See error...

Expected Behavior:
What should happen

Actual Behavior:
What actually happens

Error Messages:
[Paste error messages / logs]

Additional Context:
[Screenshots, configurations, etc.]
    Copied!

  4. Submit issue:

    https://github.com/netresearch/t3x-nr-textdb/issues/new

Getting Help 

Community Support 

Professional Support 

For commercial support and custom development:

Planned Improvements 

Version 3.1.0 

  • Performance optimizations for large datasets
  • Enhanced import/export UI with progress indicators
  • Batch operations for bulk translation management
  • Advanced filtering options

Version 3.2.0 

  • PSR-14 events for extensibility
  • Language fallback chain support
  • Translation versioning and history
  • REST API for external integrations

Version 4.0.0 

  • TYPO3 14 LTS compatibility
  • AI-assisted translation suggestions
  • Translation memory integration
  • Workflow management with approval process