Stella Smart FAQ Plugin Documentation
Stella Smart FAQ is an AI‑powered FAQ system for WordPress that generates, manages, and displays FAQs with automatic FAQPage JSON‑LD schema. This guide covers both the Free plugin and the Pro extension with step‑by‑step setup, detailed feature behavior, and field explanations.
1) Installation
Free Version
You can install the Free plugin using either method below.
Method 1: Install from WordPress Plugin Directory
- In WordPress Admin, go to
Plugins > Add New. - Search for Stella Smart FAQ.
- Click Install Now, then Activate.
Method 2: Upload ZIP File Manually
- Go to
Plugins > Add New > Upload Plugin. - Upload the
stella-smart-faq.zipfile. - Click Install Now, then Activate.
After Activation
- A Stella Smart FAQ menu will appear in your WordPress admin sidebar.
- Go to
Stella Smart FAQ > Settingsto configure your AI provider. - Go to
Stella Smart FAQ > Dashboardto scan for FAQ opportunities. - Edit any post/page to generate FAQs using the Stella FAQ meta box.
Pro Version (Extension)
- Install and activate the Free plugin first.
- Go to
Plugins > Add New > Upload Plugin. - Upload
stella-smart-faq-pro.zip. - Click Install Now, then Activate.
Important: Pro is an extension. The Free plugin must be active.
2) Quick Start
Quick Start (Free)
- Go to
Stella Smart FAQ > Settings. - Choose an AI Provider (OpenAI, Anthropic, Google Gemini, OpenRouter).
- Enter your API Key.
- Click Fetch Models to load available models.
- Select a Model, then click Test Connection.
- Edit a post or page and open the Stella FAQ meta box.
- Click Generate AI FAQs.
- Insert FAQs using shortcode or Gutenberg block.
Quick Start (Pro)
- Go to
Stella Smart FAQ > Pro Tools. - Use Bulk Generation, Topic Generator, or URL Generator.
- Enable WooCommerce FAQ placement if needed.
- Add the Elementor widget on pages (when Elementor is active).
3) Free Plugin Features (Detailed)
- AI FAQ Generator: Generates FAQs from post/page content with one click.
- Multiple AI Providers: OpenAI, Anthropic, Google Gemini, OpenRouter supported.
- FAQ Library (Custom Post Type): FAQs stored in a dedicated CPT.
- Shortcode & Gutenberg Block: Display FAQs anywhere.
- FAQ Search: Frontend search box filters FAQs live.
- Unanswered Questions Dashboard: Tracks searches that returned no results.
- FAQ Analytics: Tracks FAQ views and search terms.
- FAQPage JSON‑LD Schema: Automatically injected on FAQ pages.
- FAQ Opportunities Scan: Finds content without FAQs.
- Accent Color Customization: Match FAQ UI to branding.
- Responsive Layouts: Mobile‑friendly display.
- Lightweight Assets: CSS/JS load only when needed.
4) Pro Plugin Features (Detailed)
- Unlimited AI Generation
- Bulk FAQ Generation (all posts, category, selected)
- FAQ Generator from Topic
- URL FAQ Generator
- Advanced Layouts: Cards, Grid, Modern Accordion, Tabs
- FAQ Categories + filtering
- WooCommerce FAQ Placement
- Elementor Widget Integration
- Advanced Analytics Trends
- Import / Export: CSV + JSON
- AI SEO Score with suggestions
- Duplicate Prevention for bulk and topic/url generation
5) Field‑by‑Field Settings Guide
A) AI Provider Settings (Free)
- AI Provider: Choose OpenAI, Anthropic, Gemini, or OpenRouter.
- API Key: Your provider API key.
- Fetch Models: Loads available models.
- Model: Select which model to use.
- Test Connection: Verifies the API works.
B) Generation Settings (Free)
- Default FAQ Limit: Global default number of FAQs per post.
- Custom Prompt: Optional extra instructions.
- Max Tokens: AI output limit.
- Max Input Characters: Controls text length sent to AI.
C) Display Settings (Free)
- FAQs Per Page: Pagination or infinite scroll.
- Accent Color: Color picker for FAQ UI.
D) Pro: FAQ Generator Targets
- Enable FAQ Generator For: Posts, Pages, Products, Custom Post Types.
E) WooCommerce Settings (Pro)
- Enable WooCommerce FAQ section
- Placement: After summary / After add to cart / Tab
- Heading text: Supports
{product}placeholder
6) Using the FAQ Generator in Posts/Pages/Products
- Edit a post, page, or product.
- Open the Stella FAQ meta box.
- Set FAQ Limit (this post) to override global default.
- Optional: select a FAQ Category (Pro).
- Click Generate AI FAQs.
- Review FAQs in the FAQ library.
7) Displaying FAQs on the Frontend
Shortcodes
[stella_faq][stella_faq layout="list"][stella_faq layout="carousel"][stella_faq layout="cards"](Pro)[stella_faq layout="grid"](Pro)[stella_faq layout="modern-accordion"](Pro)[stella_faq layout="tabs"](Pro)
Gutenberg Block
Add the Stella FAQ Block and choose a layout in block settings. Pro layouts appear when Pro is active.
8) FAQ Categories (Pro)
- Go to
Stella Smart FAQ > FAQ Categories. - Create categories.
- Assign categories to FAQs.
- Filter via shortcode:
[stella_faq category="slug"]
9) Bulk Generation (Pro)
- Go to
Stella Smart FAQ > Pro Tools. - Choose scope: all posts, category, selected IDs.
- Set max posts (0 = unlimited).
- Confirm checkbox.
- Run generation.
10) Topic & URL Generators (Pro)
Topic Generator
- Go to
Pro Tools > FAQ Generator from Topic. - Enter a topic.
- Generate and add FAQs.
URL Generator
- Go to
Pro Tools > URL FAQ Generator. - Enter URL.
- Generate and add FAQs.
11) Analytics & Unanswered Questions
- Dashboard logs searches with no results.
- Generate FAQs directly from unanswered terms.
- Pro includes trend charts (engagement, search, etc.).
12) Import / Export (Pro)
Export
- Choose CSV or JSON and download FAQs.
Import
- Upload a CSV/JSON file.
- Optionally skip duplicates.
- Import summary is displayed after upload.
13) Troubleshooting
- AI connection fails: Verify API key, model, and credits. Use Test Connection.
- No FAQs generated: Check that content exists and increase Max Input Characters.
- Schema not visible: Ensure shortcode/block is on the page and test with Google Rich Results.
14) Data & Uninstall
- Free uninstall removes FAQ analytics table and settings.
- Pro uninstall removes Pro analytics table.
- FAQs can be deleted manually if needed.
15) Recommended Workflow
- Set provider, key, and model.
- Generate FAQs on key pages.
- Review and edit FAQ answers.
- Monitor unanswered questions.
- Use Pro tools for bulk automation and advanced layouts.