REDAXO-AddOn: Cropper und yform_mediacrop

Bildbearbeitung für REDAXO.

Stellt den Image-Cropper Cropper.js im Medienpool zur Verfügung. Lizenz: MIT

Das AddOn nutzt für die Browser-Assets Cropper.js 2.x. Vendor-Dateien liegen getrennt von den AddOn-eigenen Skripten unter assets/vendor/cropper, eigene Logik unter assets/js.

Features

• Zuschneiden
• Drehen
• Spiegeln
• Speichern als neue Datei
• Speichern in ausgewählte Kategorie
• Überschreiben des Originals
• Rechte für Benutzer
• Einstellungsmöglichkeit für Seitenverhältnisse
• Einstellung für Zoom-Modus: Touch, Maus
• Werkzeugleisten-Modus wählbar: Legacy oder Default
• Optionale Info-Sidebar (initial ein-/ausblendbar)
• Zuschneiden-Link nur für unterstützte Formate (jpg, jpeg, png, gif)
• Kompression konfigurierbar (JPEG-Qualität und PNG-Kompression) mit optionaler Anzeige im Zuschneiden-Formular

Beschreibung

Cropper stellt eine einfache Bildbearbeitung im Medienpool zur Verfügung. Der Aufruf der Bildbearbeitung erfolgt über den Button Bild zuschneiden in der Detailansicht des Bildes beziehungsweise in der Medienliste. Der Zuschneiden-Link wird nur bei unterstützten Formaten angezeigt. Bearbeitete Bilder werden standardmäßig als neue Datei gespeichert. Ein Überschreiben des Originals ist möglich. Nur Admins erhalten das Recht, die Qualität von Bildern zu verringern.

Installation

1. Über Installer laden oder Zip-Datei im AddOn-Ordner entpacken, der Ordner muss „cropper“ heißen.
2. AddOn installieren und aktivieren.
3. Rechte für Rollen anpassen
4. Wenn gewünscht: eigene Vorgaben für Seitenverhältnisse in den Einstellungen hinterlegen

Frontend-Build

Für Vendor-Updates von Cropper.js wird pnpm verwendet.

1. Im AddOn-Ordner pnpm install ausführen.
2. Danach pnpm build ausführen.

Der Build schreibt die Vendor-Artefakte nach assets/vendor/cropper. node_modules gehört nicht ins Repository.

YForm media_crop

Das AddOn liefert ein Cropper-Value media_crop mit. Es ist im Table-Manager und auch im Frontend verfügbar.

Pipe-Schreibweise

media_crop|crops|Bild |0|1|800|600|

PHP-Schreibweise

$yform->setValueField('media_crop', ['crops','Zugeschnitten ','0','1','800','600']);

Bugtracker

Du hast einen Fehler gefunden oder ein nettes Feature parat? [Lege bitte ein Issue an]

Changelog

siehe CHANGELOG.md und Release notes

Hinweise zu 3.0.3

• Wichtiger Hinweis für Updates aus 2.x: technische Breaking Changes durch Namespace-, Asset- und JS-Umstellung.
• Werkzeugleisten-Modi auf den aktuellen Stand vereinheitlicht (legacy, default).
• Kompressionseinstellungen mit Defaults JPEG 100 und PNG 9, inklusive gemeinsamer Sichtbarkeitssteuerung im Zuschneiden-Formular.
• Zuschneiden-Link in Medienliste und Detailansicht nur bei unterstützten Formaten (jpg, jpeg, png, gif).

Lizenz

siehe LICENSE.md

Autor

Friends Of REDAXO

• http://www.redaxo.org
• https://github.com/FriendsOfREDAXO

Projekt-Lead

Alex Wenz

Credits

Initiator: Thomas Skerbis

1st Developer: Joachim Dörr

Danke an:

• Wasserverbund Niederrhein
• REXFamilyWeek
• Sven Haustein