---
title: "Known Problems"
manual: "Netresearch TextDB"
version: "main"
source: "KnownProblems/Index.rst"
rendered: "2026-09-30T23:05:19+00:00"
---

# Known Problems {#known-problems}

## Current Limitations {#current-limitations}

### TYPO3 Version Support {#typo3-version-support}

-   **Minimum TYPO3:** 14.3.0
-   **Earlier versions:** Not supported (use version 2.x for TYPO3 12)

### PHP Version Requirements {#php-version-requirements}

-   **Minimum PHP:** 8.2
-   **Earlier PHP versions:** Not supported

## Reported Issues {#reported-issues}

### Import Performance {#import-performance}

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

-   ****Workaround:****

    -   Split large files into smaller chunks
    -   Increase PHP `max_execution_time`:

        ```ini
        max_execution_time = 300
        ```
    -   Use CLI import command instead of backend module

**Status:** Under investigation

**GitHub Issue:** [#30](https://github.com/netresearch/t3x-nr-textdb/issues/30)

### Language Fallback {#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

**GitHub Issue:** [#32](https://github.com/netresearch/t3x-nr-textdb/issues/32)

## Compatibility Issues {#compatibility-issues}

### Extension Conflicts {#extension-conflicts}

No known conflicts with other TYPO3 extensions.

If you experience issues, please:

1.  Disable other extensions temporarily
1.  Test TextDB functionality
1.  Re-enable extensions one by one
1.  Report findings to: [https://github.com/netresearch/t3x-nr-textdb/issues](https://github.com/netresearch/t3x-nr-textdb/issues)

### Database Engines {#database-engines}

-   ****Tested:****

    -   MariaDB 10.11+
    -   MySQL 8.0+

-   ****Not tested:****

    -   PostgreSQL
    -   SQLite

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

**GitHub Issue:** [#26](https://github.com/netresearch/t3x-nr-textdb/issues/26)

## Browser Support {#browser-support}

### Backend Module {#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 {#workarounds}

### Problem: Module Not Visible {#problem-module-not-visible}

-   ****Symptoms:****

    -   TextDB module doesn't appear in backend menu
    -   User has correct permissions

**Solution:**

```bash
# 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
```

### Problem: Translations Not Updating {#problem-translations-not-updating}

-   ****Symptoms:****

    -   Changes in backend don't reflect on frontend
    -   Old translations still showing

**Solution:**

```bash
# 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
```

### Problem: Import Fails Silently {#problem-import-fails-silently}

-   ****Symptoms:****

    -   Import appears to complete but no records created
    -   No error messages shown

**Solution:**

1.  Check TYPO3 logs:

    ```bash
    tail -f var/log/typo3_*.log
    ```
1.  Verify XLIFF format:

    ```xml
    <?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>
    ```
1.  Check file permissions:

    ```bash
    ls -la /path/to/upload/directory
    ```
1.  Validate XML:

    ```bash
    xmllint --noout yourfile.xlf
    ```

### Problem: Memory Exhaustion on Export {#problem-memory-exhaustion-on-export}

-   ****Symptoms:****

    -   Export fails with memory limit error
    -   Large datasets cause timeout

**Solution:**

1.  Increase PHP memory limit temporarily:

    ```ini
    ; php.ini
    memory_limit = 512M
    ```
1.  Export smaller subsets using filters
1.  Use filters to reduce the export dataset to manageable sizes

## Reporting Bugs {#reporting-bugs}

If you encounter issues not listed here:

1.  **Check existing issues:**

    [https://github.com/netresearch/t3x-nr-textdb/issues](https://github.com/netresearch/t3x-nr-textdb/issues)
1.  **Gather information:**

    -   TYPO3 version
    -   PHP version
    -   Extension version
    -   Error messages / stack traces
    -   Steps to reproduce
1.  **Create detailed report:**

    ```none
    Issue Title: Brief description

    Environment:
    - TYPO3: 14.3.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.]
    ```
1.  **Submit issue:**

    [https://github.com/netresearch/t3x-nr-textdb/issues/new](https://github.com/netresearch/t3x-nr-textdb/issues/new)

## Getting Help {#getting-help}

### Community Support {#community-support}

-   **GitHub Discussions:** [https://github.com/netresearch/t3x-nr-textdb/discussions](https://github.com/netresearch/t3x-nr-textdb/discussions)
-   **Issue Tracker:** [https://github.com/netresearch/t3x-nr-textdb/issues](https://github.com/netresearch/t3x-nr-textdb/issues)

### Professional Support {#professional-support}

For commercial support and custom development:

-   **Company:** Netresearch DTT GmbH
-   **Website:** [https://www.netresearch.de/](https://www.netresearch.de/)
-   **Email:** Contact via GitHub issues

## Planned Improvements {#future-improvements}

### Version 3.1.0 {#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

**GitHub Issue:** [#33](https://github.com/netresearch/t3x-nr-textdb/issues/33)

### Version 3.2.0 {#version-3-2-0}

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

**GitHub Issue:** [#34](https://github.com/netresearch/t3x-nr-textdb/issues/34)

### Version 4.0.0 {#version-4-0-0}

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

**GitHub Issue:** [#35](https://github.com/netresearch/t3x-nr-textdb/issues/35)

> [!NOTE]
> Planned features are subject to change. Check the
> [GitHub milestones](https://github.com/netresearch/t3x-nr-textdb/milestones)
> for current roadmap.