Helfer Funktionen¶

Überblick¶

In diesem Bereich dokumentieren wir alle Helferfunktionen, die du als Entwickler im Theme und in Templates einsetzen kannst.

Dynamic Content
Dynamische Inhalte per Placeholder und AJAX.
Öffnen
Posts by Taxonomy
Posts nach Taxonomie sortiert laden.
Öffnen
Post Meta (Engine Helper)
Post-Meta-Daten strukturiert mit TwthemeGetPostMeta laden.
Öffnen

Debug & Logging¶

Funktion	Anwendung
`twtheme_error_log($message = '')`	Debug in `error_log` schreiben, inkl. Datei/Zeile.
`twtheme_console_log($message, $type = 'warn')`	Ausgabe in der Browser-Console (`log`, `warn`, `error`).
`print_rpre($array = [])`	Arrays lesbar mit `<pre>` ausgeben.

Content & Formatierung¶

Funktion	Anwendung
`twtheme_excerpt($post_id, $content = '', $args = [])`	Auszug erstellen, optional mit Read‑More/Modal.
`twtheme_excerpt_modal($content, $extended_content, $title, $id)`	Modal-HTML für lange Inhalte erzeugen.
`twtheme_get_content($content)`	Content filtern (Hyperlinks, Shortcodes).
`twtheme_highlight_search_keywords($content)`	Suchbegriffe im Content markieren.
`remove_empty_p($content)`	Leere `<p>`‑Tags entfernen.
`twtheme_date_as_text($date)`	Datum als Text ausgeben (z. B. „vor 3 Tagen“).
`twtheme_get_date_diff($date)`	Tagesdifferenz zu heute berechnen.
`twtheme_is_strtotime($format)`	Prüfen, ob String als Datum interpretierbar ist.
`twtheme_count_content_words($content)`	Wörter zählen (HTML/Shortcodes ignorieren).
`twtheme_post_reading_time($content)`	Lesezeit in Minuten berechnen.

URLs & Links¶

Funktion	Anwendung
`twtheme_hyperlink($url = '', $title = '', $atts = [], $args = [])`	Standardisierte Links erzeugen (rel/target/Slash‑Handling).
`twtheme_hyperlink_scan($content = '', $args = [])`	Links im HTML automatisiert anpassen.
`twtheme_hyperlink_matches_id_or_class_selector($attributes, $selector)`	Prüfen, ob Link-Attribute einen Selector matchen.
`twtheme_brand_url()`	Marken-URL zurückgeben.
`filter_action_url($url = '')`	URL‑Filter für Loops/Filter‑Shortcode anwenden.

Medien & Assets¶

Funktion	Anwendung
`twtheme_media($args = [])`	Media‑Iframe mit Lazy‑Load/Blocker erzeugen.
`twtheme_preload_image($image_id, $image_url = '', $image_srcset = '', $image_sizes = '')`	`<link rel="preload">` für Bilder erzeugen.
`twtheme_preload_fonts()`	`<link rel="preload">` für Fonts ausgeben.
`twtheme_attr_get($tag, $attr)`	HTML‑Attribut aus Tag‑String lesen.
`twtheme_attr_set($tag, $attr, $value)`	HTML‑Attribut in Tag‑String setzen/ersetzen.
`twtheme_image_sizes_for_media($size_names)`	Bildgrößen für die Mediathek registrieren.

Benutzer & Rollen¶

Funktion	Anwendung
`twtheme_get_user_role()`	Erste Rolle des aktuellen Users liefern.
`twtheme_get_user_roles()`	Alle Rollen des aktuellen Users liefern.
`twtheme_user_has_role($role_name, $user_id = '')`	Prüfen, ob User Rolle hat.
`twtheme_user_is_admin($user_id = '')`	Prüfen, ob User Administrator ist.
`twtheme_get_user_meta($user_id = '')`	User‑Meta als Array liefern.
`twtheme_get_username($user_id = '')`	Anzeigename oder Login-Name liefern.

Geräteerkennung¶

Funktion	Anwendung
`get_device()`	Device‑Info (system/device) liefern.
`is_mobile()`	Mobile‑Device prüfen.
`is_tablet()`	Tablet prüfen.
`is_desktop()`	Desktop prüfen.

Utilities¶

Funktion	Anwendung
`twtheme_get_current_post_type()`	Aktuellen Post‑Type robust ermitteln.
`twtheme_get_posts($post_type_name = 'page', $args = [])`	Posts als `value/label` Liste liefern.
`twtheme_get_post_types()`	Verfügbare Post‑Types liefern.
`twtheme_get_roles()`	WordPress‑Rollen als Liste liefern.
`twtheme_get_terms()`	AJAX‑Handler für Taxonomien je Post‑Type.
`get_random_id($length = 6)`	Zufällige ID erzeugen.
`twtheme_outputter($functions, $value)`	Mehrere Output‑Filter nacheinander anwenden.
`twtheme_get_value($data = [], $fallback = true)`	`value` aus Array extrahieren (Fallback auf `placeholder`).
`twtheme_get_title($data = [], $fallback = true)`	`title` aus Array extrahieren (Fallback auf `label`).
`twtheme_wpseo_metabox_prio()`	Yoast‑Metabox Priorität auf `low` setzen.

