Download the PHP package netresearch/rte-ckeditor-image without Composer
On this page you can find all versions of the php package netresearch/rte-ckeditor-image. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download netresearch/rte-ckeditor-image
More information about netresearch/rte-ckeditor-image
Files in netresearch/rte-ckeditor-image
Package rte-ckeditor-image
Short Description Image support in CKEditor for the TYPO3 ecosystem - by Netresearch
License AGPL-3.0-or-later
Homepage https://github.com/netresearch/t3x-rte_ckeditor_image
Informations about the package rte-ckeditor-image
Image support for CKEditor for TYPO3
This extension adds comprehensive image handling capabilities to CKEditor for TYPO3.\ Add issues or explore the project on GitHub.
Features
- TYPO3 FAL Integration: Native file browser with full File Abstraction Layer support
- Magic Images: Same image processing as rtehtmlarea (cropping, scaling, TSConfig supported)
- Image Dialog: Configure width, height, alt, and title (aspect ratio automatically maintained)
- Quality Selector: Quality multipliers for optimal display (Standard 1.0x, Retina 2.0x, Ultra 3.0x, Print 6.0x)
- SVG Support: Intelligent dimension extraction from viewBox and width/height attributes
- Custom Styles: Configurable image styles with CKEditor 5 style system
- Inline Images: True inline image support with cursor positioning before/after
- Lazy Loading: TYPO3 native browser lazyload support
- Event-Driven: PSR-14 events for extensibility
- Security: Protocol blocking, XSS prevention, file visibility validation
- Fluid Templates: Customizable output via template overrides with automatic figcaption width constraint
- Image Validation: CLI command and upgrade wizard to detect and fix broken image references and nested link wrappers
- Preview Renderer: Images preserved in page module preview with broken reference warnings
- Content Blocks Support: ViewHelper for rendering RTE image previews in Content Blocks backend templates
- Table Images: Images in CKEditor 5 tables get full processing (max-width, zoom, t3:// resolution)
- Automatic Softref: RTE image references tracked automatically across all tables
Requirements
- TYPO3: 13.4.21+ (LTS) or 14.3+ (LTS)
- PHP: 8.2 or later
- Extensions: cms-rte-ckeditor (included in TYPO3 core)
Note: The plugin automatically integrates with CKEditor's
GeneralHtmlSupportfor style functionality. No additional configuration required.
Installation
Quick Start
Install the extension via composer:
Enable the Site Set to activate both the backend RTE preset and frontend rendering:
Add the extension to your site dependencies:
This enables the RTE preset with the insertimage button and includes the frontend TypoScript for image processing.
Using Bootstrap Package or another theme extension? List this extension after them in your dependencies to override their RTE preset.
Alternative: Direct TypoScript Import
If you prefer manual control over TypoScript load order:
Custom Configuration (Optional)
If you need to customize the RTE configuration or create your own preset:
-
Create a custom preset in your site extension:
-
Import the image plugin configuration:
- Enable your custom preset via Page TSConfig:
Configuration
(optional) Configure the Extension Configuration for this extension:
fetchExternalImages: By default, if an img source is an external URL, this image will be fetched and uploaded to the current BE users uploads folder. The default behaviour can be turned off with this option.
enableAutomaticRteSoftref: Automatically adds rtehtmlarea_images soft reference to all RTE-enabled text fields. Ensures images are tracked in the reference index. Default: on.
enableAutomaticPreviewRenderer: Registers an image-aware preview renderer for all record types with RTE bodytext. Shows images in page module preview and warns about broken references. Default: on.
excludedTables: Comma-separated table names to exclude from automatic softref and preview renderer processing.
includedTablesOnly: Whitelist mode — if set, only these tables are processed. Overrides excludedTables.
See the full configuration reference for details.
Maximum width/height
The maximum dimensions relate to the configuration for magic images which have to be set in Page TSConfig:
If TSConfig settings don't render correctly from custom template extensions, add the settings directly to root page configuration.
Usage as lightbox with fluid_styled_content
Configure a default css class for every image
Image lazyload support
The extension supports TYPO3 lazyload handling (fluid_styled_content) for native browser lazyload.
Image Quality Selector
The image dialog includes a quality selector dropdown for optimal image processing:
Quality Options:
- No Scaling (1.0x) - Original file, no processing (best for newsletters, PDFs, SVG files)
- Standard (1.0x) - Match display dimensions exactly
- Retina (2.0x) - High-DPI displays (default, recommended for modern devices)
- Ultra (3.0x) - Very sharp images for hero images and key visuals
- Print (6.0x) - Print-quality output and professional photography
Quality selection persists via data-quality HTML attribute. The selector automatically handles SVG dimension extraction from viewBox or width/height attributes.
See: Image Quality Selector Documentation for complete technical details, use cases, and migration guide.
Using original images without processing (noScale)
Configure noScale globally via TypoScript to skip image processing:
Modern Approach: Use the quality selector dropdown in the image dialog for per-image control. The data-quality="none" attribute provides the same functionality as noScale = 1 with better user experience.
Auto-Optimization: The extension automatically skips processing when:
- Requested dimensions match the original image dimensions
- SVG files are detected (vector graphics always use original)
- Quality selector is set to "No Scaling"
Allowed extensions
By default, the extensions from $TYPO3_CONF_VARS['GFX']['imagefile_ext'] are allowed. However, you can override this for CKEditor by adding the following to your YAML configuration:
Documentation
This project maintains three documentation tiers:
Official TYPO3 Documentation
Published Manual: https://docs.typo3.org/p/netresearch/rte-ckeditor-image/main/en-us/
For integrators, administrators, and end users. Covers installation, configuration, troubleshooting, and usage.
Source: Documentation/ (RST format, automatically built and published)
AI Development Context
AI Agents & Developers: claudedocs/ directory (gitignored)
Technical knowledge base for AI-assisted development. Not tracked in git - generate per session if needed.
Project Essentials
- AGENTS.md - AI development guide and build commands
- CONTRIBUTING.md - Contribution guidelines
- SECURITY.md - Security policy
- Documentation/AGENTS.md - TYPO3 documentation system guide
Development
DDEV Environment (Complete Testing Setup)
Included Packages:
- Bootstrap Package (v15.0+) - Automatically installed to provide frontend rendering infrastructure
- TYPO3 Styleguide - UI pattern reference for testing
- All packages pre-configured for immediate testing of:
- Image insertion and editing in RTE
- Click-to-enlarge functionality on frontend
- Caption editing (WYSIWYG mode)
- Image alignment and styling
Local Development (No DDEV)
See AGENTS.md for complete development guide, code standards, and PR checklist.
Deployment
- Developed on GitHub
- Composer repository
- TYPO3 Extension Repository
- New versions automatically uploaded to TER via GitHub Action when creating a release
Verifying Releases
Release tags are GPG-signed and include SLSA Level 3 provenance attestation for supply chain integrity.
Verify tag signature
Verify SLSA provenance
About
Developed and maintained by Netresearch DTT GmbH.
All versions of rte-ckeditor-image with dependencies
ext-dom Version *
ext-libxml Version *
typo3/cms-core Version ^13.4.21 || ^14.3
typo3/cms-backend Version ^13.4.21 || ^14.3
typo3/cms-frontend Version ^13.4.21 || ^14.3
typo3/cms-extbase Version ^13.4.21 || ^14.3
typo3/cms-rte-ckeditor Version ^13.4.21 || ^14.3