AddOn

Bugfix: mitigates deprecated warning (PHP 8.1) or exception (PHP 8.2) when using target sizes like “16fr/9fr” in the effect “focuspoint_fit”

- Another correction regarding preview issue #110, (thanks to ritzfritz for testing)
- Code refinement with [rexstan](https://staabm.github.io/2022/06/18/rexstan-REDAXO-AddOn.html) 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+.

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.

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.

Release 3.1.0 supports the upcoming darkmode-support, available with REDAXO 5.13. Thanks to @schuer for preparing the CSS.

- 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).

In der `package.yml` wurde die PHP-Anforderung auf `>=7.1` geändert, damit die Installation auf Systemen mit PHP 8 möglich ist.

- 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 Datei `focuspoint/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.

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.

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).

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

- Maintenance-version, no functional changes Zoom-factors corrected (wrong 755% replaced by correct 75%), thanks to rkemmere - updated license-file, thanks crydotsnake

- 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

- 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 Methode `hasFocus` 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 nach `focuspoint_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 der `boot.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)

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.

• 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)

PR #44 Danke an @christophboecker

Neu: Bildformat als Aspect-Ratio und input-check mit Pattern