Mit Hilfe des Styleswitchers kann dem Webseitenbesucher eine Auswahl an möglichen Designs angeboten werden.

Der Styleswitcher besteht aus einem CGI-Skript, das über eine SSI-Anweisung eingebunden wird und aus zwei JavaScript-Dateien.

Skript styleswitcher.pl

Das Skript styleswitcher.pl liegt im CGI-Verzeichnis /cgi-bin/. Die Datei muss in der Regel nicht weiter konfiguriert werden. Beim Kopieren in das CGI-Verzeichnis muss jedoch darauf geachtet werden, dass die Datei ausführbar ist und nur schreibbar von der Benutzerkennung des Webmasters.

Die Einbindung des Styleswitchers erfolgt über folgende SSI-Anweisung, die in der Templatedatei /ssi/zusatzinfo.shtml eingefügt wird:

<!--#include virtual="/cgi-bin/styleswitcher.pl" -->

Das Skript selbst führt keine Interaktion durch, sondern dient lediglich dazu, die Auswahlliste der Designs zu erstellen.
Dabei wird zunächst geprüft, ob die Alternativdesigns überhaupt im /css-Verzeichnis vorhanden sind. Ist dies nicht der Fall, wird das betreffende Design auch nicht zur Auswahl angezeigt.

Konfiguration von styleswitcher.pl

Die Konfiguration des Styleswitchers erfolgt über eine Konfigurationsdatei styleswiter.conf, die in das Verzeichnis /vkdaten gelegt werden kann.
Beispiel für diesen Webauftritt: styleswitcher.conf.
Folgende Konfigurationen sind möglich:

  • LINK_DESIGNS

    Kommaseparierte Angabe, welche Designs insgesamt zur Verfügung stehen.

  • SHOW_DESIGNS

    Angabe, welche Designs angezeigt werden sollen bei der Auswahl. Dies kann eine kleinere Menge sein als die bei dem Wert LINK_DESIGNS. Dies ist Beispielsweise dann sinnvoll, wenn man die Varianten eines Designs nicht in der normalen Auswahl anbieten will.

  • DESIGN_META_FILE

    In dieser Datei wird nach Zusatzinformationen zu einem Design geschaut. Die Standard-Metadatei meta.txt liegt jedem offiziellen Design des Vorlagenkatalogs bei.

  • ALLOW_IPS

    Mit dieser Angabe kann eine Liste an IP-Adressen angegeben werden. Der Styleswitcher wird nur dann angezeigt, wenn der Benutzer der Webseite von einer der angegebenen IP-Adressen kommt, oder aber wenn bei diesem Parameter gar keine Angabe gemahct wurde.

  • DESIGNDIR

    Diese Angabe ermöglicht es, ein anderes CSS-Verzeichnis zu wählen.

JavaScript-Dateien

Die beiden Dateien cookies.js und changestyle.js werden in das Verzeichnis /js kopiert, sofern sie dort noch nicht vorhanden ist.

Die Einbindung erfolgt in der Templatedatei /ssi/head.shtml über die folgenden Zeilen:

	
	<script type="text/javascript" src="/js/cookies.js"></script>
	<script type="text/javascript" src="/js/changestyle.js"></script>

Erzeugter HTML-Code

Ist der Styleswitcher aktiv und darf gegenüber dem Benutzer angezeigt werden, wird folgender HTML-Code erzeugt: 

       <div class="styleswitcher">
          <h3>Wechsel der Ansicht</h3>
          <ul>
              <li><a href="#" onclick="setActiveStyleSheet('fau-portal')" title="Auf das Design des FAU-Portals wechseln">Design FAU-Portal</a></li>
              <li><a href="#" onclick="setActiveStyleSheet('rrze-portal')" title="Auf das Design des RRZE-Portals wechseln">Design RRZE-Portal</a></li>
          </ul>
        </div>

Beispiel, bei dem die beiden Designs RRZE-Portal und FAU-Portal zur Auswahl gestellt werden.