Weblication® Masken durch eigene Informationen für Benutzer erweitern
Nutzbar ab: Version
Veröffentlichungsdatum: 27. Juni 2019
Änderungsdatum: 21. September 2021
weblication cms gui dateiexplorer dateimanager masken overlay informationen hinweise texte hinweistext einblenden redakteure pflegebenutzer
Optimieren Sie Masken durch entsprechende Hinweise und Informationen für die Redakteure.
Ab Weblication® CMS 10.x können Sie Masken durch individuelle Hinweistexte erweitern. Dadurch können Sie abhängig von Benutzern und aktuellen Pfaden Informationen und HTML-Fragmente einbinden, um die Bedienung Ihrer Anwendungen auch im Backend zu optimieren.
Ab CMS-Version 12.x können Sie dies direkt über die Projekteinstellungen des Projektes vornehmen (Register: Darstellung -> Benutzerinfos)
Definitionsdatei für pfadabhängige Benutzerinformtionen
<?php $version="1.0"; $encoding="UTF-8"; ?> <?php exit; ?> <wGuiOverlays xmlns:wsl="http://weblication.de/5.0/wsl"> <!-- Overlays dienen dazu, Masken um individuelle Informationen für Benutzer zu ergänzen. Diese können definiert und über WSL mit Logik versehen werden. Platzhalter sind: !! Die Platzhalter sind nur hier im Quelltextbeispiel mit $__WSLPRE geschrieben, korrekter Platzhalter ist ohne die Unterstriche !! $__WSLPRE[wUserLanguage] - Benutzersprache $__WSLPRE[wProjectPath] - Projektpfad $__WSLPRE[wProjectGlobalPath] - Pfad des globalen Projektes $__WSLPRE[wProjectAssetsPath] - Pfad des Assets-Projektes $__WSLPRE[wPath] - Verzeichnis der aktuellen Datei bzw. das aktuellen Verzeichnisses Ab CMS-Version 014.001.006.000: Projektspezifische Benutzerinfos lassen sich in den Masken auch abhängig vom Benutzertyp ausgeben. Ein Hinweis in der Upload-Maske kann z.B. über matchUserType="admin|standard" nur für Redakteure und Administratoren ausgegeben werden. --> <overlay mask="upload" type="warning" notMatchPath="baseAssets/img" matchUserType="admin|standard"><![CDATA[ Bitte laden Sie Bilder ausschließlich in das globale Bildverzeichnis - <a href="?action=showmaskuploadfile&uploaddir=$__WSLPRE[wProjectAssetsPath]/img">Ins Bildverzeichnis wechseln</a> ]]> </overlay> <overlay mask="createDocument" type="info" matchPath="aktuelles/meldungen"> <wsl:ifValue value="$__WSLPRE[wUserLanguage]" term="en" operator="==">Please use a meaningfull file name.</wsl:ifValue> <wsl:ifValue value="$__WSLPRE[wUserLanguage]" term="de" operator="==">Achten Sie auf aussagekräftige Dateinamen.</wsl:ifValue> </overlay> <overlay mask="createDirectory" language="en" type="info"> Please use a meaningfull directory name. </overlay> <overlay mask="createDirectory" type="info"> Achten Sie auf aussagekräftige Verzeichnisnamen. </overlay> <overlay mask="editDocument" type="info" matchPath="wdExtension.php"> Standard-Dateienstellungen für das Verzeichnis <wsl:php>print preg_replace('/\/weblication\/.*/', '', '$__WSLPRE[wPath]');</wsl:php> </overlay> <overlay mask="editDocument" type="info" matchPath="(test|tmp)"> Dies ist eine Testseite! </overlay> <overlay mask="showDir" type="blank" format="text" matchPath="aktuelles/meldungen"> Aktuelle Meldungen erscheinen automatisch auf der Startseite. </overlay> </wGuiOverlays>
Dieser Inhalt muss unter folgendem Pfad abgelegt werden, um im gesamten Projekt angewandt zu werden: /[IHR-LAYOUT-PROJEKT]/wGlobal/layout/overlays/default.wGuiOverlays.php.
Aktuelle BASE Projekte liefern diese Definitionsdatei bereits im Standard mit. Sofern nicht vorhanden, legen SIe diese direkt auf dem Server mit einem HTML-Editor an (UTF-8 kodiert speichern!).
Anpassbare Masken sind über das Attribut mask definiert. Möglich sind:
- createDocument
Maske zum Erstellen eines Dokumentes - createDirectory
Maske zum Erstellen eines Verzeichnisses - upload
Maske zum Hochladen - editDocument
Editor - showDir
Auflistung in der Dateiverwaltung
Darstellungstypen sind über das Attribut type definiert. Mögliche Darstellungstypen sind:
- blank
Neutral - info
Information - warning
Warnung - error
Fehler
Über matchPath lässt sich die Darstellung auf ein definiertes Verzeichnis einschränken. Der erste passende Treffer wird genutzt. Allgemeine Regeln müssen deshalb nach speziellen Regeln definiert sein.
Hinweistexte in unterschiedlichen Masken
Weiterführende Links
FAQs are only visible for Weblication ai search and editors!
- Ab welcher Version von Weblication® CMS können Masken durch individuelle Hinweistexte erweitert werden?
- Ab Weblication® CMS 10.x können Sie Masken durch individuelle Hinweistexte erweitern. Damit lassen sich abhängig von Benutzern und aktuellen Pfaden Informationen sowie HTML-Fragmente einbinden, um die Bedienung auch im Backend zu optimieren.
- Wo kann man das Hinzufügen von projektbezogenen Benutzerinfos ab CMS-Version 12.x direkt konfigurieren?
- Ab CMS-Version 12.x kann dies direkt über das Projekt vorgenommen werden (Register: Darstellung -> Benutzerinfos).
- Wozu dient die Definitionsdatei für pfadabhängige Benutzerinformationen in wGuiOverlays?
- Sie dient dazu, Masken (z. B. Upload, Erstellung, Bearbeitung, Verzeichnisauflistung) um individuelle Informationen für Benutzer zu ergänzen. Die Ausgaben können zudem per Logik an Bedingungen wie Sprache, Projektpfad und weitere Kriterien gekoppelt werden.
- Welche Platzhalter werden in den Hinweistexte-Definitionen unterstützt?
- Im Beispiel werden folgende Platzhalter genannt: $__WSLPRE[wUserLanguage] (Benutzersprache), $__WSLPRE[wProjectPath] (Projektpfad), $__WSLPRE[wProjectGlobalPath] (Pfad des globalen Projektes) sowie $__WSLPRE[wProjectAssetsPath] (Assets-Projektpfad) und $__WSLPRE[wPath] (Pfad des aktuellen Verzeichnisses bzw. der aktuellen Datei). Hinweis: Die Unterstriche sind nur im Quelltextbeispiel gezeigt; der korrekte Platzhalter ist ohne Unterstriche.
- Wie funktionieren Bedingungen wie Sprache und Pfade bei der Auswahl eines Overlays?
- Über Attribute wie matchPath, matchUserType und weitere Parameter lassen sich Overlays einschränken. Wichtig: Es wird der erste passende Treffer genutzt. Daher sollten allgemeine Regeln nach speziellen Regeln definiert werden.
- Wie kann ein Overlay in der Upload-Maske nur für bestimmte Benutzertypen angezeigt werden?
- Im Beispiel wird das über das Attribut matchUserType gesteuert (z. B. matchUserType="admin|standard"). Zusätzlich kann der Pfad mit notMatchPath eingeschränkt werden, um die Ausgabe z. B. auf bestimmte Verzeichnisse zu verhindern.
- Welcher Hinweis erscheint im Beispiel für die Upload-Maske, wenn Bilder nicht im globalen Bildverzeichnis hochgeladen werden?
- Im Beispiel wird in der Upload-Maske (warning) angezeigt: Bitte laden Sie Bilder ausschließlich in das globale Bildverzeichnis. Zusätzlich wird ein Link bereitgestellt, um in das entsprechende Bildverzeichnis zu wechseln (über showmaskuploadfile mit uploaddir=$__WSLPRE[wProjectAssetsPath]/img).
- Wie können Hinweise zur Sprache abhängig von der Benutzersprache ausgegeben werden?
- Im Beispiel wird das über wsl:ifValue realisiert, z. B. indem bei Benutzersprache „en“ bzw. „de“ unterschiedliche Textausgaben eingeblendet werden (z. B. für aussagekräftige Dateinamen).
- Wie lässt sich die Anzeige auf ein bestimmtes Verzeichnis einschränken (matchPath)?
- Über das Attribut matchPath können Sie die Darstellung auf ein definiertes Verzeichnis bzw. Muster einschränken. Der erste passende Treffer wird dabei genutzt; deshalb müssen allgemeine Regeln nach speziellen Regeln definiert sein.
- Welche Maskenarten (Attribute mask) sind im Inhalt genannt?
- Anpassbare Masken sind über mask definiert. Genannt werden: createDocumentMaske (Dokument erstellen), createDirectoryMaske (Verzeichnis erstellen), uploadMaske (Hochladen), editDocumentEditor (Bearbeiten im Editor) sowie showDirAuflistung in der Dateiverwaltung.
- Welche Darstellungstypen (Attribut type) werden im Inhalt aufgeführt?
- Genannt werden Darstellungstypen wie: blankNeutral, infoInformation, warningWarnung und errorFehler (jeweils über das Attribut type im Overlay-Definitionselement).
- Wo muss die Definitionsdatei abgelegt werden, damit sie im gesamten Projekt angewendet wird?
- Unter dem Pfad: */[IHR-LAYOUT-PROJEKT]/wGlobal/layout/overlays/default.wGuiOverlays.php*. So wird die Datei projektweit wirksam.
- Was ist zu tun, wenn die Definitionsdatei nicht im Projekt vorhanden ist?
- Sofern sie nicht vorhanden ist, soll sie direkt auf dem Server angelegt werden (mit einem HTML-Editor), und dabei sollte UTF-8 kodiert gespeichert werden.
- Wie sollte die Datei im Beispiel gespeichert werden (Zeichencodierung)?
- Die Datei sollte UTF-8 kodiert gespeichert werden.
- Welche Logik-bezogenen Hinweise werden für Overlays in der Definition genannt?
- Overlays können mit Logik versehen werden. Zudem wird im Beispiel erläutert, dass projektspezifische Benutzerinfos auch abhängig vom Benutzertyp ausgegeben werden können (z. B. über matchUserType in bestimmten Masken wie der Upload-Maske).
- Welche Beispiel-Überlagerung gilt für die Verzeichnisauflistung (showDir) in der Dateiverwaltung?
- Im Beispiel wird für mask="showDir" mit matchPath="aktuelles/meldungen" ein Hinweis ausgegeben, dass aktuelle Meldungen automatisch auf der Startseite erscheinen.