Markitup Versions Save

Integriert den MarkItUp-Editor (Markdown und Textile) in REDAXO CMS

3.8.0

1 month ago

Bitte unbedingt beachten. Mit diesem Release erfolgt die Umstellung auf den Namespace FriendsOfRedaxo\MarkItUp. Für eine kurze Übergangszeit stehen weiterhin die alten Klassennamen zur Verfügung, sind aber als "deprecated" markiert. Das soll nur die Umstellung erleichtern; mit Relase 4.0 werden diese Convenience-Klassen entfallen. Release 4 ist für Ende Juni vorgesehen!

Hinweise zur Nutzung der neuen Schreibweise finden sich in der Dokumentation (docs/de_de/howto_integration.md)

Allgemeine Hinweise zur Umstellung des eigenes Codes stehen in den Tricks (Oh! Das Addon hat "Namespace"! Und nun?)

Features (zusätzlich zu beta1)

Umstellung auf Namespaces in Vorbereitung auf REDAXO 6.0 (mit Installation via Composer)
- Namespace FriendsOfRedaxo\MarkItUp
- Klassen- und Funktionsnamen nun ohne Prefix markitup_ und in CamelCase-Schreibweise
  - markitup_markdown wird zu FriendsOfRedaxo\MarkItUp\Markdown
  - markitup_textile wird zu FriendsOfRedaxo\MarkItUp\Textile
  - markitup wird zu FriendsOfRedaxo\MarkItUp\Markitup
  - cache wird zu FriendsOfRedaxo\MarkItUp\Cache
- Klassennamen gleichlautend und -geschrieben als Dateinamen im Lib-Verzeichnis
- Die alten Klassen und Funktionen ko-existieren als Alias-Elemente mit Vermerk "deprecated"; mit Release 4 entfallen die Alias-Elemente!
- Dokumentation angepasst:
  - README-Dateien
  - docs/de_de/howto_integration.md ("Editor integrieren")
Da MarkItUp ohnehin für Markdown den Core-Vendor benutzt (class Markdown extends Parsedown), ist die eigene Klasse Markdown auf "deprecated" gesetzt und wird ebenfalls mit Release 4 ersetzt.
Documentation-Plugin aufgelöst.
- Die Handbuchseiten werden in der package.yml) als SubPages angelegt
- Inhalte umgruppiert: Handbuch für Autoren und Handbuch für Entwickler
- Freischalten über Berechtigungen (markitup[manual], markitup[developer]); bisher war das Handbuch auf Admins beschränkt.
- Plugin beim Update löschen
Voraussetzungen angehoben: PHP 8.1 und REDAXO 5.15

3.8.0-beta2

2 months ago

Features (zusätzlich zu beta1)

Documentation-Plugin aufgelöst.
- Die Handbuchseiten werden in der package.yml) als SubPages angelegt
- Umgruppiert: Handbuch für Autoren und Handbuch für Entwickler
- Freischalten über Berechtigungen (markitup[manual], markitup[developer])
Voraussetzungen angehoben: PHP 8.1 und REDAXO 5.15

Bugfix

Beim Update auf 3.8beta1 wurde die Cache.php nicht gefunden da nun im Namespace (@madiko)

3.8.0-beta1

2 months ago

ab 3.8.0 Generell bitte beachten:

Umstellung auf den Namespace FriendsOfRedaxo\MarkItUp. Aus Klasse markitup wird z.B. FriendsOfRedaxo\MarkItUp\MarkItUp.
Anpassung der Dokumentation an die Namespace-Schreibweise

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 in den Modulen mit MarkItUp verwaltete Textfelder haben. Für eine Übergangszeit sind die alten Klassen und Funktionen weiterhin verfügbar. In der Entwicklungsumgebung sind die Aufrufe als "deprecated" gekennzeichnet und sollten rasch auf die neue Variante umgestellt werden.

In Version 4.0.0 werden die alten Aufrufvarianten endgültig entfernt.

In der README sowie in der Dokumentation ("Editor integrieren", plugins/documentation/docs/de_de/howto_integration.md) sind Hinweise zu Umstellung. Alle Code-Beispiele sind überarbeitet und zeigen nur noch die neue Namespace-Variante.

Kurzfassung der beiden Varianten:

Den Klassennamen um den Namespace erweitert ändern: FriendsOfRedaxo\MarkItUp\MarkItUp::func(...).
Am Anfang der Datei ein Use-Statement einfügen: use FriendsOfRedaxo\MarkItUp\MarkItUp; und MarkItUp::func(...) benutzen

Bei Einsatz des PHP-CS-FIXER wird meist die erste Variante in die zweite umgewandelt.