Weblication® Masken durch eigene Informationen für Benutzer erweitern

Nutzbar ab: Version

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
Hinweistexte in unterschiedlichen Masken