Mehrsprachigkeit

🏠Pro Seite

Das Modul Mehrsprachigkeit macht Beiträge und Seiten mehrsprachig: Inhalt steht in Sprachblöcken, oben erscheint automatisch ein Umschalter, und die gewählte Sprache gilt auf allen Seiten weiter. Bis Blog List 1.3.0 steckte das im Blog-Modul, das Modul About Page hatte eine eigene Kopie davon. Beides ist jetzt hier zusammengefasst.

Allgemein

Sprachblöcke und Umschalter

Jede Sprache bekommt einen eigenen Block, z. B. weinhold_languages_de und weinhold_languages_en. Hat eine Seite Blöcke in mindestens zwei Sprachen, setzt das Modul oben einen Umschalter ein (in Blog-Beiträgen in einer Zeile mit dem Zurück-Button). Die Wahl landet im Browser (localStorage, Schlüssel weinhold_languages) und gilt auf allen Seiten und Subdomains mit derselben Adresse.

Sprachen pro Seite

Unter Weinhold → Mehrsprachigkeit legt jede Site ihre Sprachen fest: Code (de, en, fr …), Beschriftung im Umschalter, Reihenfolge und Standardsprache. Ohne Einstellung gelten Deutsch und English mit Deutsch als Standard. Der Umschalter zeigt auf einer Seite nur die Sprachen, für die sie einen Block hat. Fehlt einer Seite die gewählte Sprache, zeigt sie die Standardsprache. Eine neue Sprache erfordert deshalb keine Änderung an bestehenden Beiträgen.

Feste Beschriftungen

Texte, die Module selbst ausgeben (z. B. Zurück, Alle zuklappen, Kern-Module), sind als Beschriftungen mit deutscher und englischer Vorgabe hinterlegt. Für weitere Sprachen trägt man die Übersetzung in derselben Admin-Seite ein, leere Felder nutzen die Vorgabe.

Profilseite

Die Startseite von weinify.de (früher Modul About Page) nutzt dieselben Sprachblöcke in einem Rahmen mit der Klasse weinhold-languages-profile: 900 px breit, Überschriften und Listenpunkte in der Akzentfarbe der Site.

Shortcodes

Shortcode	Beschreibung
weinhold_languages_de,weinhold_languages_en	Inhalt in einer Sprache; für jede Sprache der Site gibt es weinhold_languages_ plus Sprachcode (z. B. weinhold_languages_fr)
weinhold_languages_text	Kurzer Text in mehreren Sprachen innerhalb von Fließtext oder Überschriften, Attribute je Sprachcode, z. B. de="Regeln" en="Rules"
weinhold_languages_switch	Sprachauswahl mit allen Sprachen der Site an beliebiger Stelle

Frei geschriebenes HTML wird ebenfalls umgeschaltet: ganze Abschnitte mit der Klasse weinhold-languages-de, weinhold-languages-en usw., kurze Texte mit weinhold-languages-text-de, weinhold-languages-text-en usw. (pro Elternelement wird genau eine Sprache gezeigt).

Dateien

modules/languages.php – Sprachblock-Shortcodes, Umschalter (the_content-Filter), Sprach-JS, Admin-Seite für Sprachen und Beschriftungen.
includes/weinhold_languages.php – immer geladen, auch wenn das Modul aus ist: Sprachliste der Site, Erkennen von Sprachblöcken, mehrsprachige Spans, Beschriftungs-Tabelle und der Ersatz bei ausgeschaltetem Modul.
assets/weinhold_languages.css – Umschalter, Sprachblöcke und der Rahmen weinhold-languages-profile.

Für Entwickler

Funktionen für andere Module

Funktion	Zweck
weinhold_languages_codes()	Sprachen der Site, Standardsprache zuerst (Modul aus: nur die Standardsprache)
weinhold_languages_default()	Standardsprache der Site
weinhold_languages_current()	Sprache des Blocks, der gerade gerendert wird
weinhold_languages_extract_blocks()	Sprachblöcke eines Inhalts als Liste Sprachcode zu Inhalt (escapte Beispiele werden ignoriert)
weinhold_languages_html()	Text je Sprache als umschaltbare weinhold-languages-text-Spans
weinhold_languages_register_string()	Feste Beschriftung mit Vorgaben registrieren (Schlüssel, Texte je Sprache, Beschreibung)
weinhold_languages_string(),weinhold_languages_string_html()	Beschriftung in einer Sprache bzw. als umschaltbare Spans

Hooks

