wc-bootstrap/functions.php

<?php
/**
 * WooCommerce Bootstrap functions and definitions.
 *
 * Child theme of WP Bootstrap that overrides WooCommerce plugin templates
 * with Bootstrap 5 structures and styling.
 *
 * @package WcBootstrap
 * @since 0.1.0
 */

// Prevent direct access.
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * Define theme constants.
 *
 * CRITICAL: WordPress reads the version from TWO places:
 * 1. style.css header "Version:" — WordPress uses THIS for admin display
 * 2. This PHP constant — used internally by the theme
 * Both MUST be updated on every release.
 */
define( 'WC_BOOTSTRAP_VERSION', '0.0.1' );
define( 'WC_BOOTSTRAP_PATH', get_stylesheet_directory() . '/' );
define( 'WC_BOOTSTRAP_URL', get_stylesheet_directory_uri() . '/' );

/**
 * Load Composer autoloader if present.
 */
if ( file_exists( WC_BOOTSTRAP_PATH . 'vendor/autoload.php' ) ) {
    require_once WC_BOOTSTRAP_PATH . 'vendor/autoload.php';
}

/**
 * Sets up theme defaults and registers support for various WordPress features.
 */
function wc_bootstrap_setup(): void {
    // Make theme available for translation.
    load_child_theme_textdomain( 'wc-bootstrap', WC_BOOTSTRAP_PATH . 'languages' );
}
add_action( 'after_setup_theme', 'wc_bootstrap_setup' );

/**
 * Initialize the WooCommerce-to-Twig template bridge.
 *
 * Registers the WooCommerce Twig extension with the parent theme's TwigService
 * and sets up template interception hooks so the child theme's Twig templates
 * are rendered instead of WooCommerce's PHP templates.
 *
 * Runs at 'init' priority 20 to ensure WooCommerce is fully loaded (it
 * initializes at 'init' priority 0).
 */
function wc_bootstrap_init_twig_bridge(): void {
    // Guard: require parent TwigService and WooCommerce.
    if ( ! class_exists( '\WPBootstrap\Twig\TwigService' ) || ! function_exists( 'WC' ) ) {
        return;
    }

    $twig = \WPBootstrap\Twig\TwigService::getInstance();
    $env  = $twig->getEnvironment();

    // Add child theme templates directory to the Twig loader so {% include %}
    // directives in Twig templates can find other child theme templates.
    $loader = $env->getLoader();
    if ( $loader instanceof \Twig\Loader\FilesystemLoader ) {
        $template_dir = WC_BOOTSTRAP_PATH . 'templates';
        if ( is_dir( $template_dir ) ) {
            $loader->prependPath( $template_dir );
        }
    }

    // Register WooCommerce functions and filters as Twig extensions.
    $env->addExtension( new \WcBootstrap\Twig\WooCommerceExtension() );

    // Register template interception hooks.
    $override = new \WcBootstrap\TemplateOverride();
    $override->register();
}
add_action( 'init', 'wc_bootstrap_init_twig_bridge', 20 );

/**
 * Enqueue child theme styles.
 *
 * Loads parent theme stylesheet first, then child theme overrides.
 * CSS cascade order:
 *   1. wp-bootstrap (parent)
 *   2. woocommerce (plugin styles)
 *   3. wc-bootstrap-style (child theme style.css)
 *   4. wc-bootstrap-overrides (plugin CSS overrides)
 */
function wc_bootstrap_enqueue_styles(): void {
    $theme_version = wp_get_theme()->get( 'Version' );

    // Enqueue parent theme stylesheet.
    wp_enqueue_style(
        'wp-bootstrap-style',
        get_template_directory_uri() . '/assets/css/style.min.css',
        array(),
        wp_get_theme( 'wp-bootstrap' )->get( 'Version' )
    );

    // Enqueue child theme stylesheet.
    wp_enqueue_style(
        'wc-bootstrap-style',
        get_stylesheet_directory_uri() . '/style.css',
        array( 'wp-bootstrap-style' ),
        $theme_version
    );

    // Enqueue plugin Bootstrap override styles.
    // Depend on plugin stylesheets so overrides always load after plugin CSS.
    wp_enqueue_style(
        'wc-bootstrap-overrides',
        get_stylesheet_directory_uri() . '/assets/css/wc-bootstrap.css',
        array( 'wc-bootstrap-style', 'woocommerce-general' ),
        $theme_version
    );
}
add_action( 'wp_enqueue_scripts', 'wc_bootstrap_enqueue_styles' );

