.. ein uraltes Thema, aber nachwievor so nötig wie eh und je.
Fakt ist: viele Klassen sind via den minimalistischen get_description() Beispielen nicht hinreichend erklärbar in all ihren Möglichkeiten/Optionen.
Vorschlag: Einführung einer get_help() Methode innerhalb der Klassen welche die Hilfetexte ausgibt.. features:
enthält Hilfetexte in den derzeitigen BE Sprachen (DE & EN.. aber potentiell auch erweiterbar..) und ist an $REX['LANG'] gekoppelt.
Texte in untersch. Formaten möglich ("parser" flag).. TXT, HTML, Textile.. (letzteres weil es schlichtweg das Schreiben - evtl. auch längerer Hilfen - wesentlich vereinfacht.. zumal Textile in den meisten Redaxo Installationen aktiv sein dürfte, bzw. ein Aktivieren kein Drama darstellt..)
Vorteile:
keine zusätzlichen (lang) files und deren Zuordnungen nötig
Hilfetexte sind automatisch spezifisch für die Klassen(version)..
joachimdoerr
commented
10 years ago
.. ein uraltes Thema, aber nachwievor so nötig wie eh und je.
Fakt ist: viele Klassen sind via den minimalistischen
get_description()Beispielen nicht hinreichend erklärbar in all ihren Möglichkeiten/Optionen.Vorschlag: Einführung einer
get_help()Methode innerhalb der Klassen welche die Hilfetexte ausgibt.. features:$REX['LANG']gekoppelt.Vorteile: