Shortcodes — Plugixa FAQ

The [plugixa_faq] shortcode puts a configurable FAQ block anywhere in your site — posts, pages, widgets, template files, and the Gutenberg Shortcode block.

Quick start

[plugixa_faq]

Displays all published FAQs using the default view.

All attributes

Defaults are the plugin-wide defaults — they can be changed globally in Settings, or per-instance via the attributes below.

Content filtering

Attribute	Default	Values	Description
id	0	int	Load a saved shortcode configuration by ID.
category	""	slug(s)	Comma-separated category slugs to include.
ids	""	IDs	Comma-separated FAQ IDs.
limit	-1	int	Max FAQs (-1 = unlimited).
content_source	plugixa_faqs	see Content Sources	Data source.
content_display	excerpt	excerpt, full	For non-native sources.
orderby	menu_order	menu_order, id, title, date, helpful_count	Sort field.
order	ASC	ASC, DESC	Sort direction.
language	auto	language code	Force a language (overrides WPML/Polylang detection).

Display

Attribute	Default	Values	Description
view	""	slug or ID	Visual preset — see Views.
style	accordion	see below	Layout style (shortcut for the view’s layout.style).
search	false	bool	Show search box above FAQs.
search_placeholder	""	string	Custom placeholder text.
group_by_category	false	bool	Render category headers above grouped FAQs.
show_category_description	true	bool	Show description under category headers.
schema	true	bool	Output Schema.org FAQPage JSON-LD.
dark_mode	from_view	from_view, enabled, disabled, auto	Override the view’s dark mode setting. auto follows prefers-color-scheme.

Behavior

Attribute	Default	Values	Description
open_first	false	bool	Auto-expand the first FAQ.
allow_multiple	true	bool	Allow multiple FAQs to be open at once.
enable_permalinks	true	bool	Add anchor links to each FAQ.
permalink_text	Permalink	string	Permalink label.
permalink_position	answer-top-right	answer-top-right, answer-bottom-right	Where the permalink button appears.
enable_toggle_all	false	bool	Show “Expand all / Collapse all” button.
enable_social_share PRO	false	bool	Show social share icons.

Pagination

Attribute	Default	Values	Description
pagination	none	none, numbers, load_more PRO, infinite_scroll PRO	Pagination type.
per_page	10	int	Items per page.
pagination_style	numbers	same as above	Visual style (from view).
load_more_label	Load More	string	Button label.

Feedback

Attribute	Default	Values	Description
feedback_enabled	false	bool	Show “Was this helpful?” widget per FAQ.

WordPress Posts / Pages source

Attribute	Default	Description
show_read_more	false	Show “Read More” link under the answer.
read_more_text	Read More	Link label.
show_author	true	Show post author.
show_date	true	Show post date.
show_category	true	Show post category.

WooCommerce source PRO

Attribute	Default	Values	Description
product_style	default	default, modern, minimal	Product card style when content_source="woocommerce_products".

Examples

Filter by category

[plugixa_faq category="shipping"]
[plugixa_faq category="shipping,returns,payments"]

Specific FAQs only

[plugixa_faq ids="1,5,8,12"]

Search and group

[plugixa_faq search="true" group_by_category="true"]

Pagination

[plugixa_faq pagination="numbers" per_page="10"]
[plugixa_faq pagination="load_more" per_page="5" load_more_label="Show more questions"]

Deep linking

[plugixa_faq enable_permalinks="true"]

Users land on /your-page/#faq-12 and the target FAQ auto-opens and scrolls into view.

Full example

[plugixa_faq
  category="products"
  view="horizontal-modern"
  search="true"
  group_by_category="true"
  open_first="true"
  allow_multiple="false"
  pagination="load_more"
  per_page="8"
  feedback_enabled="true"
  dark_mode="auto"
]

The visual Shortcode Builder

Instead of memorizing attributes, use the builder at Plugixa FAQ → Shortcodes → Add New.

Configure settings via tabbed UI:

Content tab

• Select categories, specific FAQs, limit.
• Pick a content source and display mode.
• Preview the FAQs that will be rendered.

Display tab

• Pick a view.
• Toggle search, grouping, schema.
• Override dark mode.

Behavior tab

• open_first, allow_multiple, permalinks, toggle-all button.
• Feedback widget (on/off).

Save and reuse

Click Save Configuration to store the shortcode under a name. Access saved configurations from the list ([plugixa_faq id="7"]).

The Gutenberg block

See Blocks — the block exposes the same options through a visual sidebar, no shortcode typing required.

Settings cascade

When a setting appears in multiple places, this is the priority order (highest wins):

1. Shortcode attribute — e.g., [plugixa_faq open_first="true"].
2. View config — the view selected via the view attribute.
3. Global settings — Plugixa FAQ → Settings.

Use in PHP / template files

<?php echo do_shortcode( '[plugixa_faq category="general" limit="5"]' ); ?>

Use in widgets

• Appearance → Widgets → add a Shortcode widget.
• Paste [plugixa_faq].

Troubleshooting

The shortcode is printed as text

• Confirm the plugin is active.
• Check that your theme isn’t escaping shortcodes (rare but possible in custom post types).

“No FAQs found”

• Check the category slug — typos are the #1 cause.
• Confirm FAQs are published, not draft.
• If multilingual, check the current language matches the FAQ’s language.

Design looks different from the view preview

• The shortcode attribute overrides the view. Check whether you’ve accidentally set open_first or dark_mode inline.
• CSS conflicts from the theme — use browser DevTools to find the overriding rule. Add overrides in Settings → Custom CSS.

Related

• Views — styling
• Blocks — Gutenberg block
• Content Sources — non-native sources
• Settings — global defaults