Troubleshooting & Support 

Solutions to common issues, debugging techniques, and support resources.

Quick Fixes 

Most Common Issues 

1. Style Dropdown Disabled (v13.0.0+) 

// Ensure these dependencies are present:
static get requires() {
    return ['StyleUtils', 'GeneralHtmlSupport'];
}
Copied!

2. Images Not Appearing in Frontend 

  • Check TypoScript setup
  • Verify file permissions
  • Clear all caches

3. File Browser Not Opening 

  • Check backend user permissions
  • Verify TSConfig
  • Check file mount configuration

Debugging Techniques 

Enable Debug Mode 

$GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'] = '*';
$GLOBALS['TYPO3_CONF_VARS']['SYS']['displayErrors'] = 1;
Copied!

Browser Console 

  • Check for JavaScript errors
  • Monitor network requests
  • Inspect CKEditor plugin loading

TYPO3 Logs 

  • Check var/log/typo3_*.log
  • Review deprecation log
  • Monitor PHP error log

Database Queries 

  • Enable SQL debug mode
  • Check soft references
  • Verify file relations

Getting Help 

Self-Help Resources 

  1. Check this troubleshooting guide
  2. Review Integration & Configuration
  3. Consult Examples & Use Cases
  4. Search GitHub Issues

Community Support 

GitHub Discussions
github.com/netresearch/t3x-rte_ckeditor_image/discussions
TYPO3 Slack
#ext-rte_ckeditor_image channel
TYPO3 Forum
typo3.org/community/meet

Reporting Bugs 

Report bugs: github.com/netresearch/t3x-rte_ckeditor_image/issues

Include:

  • TYPO3 version
  • PHP version
  • Extension version
  • Steps to reproduce
  • Error messages
  • Browser console output

Troubleshooting Topics 

📦 Installation Issues 

Extension installation problems, dependency conflicts, cache issues, and permission problems

✏️ Editor Issues 

Image button problems, style dropdown issues, file browser problems, and CKEditor errors

🖥️ Frontend Issues 

Image display problems, broken links, dimension issues, and rendering problems

⚡ Performance Issues 

Editor performance, frontend performance, image processing optimization, and database performance