Beschreibung
Xlanguage ist ein xXtensible Multisprache- und Zeichencodierungs-Mangament Plugin.
Es kann sowohl mehrer Sprachen und / oder / auch Zeichencodierungen verwalten und umsetzen.
Was xlanguage kann
- Anzeigen von Inhalten der anzuzeigenden Sprachen auf Basis der dynamischen Wahl des Benutzers
- Umwandlung von Inhalten von einer Zeichenkodierung in eine andere Zeichenkodierung
Was xlanguage NICHT kann
- xlanguage kann NICHT Inhalte selbstständig Übersetzen.
- xlanguage kann NICHT Zeichencodierunge ändern, solange nicht die Ereiterung im php "iconv", "mb_string" oder "xconv" zur Verfügung stehen.
Eigenschaften
- Automatische Erkennung der Sprache des Besuchers auf Grund seiner im Browser eingestellten Sprache.
- Spracheinstellungen beim jeweiligen Besucher in sein Cookie schreiben und bei wiederbesuch automatisch zuordnen
- Manuelles Umschalten der aktuellen Sprache in eine andere mögliche Sprache anhand des Sprachauswahlblock
- Unterstützt den M-S-M Modus für die Zeichencodierung
Anmerkung:
M-S-M: Mehrfache Codierungen, Einfache Codierungen, Mehrfache ausgegebene Codierungen.
M-S-M ermöglicht in einer Sprache one site to fit various users with different language character encoding usages. For example, a site having xlanguage implemented porperly allows users to input content either with GB2312, with BIG5 or UTF-8 encoding and to store the content into DB with specified encoding, for say GB2312, and to display the content either with GB2312, with BIG5 or with UTF-8 encoding.
Installieren / Deinstallieren des Moduls
Es sind keine besonderen Maßnahmen erforderlich, um das Modul zu installieren. Kopieren Sie das entpackte Modul auf Ihren Server in das Verzeichnis ../modules und Installieren es dann anschießend in der Moduladministation.
Detaillierte Anweisungen zur Installation von Modulen sind in englisch als XOOPS Operations Manual vorhanden.
Betriebsanleitung
- 1. Installiere "xlanguage" als normales Modul
- 2. Wähle in der Moduleinstellung unter "Listen der Sprachen" eine Basissprache oder Erweiterete Sprache aus der Auswahl aus. Es können nur Sprachen benutzt werden, die auch vorher schon im Core installiert worden sind.
Beachte:
Modulsprachen sollte in jedem Modul vorhanden sein, damit diese auch angezeigt werden können.
Bevor man eine Erweiterte Sprache hinzufügen kann muss zuerst eine Basissprache definiert werden.
Erweiterte Sprachen bedeutet, dass hier das charset ausgetauscht wird.
Normalerweise mach das nur Sinn bei chinesischen oder arabischen Sprachen.
Jedoch kann man diese auch bei anderen Sprachseiten einsetzen, um z.B. eine Konvertierung von charset:UTF-8 nach charset:iso-8859-1 zu ermöglichen.
Beispiel:
Gäbe es ein charset: bayrisch, dann wäre die Basissprache deutsch mit charset: UTF-8 und eine Erweiterte Sprache als Basissprache deutsch mit charset:bayrisch.
- 3. In der Blockadministration den Block Sprachauswahl aktivieren.
- 4. Um mehrsprachigen Content zu erhalten müssen mindestens 2 Sprachen definiert werden.
Innerhalb von News wie auch Text für Downloads oder sonstige Texte wie z.B. Modulbezeichner in der Moduladministration haben immer den gleichen Syntax:
Definition: [Codezeichen]Text in der jeweiligen Sprache[/Codezeichen]. Alles was nicht zwischen Codebezeichner steht wird immer angezeigt.
Beispiel für einen Link in 3 Sprachen:
<a href:"www.zurseite.de"> [de]Zur Seite[/de][en]Go to the page[/en][fr]aller à la page [/fr]
</a>
Wie an dem Beispiel Link zu sehen ist, wird nur das in der zusätzliche Sprache angezeigt, was sich auch zwischen den Sprachbezeichnern befindet.
Beispiel für eine Modulbezeichnung oder den Titel eines Blocks in 2 Sprachen für das Modul gbook:
[de]Gästebuch[/de][en]Guestbook[/en]
- 5. Wenn man auch im Theme Sprachvariablen verwenden möchte, geht auch dieses Problemlos.
1) Vorraussetzung: ändere in der Datei /modules/xlanguage/api.php die Variable (ca. Zeile 110) "$xlanguage_theme_enable = true;"
2) Ändern der Optionen in api.php (ca. Zeile 112) "$options = array("images", " ", 5); // display mode, delimitor, number per line";
3) Füge in das Theme oder template <{$smarty.const.XLANGUAGE_SWITCH_CODE}> ein, wo die Sprachvariable benötigt wird.
Handbuch
Zu diesem Modul ist kein detailiertes Handbuch verfügbar.
