Articles on: Troubleshooting

Using the debug mode to inspect any missing hooks in WooCommerce product pages

If your theme is missing required WooCommerce hooks or filters, the Chamevo Product Designer may not display correctly. This issue often happens with heavily customized themes or when using page builders like Elementor.

1. Debug Mode

The plugin includes a built-in debugger that helps you identify missing hooks or theme conflicts.

Go to Chamevo → Settings
Select Advanced settings
Open Troubleshooting Menu
Enable Debug Mode.
Save Changes and Visit a product page where the Product Designer is enabled.

A modal window will display details about any missing hooks or filters.

This modal only appears for administrators.
It will show up on product pages with the designer enabled and on the cart page.

2. Solving Missing Hooks

a) Missing Hook: `woocommerce_before_single_product_summary`

Context: This hook replaces the product image with the Chamevo Product Designer.

If your theme’s content-single-product.php file does not include this hook, add:

<?php
  /**
   * woocommerce_before_single_product_summary hook
   *
   * @hooked woocommerce_show_product_sale_flash - 10
   * @hooked woocommerce_show_product_images - 20
   */
  do_action( 'woocommerce_before_single_product_summary' );
?>

b) Missing Hook: `woocommerce_single_product_summary`

Context: This hook adds the product designer or UI elements after the title/short description.

Ensure your theme includes:

<div class="summary entry-summary">
  <?php
    /**
     * woocommerce_single_product_summary hook
     *
     * @hooked woocommerce_template_single_title - 5
     * @hooked woocommerce_template_single_rating - 10
     * @hooked woocommerce_template_single_price - 10
     * @hooked woocommerce_template_single_excerpt - 20
     * @hooked woocommerce_template_single_add_to_cart - 30
     * @hooked woocommerce_template_single_meta - 40
     * @hooked woocommerce_template_single_sharing - 50
     */
    do_action( 'woocommerce_single_product_summary' );
  ?>
</div><!-- .summary -->

c) Missing Hook: `woocommerce_before_add_to_cart_button` (Required)

Context: This hook is used for extra form fields and positioning the Customize button.

If missing, add this line in the relevant add-to-cart template file:"

<?php do_action( 'woocommerce_before_add_to_cart_button' ); ?>

3. Alternative Solution"

If editing templates is not an option (e.g., when using Elementor or other page builders), you can manually embed the Product Designer with the shortcode:

[chamevo]

This ensures the designer loads even without the missing WooCommerce hooks.

Always create a child theme before editing WooCommerce template files, so your changes are not lost during theme updates.

Updated on: 01/12/2025

Was this article helpful?

Thank you!