Templates & Pages¶

Funktion	Anwendung
`twtheme_find_addon_template($template_filename)`	Template in Add‑on‑Verzeichnissen suchen.
`twtheme_addon_single_template($single_template)`	Single‑Template aus Add‑on laden.
`twtheme_addon_archive_template($archive_template)`	Archive‑Template aus Add‑on laden.
`twtheme_addon_taxonomy_template($taxonomy_template)`	Taxonomy‑Template aus Add‑on laden.
`twtheme_page_template($single_template)`	Page‑Template überschreiben.

Posts & Taxonomien¶

Funktion	Anwendung
`twtheme_posts_by_taxonomy($taxonomy, $args = [], $term_args = [], $sort = [], $transient_name = '', $transient_period = '')`	Posts nach Taxonomie sortiert holen. Siehe: `./posts-by-taxonomy/`
`twtheme_redirect_to_post()`	AJAX‑Handler: Redirect zu Post/Term.

UI & Output¶

Funktion	Anwendung
`twtheme_spinner()`	HTML‑Spinner ausgeben.
`twtheme_skip_links()`	Skip‑Links für Accessibility ausgeben.
`twtheme_pagination($link, $args)`	Pagination‑Links formatieren.
`twtheme_dynamic_content($key = '', $html = '', $script = '', $loading = 'lazy', $attr = '')`	Dynamischen Placeholder erzeugen. Siehe: `./dynamic-content/`
`twtheme_dynamic_content_response()`	AJAX‑Handler für dynamischen Content.
`twtheme_brand_icon()`	Brand‑Icon als Base64‑SVG liefern.
`twtheme_brand_title($title)`	Brand‑Logo mit Titel ausgeben.

Meta & Daten¶

Funktion	Anwendung
`TwthemeGetPostMeta` (Klasse)	Post-Meta strukturiert laden. Siehe: Post Meta (Engine Helper)
`twtheme_update_single_post_meta($post_id, $field_key, $value, $array_meta)`	Single‑Meta speichern und Array‑Meta synchronisieren.
`image_upload_meta_box($field_name = '', $value = '')`	Bild‑Meta‑Box ausgeben.

Shortcode‑Helfer¶

Funktion	Anwendung
`twtheme_media_shortcode($atts = [])`	Shortcode‑Handler für Media.
`twtheme_hyperlink_shortcode($atts)`	Shortcode‑Handler für Hyperlinks.
`twtheme_icon_shortcode_sanitize_slug($value)`	Icon‑Slug für Shortcode bereinigen.

Anwendung im Theme (Beispiele)¶

// 1) Lesezeit anzeigen
$minutes = twtheme_post_reading_time(get_the_content());
echo '<span class="reading-time">' . esc_html($minutes) . ' min</span>';

// 2) Standard-Link erzeugen
echo twtheme_hyperlink('https://example.com', 'Mehr erfahren');

// 3) Dynamischen Inhalt mit Platzhalter
echo twtheme_dynamic_content('hero', '<div>…</div>', '<script>/* … */</script>');

Ausführliche Beschreibungen zu komplexeren Helfern findest du in den Unterseiten.

Technische Dokumentation¶

Überblick¶

Dieses Kapitel fasst den aktuellen Stand zu helfer funktionen direkt aus dem Theme-Code zusammen.

Verhalten im Frontend¶

Funktion	Frontend-Relevanz
`twtheme_outputter($functions, $value)`	Steuert den Bereich outputter.

Shortcodes¶

Shortcode-Funktion	Zweck
`twtheme_betreuungsgebiet_karte_shortcode($atts, $content, $shortcode)`	Steuert den Bereich betreuungsgebiet karte shortcode.
`twtheme_bildungseinrichtung_karte_shortcode($atts, $content, $shortcode)`	Steuert den Bereich bildungseinrichtung karte shortcode.
`twtheme_buttom_shortcode($atts = [])`	Steuert den Bereich buttom shortcode.
`twtheme_depot_btn_shortcode($atts = [], $content = '', $tag = '')`	Steuert den Bereich depot btn shortcode.
`twtheme_hyperlink_shortcode($atts)`	Steuert den Bereich hyperlink shortcode.
`twtheme_img_caption_shortcode($html, $attr, $content = "")`	Steuert den Bereich img caption shortcode.
`twtheme_media($args = [])`	Steuert den Bereich media.
`twtheme_media_shortcode($atts = [])`	Steuert den Bereich media shortcode.

Entwicklertipps¶

Relevante Funktionen¶

