Troubleshooting

Notices Are Not Displaying

Wrong Position

Verify that the selected position exists on the page:

1. Some positions are only in checkout
2. Some are only in cart
3. Block checkout may not support all hooks

Theme Conflict

Some themes may override WooCommerce templates. Check:

• your-theme/woocommerce/checkout/form-checkout.php
• your-theme/woocommerce/cart/cart.php

Cache

If changes are not appearing:

1. Clear browser cache
2. Clear server cache (if using a cache plugin)
3. Try incognito window

Button Text Is Not Changing

Field Is Empty

Check that you have filled in the Order button text field in the module settings.

Conflict with Other Plugins

Other plugins may change the button text with higher priority:

// WPify Woo uses default priority 10
add_filter( 'woocommerce_order_button_text', ... );

HTML in Button Is Not Working

Option Is Not Enabled

To use HTML entities in the button text you must:

1. Enable the Change order button HTML option
2. Save changes

Caution

This option changes the entire button HTML. Incorrect usage may break checkout functionality.

Notice Is Displaying in Wrong Location

Custom Hook

If using Custom position, make sure that:

1. The hook exists in your theme
2. The hook is called on the correct page
3. The priority is not conflicting with other actions

Block vs Classic Checkout

Some positions only work with classic checkout. Block checkout has a different structure.

Notice Style Is Not Working

Missing CSS

WooCommerce styles require:

1. Active WooCommerce CSS
2. A theme supporting WooCommerce

Custom Class

If using a custom CSS class, make sure that:

1. The class is defined in your CSS
2. The CSS file is loaded

/* Example custom class */
.my-custom-notice {
    background: #f7f7f7;
    padding: 15px;
    border-left: 4px solid #0073aa;
}

Diagnostics

Checking Hooks

// Checking if hook exists
add_action( 'woocommerce_before_checkout_form', function() {
    echo '<!-- Hook is working -->';
} );

Checking Module Settings

$module = wpify_woo_container()->get(
    \WpifyWoo\Modules\Template\TemplateModule::class
);

var_dump( $module->get_setting( 'place_order_button_text' ) );
var_dump( $module->get_setting( 'checkout_texts' ) );

Testing Positions

To test all positions you can temporarily add:

$positions = [
    'woocommerce_before_checkout_form',
    'woocommerce_review_order_before_submit',
    // ... other positions
];

foreach ( $positions as $position ) {
    add_action( $position, function() use ( $position ) {
        echo '<div style="background:yellow">Position: ' . $position . '</div>';
    } );
}

Compatibility

Block Checkout

WooCommerce block checkout (Gutenberg) has limited support for some hooks. We recommend using classic checkout for full compatibility.

Page Builders

Some page builders (Elementor, Divi) may have their own checkout templates that do not support WooCommerce hooks.