Filter weinhold_languages_toggle_bar bekommt das Umschalter-HTML und die Sprachen der Seite; Blog List setzt darüber den Zurück-Button in dieselbe Zeile. Action weinhold_languages_needs_assets läuft, sobald eine Seite Sprachblöcke oder Spans ausgibt; Blog List lädt darüber sein CSS (Farben und Schriften der Site).

JavaScript

window.weinholdLanguages.apply(code) schaltet um, window.weinholdLanguages.current() liefert die angezeigte Sprache. Nach jedem Umschalten feuert das Event weinhold:languages auf document.

Optionen

weinhold_languages_settings (Sprachen und Standardsprache) und weinhold_languages_strings (gepflegte Beschriftungen), jeweils pro Site.

Besonderheiten

Ist das Modul aus, zeigen alle Sprachblöcke nur die Standardsprache, ohne Umschalter und ohne JavaScript. Rohe Shortcodes erscheinen nie, auch nicht für Sprachen wie weinhold_languages_fr.

Blog List speichert Caption und Kurzbeschreibung je Sprache (_weinhold_blog_caption_ bzw. _weinhold_blog_summary_ plus Sprachcode), auch solange das Modul aus ist. Tag-Übersetzungen pflegt Blog List je Sprache, der Tag-Name selbst gilt für die Standardsprache.

Der localStorage-Schlüssel weinhold_languages ist derselbe wie vor dem Modul, eine früher gewählte Sprache bleibt also erhalten.

Versionshistorie

Version	Datum	Änderung
1.4.0	07.11.2026	Auch Shortcodes, Hilfsfunktionen und Hooks mit vollem Namen: [weinhold_languages_de], [weinhold_languages_text], [weinhold_languages_switch], Helfer weinhold_languages_* in includes/weinhold_languages.php, Hooks weinhold_languages_toggle_bar und weinhold_languages_needs_assets, Speicherschlüssel weinhold_languages (eine früher gespeicherte Sprachwahl wird einmalig übernommen). Alle Beiträge, Seiten und die Header-/Footer-Beschriftungen wurden umgestellt.
1.3.0	07.11.2026	Einheitliche Namen mit vollem Präfix: Klassen weinhold-languages-* statt weinhold-lang-* (Sprachblöcke, Umschalter, kurze Texte weinhold-languages-text-de usw.), Startseiten-Rahmen weinhold-languages-profile, data-Attribut data-weinhold-languages-lang, JavaScript window.weinholdLanguages und Event weinhold:languages. Shortcodes, Hilfsfunktionen und die gespeicherte Sprachwahl blieben in dieser Version noch unverändert. Bestehende Inhalte wurden mit umgestellt.
1.2.1	07.11.2026	Nutzt die neuen Variablennamen von Blog List 1.9.0 (--weinhold-blog-list-* statt --wbl-*).
1.1.0	05.11.2026	Sprachblöcke nur noch als weinhold_languages plus Sprachcode (alte Namen entfernt, alle Beiträge umgestellt); Klassen heißen weinhold-languages-de, weinhold-languages-text-de usw., weinhold-languages-toggle und weinhold-languages-profile.
1.0.0	05.11.2026	Erste Veröffentlichung: Sprachlogik aus Blog List 1.3.0 und About Page 1.0.0 zusammengeführt, beliebig viele Sprachen pro Site, feste Beschriftungen, Rahmen für die Startseite.

Multilingual

🏠Per site

The Multilingual module makes posts and pages multilingual: content sits in language blocks, a switcher appears at the top automatically, and the chosen language carries over to every page. Up to Blog List 1.3.0 this lived in the blog module, and the About Page module had its own copy. Both are now combined here.

General

Language blocks and switcher

Each language gets its own block, e.g. weinhold_languages_de and weinhold_languages_en. If a page has blocks in at least two languages, the module adds a switcher at the top (in blog posts on the same line as the back button). The choice is stored in the browser (localStorage, key weinhold_languages) and applies to every page.

Languages per site

Under Weinhold → Mehrsprachigkeit each site sets its languages: code (de, en, fr …), switcher label, order and default language. Without settings, Deutsch and English apply with German as default. The switcher only shows the languages a page has blocks for. If a page lacks the chosen language, it shows the default language, so adding a language requires no changes to existing posts.

Fixed labels

Texts that modules output themselves (e.g. Back, Collapse all, Core modules) are stored as labels with German and English defaults. For further languages, enter the translation on the same admin page; empty fields use the default.

Profile page

The weinify.de home page (formerly the About Page module) uses the same language blocks inside a frame with the class weinhold-languages-profile: 900 px wide, headings and list markers in the site’s accent colour.

