This page lists every bisteinoff_* action the theme fires with do_action(). For how to attach callbacks from a child theme, see Using Theme Hooks. Filters are listed separately: Filter Hooks Reference.

Unless noted, the parent theme already prints default output on the hook. Layout hooks named before_* / after_* are usually empty aside from Bootstrap wrappers on some loops — they are the easiest place to inject markup.

Document head and header

Fired from header.php.

Hook	Arguments	Default callback	What it does
`bisteinoff_opengraph_atts`	—	SEO: Open Graph prefix on `<html>`	Runs inside the `<html>` tag. Do not echo a full tag; only extra attributes.
`bisteinoff_embed`	`string $location`	Embed: prints Website Settings → Embed for that location	Locations used by the theme: `'head'` (in `<head>`), `'body'` (right after `<body>`), `'footer'` (before `</body>`), `'google_fonts'` (from the fonts loader). Output is passed through the `bisteinoff_embed_html` filter (Cookie Consent uses this).
`bisteinoff_seo`	—	SEO: title, description, robots, Open Graph tags	Inside `<head>`, before `wp_head()`. Disabled when `BISTEINOFF_THEME_OPTIONS_SEO` is false.
`bisteinoff_class`	`string $location`	MarkupBuilder: echoes extra CSS classes	Used as`class=""` on `<header>` and `'footer'` on `<footer>`. Echo space-separated class names only, not a `class` attribute.
`bisteinoff_logo`	`string $location`	Logo renderer	`'header'` uses unprefixed options (`logo`, `logo_title`, …). Other locations use a prefix, e.g. `footer_logo`. Also used on the maintenance screen as `'footer'`.
`bisteinoff_nav`	`string\|array $type`	Nav renderer; multilingual switcher when enabled	See the Navigation section below.
`bisteinoff_contact`	`string $location`	Contact block (requires Bisteinoff Global Contact Manager)	`'header'`, `'hamburger'`, `'footer'`.
`bisteinoff_cta`	`string $location`	Header CTA button from Website Settings	`'horizontal'` (desktop header), `'hamburger'` (off-canvas). Wrapper and link classes are filterable.

Navigation

bisteinoff_nav accepts a string, or [ 'footer', '1' ] … '4' for the four footer columns.

$type	Where	Notes
`'horizontal'`	Header	Primary bar. Hidden on small screens depending on the header menu option.
`'hamburger'`	Header	Off-canvas menu. Renders `template-parts/nav-hamburger.php`.
`'woo-cart'`	Header	Only if WooCommerce is active, cart is not disabled, and the view is not cart/checkout.
`'languages'`	Header	Language switcher. Requires multilingual mode.
`[ 'footer', n ]`	Footer columns 1–4	`n` is `'1'`, `'2'`, `'3'`, or `'4'`.
`'footer_languages'`	Copyright bar	Footer language switcher.
`'copyright'`	Copyright bar	Secondary footer menu.

Inside the hamburger template:

Hook	Arguments	When
`bisteinoff_nav_hamburger_before_title`	—	Off-canvas header, before the menu title
`bisteinoff_nav_hamburger_after_title`	—	After the menu title, before the close button
`bisteinoff_nav_before`	`string $type`	Before the `wp_nav_menu()` list. Header horizontal nav also fires this with `'horizontal'`.
`bisteinoff_nav_after`	`string $type`	After the menu list
`bisteinoff_nav_footer`	`string $type`	Bottom of the off-canvas panel (`'hamburger'`)

Footer

Fired from footer.php unless noted.

Hook	Arguments	Default callback	What it does
`bisteinoff_footer_wrapper_before`	—	Opens a background-image wrapper when a footer image is set (priority 10)	Safe to add content after priority 10 if you need to sit inside that wrapper.
`bisteinoff_socials`	`string $location`	Prints selected networks for that location	Footer uses `'footer'`. Reads the `{location}_socials` option.
`bisteinoff_footer_note`	—	Optional note from Website Settings → Footer	Column 4, under socials.
`bisteinoff_copyright`	—	© year range, site name, attribution	Also used on the maintenance screen.
`bisteinoff_footer_wrapper_after`	—	Closes the background wrapper (priority 90)	Run before 90 to stay inside the wrapper, after 90 to sit outside it.

Shared content chrome

Used on pages, posts, archives, search, 404, gallery, contact, testimonials, and similar templates.

Hook	Arguments	Default callback	What it does
`bisteinoff_content_data`	—	Echoes data attributes on `<main id="content">`	Called inside the opening `<main>` tag. Echo attributes only.
`bisteinoff_title`	—	SEO heading (H1 text for the view)	Used in page headers, WooCommerce archive/product titles, related-article cards.
`bisteinoff_breadcrumbs`	—	Breadcrumb nav (skipped on front page and maintenance)	Trail is filterable via `bisteinoff_breadcrumb_items`.

Pages

Templates: page.php, contact-page.php, gallery-page.php, testimonials-page.php (same layout hooks).

Hook	Typical use
`bisteinoff_before_page_content`	Above the page header, inside `<main>`
`bisteinoff_after_page_header`	Between header (title/breadcrumbs) and the content loop. Not fired on contact/gallery/testimonials templates that skip this slot.
`bisteinoff_before_page_loop`	Before `the_content()`. Parent opens a Bootstrap container here when the page builder is off (priority 0).
`bisteinoff_after_page_loop`	After the loop. Parent closes the container (priority 100).
`bisteinoff_after_page_content`	End of `<main>`