/**
 * Enqueue child theme scripts.
 *
 * @since 0.1.0
 */
function wc_bootstrap_enqueue_scripts(): void {
    $theme_version = wp_get_theme()->get( 'Version' );

    // Quantity +/- button handler for Bootstrap input-group widget.
    wp_enqueue_script(
        'wc-bootstrap-quantity',
        get_stylesheet_directory_uri() . '/assets/js/quantity.js',
        array(),
        $theme_version,
        true
    );
}
add_action( 'wp_enqueue_scripts', 'wc_bootstrap_enqueue_scripts' );

/**
 * Handle plugin page rendering via plugin render filter.
 *
 * Delegates page rendering to the parent theme's TwigService so that plugin pages
 * share the same page shell (header, footer, layout) as native WordPress pages.
 * Falls back to letting the plugin handle rendering if the parent theme is not available.
 *
 * @param bool   $rendered Whether the page has been rendered.
 * @param string $content  Pre-rendered plugin HTML content.
 * @param array  $context  Plugin template context.
 * @return bool True if rendering was handled, false to let plugin use fallback.
 *
 * @since 0.1.0
 */
function wc_bootstrap_render_page( bool $rendered, string $content, array $context ): bool {
    if ( ! class_exists( '\WPBootstrap\Twig\TwigService' )
        || ! class_exists( '\WPBootstrap\Template\ContextBuilder' ) ) {
        return false; // Can't render, let plugin use its own fallback
    }

    $context_builder = new \WPBootstrap\Template\ContextBuilder();
    $theme_context   = $context_builder->build();
    $twig            = \WPBootstrap\Twig\TwigService::getInstance();

    // Inject plugin content as the page post content so page.html.twig renders it
    // inside the standard content block. Title is empty so the parent theme does not
    // render its own <h1> — plugin templates handle their own headings.
    $theme_context['post'] = array_merge(
        $theme_context['post'] ?? [],
        [
            'content'   => $content,
            'title'     => '',
            'thumbnail' => '',
        ]
    );

    echo $twig->render( 'pages/page.html.twig', $theme_context );
    return true;
}
add_filter( 'woocommerce_render_page', 'wc_bootstrap_render_page', 10, 3 );

/**
 * Signal to the plugin that its content will be wrapped by the parent theme.
 *
 * When the parent theme's TwigService is available, the plugin templates should skip
 * their outer wrapper elements (breadcrumbs, sidebar, page shell) to avoid double-wrapping.
 *
 * @param bool $wrapped Whether content is theme-wrapped.
 * @return bool
 *
 * @since 0.1.0
 */
function wc_bootstrap_is_wrapped( bool $wrapped ): bool {
    if ( class_exists( '\WPBootstrap\Twig\TwigService' ) ) {
        return true;
    }
    return $wrapped;
}
add_filter( 'woocommerce_is_theme_wrapped', 'wc_bootstrap_is_wrapped' );

/**
 * Add sticky header scroll shadow behavior.
 *
 * Toggles an 'is-stuck' class on the navbar when the page is scrolled,
 * adding a subtle box-shadow to visually separate the header from content.
 *
 * @since 0.1.0
 */
function wc_bootstrap_sticky_header_script(): void {
    ?>
    <script>
    (function() {
        var header = document.querySelector('header.sticky-top');
        if (!header) return;
        var onScroll = function() {
            header.classList.toggle('is-stuck', window.scrollY > 0);
        };
        window.addEventListener('scroll', onScroll, { passive: true });
        onScroll();
    })();
    </script>
    <?php
}
add_action( 'wp_footer', 'wc_bootstrap_sticky_header_script' );