About the plugin

Aha FAQ for WooCommerce is a WooCommerce add-on that shows FAQs on each product from a central Aha Woo FAQ library. Questions live in a custom post type (aha_woo_faq); each post’s title is the question and the editor content is the answer. Use the FAQ Categories taxonomy (hierarchical) to organize them—one question can belong to several categories. On the product edit screen, the Product FAQ metabox lets you choose a library source: either all questions in one category (dropdown) or specific library posts (search with autocomplete, reorderable list). There is no separate “FAQ typed only on this product” list; content is always sourced from the library. Display with [aha_woocommerce_faq] or automatically on the single product page. Four layout styles, full appearance controls, and optional FAQPage JSON-LD.

Features: Aha Woo FAQ library (CPT + FAQ Categories); product metabox (by category or specific questions + reorder); shortcode with optional product_id; automatic display; layouts Accordion, Cards, Bordered, Minimal; appearance and typography; optional FAQPage schema. Pro-only; license activation required.

Installation

Via WordPress admin

1. Upload the plugin ZIP via Plugins → Add new → Upload plugin, or install from your preferred source.
2. Click Install now, then Activate.
3. Ensure WooCommerce is installed and active.

Via FTP

1. Unzip the plugin ZIP file on your computer.
2. Connect to your server via FTP and go to wp-content/plugins.
3. Upload the plugin folder aha-faq-for-woocommerce into wp-content/plugins.
4. In the WordPress admin, go to Plugins and activate Aha FAQ for WooCommerce.

Configuration (tabs)

After activating the plugin, go to WooCommerce → Aha FAQ for WooCommerce. Settings are organized in tabs: General, Aha Woo FAQ, Shortcode, Appearance, License, and Uninstall. The FAQ metabox, shortcode output, and automatic display work only after a valid license is activated on the License tab.

General

• Enable automatic FAQ – When enabled, the FAQ block is output automatically on the single product page (according to the hook position).
• Hook position – Where to display the FAQ: After product summary, After add to cart, or Inside product tabs.
• FAQ title – Heading shown above the FAQ list (e.g. “Frequently Asked Questions”).
• FAQ schema (JSON-LD) – When enabled, outputs FAQPage structured data for search engines.
• Accordion initial state – Controls how FAQ items appear on page load: All closed (default), First item open, or All open.
• FAQ layout – Choose the visual style for the FAQ list:
  • Accordion – Single continuous list with outer border and +/− icons.
  • Cards – Each question in a separate rounded, spaced box with shadow.
  • Bordered – Left accent border with chevron icon per item; no outer container.
  • Minimal – Full-color question rows separated by lines; no container border, no icon.

Aha Woo FAQ

This tab summarizes the library and links to manage questions and FAQ Categories. Questions are stored in the Aha Woo FAQs menu (top-level in the admin): each post is one question (title) and answer (content). Assign one or more FAQ Categories to each question (sidebar / metabox); the same question can appear in several categories. On each product, use the Product FAQ metabox to choose by category (one category — all published questions in that term) or specific questions (search the library and build an ordered list).

Shortcode

This tab is documentation only (no save button): a highlighted box with the shortcode to copy, all optional attributes as tags, an example, a priority note (shortcode attributes → saved General/Appearance settings → defaults), plus tables of basic examples, every attribute, advanced examples, and tips for page builders. Use [aha_woocommerce_faq] on the current product page or [aha_woocommerce_faq product_id="123"] elsewhere. The same reference is summarized again in the Shortcode section of this doc.

Appearance

Customize the visual style of the FAQ block on the frontend.

Colors: Choose a Quick palette (Default, Dark, Light, Purple, Blue, Green, Yellow, Orange, Red, Pink, Violet) to fill all color fields at once, or set each color individually: question button background, question text & icon color, hover background, answer area background, answer text color, FAQ section title color, and borders.

Typography:

