Zum Inhalt

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:

  1. Inhalte an den Highlighter übergeben
  2. 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.