klxm / image_editor
Bilder zerstörungsfrei bearbeiten für REDAXO 6: Zuschneiden, Drehen, Spiegeln, Ausrichten, Entzerren – im Medienpool und für andere Addons
Requires
- php: ^8.5
- ext-gd: *
- klxm/klxm_meta: ^1.0@dev
- redaxo/core: ^6.0@dev
Requires (Dev)
None
Suggests
- ext-imagick: Entzerren großer Bilder schneller und genauer
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 11:17:26 UTC
README
Du nutzt REDAXO 5? → Zweig
5.xREDAXO 6 ist noch nicht erschienen. Für aktuelle REDAXO-5-Installationen ist der Zweig
5.xdie richtige Wahl (ZIP herunterladen): Zuschnitte je Bildformat samt Ausgabe, ideal zusammen mit MediaPlace (Bearbeitung), focuspoint (Fokuspunkt) und media_negotiator (AVIF/WebP).Dieser Zweig (
main) ist die Version für REDAXO 6 (in Entwicklung).
Bilder bearbeiten für REDAXO 6
Zerstörungsfreie Bildbearbeitung für den Medienpool (aus KLXM Studio, MIT): Zuschneiden, Drehen, Spiegeln, Ausrichten, Entzerren, dazu Anpassen (Effekte, Sättigung, Helligkeit, Kontrast, Schärfe), Fokuspunkt/Einpassen und Ausschnitt je Bildformat: Für 16:9, 4:3, 1:1, 4:5 … legst du je Format selbst fest, welcher Teil des Bildes zu sehen ist, wenn der Fokuspunkt nicht reicht. Das Original im Medienpool bleibt unverändert – gespeichert werden nur die Schritte.
Voraussetzungen und Installation
- REDAXO 6 (
redaxo/core6.x), PHP 8.5 mit GD; Imagick ist optional (Entzerren großer Bilder schneller und genauer). - Am einfachsten zusammen mit fluid: dessen
install-dev.shrichtet REDAXO 6, fluid und image_editor mit einem Befehl ein. - In ein bestehendes REDAXO-6-Projekt:
composer require klxm/image_editor:^1.0@beta php bin/console migrate
Nach Updates (composer update) wieder php bin/console migrate – das kopiert die Assets neu.
Nutzung
- Medienpool: In der Seitenleiste eines Bildes (wie die Mediathek in KLXM Studio) gibt es:
- eine Vorschau, in die du klickst, um den Fokuspunkt zu setzen,
- die Werkzeuge Zuschneiden, Drehen, Spiegeln, Ausrichten und Entzerren,
- Zuschnitte je Format als kleine Vorschauen; ein Klick öffnet den Ausschnitt dieses Formats, ein Punkt zeigt einen eigenen Ausschnitt,
- Anpassen und Darstellung im Rahmen.
- fluid: an jedem Bild auf der Website und in Bildfeldern der Blöcke. Steht ein Bild in einem festen Format, erscheint zusätzlich „Ausschnitt“: Der Dialog öffnet mit diesem Format, die anderen Formate lassen sich daneben wählen.
Ausschnitt je Format:
- Ziehen verschiebt, Mausrad oder Zwei-Finger-Geste zoomt, die Pfeiltasten verschieben ebenfalls.
- „Automatisch (Fokuspunkt)“ bzw. ein Doppelklick nimmt den eigenen Ausschnitt wieder weg; dann schneidet das Bild wieder um den Fokuspunkt.
- Ein Punkt am Format zeigt, dass es einen eigenen Ausschnitt hat.
- Ändert sich das Bild selbst (Zuschneiden, Drehen …), werden die Ausschnitte zurückgesetzt, weil sie nicht mehr passen.
In Templates und Modulen
use Klxm\ImageEditor\ImageEditor; // Bild im Format 16:9 – eigener Ausschnitt, sonst um den Fokuspunkt; srcset, width/height, Alt-Text aus dem Medienpool echo ImageEditor::img('bild.jpg', '(min-width: 1200px) 600px, 100vw', '16:9'); // eigene Attribute; 'alt' überschreibt den Alt-Text, 'priority' für das wichtigste Bild der Seite (LCP) echo ImageEditor::img('bild.jpg', '100vw', '21:9', ['class' => 'hero', 'priority' => true]); // anderes Format je Bildschirmbreite – jedes Format mit eigenem Ausschnitt echo ImageEditor::picture('bild.jpg', '16:9', ['(max-width: 639px)' => '4:5'], '100vw');
- AVIF/WebP wählt der Media Manager des Cores je nach Browser.
- Der Alt-Text kommt aus dem Alt-Feld des Medienpools (je Sprache). Der Titel ist kein Alt-Text; ohne Alt-Text gibt es
alt="" role="presentation". - Ohne PHP geht auch die Adresse direkt, z. B.
index.php?rex_media_type=image_editor_16x9_960&rex_media_file=bild.jpg.
Für Entwickler
- Speicher: Spalte
rex_media.image_editor(JSON:ops,orig,fx,focus,fit,crops,at); bearbeitete Fassung unterdata/addons/image_editor/master/. - Ausgabe über den Media Manager: Typen
image_editor(volle Größe) undimage_editor_320 … _2560(AVIF/WebP je nach Browser),image_editor_base(ohne Anpassung, für die Vorschau). - Vorschaubild für soziale Netzwerke:
image_editor_share– 1200 × 630 als JPEG (ohne WebP/AVIF), eigener Ausschnitt im Format 40:21 oder um den Fokuspunkt;ImageEditor::shareUrl('bild.jpg'). - Je Format:
image_editor_{a}x{b}_{breite}, z. B.image_editor_16x9_960(Formate inImageEditor::RATIOS: 16:9, 16:10, 21:9, 3:2, 4:3, 1:1, 4:5, 3:4). Ausgeliefert wird der eigene Ausschnitt (crops), sonst das größte Rechteck um den Fokuspunkt. Das Bild hat danach genau das Format, im Rahmen schneidet CSS nichts mehr ab. ImageEditor::url($datei, $breite, $format),::srcset($datei, $format),::size($datei, $format)(Format optional, z. B.'16:9') und::imgStyle($datei)(object-position/-fit für den Fokuspunkt). Eigene Media-Manager-Typen:ImageEditor::useEdited($context)am Anfang vonprocess().- API:
index.php?rex-api-call=image_editor(action=info,save,adjust,cropmitratioundrectals Anteile{x, y, w, h}odernull) – Rechte des Medienpools. - JS:
ImageEditor.crop({ file, api, ratio })öffnet den Dialog „Ausschnitt je Format“. - Quellen der Oberfläche in
resources/js, gebaut mit esbuild:esbuild resources/js/image-editor.entry.js --bundle --minify --format=iife --target=es2020 --outfile=assets/image-editor.js
Lizenz
MIT – siehe LICENSE. Bildeditor aus KLXM Studio (MIT).