AdSense¶
Überblick¶
Mit AdSense bindest du Google‑Anzeigen ein und steuerst sie zentral über die Theme‑Optionen. Anzeigen werden per Shortcode im Content oder in Templates ausgegeben.
Einstellungen¶
Unter Theme‑Optionen → AdSense findest du:
- Client ID: deine AdSense‑ID (beginnt mit
ca-pub). - Content Blocker: welcher Cookie‑Blocker die Anzeige freigibt.
- Ads: Liste deiner Anzeigen mit eindeutiger Shortcode ID und Slot ID.
- Lazy Loading: optionales Lazy‑Loading je Anzeige.
Anzeige einfügen¶
Kurzform im Content:
[ad id="sidebar"]
Optional kannst du eine CSS‑Klasse ergänzen:
[ad id="sidebar" class="mb-4"]
Verhalten¶
- Ohne gültige Client ID oder Slot ID wird keine Anzeige ausgegeben.
- Die Anzeige wird erst geladen, wenn der gewählte Content Blocker zustimmt.
Anwendung im Frontend¶
Anzeigen werden per Shortcode eingebunden, z. B. [ad id="sidebar"]. Ohne Zustimmung des Content Blockers erscheinen sie nicht.
Entwicklertipps¶
Relevante Funktionen¶
| Funktion | Zweck | Rückgabe |
|---|---|---|
twtheme_ad($shortcode_id, $class = '', $args = []) |
Rendert die Anzeige per Shortcode‑ID. | string |
Twtheme Hooks & Filter¶
| Hook/Filter | Typ | Parameter | Zweck |
|---|---|---|---|
twtheme_option_fields |
Filter | ($form_data) |
AdSense‑Optionen in den Theme‑Optionen einhängen. |
twtheme_tinymce_shortcodes |
Filter | ($shortcodes) |
AdSense‑Shortcode im Editor anbieten. |