Customization

.my-banner {
    background: rgb(var(--nk-primary));
    color: rgb(var(--nk-primary-contrast));
    border-radius: var(--nk-radius-brand);
    border: 1px solid var(--nk-border-color);
}

.dark .my-banner { background: var(--nk-surface-raised); }

// Engine hook — the same code works in any NovaKit theme.
add_action( 'nk_before_header', function (): void {
    echo '<div class="my-topbar">Free shipping this week</div>';
} );

// Theme function — specific to how NovaSpark renders a post.
if ( function_exists( 'novaspark_reading_time' ) ) {
    // Returns an int — minutes.
    echo esc_html( novaspark_reading_time() . ' min read' );
}

// nk_before_header — an announcement bar above everything.
add_action( 'nk_before_header', function (): void {
    echo '<div class="my-topbar">Free shipping this week</div>';
} );

// nk_header — priority 5 runs before NovaKit draws its own header.
add_action( 'nk_header', 'my_custom_header', 5 );

// nk_after_header — the theme's own breadcrumbs, which echo directly.
add_action( 'nk_after_header', 'novaspark_breadcrumbs' );

// nk_page_cover — swap in your own cover for one post type.
add_action( 'nk_page_cover', function (): void {
    if ( is_singular( 'product' ) ) {
        get_template_part( 'template-parts/product-cover' );
    }
} );

// nk_before_footer — a call-to-action band above the footer.
add_action( 'nk_before_footer', function (): void {
    echo do_shortcode( '[my_newsletter_cta]' );
} );

// nk_footer — an extra row inside the footer, after NovaKit's.
add_action( 'nk_footer', 'my_extra_footer_row', 20 );

// nk_after_footer — the very last thing on the page.
add_action( 'nk_after_footer', function (): void {
    echo '<div id="my-cookie-bar"></div>';
} );

// Theme Options were saved — clear anything you derived from them.
add_action( 'nk_settings_updated', function (): void {
    delete_transient( 'my_nav_cache' );
} );

add_action( 'nk_account_registered', function ( int $user_id ): void {
    $user = get_userdata( $user_id );

    wp_mail(
        $user->user_email,
        'Welcome aboard',
        'Your account is ready.'
    );
} );

add_action( 'nk_form_custom_submit', function ( array $values, string $handle ): void {
    if ( 'contact' !== $handle ) {
        return;
    }

    my_push_to_crm( $values[ 'email' ] ?? '' );
}, 10, 2 );

add_action( 'nk_render_global_section', function ( int $section_id, string $slot ): void {
    if ( 'footer' === $slot ) {
        my_track_block( $section_id );
    }
}, 10, 2 );

add_filter( 'nk_elementor_widget_enabled', function ( bool $enabled, string $name ): bool {
    // Widget names are the get_name() value, e.g. 'nk-brands'.
    return 'nk-brands' === $name ? false : $enabled;
}, 10, 2 );

add_filter( 'nk_section_types', function ( array $types ): array {
    // slug => label. Adds a new type to the Global Blocks taxonomy.
    $types[ 'promo' ] = __( 'Promo Bar', 'my-child' );

    return $types;
} );

add_filter( 'nk_design_presets', function ( array $presets ): array {
    // Hide a bundled preset from Theme Options.
    unset( $presets[ 'finance' ] );

    return $presets;
} );

add_filter( 'nk_dashboard_recommended_plugins', function ( array $plugins ): array {
    return array_values( array_filter(
        $plugins,
        fn( array $p ): bool => 'jetpack' !== $p[ 'slug' ]
    ) );
} );

add_filter( 'nk_demo_sources', function ( array $sources ): array {
    // Must implement DemoImporter\Sources\DemoSourceInterface.
    $sources[] = new My_Demo_Source();

    return $sources;
} );

add_filter( 'nk_library_sources', function ( array $sources ): array {
    // Must implement Library\Sources\SourceInterface.
    $sources[] = new My_Library_Source();

    return $sources;
} );

add_filter( 'nk_smart_loops_card_styles', function ( array $styles ): array {
    // slug => [ 'label' => …, 'render' => callable ]
    unset( $styles[ 'custom-template' ] );

    return $styles;
} );

add_filter( 'nk_testimonial_skins', function ( array $skins ): array {
    unset( $skins[ 'custom-template' ] );

    return $skins;
} );

add_filter( 'nk_testimonial_containers', function ( array $containers ): array {
    // slug => [ 'label' => …, 'engine' => … ]
    unset( $containers[ 'marquee' ] );

    return $containers;
} );

add_filter( 'nk_icon_sets_to_load', function ( array $used, array $enabled ): array {
    // $used is what NovaKit detected on the page; $enabled is every set
    // switched on. Return $enabled to stop relying on detection.
    return $enabled;
}, 10, 2 );

add_filter( 'nk_custom_header_args', function ( array $args ): array {
    $args[ 'width' ]  = 2560;
    $args[ 'height' ] = 600;

    return $args;
} );

add_filter( 'nk_archive_card_template_id', function ( int $id, WP_Post $post ): int {
    // Use a different Card Global Block for one post type.
    return 'product' === $post->post_type ? 1234 : $id;
}, 10, 2 );