FAQ Pro – AI and SEO-optimised FAQs for dynamic products and experiential worlds

Installation

• Open the Plugin Manager via Settings > System > Plugins
• Upload, install and activate the plugin

Create FAQ group

Settings > Extensions > FAQ > FAQ groups

Settings

• Display name
  Name of the FAQ group that can be displayed in the storefront.
• Description
  Description of the FAQ group for additional information about the included content.
• Priority
  The higher the number, the higher the priority. This is used for sorting when several FAQ groups are displayed at the same time.
• Active
  If active, the group is displayed.
• Sales channels
  Restricts the display of the FAQ group to selected sales channels.
• Rule
  Controls the display of the FAQ group via Rule Builder conditions.

Visibility

• Visibility of the group name
  Defines whether the name of the FAQ group is displayed in the storefront.
• Visibility of the group description
  Defines whether the description of the FAQ group is displayed in the storefront.
• Display (collapsible)
  Defines the display type of the FAQ group.

Structured data (JSON-LD)

• Disable JSON-LD output
  If enabled, no structured data (JSON-LD) is output in the storefront for this FAQ group and all FAQs contained in it.

Product assignment

• Assigned products
  Assigns the FAQ group to individual products.
• Dynamic product groups
  Assigns the FAQ group to dynamic product groups.

Category assignment

• Categories
  Assigns the FAQ group to categories.
• FAQ display
  Defines whether the display always appears below the product list or via the Shopping Experiences element.

Shopping Experiences

• Allows Shopping Experiences to be displayed before or after the assigned FAQs.

Create FAQs

Settings > Extensions > FAQ > FAQ 
Settings

• Internal name
  Used for overview purposes in the admin area.
• Question
  Question displayed in the storefront.
• Answer
  Answer to the stored question. HTML can be included.
• Priority
  The higher the number, the higher the priority. Used for sorting multiple questions within an FAQ group.
• Active
  Activates or deactivates the FAQ.
• Sales channels
  Restricts the display of the FAQ to selected sales channels.
• Rules
  Controls the display of the FAQ via Rule Builder conditions.
• FAQ display
  Defines the default state of the FAQ, for example collapsed or expanded.
• FAQ groups
  Assigns the FAQ to one or more FAQ groups.

• Restrict assigned products
  If products are specified here, the FAQ is only displayed for these products. However, the products or dynamic product groups assigned to the FAQ group must include the selected products.

Keywords

Keywords enable the automatic assignment of FAQs to products based on the content of the product description.

• Matching type
  Defines how the keyword is compared with the content of the product description.
• Keyword
  Term or search pattern used for the assignment.

Image

• Image position
  If an image is assigned, the image is displayed in the FAQ answer at the selected position.
• Image size
  Predefined image sizes (large, medium, small)
• URL / link (when clicking the image)
  If a link is entered (absolute link with https://www.xxx.xx), the image is linked.
• Open URL / link as
  Selection whether the link should open in a new tab or in the same window.
• Image selection
  The image is selected here. Only one image can be added.

Video

• Video position
  If a video is assigned, the position can be selected here. The size is predefined, and it is expected that a text description has also been added. Two columns are provided.
• Video type
  YouTube, Vimeo or other video types. If special video players need to be integrated, please submit a support request.
• Embed URL
  Insert only the video link. For YouTube, use the normal watch link, the embed link or simply the YouTube ID: "https://www.youtube.com/watch?v=DYDY4NW1L_TEST" or "https://www.youtube.com/embed/DYDY4NW1L_TEST" or the YouTube ID: "DYDY4NW1L_TEST". For Vimeo, use the Vimeo embed link or the Vimeo ID: "https://player.vimeo.com/video/123456789" or Vimeo ID: "123456789". For other video types, use the embed link.
• Enhanced privacy mode (embed videos without cookies):
  Only for YouTube: If enhanced privacy mode is active, YouTube does not store information about visitors on your website.
• Show control bar
  Only for YouTube: Displays the controls of the YouTube player in the video.

Documents

• Upload document
  Upload the desired documents using the media selector.
  Since Shopware limits the file types during upload, a free plugin for extending the file types can be requested from us via a support request.
• Edit document
  By clicking on an uploaded document, it can be edited:
• Title
  If specified, this name appears in the frontend instead of the document file name.
• Description
  If specified, this appears next to the name in the frontend.
• Position
  The position is changed by moving the item in the admin area and cannot be changed here.
• Document available in the following languages
  This allows documents to be displayed differently in different languages.

SEO

• SEO URL
  If TEXT is entered here, this question is accessible in the frontend with this URL. SEO URL generation is required. For the SEO URL, only a string/word can be entered, and "/" can be used in the URL (not at the beginning of the URL). The entered SEO URL is generated and used together with the Shopware path.
  Example: "custom/faq". The SEO path template can be changed under Settings > Shop > SEO.
• Meta title
  A meta title for search engines can be stored for the FAQ.
• Meta description
  A meta description for search engines can be stored for the FAQ.
• Meta data
  Additional meta data for the FAQ.

FAQ usage in Shopping Experiences

Content > Shopping Experiences > Create layout
A new block category "ACRIS FAQ" with a new Shopping Experiences element "FAQ groups" is available under Blocks.

Element settings

• Load FAQ groups from
  FAQ groups can be selected manually or loaded automatically based on the current category or the currently displayed product.

Plugin configurations

Extensions > My Extensions > ACRIS FAQ > Configure
General

• Positioning of the FAQ tab on product pages
  Defines where the FAQ tab is displayed on the product detail page.
• Show FAQ in the product description
  Controls the output of FAQs within the product description.
• FAQ detail pages are accessible and can be indexed by search engines
  Defines whether FAQ detail pages are accessible and indexable by search engines.
• TWIG code handling in FAQ answers
  Controls the processing of TWIG template code in FAQ answers.

Search

• Enable search for FAQs
  Activates the integration of FAQs into the shop search.
• FAQ search preview max. number of search results
  Defines the number of FAQ hits displayed in the search preview.
• Hide the text "No search results" in the search preview if no results were found.

Formatting / appearance
Provides configuration options for colors, symbols, spacing and HTML markup.
Video settings
Contains settings for embedding videos, privacy options and preview images.

faq-ai.txt
This setting allows you to enable or disable the output of the faq-ai.txt file for the relevant sales channel.

Import / export of FAQs 

Under Settings > Import / Export, FAQs can be imported or exported using an import/export profile.
During import, FAQs are not created twice. Existing FAQs are searched using the following import fields to avoid duplicate FAQs:
1. UUID (id)
2. Internal name (internalName) (fallback 1)
3. FAQ question (name) (fallback 2)

Known limitations / notes:
FAQs can be assigned once as a TAB and once in the DESCRIPTION via the plugin settings. As a result, Google may detect the rich snippets twice and identify the FAQPages field twice. To prevent this, display FAQs in the plugin configuration either as an FAQ TAB or in the DESCRIPTION TAB.