Dokumentation Sprachauswahl2

Aus DeDi-Help

Version vom 11:30, 6. Okt. 2009 von Eppi (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

DeDi Modul : Sprachauswahl2 Versionsstand 1.0

Das Modul bietet die Möglichkeit, Benutzern im Frontend eine komfortable Auswahl der vorhandenen Sprachen zur Verfügung zu stellen. Das Modul bietet vielfältige Design- und Funktionseinstellungen.

Nachdem das Modul im Backend importiert wurde (Backend unter Design > Module > Modul importieren) können wir es in ein Template integrieren und die nötigen Einstellungen vornehmen.


Inhaltsverzeichnis

[bearbeiten] Übersicht Modulkonfiguration im Backend

Bild:Config-Sprachauswahl_2.gif

[bearbeiten] Erklärung der Einstellungen

Schriftart {font}

Einstellung der Schriftarten in unserer Sprachauswahl. Im Bereich Layout finden wir im HTML-Code die Definition der Schriftarten wieder. Im Template kann nur eine Schriftarten definiert werden, deren aussehen aus der CSS-Datei entnommen wird. Natürlich können Sie auch auf die Verwendung der CSS-Einstellung verzichten und die Definition der Schriftarten direkt in das Template per HTML schreiben. In diesem Falle wählen wir in dem Drop-Down Menü den obersten Punkt, "kein" aus.


Ordner der Sprachen-Icons

Mit diesem Pulldown-Menü kann der Ordner ausgewählt werden, in welchem sich die Icons für die Sprachauswahl befinden. In diesem Modul sind vier verschiedenen Sets an Flaggen sind enthalten. Damit diese verwendet werden können, müssen sie mit dem Dateimanger hoch geladen werden. Legen Sie hierzu über den Dateimanager ein neues Verzeichnis an (z.B. flags) und laden Sie die mitgelieferten Grafiken in dieses Verzeichnis. Es können auch eigene Icons erstellt werden (siehe Kapitel "Eigene Icons erstellen")


Sprache für Kürzel xx:

Mit diesem Pulldown-Menü muss für jede Sprache die zur Auswahl stehen soll ein Kürzel zugewiesen werden. Im Pulldown-Menü stehen die Sprachen analog der Sprachauswahl im Backend zur Verfügung. Die Beschriftung der Einträge entspricht der Namensgebung im Backend (unter Administration > Sprachen). Es können auch mehr Sprachen zur Auswahl definiert werden (siehe Kapitel " Neue Sprachen hinzufügen ")


Links zu einer anderen Seite

Standardmäßig ist dieses Feld leer. Somit verweißt jeder Link auf dieselbe Seite aber in einer anderen Sprache. Mit dieser Funktion kann aber der Link auch auf eine andere Seite in der neu gewählten Sprache verweisen (z.B. auf die jeweilige Startseite), dazu muss die idside der entsprechenden Seite angegeben werden. Diese Funktion ist besonders gut für Einstiegseiten geeignet, auf welcher die gewünscht Sprache Ausgewählt werden kann.


Aktuelle Sprache mit anzeigen?

Wir können festlegen dass die aktuelle Sprache angezeigt werden soll (Kontrollkästchen "ja" aktivieren) oder dass die aktuelle Sprache nicht angezeigt werden soll (Kontrollkästchen "ja" deaktivieren).


Nicht verfügbare Sprachen mit ausgeben?

Wir können festlegen dass nicht verfügbare Sprachen mit dem entsprechenden Template angezeigt werden sollen (Kontrollkästchen "ja" aktivieren) oder dass diese Sprachen nicht angezeigt werden sollen (Kontrollkästchen "ja" deaktivieren).


Nicht verfügbare Sprachen als Leer-GIF darstellen?

Wir können festlegen dass nicht verfügbare Sprachen mit dem entsprechenden Template aber mit einem durchsichtigen Icon angezeigt werden soll (Kontrollkästchen "ja" aktivieren) oder dass das als Icon ein farblose (schwarzweiss) Flagge angezeigt werden soll (Kontrollkästchen "ja" deaktivieren).


Template

Die optische Ausgabe wird über das Template gesteuert. Das Template ist normaler HTML Code, bestückt mit DeDi-Variablen zur Ausgabe. Beim ersten Aufruf des Moduls wird das Standardtemplate geladen, welches wir beliebig verändern können. Wir nutzen hier das Standardtemplate zur Erklärung und Darstellung der einzelnen Funktionen.

Der HTML-Code der Ausgabe wird in zwei Bestandteile aufgeteilt und in die Textbereiche des Moduls eingefügt.


Layout Sprachen (aussen):

Mit diesem Template kann der Rahmen der Sprachausgabe gesteuert werden. Dabei Repräsentiert die DeDi-Variable {content} die Ausgabe der einzelnen Sprachelemente.


Layout der verfügbaren Sprache-Elemente:

In diesem Template wird die Ausgabe der einzelnen Sprachen gesteuert die verfügbar sind. Pro verfügbare Sprache wird dieses Template in die DeDi-Variable {content} eingefügt.


Layout der nicht verfügbaren Sprache-Elemente:

In diesem Template wird die Ausgabe der einzelnen Sprachen gesteuert die nicht verfügbar sind. Wenn die Option "Nicht verfügbare Sprachen mit ausgeben" aktiviert ist, wird für jede nicht verfügbare Sprache dieses Template in die DeDi-Variable {content} eingefügt.

Layout allgemein

Es können nur bestimmte Variablen innerhalb der Templatekonfiguration verwendet werden, um Informationen abzurufen. DeDi-Variablen werden immer in { } geschrieben. Die verwendeten DeDi-Variablen und deren Bedeutung sind:


{img}

Gibt URL auf das entsprechende Icon aus Mögliche HTML Kombination:

<img src="{img}">


{url}

Gibt URL für ein Sprach-spezifischer Link aus. Mögliche HTML Kombination:

href="{url}"


{name}

Gibt den Namen der entsprechenden Sprache aus. Mögliche HTML Kombination:

<a href="{url}">{name}</a>


{font}

Ausgabe der CSS Variable wie in der Modulkonfiguration eingestellt. Mögliche HTML Kombination:

{name}


{content}

Ausgabe der einzelnen Sprachen-Elemente.

Alle Variablen können beliebig verwendet werden. So gibt folgender HTML Code zum Beispiel eine untereinander angeordnete Sprachauswahl mit Icon und dem Namen der Sprache aus:

<a href="{url}"><img src="{img}" alt="{name}" border="0"></a>  {name}

[bearbeiten] Ausgabebeispiele

Beispiel 1: Alle Sprachen verfügbar.

Bild:Output-Sprachauswahl_2_a.gif


Beispiel 2: Nur Deutsch verfügbar. Die Option "Icons für nicht verfügbare Sprachen mit ausgeben" ist eingeschaltet.

Bild:Output-Sprachauswahl_2_b.gif

[bearbeiten] Neue Sprachen hinzufügen

Zum hinzufügen von weiteren Sprachen einfach in der Modul Konfiguration das Array der Variable "$piclangs" um einen Eintrag erweitern und ein neues Icon hoch laden, das die Endung des neuen Eintrags im Dateinamen hat.


Beispiel:

  • im Backend neu angelegte Sprache: "spanisch"
  • in der Modulkonfiguration "es" in der Variable $piclangs hinzufügen:
    • variable vorher: $piclangs = array("de","en","fr","it");
    • variable nachher: $piclangs = array("de","en","fr","it","es");
  • zwei Icons erstellen (ein Graustufen-Icon = Sprache nicht verfügbar, ein Icon in Farbe = Sprache verfügbar)
  • dem Graustufen-Icon den Namen "flag_no_es.gif" geben und in denselben Ordner uploaden in dem auch die anderen Icon gespeichert sind.
  • dem farbigen Icon den Namen "flag_es.gif" geben und in das gleiche Verzeichnis hochladen
  • im DeDi-Backend im Dateimanager die Verzeichnisse aktualisieren
  • in der Template-Konfiguration erscheint nun eine neue Zeile "Sprache für Kürzel ES", in der Pulldown-Menü "spanisch" auswählen.
  • fertig.


Eigene Icons erstellen

  • Für jede Sprache ein Icon erstellen wenn die Seite verfügbar ist.
  • Für jede Sprache ein Icon erstellen wenn die Seite nicht verfügbar ist.
  • Die Bilder müssen folgender Namenskonvention einhalten:
    • Icons wenn Seite verfügbar: flag_xx.gif
    • Icons wenn Seite nicht verfügbar: flag_no_xx.gif
    • Leer-Gif: blank.gif
    • Die Bilder mit dem Dateimanger in das entsprechende Projekt hochladen.


Dabei entspricht xx dem Kürzel für die einzelnen Sprachen, welche auch bei der Modulkonfiguration ausgegeben wird. Dabei sind diese vier Kürzel bereits vordefiniert: de, en, fr, it

Persönliche Werkzeuge