[PRO] Using the Hooks System in Botiga

Want to inject custom HTML or shortcodes into specific spots across your site without editing template files? The Hooks system in Botiga Pro lets you drop content into pre-defined positions in the header, content, WooCommerce, sidebar, and footer.

In this guide, we’ll walk you through how to use the Hooks system in Botiga Pro.

Before you get started, make sure you’ve installed and activated the Botiga theme on your WordPress site. If you’re using features from Botiga Pro, ensure that both the Botiga theme and the Botiga Pro plugin are installed and active. This feature requires Botiga Pro.

Accessing the Hooks Panel

From your WordPress admin, go to Appearance >> Customize >> Hooks. The panel is split into six sections: General, Header, Content, WooCommerce, Sidebar, and Footer. To prevent broken markup, the theme automatically balances any unclosed tags in your hook content.

Hooks panel sections in the Botiga Customizer

Text Markup Variables

Botiga Pro provides text markup variables you can use inside your hook content. They get replaced with the correct URL at render time.

  • {{front_page_url}} outputs the front page URL
  • {{blog_page_url}} outputs the blog page URL

The variables below require the WooCommerce plugin installed and activated:

  • {{shop_page_url}} outputs the shop page URL
  • {{cart_page_url}} outputs the cart page URL
  • {{checkout_page_url}} outputs the checkout page URL
  • {{shop_myaccount_url}} outputs the My Account page URL

Usage Example

Example of HTML and a text markup variable used in a Botiga hook

Hooks With the Templates Builder

Since Botiga Pro 1.1.4, hooks also work with the Templates Builder module. To learn more, check out our guide on building content block templates in Botiga Pro.

Frequently Asked Questions

Below, we’ve answered some of the most common questions about the Hooks system in Botiga Pro.

Can I use shortcodes inside hooks?

Yes. Any WordPress shortcode you’d use in a post or page works inside a hook. The shortcode is executed when the hook is rendered.

What happens if I leave an HTML tag unclosed?

Botiga automatically balances any unclosed tags before rendering the hook, so you won’t break your layout. Even so, valid HTML is the safest input.

Will the WooCommerce variables break my site if WooCommerce is deactivated?

No. The WooCommerce-related variables simply won’t be replaced if WooCommerce isn’t active, but they won’t cause errors.

That’s it! You’ve successfully used the Hooks system to inject custom content into your Botiga Pro site.

Next, would you like to take customization further with full template control? Check out our guide on the Templates Builder in Botiga Pro to learn more.