Vendix Theme öffnet seine Bereiche für Plugins und Child-Themes. Diese Referenz listet die dokumentierten Hooks auf. Die FAQ in der Readme des Themes und die Hinweise im Code beschreiben jeden davon ausführlicher.
Ein Layout an einer Theme-Location ausgeben
Der Filter vendix_theme/location erhält die Location-Namen des Elementor Theme Builders: header, footer, single und archive. Ein Plugin, das sein eigenes Layout für die Location ausgibt, gibt true zurück; das Theme zeichnet dort dann nichts Eigenes.
add_filter( 'vendix_theme/location', function ( $printed, $location ) {
if ( 'header' !== $location ) {
return $printed;
}
// Print your header here.
echo '<header class="my-header">…</header>';
return true;
}, 10, 2 );
headerundfooterlaufen auf jeder Seite.singleläuft für einen Beitrag, eine Seite (auch Warenkorb, Kasse und Kontoseiten), einen Anhang oder einen Eintrag eines anderen Beitragstyps, ein Produkt und die 404-Seite.archiveläuft für die Beitragsseite, Beitragsarchive, Suchergebnisse, den Shop sowie Produktkategorien und -schlagwörter.- Ein Location-Name sagt nicht, welche Art von Seite angezeigt wird. Wählen Sie Ihre Vorlage anhand der Anfrage (Beitragstyp,
is_404(),is_cart()und Ähnliches) und geben Sie für die anderenfalsezurück. - Wenn
singleoderarchiveausgegeben wird, gibt das Theme darum herum nur seinen Header und Footer aus. current_theme_supports( 'vendix-templates' )zeigt an, dass das Theme so arbeitet.
Ein Plugin-Layout hat Vorrang, danach der Elementor Theme Builder, dann der eigene Teil des Themes.
Actions
| Action | Wo sie läuft |
|---|---|
vendix_theme/header_before | Vor dem Theme-Header, außerhalb davon |
vendix_theme/header_after_branding | In der Header-Zeile, direkt nach dem Logo oder Website-Titel |
vendix_theme/header_actions | Am Ende der Header-Zeile; Elemente stehen zusammen in der Gruppe .vt-header-actions |
vendix_theme/header_after | Nach dem Theme-Header, außerhalb davon |
vendix_theme/footer_before | Nach dem Inhalt und vor dem Footer, unabhängig davon, wer den Footer zeichnet |
vendix_theme/single_before_content | Direkt über dem Text eines Beitrags, mit der Beitrags-ID |
vendix_theme/single_after_content | Direkt unter dem Text eines Beitrags, mit der Beitrags-ID |
vendix_theme/post_meta | Ende der Meta-Zeile eines Beitrags, mit der Beitrags-ID |
vendix_theme/card_meta | Ende der Meta-Zeile einer Beitragskarte, mit der Beitrags-ID |
vendix_theme/news_* | Die News-Bereiche auf News-/Magazin-Websites: news_top_bar, news_ticker, news_post_meta, news_card_meta, news_before_content, news_after_content |
Die Header-Actions laufen nur, wenn das Theme seinen eigenen Header zeichnet. Ein minimaler Header, zum Beispiel auf der schlichten Kasse, zeigt keine Actions der Header-Zeile. Ein transparenter Header liegt über dem oberen Seitenbereich und verdeckt ein davor oder danach ausgegebenes Element; prüfen Sie zuerst vendix_theme_header_transparent() und lassen Sie das Element weg, wie es das Theme bei der News-Top-Bar macht.
Die Beitrags-Actions laufen auf jedem Website-Typ. Auf News-Websites bleiben die vendix_theme/news_*-Actions an ihrer Stelle; die allgemeinen folgen danach, außer vendix_theme/single_after_content, das vor vendix_theme/news_after_content kommt.
Filter
| Filter | Was er ändert |
|---|---|
vendix_theme/site_type | Den Website-Typ: business, store oder news |
vendix_theme/defaults | Den Standardwert jeder Theme-Option, mit dem Website-Typ |
vendix_theme/header_minimal | Ob der Theme-Header nur das Logo oder den Website-Titel zeigt |
vendix_theme/footer_minimal | Ob der Theme-Footer nur den Footer-Text zeigt |
vendix_theme/page_options_post_id | Den Beitrag, dessen Seitenlayout-Optionen gelten, für Ansichten, für die eine Seite steht, etwa den Shop |
vendix_theme/palette | Die Design-System-Farben der Block-Editor-Palette |
vendix_theme/setup_url | Die Adresse der geführten Einrichtung eines Plugins für die Willkommensseite |
vendix_theme/setup_complete | Ob die geführte Einrichtung des Plugins abgeschlossen ist, wodurch der Einrichtungshinweis ausgeblendet wird |
Plugins können den Website-Typ auch mit vendix_theme_site_type() auslesen.
Dem Theme Ihre Farben und Schriften übergeben
- Farben: Der Filter
vendix_theme/paletteerhält ein leeres Array. Geben Sie die Design-System-Farben als Schlüssel und Hex-Farbe zurück, mit den Schlüsselnprimary,secondary,accent,heading,text,muted,border,bg_lightundbg_dark. Das Theme übernimmt jede gültige Hex-Farbe für die Block-Editor-Palette und behält seine eigene Palette, wenn keine angegeben wird. Die Website selbst liest die CSS-Variablen--vendix-color-*. - Typografie: Setzen Sie CSS-Variablen auf dem Root-Element,
--vendix-type-{body|h1|h2|h3|h4|h5|h6|menu}-{family|size|size-tablet|size-mobile|weight|line-height|letter-spacing|transform}, jeweils nur, wenn sie einen Wert hat. Das Theme liest sie für den Fließtext, die Überschriften, das Theme-Menü sowie Text, Titel und Überschriften von News-Beiträgen, mit seinen eigenen Werten als Fallback. Tablet-Größen gelten bis 1024 Pixel und Smartphone-Größen bis 767 Pixel.
CSS-Hooks
| Hook | Was er anzeigt |
|---|---|
Klasse vt-sticky-header auf <html> | Ein fixierter Theme-Header wird angezeigt |
Variable --vt-sticky-header-height auf <html> | Die Höhe des geschlossenen fixierten Headers, für Elemente, die darunter haften |
Klasse vt-menu-open auf <html> | Das Smartphone-Menü ist geöffnet |
Klasse vt-header-slot | Ein Bereich neben dem Logo: Auf dem Desktop rückt das Menü in eine eigene Zeile, auf Tablets und Smartphones nimmt der Bereich eine ganze Zeile ein |
Variable --vt-back-to-top-offset | Verschiebt die Nach-oben-Schaltfläche nach oben, für Plugin-Elemente, die am unteren Bildschirmrand fixiert sind |
Klassen vt-type-business, vt-type-store, vt-type-news auf <body> | Der Website-Typ |
Klasse und Variable des fixierten Headers fehlen, wenn der Header nicht fixiert ist, wenn ein Plugin oder der Elementor Theme Builder den Header zeichnet und wenn der Header ausgeblendet ist.