• Question font size – Preset sizes: Small (0.875rem), Normal (1rem), Medium (1.1rem), Large (1.25rem), Extra Large (1.4rem), 2X Large (1.6rem). Leave as Default to inherit the theme size.
• Question font weight – Normal (400), Medium (500), Semi Bold (600), Bold (700), Extra Bold (800), or Default to inherit from the theme.
• Answer font size – Enter any valid CSS value (e.g. 1rem, 16px, 0.95em). Leave blank to use the theme default.
• Answer font weight – Same presets as question weight above.

License

Paste the license key you received after purchase and click Validate license. When the status shows active, the plugin is fully unlocked (metabox, shortcode, automatic display, and settings). Without a valid license, only the settings page and license tab are available.

Uninstall

Optional preference: if you enable Remove all plugin data when the plugin is deleted and later delete the plugin from Plugins → Installed Plugins (Delete, not only Deactivate), stored plugin settings, license data saved for the site, and this preference itself can be removed. The screen only saves your choice; WordPress runs cleanup when you confirm deletion. Your products, Aha Woo FAQ library posts, and WooCommerce data are not removed by this option.

Aha Woo FAQ library

The library holds reusable questions you categorize once and attach to products by category or by picking individual posts.

• Aha Woo FAQs (admin menu) – List of questions. Each post: title = question, content = answer (rich text). Use FAQ Categories in the sidebar to assign one or more categories to each question.
• FAQ Categories – Create and manage categories (e.g. General, Shipping, Returns). The taxonomy is hierarchical; a question can belong to several categories.
• On each product, open the Product FAQ metabox. Choose library source: By category (dropdown — all published questions in that category appear for this product) or Specific questions (type to search, add items, drag to reorder).

Product FAQ metabox

On the product edit screen, the Product FAQ metabox connects this product to the library. You do not type long answers here—those live on Aha Woo FAQ posts.

• Library source – Select By category or Specific questions.
• By category – Choose one FAQ category from the dropdown. All published questions in that category are shown for this product (order follows menu order / title as configured in the library).
• Specific questions – Search by typing at least two characters; click a result to add it as a tag. Reorder tags by dragging. Only the selected posts appear, in your chosen order.
• Quick links – Open Add new Aha Woo FAQ or All Aha Woo FAQs in a new tab when you need to create or edit library content.

Rich-text rules for answers are defined in the library post editor (same as standard WordPress post content).

Shortcode

Use the shortcode to display product FAQs anywhere: pages, posts, or page builders (Elementor, Gutenberg, WPBakery, etc.). All appearance settings can be overridden per shortcode — useful for landing pages with a completely different style.

Priority (what wins)

1. Shortcode attributes on that block (page, template, or widget).
2. Plugin settings saved under General and Appearance.
3. Built-in defaults if nothing is set.

Basic examples

Replace 123 with the actual product ID. Find it in the product edit URL (post=123) or in the product list.

All available attributes

Any attribute below overrides the global plugin setting for that specific shortcode instance. Leave it out to use the plugin setting instead.

Examples with attributes

In page builders

• Elementor – Add a Shortcode widget and paste the shortcode with any attributes.
• Gutenberg – Add the Shortcode block and paste the shortcode.
• Classic editor – Paste the shortcode directly in the content.

The shortcode only outputs content when the plugin license is active.

Activating the license (Pro)

Aha FAQ for WooCommerce is a Pro-only plugin. To use the metabox, shortcode, and automatic FAQ display:

1. Install and activate the plugin (WooCommerce must be active).
2. Go to WooCommerce → Aha FAQ for WooCommerce and open the License tab.
3. Paste the license key you received after purchase and click Validate license.
4. When the status shows Active, the full plugin is unlocked. You can then add FAQs in the product metabox, use the shortcode, and enable automatic display in the General tab.

Uninstall preference

The Uninstall tab stores a single checkbox for whether plugin options (and license data stored by this plugin) should be erased when you delete the plugin from WordPress. Nothing is removed until you use Delete on the Plugins screen. Library FAQ posts (Aha Woo FAQs) and WooCommerce products are not deleted by this plugin.

Video – Setup and demo

Video walkthrough for license activation, configuration, and plugin demonstration.