Shortcodes

Shortcode	Description
weinhold_languages_de,weinhold_languages_en	Content in one language; every site language has weinhold_languages_ plus its code (e.g. weinhold_languages_fr)
weinhold_languages_text	Short text in several languages inside body text or headings, one attribute per language code, e.g. de="Regeln" en="Rules"
weinhold_languages_switch	Language switcher with all site languages anywhere on the page

Hand-written HTML is switched as well: whole sections with the class weinhold-languages-de, weinhold-languages-en etc., short texts with weinhold-languages-text-de, weinhold-languages-text-en etc. (exactly one language is shown per parent element).

Files

modules/languages.php – language block shortcodes, switcher (the_content filter), language JS, admin page for languages and labels.
includes/weinhold_languages.php – always loaded, even when the module is off: site language list, detecting language blocks, multilingual spans, label table and the fallback for a disabled module.
assets/weinhold_languages.css – switcher, language blocks and the weinhold-languages-profile frame.

For Developers

Functions for other modules

Function	Purpose
weinhold_languages_codes()	Site languages, default first (module off: only the default language)
weinhold_languages_default()	Default language of the site
weinhold_languages_current()	Language of the block currently being rendered
weinhold_languages_extract_blocks()	Language blocks of a content as a map from language code to content (escaped examples are ignored)
weinhold_languages_html()	Text per language as switchable weinhold-languages-text spans
weinhold_languages_register_string()	Register a fixed label with defaults (key, texts per language, description)
weinhold_languages_string(),weinhold_languages_string_html()	Label in one language or as switchable spans

Hooks

The filter weinhold_languages_toggle_bar receives the switcher HTML and the page’s languages; Blog List uses it to put the back button on the same line. The action weinhold_languages_needs_assets runs as soon as a page outputs language blocks or spans; Blog List uses it to load its CSS (site colours and fonts).

JavaScript

window.weinholdLanguages.apply(code) switches the language, window.weinholdLanguages.current() returns the language shown. After each switch the event weinhold:languages fires on document.

Options

weinhold_languages_settings (languages and default language) and weinhold_languages_strings (maintained labels), both per site.

Special Cases

If the module is off, all language blocks show only the default language, without switcher and without JavaScript. Raw shortcodes never appear, not even for languages like weinhold_languages_fr.

Blog List stores caption and short description per language (_weinhold_blog_caption_ or _weinhold_blog_summary_ plus language code), even while the module is off. Blog List keeps tag translations per language; the tag name itself is the default language.

The localStorage key weinhold_languages is the same as before the module, so a previously chosen language is kept.

Version History

Version	Date	Change
1.4.0	07.11.2026	Shortcodes, helper functions and hooks with the full name as well: [weinhold_languages_de], [weinhold_languages_text], [weinhold_languages_switch], helpers weinhold_languages_* in includes/weinhold_languages.php, hooks weinhold_languages_toggle_bar and weinhold_languages_needs_assets, storage key weinhold_languages (a previously saved language choice is taken over once). All posts, pages and the header/footer captions were converted.
1.3.0	07.11.2026	Consistent names with the full prefix: classes weinhold-languages-* instead of weinhold-lang-* (language blocks, switcher, short texts weinhold-languages-text-de etc.), home page frame weinhold-languages-profile, data attribute data-weinhold-languages-lang, JavaScript window.weinholdLanguages and event weinhold:languages. Shortcodes, helper functions and the saved language choice stayed unchanged in this version. Existing content was converted as well.
1.2.1	07.11.2026	Uses the new variable names of Blog List 1.9.0 (--weinhold-blog-list-* instead of --wbl-*).
1.1.0	05.11.2026	Language blocks only as weinhold_languages plus language code (old names removed, all posts converted); classes are weinhold-languages-de, weinhold-languages-text-de etc., weinhold-languages-toggle and weinhold-languages-profile.
1.0.0	05.11.2026	First release: language logic merged from Blog List 1.3.0 and About Page 1.0.0, any number of languages per site, fixed labels, frame for the home page.

Mehrsprachigkeit

Sprachblöcke und Umschalter

Sprachen pro Seite

Feste Beschriftungen

Profilseite

Funktionen für andere Module

Hooks

JavaScript

Optionen

Multilingual

Language blocks and switcher

Languages per site

Fixed labels

Profile page

Functions for other modules

Hooks

JavaScript

Options

Weitere Beiträge

design

theme-weinify

languages

soundboard.weinify.de