Widget-Plugin: Sprachauswahlelement


Das Symbol für Widgets vom Typ Sprachauswahlelement im Xima® Formcycle-Designer.

Plugin-Download 

Funktionsbeschreibung

Beispiel für ein eingefügtes Sprachauswahl-Widget in einem Formular. Die aktuell verwendete Sprache wird fett dargestellt.

Das Plugin stellt ein neues Widget im Designer zur Verfügung, welches es erlaubt, auf einfache Art eine Auswahlleiste für die Formularsprache einzufügen. Das Widget verwendet individuell im Designer zu konfigurierende Einstellungen im Bezug auf die anzuzeigenden Sprachen und die für sie anzuzeigenden Namen. 

Durch einen Klick im Widget auf eine Sprache wird das Formular mit bereits eingegebenen Werten in den entsprechenden Sprache neu geladen. Zu beachten ist hier, dass es aufgrund von Sicherheitsbeschränkungen der Browser nicht möglich ist, vom Nutzer ausgewählte Dateien in Upload-Elementen wieder einzutragen.

Installation

Das Plugin kann als Mandant-Plugin oder System-Plugin installiert werden. Eine Anleitung zur Installation von Plugins finden Sie hier.

Konfiguration

An Widgets dieses Typs können die folgenden Eigenschaften konfiguriert werden:

Grundeigenschaften

Basiseinstellungen für Grundeigenschaften

Dieses Element hat keine zusätzlichen Einstellungen im Bereich Grundeigenschaften.

Darstellung

In diesem Bereich kann für Sprachauswahl-Widgets nur die Positionierung des Inhalts relativ zur Seite eingetragen werden.

Optionen

Mögliche Konfiguration der zu verwendenen Auswahloptionen eines Sprachauswahl-Widgets.

Sprachauswahl-Widgets verfügen über einen zusätzlichen Bereich Optionen. Hier können die in der Sprachauswahl sichtbaren Sprachen und die für die jeweilige Sprache anzuzeigenden Namen festgelegt werden. 

Für jede anzuzeigende Sprache ist eine Zeile mit dem sichtbaren Beschreibungstext und dem Kürzel der Sprache einzugeben (z.B. en für Englisch). Optional können in der Spalte Titel die Title-Attribute festgelegt werden. Die Sprachen müssen im Designer unter Formularsprache gepflegt werden, damit eine Übersetzung auch tatsächlich durchgeführt wird.

Neben der Konfiguration der Optionen direkt am Widget ist es zudem möglich, eine CSV-Datenquelle zu verwenden. Diese kann im Auswahlelement Datenquelle selektiert werden.

Hilfe

Basiseinstellungen für Hilfe

Dieses Element hat keine zusätzlichen Einstellungen im Bereich Hilfe.

CSS-Klassen

Basiseinstellungen für CSS-Klassen

Dieses Element hat keine zusätzlichen Einstellungen im Bereich CSS-Klassen.

Attribute

Basiseinstellungen für Attribute

Dieses Element hat keine zusätzlichen Einstellungen im Bereich Attribute.

Verfügbar wenn

Basiseinstellungen für Verfügbar wenn

Dieses Element hat keine zusätzlichen Einstellungen im Bereich Verfügbar wenn.

Sonstiges

Basiseinstellungen für Sonstiges

Dieses Element hat keine zusätzlichen Einstellungen im Bereich Sonstiges.

Das Makro [velocity] konnte nicht ausgeführt werden. Grund: [The execution of the [velocity] script macro is not allowed in [xwiki:Formcycle.PluginDocumentation.WidgetXLanguageSwitchPlugin]. Check the rights of its last author or the parameters if it's rendered from another script.]. Klicke auf diese Nachricht, um Details zu erfahren.

Word-/PDF-Export

Standardmäßig ist das Widget so konfiguriert, dass es nicht im Word-/PDF-Export auftaucht. Es ist auch nicht sinnvoll, an dieser Einstellung etwas zu ändern, da das Element in einem exportierten Formular keine Funktion hat.

Mögliche CSS-Anpassungen

Um das Aussehen des Widgets zu individualisieren, können per CSS Anpassungen vorgenommen werden. 

Zum Beispiel kann das standardmäßig Unterstreichen der Spracheauswahlen entfernent werden:

.XItem.XLanguageSwich {
   text-decoration: none;
}

Die Farbe der aktiven Sprache kann wie folgt verändert werden:

.XItem.XLanguageSwich.XLanguageSwichActive {
   color: red;
}

Versionshistorie

2.0.2

  • CSS-Konflikte mit Leitfaden-Plugin behoben
  • Probleme beim Zugriff auf die JQuery-Bibliothek behoben

2.0.1

  • Fix: Nutze Rquest-URL zum Laden des Formulars bei Sprachwechsel. Bisher ging der Sprachwechsel etwa nicht im Postfach oder bei der Einbindung via AJAX.
  • Feature: Beim Wechsel der Sprache wird in der Adresszeile des Browsers die URL angepasst. Damit wird die richtige Sprache genommen, wenn etwa die Seite im Browser neugeladen wird.
  • Erfordert wenigstens FORMCYCLE 7.0.7+

2.0.0

  • Update für Xima® Formcycle 7

Das Makro [velocity] konnte nicht ausgeführt werden. Grund: [The execution of the [velocity] script macro is not allowed in [xwiki:Formcycle.PluginDocumentation.WidgetXLanguageSwitchPlugin]. Check the rights of its last author or the parameters if it's rendered from another script.]. Klicke auf diese Nachricht, um Details zu erfahren.