Contact page extras (only on contact-page.php):

Hook	Arguments	What it does
`bisteinoff_contact_items`	`int $post_id`	Contact list chosen on that page (plugin required)
`bisteinoff_contact_map`	`int $post_id`	Map embed from post meta `_bst_contact_map` (no plugin required)

Landing pages and front page

page-landing.php (no header chrome):

bisteinoff_before_lp_page_content
bisteinoff_before_lp_page_loop / bisteinoff_after_lp_page_loop
bisteinoff_after_lp_page_content

front-page.php:

Hook	When it runs
`bisteinoff_before_frontpage_content`	Always, after `<main>` opens
`bisteinoff_before_frontpage_loop` / `bisteinoff_after_frontpage_loop`	When the front page is a posts blog. Parent adds a container (priorities 0 and 100) if the builder is off.
`bisteinoff_frontpage_content`	When the front page is not a posts loop (static front page / no posts). Nothing is hooked by default — attach your own output, or let the page builder fill the page.
`bisteinoff_after_frontpage_content`	Always, before `<main>` closes

Archives, search, 404

archive.php and taxonomy-testimonials_category.php:

bisteinoff_before_archive_content
bisteinoff_after_archive_header
bisteinoff_before_archive_loop / bisteinoff_after_archive_loop
bisteinoff_after_archive_content

search.php: bisteinoff_before_search_results / bisteinoff_after_search_results around the results list.

index.php and 404.php use the shared chrome only (bisteinoff_content_data, bisteinoff_title, bisteinoff_breadcrumbs).

Single posts

Template: template-parts/content-single.php.

Hook	Arguments	What it does
`bisteinoff_before_single_content`	—	Top of the article, inside `<main>`
`bisteinoff_after_single_header`	—	After title, breadcrumbs, and date
`bisteinoff_single_meta`	`string $type`, `array $args = []`	Prints one meta line. Types: `'date'`, `'time'` (reading time), `'category'`, `'tag'`. For `'category'`, `$args` may include `primary` and `secondary` (both default true). Also used on cards and in the Posts builder component.
`bisteinoff_share`	—	Share buttons from Website Settings
`bisteinoff_after_single_content`	—	After the article body
`bisteinoff_before_single_comments` / `bisteinoff_after_single_comments`	—	Around comments
`bisteinoff_related_articles`	—	Related posts block
`bisteinoff_related_articles_carousel_attributes`	—	Echoes carousel `data-*` attributes on the related-articles wrapper

Testimonials

Hook	Arguments	What it does
`bisteinoff_testimonial_form`	`string $location`	`'modal'` prints a button that opens the form modal. `'below'` prints the inline form. Only the location that matches Testimonials Settings → form display mode actually outputs anything.
`bisteinoff_testimonial`	`string $type`, `array $args = []`	Field of the current testimonial. Types: `'name'`, `'city'`, `'photo'`, `'date'`, `'rating'`, `'media'`, `'user'` (photo + name + city). `$args['context']` is `'card'` or `'single'`. `$args['post_id']` optional.

bisteinoff_ad — argument int $location (1-based slot). The parent theme listens to this action but does not fire it in its templates. Call it from a child template or from another layout hook. Slot count follows BISTEINOFF_THEME_OPTIONS_ADS (see Theme Constants).

add_action( 'bisteinoff_after_archive_header', function (): void {
    echo '<div class="container-fluid">';
    do_action( 'bisteinoff_ad', 1 );
    echo '</div>';
} );

WooCommerce

Hook	Where
`bisteinoff_before_woo_content`	Inside `<main>`, before the shop/product container
`bisteinoff_after_woo_content`	After the container, still inside `<main>`
`bisteinoff_before_woo_product_gallery` / `bisteinoff_after_woo_product_gallery`	Single product image template

Shop and product titles still use bisteinoff_title and bisteinoff_breadcrumbs.

After saving options

When an options panel is saved, the theme fires:

do_action( 'bisteinoff_after_save_{$option_name}', array $old, array $output, array $input )

Known $option_name values:

bisteinoff_theme_options — Website Settings
bisteinoff_theme_design — Design Settings
bisteinoff_language_settings — Languages
bisteinoff_testimonials_settings — Testimonials Settings
bisteinoff_cookie_consent — Cookie Settings

Use this for side effects (flush rewrite rules, rebuild a cache). Do not echo HTML here.

add_action( 'bisteinoff_after_save_bisteinoff_theme_options', function ( array $old, array $output, array $input ): void {
    if ( ( $old['some_slug'] ?? '' ) !== ( $output['some_slug'] ?? '' ) ) {
        flush_rewrite_rules( false );
    }
}, 10, 3 );

Admin metabox wrappers

Each metabox template fires:

bisteinoff_admin_{$id}_metabox_before
bisteinoff_admin_{$id}_metabox_after

Ids used by the parent theme: bst_page (template settings), bst_contact, bst_seo, bst_feature, bst_slide, bst_testimonial, bst_cookie.

The SEO module already hooks bisteinoff_admin_bst_seo_metabox_before and …_after for the tags preview and placeholders widget.

Copy-paste map: a typical page

Order inside page.php:

bisteinoff_content_data (on <main>)
bisteinoff_before_page_content
Header: bisteinoff_title, bisteinoff_breadcrumbs
bisteinoff_after_page_header
bisteinoff_before_page_loop → the_content() → bisteinoff_after_page_loop
bisteinoff_after_page_content

For Developers

Action Hooks Reference