HND FAQ – Frequently Asked Questions

توسط Hundikuu

A complete FAQ plugin for WordPress. Display your frequently asked questions as an accessible accordion with automatic Schema.org FAQPage JSON-LD markup for rich results in search engines.

Features:

Unlimited FAQ items and categories
Accessible accordion — keyboard navigation, ARIA attributes
Schema.org FAQPage JSON-LD — automatic rich result markup
Gutenberg block with sidebar controls
Elementor widget
Shortcode [hnd_faq] with all options
Table of Contents — inline above the accordion or sticky sidebar
Drag & drop question reorder in admin
Per-question colour overrides
“Was this helpful?” thumbs up/down voting
Open-count analytics (per-question view tracking)
Category ordering by custom number
Print CSS and RTL support
WPML and Polylang compatible
Import / Export via CSV

Pro version available

HND FAQ Pro adds:

Live search across all questions and answers
Suggest a question — front-end submission form
Card / Grid layout (questions and answers visible simultaneously)
WooCommerce product tab integration
Table of Contents customisation — scrollspy, colours, numbered list
Custom CSS editor
Conditional display by role, page, or post type
Advanced analytics dashboard widget
Priority email support

Shortcode examples:

[hnd_faq]
[hnd_faq category="general"]
[hnd_faq category="general,technical" orderby="title" order="ASC"]
[hnd_faq show_titles="false" limit="5"]

Shortcode attributes:

category — category slug(s), comma-separated (default: all)
orderby — menu_order | title | date (default: menu_order)
order — ASC | DESC (default: ASC)
limit — number of items, -1 for all (default: -1)
show_titles — show category headings: true | false (default: true)
toc — table of contents position: none | above | sidebar (default: global setting)
class — extra CSS class on the wrapper

Customisation:

The plugin uses CSS custom properties that can be overridden in your theme:

--hnd-faq-accent, `--hnd-faq-accent-bg`, `--hnd-faq-head-bg`, `--hnd-faq-border-color`, `--hnd-faq-border-radius`, and more. All visual settings are also available from **FAQ → Settings** with a live preview.

Upload the hnd-faq folder to /wp-content/plugins/.
Activate the plugin through the Plugins screen in WordPress.
Go to FAQ Add New Question to create your first question.
Assign questions to categories under FAQ Categories.
Add the [hnd_faq] shortcode to any page, or insert the FAQ Accordion block in the block editor or Elementor editor.

سوالات متداول

How do I display FAQ questions on a page?

Use the shortcode [hnd_faq] or insert the FAQ Accordion Gutenberg block. An Elementor widget is also available.

Can I show only certain categories?

Yes — use the category shortcode attribute with a category slug: [hnd_faq category="general"]. Multiple slugs are comma-separated.

Does it output Schema.org markup?

Yes. FAQPage JSON-LD is automatically added to every page where the accordion is rendered. This enables rich results (accordion snippets) in Google Search.

Is the accordion accessible?

Yes — the accordion uses proper ARIA attributes (aria-expanded, aria-controls, hidden) and is fully keyboard-navigable.

How do I change the colours?

Go to FAQ Settings Colors. A live preview updates as you make changes. You can also override the CSS custom properties directly in your theme.

Does it work with WPML or Polylang?

Yes. The plugin registers the FAQ post type and taxonomy with both WPML (via wpml-config.xml) and Polylang (via filters), so all questions and categories are translatable.

Can I import questions from a CSV file?

Yes. Go to FAQ Import / Export to download a sample CSV, fill it in, and upload it. Existing questions can be skipped or updated on import.