AddOn
Focuspoint
Beschreibung
Dieses Addon erweitert den Medienpool um die Fähigkeit bei einem Bild einen Focuspoint zu setzten.zusätzlich liefert es passende Media Manager Effekte
Umsetzung
Versionen
4.2.3
Bugfix:
- Installations-Abbruch wegen nicht initialisiertem
$mm_type_id
gefixed (#138; Danke @tbaddade)
4.2.2
Bugfix:
- Abhängigkeiten in
package.yml
an die seit Version 4.1 geltenden Mindestversionen (PHP 8.1, REDAXO 5.15) angepasst (#136, Danke an @godsdog)
ab 4.2.0 Generell bitte beachten:
- Umstellung auf den Namespace FriendsOfRedaxo\Focuspoint. Aus Klasse
focuspoint_media
wird z.B.
FriendsOfRedaxo\Focuspoint\FocuspointMedia
. - Ab jetzt ist PHP 8.1 Mindestvoraussetzung und REDAXO 5.15.
- Ausnahme: auf
rex_effect
undrex_api
aufsetzende Klassen
Diese Version ist die Vorbereitung auf REDAXO 6. Es gibt keine Änderungen am Funktionsumfang.
Die Umstellung im Namespace hat jetzt nur Auswirkungen für Entwickler, die zusätzlich eigene Focuspoint-Effekte scheiben oder
anderweitig auf die Focuspoint-Tools/Klassen zugreifen. Für eine Übergangszeit ist der alte Aufruf mit z.B. focuspoint_media
weiterhin möglich. In der Entwicklungsumgebung sind die Aufrufe als Deprecated gekennzeichnet und sollten
rasch auf die neue Variante umgestellt werden. Mit Version 5.0.0 wird die alte Aufrufvariante endgültig entfernt.
Zur Umstellung gehören auch neue Klassennamen im CamelCase-Stil.
Zur Umstellung kann man am Beispiel gezeigt
- Den Klassennamen um den Namespace erweitert ändern:
FriendsOfRedaxo\Focuspoint\FocuspointMedia::func(...)
. - Am Anfang der Datei ein Use-Statement einfügen:
use FriendsOfRedaxo\Focuspoint\FocuspointMedia;
undFocuspointMedia
benutzen
Bei Einsatz des PHP-CS-FIXER wird die erste Variante in die zweite umgewandelt.
4.0.4
Bugfix: mitigates deprecated warning (PHP 8.1) or exception(PHP 8.2) when using target sizes like "80%" in the effect "focuspoint_fit".
Dies ist die letzte Version für PHP ab Version 7.4.
4.0.3
Bugfix: mitigates deprecated warning (PHP 8.1) or exception (PHP 8.2) when using target sizes like "16fr/9fr" in the effect "focuspoint_fit"
4.0.2
- Another correction regarding preview issue #110, (thanks to ritzfritz for testing)
- Code refinement with rexstan up to level 6
based on PHP8 specification. Some notifications are suppressed by@phpstan-ignore-next-line
, as the root
cause is outside focuspoint; three are not covered yet focuspoint_media::_construct
removed: only relevant for PHP 5.6. Focuspoint is based on REDAXO 5.13.0+ and needs PHP 7.3+.
4.0.1
Corrected an error that prevented a proper, media-type related preview in the media-manager´s detail-window. (Thanks to LEAakaLAP und Markus Neubauer). Additionally, the developer-section of the documentation is extended with another use case for ExtensionPoint FOCUSPOINT_PREVIEW_SELECT: remove media-types for images outside the media pool from the preview selection.
4.0.0
Changes in the Mediapool-markup forced an update in the hook mechanismen, which enables Focuspoint´s interactive selection in the Mediapool-sidebar. Due the changed mechanismen, Focuspoint 4.0 and onward is incompatible with REDAXO 5.12.x and prior versions.
3.1.0
Release 3.1.0 supports the upcoming darkmode-support, available with REDAXO 5.13. Thanks to @schuer for preparing the CSS.
3.0.2
- Bugfix: PHP 8 fixed an error in MySQL transaction handling regarding DDL-statements. This now (properly) results in an exception in certain situations during install. The new installation routine works without transactions.
- A successfull installation now provides detailed information (available since REDAXO 5.12).
3.0.1
In der package.yml
wurde die PHP-Anforderung auf >=7.1
geändert, damit die Installation auf Systemen mit PHP 8 möglich ist.
3.0.0
- Dokumentation so umgebaut, dass sie auf Github und im Backend ähnlich dargestellt wird (Dual-Use)
HELP.PHP ist dafür komplett neu geschrieben. Das docs-Verzeichnis und die Texte sind neu zusammengestellt.
Zusätzlich sind unterstützendes css/js dabei (help.min.xxx) z.B. für Syntax-Highlighting - Media-Manager-Effect
focuspoint_resize
, ohnehin seit 30.08.2018 (2.0.0) als deprecated markiert, ist jetzt komplett raus.
Wer ihn noch benötigt kopiere die Dateifocuspoint/lib/focuspoint_resize.php
vor dem Update in ein sicheres Verzeichnis,
z.B. nach project/lib. - Der intern genutzte Media-Manager-Effekt
focuspoint_media_detail
kann nun begrenzt geändert werden.
Löschen und Ändern des Namens ist weiterhin nicht zulässig.
2.2.2
Bugfix: the method focuspoint::customfield did return only a partial set of values. This could lead to problems on subsequent calls to EP "METAINFO_CUSTOM_FIELD". Now the full set is returned.
2.2.1
The URL used to identify and replace the standard-file-view in a Media-Edit-Window was not
correctly identified in REDAXO 5.10 due to changes in rex_media_manager::getUrl. The corrected code
is backward compatible (tested with REX 5.9).
2.2.0
Enhancements:
- Extension-Point "FOCUSPOINT_PREVIEW_SELECT": the preview-dropdown in the media-editor uses the meta-types´s name-field as item-label. While this name tends be a more technically one, but not self-explaining for editors, the EP offers a way to change the label. For details take a look into the documentation-section "Für Entwickler (API)".
You can find the documentation via the addon-administration-page
(requested by @DanielWeitenauer)
Bugfixes:
- Requirements-section in package.yml with enhanced explicit mention of dependencies to media_manager, mediapool and PHP (thanks to @skerbis, @staabm)
- Focuspoint restricts the AddOn "Metainfo" in changing meta-fields of fieldtype "Focuspoint (AddOn)" (no delete, no rename, no change of fieldtype on "med_focuspoint" or fields in use) Saving other allowed changes was not possible in some situations. The blocking mechanismen is rewritten. (reported by @pschuchmann)
- typo-corrections in language- and documentation-files
2.1.3
- Maintenance-version, no functional changes
Zoom-factors corrected (wrong 755% replaced by correct 75%), thanks to @rkemmere - updated license-file, thanks @crydotsnake
2.1.1
- Maintanence-version, no functional changes
- Injection of focuspoint-help into Media-Manager is changed in REX 5.8.0
- Requirements-section in package.yml changed to reflect REX 5.8.0
- Traducción en castellano - thanks to @nandes2062
2.1.0
- In den Media-Manager-Effekten unterstützt die Koordinatenermittlung auch den Fall, dass das Bild nicht aus dem Medienpool kommt, sondern per 'effect_mediapath' aus einem anderen Verzeichnis.
Als Koordinatenquelle werden url (..&xy=..), Effektkonfiguration (Fallback) und der allgemeine Fallback "Bildmitte" herangezogen. - die Klasse
focuspoint_media
hat eine zusätzliche MethodehasFocus
bekommen, mit der abgeprüft wird, ob das Fokuspunkt-Metafeld gesetzt ist (also eine gültige Koordinate enthält). - Im AddOn "Metainfo" wurde die Bearbeitung von Feldern, die den Metainfo-Datentyp "Focuspoint (AddOn)" haben, beschränkt. Das Default-Feld "med_focuspoint" kann nicht gelöscht werden; Feldname und Datentyp können nicht geändert werden. Gleiches gilt für selbst angelegte Metainfo-Felder des Typs "Focuspoint (AddOn)", sobald sie in einem Media-Manager-Effekt eingesetzt werden, der auf der Klasse
rex_effect_abstract_focuspoint
basiert. - Im AddOn "Media-Manager" ist Bearbeiten und Löschen des Typs "focuspoint_media_detail" gesperrt.
(Hinweis von @tbaddade) - Die
boot.php
wurde entschlackt, um die Initialisierung der REDAXO-Instanz zu entlasten; die entprechenden Codeböcke sind nachfocuspoint_boot.php
ausgelagert und werden nur bei Bedarf geladen. - Der Effekt 'focuspoint_resize' für den Media-Manager ist seit Release 2.0 auf "deprecated" gesetzt.
Wie angekündigt ist der Effekt ab Version 2.1 noch im Addon enthalten, er wird aber nicht mehr in derboot.php
aktiviert. (Siehe Dokumentation). Wer den Effekt noch benötigt, muss ihn an anderer Stelle selbst aktivieren (rex_media_manager::addEffect('rex_effect_focuspoint_resize');
). - Kleinere Korrekturen in der Dokumentation (danke @claudihey)
2.0.2
Ein komplett neu entwickeltes Major-Release
- Bugfix: Anpassung an PHP 5.6 (siehe ChangeLog)
!!!! Wichtiger Hinweis für Updater !!!
Achtung: sowohl die Metafelder in rex_media als auch die Parameter der Media-Manager-Effekte
sind geändert. Im Rahmen des Updates werden frühere Versionen vor 2.0 automatisch umgestellt
und die nicht mehr benötigten Felder gelöscht. Die Effekte im Media-Manager werden angepasst.
Wer die Fokuspunkt-Parameter direkt auswertet statt die Zielbilder via Media-Manager zu
erzeugen, muss die betroffenen Scripte händisch anpassen. Informationen dazu sind in der
Dokumentation zu finden. Empfehlung: zuerst die Datenbank sichern.
Was neu ist (Auszug):
- Eigener Meta-Datentyp "Focuspoint (AddOn)" für Fokuspunkt-Metafelder
- Individuelle Fokuspunkt-Metafelder können angelegt werden
- neu gestaltete interaktive Fokuspunkt-Auswahl
- Eingabefelder können ausgeblendet werden
- Reset auf den "Ausgangswert", Reset auf "Bildmitte"
- Preview mit echten temporären Bildern; daher "Abbruch" der Eingabe möglich.
- Zoom für bessere Detailauswahl
- MM-Effekte basieren auf der Klasse
rex_effect_abstract_focuspoint
- Media-Klasse
focuspoint_media
für Medien mit Fokuspunkt - Abruf von Medien mit "on the fly"-Koordinaten (via rex-api-call)
- Ausführliche Dokumentation (via "help-Button" in der AddOn-Verwaltung)
1.4.3
PR #44 Danke an @christophboecker
1.3.3
Neu: Bildformat als Aspect-Ratio und input-check mit Pattern