Foreignwords¶
Überblick¶
Das Add-on Foreignwords erweitert TWtheme um ein Glossar mit Fremdwort‑Einträgen und automatische Hervorhebungen im Content (Tooltip/Abkürzungen). Ziel ist ein verständlicheres Leseerlebnis für Endanwender.
Glossar nutzen¶
Unter Foreign Words → Einstellungen findest du den Bereich Glossary:
- Activate: schaltet das Glossar (Übersicht + Detailseiten) frei
- Set link: setzt Links zur Detailseite, z. B. im Tooltip
Ist das Glossar aktiv, sind die Einträge öffentlich und erscheinen alphabetisch im Glossar.
Einträge anlegen¶
Jeder Eintrag enthält:
- Begriff (Titel)
- Beschreibung (Kurztext)
- Abkürzung (optional)
- Aussprache (optional, wichtig für Screen‑Reader)
- Plural und Synonyme (optional)
Zusätzlich kannst du festlegen, ob der Begriff im Glossar angezeigt werden soll.
Hervorhebung im Content¶
Wenn in den Einstellungen unter Word Info → Presentation der Modus Tooltip gewählt ist, werden erkannte Fremdwörter im Content markiert und Tooltips ausgegeben.
Das Verhalten für Leser:
- Beim Hover/Klick erscheint die kurze Erklärung
- Abkürzungen werden automatisch ausgeschrieben
- Glossar‑Einträge verlinken zur Detailseite
Anwendung im Frontend¶
Bei aktiviertem Tooltip‑Modus werden Fremdwörter im Content hervorgehoben und verlinken – falls aktiv – ins Glossar (/lexikon).
Entwicklertipps¶
Für die technische Einbindung gilt:
- Glossar‑Archiv:
/lexikon - Themen‑Archiv:
/lexikon/themen - Sprache je Eintrag über die Taxonomie Locale
Im Theme für zusätzliche Blöcke nutzen¶
Foreignwords markiert standardmäßig den normalen Content. Wenn du Inhalte außerhalb des Content‑Blocks ausgibst (z. B. modulare Blöcke, Footersnippets, dynamische Bereiche), kannst du diese gezielt einbeziehen:
- Inhalte an den Highlighter übergeben
- Ausgabe anschließend mit
highlight()rendern
Beispiel:
global $fwh;
$block_html = do_shortcode('[lc_get_post post_type="lc_section" slug="kontaktformular"]');
// Inhalt dem Highlighter bekannt machen (für Erkennung/Cache)
$fwh->add_content($block_html);
// Ausgabe mit Hervorhebung
echo $fwh->highlight($block_html);
So werden Fremdwörter auch in Blöcken erkannt, die sonst nicht in der normalen Inhaltsanalyse landen.
Twtheme Hooks & Filter¶
| Hook/Filter | Typ | Parameter | Zweck |
|---|---|---|---|
twtheme_foreignword_fields |
Filter | ($fields) |
Zusätzliche Felder für den CPT ergänzen. |
twtheme_dynamic_content_response_html |
Filter | ($html) |
Hervorhebung in dynamischen AJAX‑Inhalten. |