Funktion	Parameter	Zweck
`twtheme_betreuungsgebiet_karte_shortcode($atts, $content, $shortcode)`	`$atts`: Funktionsparameter; `$content`: Ausgabe-/Textinhalt; `$shortcode`: Funktionsparameter	Steuert den Bereich betreuungsgebiet karte shortcode.
`twtheme_bildungseinrichtung_karte_shortcode($atts, $content, $shortcode)`	`$atts`: Funktionsparameter; `$content`: Ausgabe-/Textinhalt; `$shortcode`: Funktionsparameter	Steuert den Bereich bildungseinrichtung karte shortcode.
`twtheme_buttom_shortcode($atts = [])`	`$atts`: Funktionsparameter (Standard: `[]`)	Steuert den Bereich buttom shortcode.
`twtheme_console_log($message, $type = 'warn')`	`$message`: Funktionsparameter; `$type`: Funktionsparameter (Standard: `'warn'`)	Steuert den Bereich console log.
`twtheme_count_content_words($content)`	`$content`: Ausgabe-/Textinhalt	Steuert den Bereich count content words.
`twtheme_depot_btn_shortcode($atts = [], $content = '', $tag = '')`	`$atts`: Funktionsparameter (Standard: `[]`); `$content`: Ausgabe-/Textinhalt (Standard: `''`); `$tag`: Funktionsparameter (Standard: `''`)	Steuert den Bereich depot btn shortcode.
`twtheme_error_log($message = '')`	`$message`: Funktionsparameter (Standard: `''`)	Steuert den Bereich error log.
`twtheme_excerpt($post_id, $content = '', $args = [])`	`$post_id`: Identifikator; `$content`: Ausgabe-/Textinhalt (Standard: `''`); `$args`: Konfigurationsdaten (Standard: `[]`)	Steuert den Bereich excerpt.
`twtheme_excerpt_modal($content, $extended_content, $title, $id)`	`$content`: Ausgabe-/Textinhalt; `$extended_content`: Funktionsparameter; `$title`: Ausgabe-/Textinhalt; ... +1 weitere	Steuert den Bereich excerpt modal.
`twtheme_get_content($content)`	`$content`: Ausgabe-/Textinhalt	Steuert den Bereich get content.
`twtheme_get_current_post_type()`	—	Short function for print_r with
`twtheme_get_post_types()`	—	Steuert den Bereich get post types.
`twtheme_get_posts($post_type_name = 'page', $args = [])`	`$post_type_name`: Identifikator (Standard: `'page'`); `$args`: Konfigurationsdaten (Standard: `[]`)	Steuert den Bereich get posts.
`twtheme_get_roles()`	—	Steuert den Bereich get roles.
`twtheme_get_terms()`	—	Steuert den Bereich get terms.
`twtheme_get_user_meta($user_id = '')`	`$user_id`: Identifikator (Standard: `''`)	Steuert den Bereich get user meta.
`twtheme_get_user_role()`	—	Steuert den Bereich get user role.
`twtheme_get_user_roles()`	—	Steuert den Bereich get user roles.
`twtheme_get_username($user_id = '')`	`$user_id`: Identifikator (Standard: `''`)	Steuert den Bereich get username.
`twtheme_highlight_search_keywords($content)`	`$content`: Ausgabe-/Textinhalt	Steuert den Bereich highlight search keywords.

Hooks & Filter¶

Hook/Filter	Typ	Parameter	Zweck
`admin_post_nopriv_twtheme_to_post`	`add_action`	Callback: `'twtheme_redirect_to_post'`	Hook `admin_post_nopriv_twtheme_to_post` wird via `add_action` eingebunden.
`admin_post_twtheme_to_post`	`add_action`	Callback: `'twtheme_redirect_to_post'`	Hook `admin_post_twtheme_to_post` wird via `add_action` eingebunden.
`twtheme_menu_item_title`	`apply_filters`	-	Hook `twtheme_menu_item_title` wird via `apply_filters` eingebunden.
`twtheme_menuitem_icon`	`apply_filters`	-	Hook `twtheme_menuitem_icon` wird via `apply_filters` eingebunden.
`twtheme_menuitem_link_before`	`apply_filters`	-	Hook `twtheme_menuitem_link_before` wird via `apply_filters` eingebunden.
`twtheme_paginate_link`	`add_filter`	Callback: `'twtheme_pagination'`	Hook `twtheme_paginate_link` wird via `add_filter` eingebunden.
`twtheme_skip_links`	`apply_filters`	-	Hook `twtheme_skip_links` wird via `apply_filters` eingebunden.
`wp_ajax_nopriv_twtheme_get_terms`	`add_action`	Callback: `'twtheme_get_terms'`	Hook `wp_ajax_nopriv_twtheme_get_terms` wird via `add_action` eingebunden.
`wp_ajax_twtheme_get_terms`	`add_action`	Callback: `'twtheme_get_terms'`	Hook `wp_ajax_twtheme_get_terms` wird via `add_action` eingebunden.

Stand: 2026-03-11