Abuja Digital Studio · Est. 2018
Start a Project
DocsONavTopbar, footer, and OEngage stacking
Reference

Topbar, footer, and OEngage stacking

ONavorravo.com/docs/onav/topbar-footer

Topbar, footer, and OEngage stacking

Topbar v2

The topbar is an independent fixed bar rendered above the primary nav. It lives under onav_config['topbar_v2'].

php$config['topbar_v2'] = [
    'enabled'      => true,
    'height'       => 36,           // 24-80 px
    'bg'           => '#0b0b0c',
    'text_color'   => 'rgba(255,255,255,0.7)',
    'link_color'   => 'rgba(255,255,255,0.9)',
    'link_hover'   => '#ffffff',
    'descriptor'   => 'Free shipping on orders over $50',
    'hide_mobile'  => true,
    'oengage_order'=> 'above',      // 'above' or 'below' the OEngage utility bar
    'items'        => [
        [ 'label' => 'Blog', 'url' => '/blog' ],
    ],
];

Footer builder

Under ONav > Footer the plugin renders a widget-aware footer with five column types: links, brand, social, newsletter, and raw html. Add up to six columns per row and pick a layout: split, centered, minimal, or stacked.

The rendered footer reads --onav-* tokens that ONav writes inline at wp_head, so it inherits whatever colors you set in Appearance.

Stacking with OEngage

When OEngage (the oregister plugin) is active, ONav detects its oe_settings option and adjusts CSS offsets so the two bars do not overlap. Configure stacking order in the topbar tab:

  • oengage_order = 'above' - the OEngage utility bar sits above the ONav topbar
  • oengage_order = 'below' - the OEngage bar sits beneath

Detection runs at render time:

php$oe        = get_option( 'oe_settings', [] );
$oe_active = is_array( $oe ) && ! empty( $oe['utility_bar_enabled'] );

When active, ONav pushes #oe-utility-bar to the correct top offset via inline CSS.

Topbar, footer, and OEngage stacking · ONav Docs | Orravo