2. ⚙️ Configuration Guide

This document provides a detailed reference for every configuration option available in the JaJuMa Category Grid Callouts extension.

2.1 🔧 General Configuration

Navigate to
JaJuMa -> Category Grid Callouts -> Configuration
in your Magento Admin Panel to access the global settings for the extension.

2.1.1 Enable Extension

This is the master switch for the extension's functionality.

• Yes:
  The extension is active and will display configured callouts on the frontend.
• No:
  The extension is globally disabled. No callouts will be displayed, regardless of their individual status.

2.1.2 Grid System: Ensuring Theme Compatibility

This is a critical setting that ensures the extension's output matches your theme's HTML structure for the category grid. Selecting the correct option prevents layout issues and ensures callouts integrate seamlessly.

2.2 📝 Managing Callouts

Navigate to
JaJuMa -> Category Grid Callouts -> Category Grid Callouts
to create, edit, and manage your individual callouts.

2.2.1 Status

This toggle enables or disables a single, specific callout.

• Enabled:
  The callout is active and will be displayed if its conditions are met.
• Disabled:
  The callout is inactive.

💡 Pro Tip:
Disabled callouts can still be used within a "Random Banner" or "Random Grid Item" container, which is useful for A/B testing or rotating seasonal content without deleting it.

2.2.2 Show on all pages

This setting controls how the callout behaves with paginated category results.

• No:
  The callout will appear only on the specific pagination page defined in the Page field. This may result in an uneven grid on the last row if the number of items is not a multiple of your column count.
• Yes:
  The callout will be repeated in the same position on every pagination page for the selected category. This feature significantly improves layout integrity by automatically adjusting the number of products displayed to ensure the grid remains perfectly even, with no blank spaces.

⚠️ Warning:
For the "Show on all pages" feature to function correctly, the Position value must be less than the number of products per page in your category grid.

2.2.3 Name

An internal name used to identify the callout in the admin grid. This is not visible to customers.

2.2.4 Type: Banner vs. Grid Item

This determines how the callout is rendered in the grid.

• Banner:
  A full-width block of content injected between the rows of your product grid. Ideal for high-impact promotions.
• Grid Item:
  A content block that takes the place of a single product within the grid. It has the same width as a product item, creating a seamless, integrated look. Ideal for linking to buying guides, related categories, or featured content.
• Random Banner / Random Grid Item:
  These are powerful container types used for A/B testing and content rotation. They do not have their own content. Instead, you assign other (typically disabled) callouts to them. On each page load, the container will randomly select and display one of the assigned callouts, helping you test offers or prevent "banner blindness."

2.2.5 Position

The numerical position where the content will be injected.

• For Banner types:
  This is the row number after which the banner will appear. 1 means after the first row.
• For Grid Item types:
  This is the item slot number in the grid. 3 means it will appear in the third position, pushing all subsequent products back.

2.2.6 Page

The specific pagination page number on which the callout should appear. This field is only active when Show on all pages is set to No.

2.2.7 Categories

Controls which categories the callout will appear in.

• Show on all Categories:
  Set to Yes to display the callout in every category.
• Categories Dropdown:
  If Show on all Categories is No, you can select one or more specific categories from this list.
• URL Paths:
  As an alternative to the category tree, you can specify URL paths as a comma-separated list. This is useful for targeting pages that aren't standard categories. Regular expressions are supported.
  • Example: men/tops-men.html,gear.html

2.2.8 Store View

Select the store view(s) where this callout should be active. This allows you to tailor promotions for different markets and languages.

2.2.9 Callout Content

This tab contains the Magento Page Builder / WYSIWYG editor. Use this to create the visual content for your callout, including images, text, links, videos, or any other custom HTML.

2.3 📞 Need Help?

Still have questions or need help with your configuration? Our expert team is here to assist. Please don't hesitate to contact our support team for personalized assistance.