FAQ Concertina Plugin
Display FAQs in an expandable concertina or accordion section. FAQs can be ordered and categorised, and their appearance can be customised.
FAQ Concertina is a plugin for WordPress that enables you to easily display a list of FAQs (Frequently Asked Questions) on your page or blog post in an attractive and presentable fashion.
This is achieved by using the following simple shortcode in your WordPress page or blog post:
[faq-concertina] When the list of FAQs appears on your page the answers are initially hidden with only the questions visible. This makes efficient use of the space available on the page and avoids large tracts of text which can be difficult for the reader to take in, especially on small screen devices such as smartphones.
The answer can be made to appear as an expandable section, concertina-style, by clicking on the question. The answer can be hidden again by clicking anywhere on either the question or answer.
With FAQ Concertina you can:
- have any number of FAQs,
- define the order in which the FAQs appear on the page,
- determine whether or not more than one answer can be visible at any one time,
- categorise FAQs so that FAQs from different categories can appear in separate lists, either on the same page or on separate pages,
- customise the appearance of the FAQ listing to fit in with the style of your theme.
Although primarily intended for FAQs FAQ Concertina is, of course, not limited to just FAQs and can be used for any content with a heading where the content is initially hidden and can be expanded by clicking on the heading. Feel free to use your imagination to come up with all kinds of creative uses for FAQ Concertina!
WHAT’S NEW?
- As of version 1.4.8 FAQs can now display a featured image (also known as post thumbnail)
- As of version 1.4.6 FAQs support post revisions.
- As of version 1.4.0 FAQ Concertina is WAI-ARIA compliant. This means that FAQ Concertina is fully accessible and compatible with screen readers and other assistive technologies. Thanks to Tim Kaye @kts915 for contributing JavaScript code to make this possible.
The FAQ Concertina download includes a fully illustrated 20 page manual in .pdf format to help you get the most from the plugin. The manual can also be downloaded from the website:
Installation
To install FAQ Concertina simply upload the faq-concertina directory to the wp-content/plugins directory of your WordPress website.
Log-in to the dashboard of your WordPress website and select ‘Plugins’ from the lefthand sidebar. FAQ Concertina should appear in your list of plugins. Click on ‘Activate’ to, err…, activate it!
For a simple FAQ list add this shortcode to your page or post:
[faq-concertina] If you are using categories use this version of the shortcode:
[faq-concertina category="category-slug"] Screenshots
A list of FAQs as they appear on your site. The colour and appearance can be customised to suite your theme.
Click on a question and the answer expands below in a concertina/accordion fashion.
More than one answer can be displayed at a time.
Answers can be closed by clicking anywhere on the panel.
FAQs are managed using a familiar listing in the WordPress dashboard. You can sort on any column for easy management of your FAQs.
FAQs are entered and edited using a familiar post entry/edit screen in the WordPress dashboard.
The appearance of the FAQs in your site can be configured on the settings page.
FAQ
FAQ Concertina is a plugin that works independently from the theme and is theme agnostic. It will work with any theme. Just put the shortcode [faq-concertina] in your page or post.
FAQ Concertina is fully responsive, and will adapt to the width of the device viewport. Furthermore, the width setting can be over-ridden so that FAQs appear at full width on narrow viewport devices such as smartphones, whatever the width has been set to for larger screens.
FAQ Concertina includes a settings page which allows you to customise colour schemes, animation speed, width, and other appearance settings.
Appearance settings can be disabled so that you can customise the included .css file for full control over the appearance of your FAQs. As of version 1.2.0 the settings page also includes colorpicker fields to enable you to choose a custom colour scheme.
FAQ Concertina is WAI-ARIA compliant and fully accessible. It will work with screen readers and other assistive technologies. Furthermore FAQs can be navigated using the keyboard as well as with the mouse/trackpad.
FAQ Concertina provides options on the settings page to order your FAQs alphabetically, chronologically (i.e. by when they were created), or numerically according to the ‘Order’ attribute.
Yes, this is the default behaviour of FAQ Concertina. However, if you want the site visitor to only be able to see one answer at a time then, as of version 1.3.0, there is a ‘Hide Others’ option that can be accessed on the Settings page.
FAQ Concertina allows you to categorise FAQs and pull FAQs into a specific list using the category parameter in the shortcode. See the full .pdf manual for complete instructions.
The settings page allows you to define a single appearance for all FAQ listings. However, if you have categorised your FAQs then FAQ Concertina adds the category slug as a class allowing you to style different category listings differently in the .css file.
There is no limit to the number of FAQs you can have. Likewise there is no limit to the number of FAQ categories that you can use.
Yes. As of version 1.1.2 FAQs are publicly queryable which means that the content in the questions and answers can be crawled by search engine spiders. It also means that FAQs can each have their own page addressable by slug.
Yes. As of version 1.4.3 you can include shortcodes as part of your answer. FAQ Concertina will ensure that the shortcode is parsed and the generated content included as part of the answer.
Although primarily intended for FAQs FAQ Concertina is, of course, not limited to just FAQs and can be used for any content with a heading where the content is initially hidden and can be expanded by clicking on the heading.
FAQ content can be entered in any language. Furthermore, FAQ Concertina is fully internationalised (i18n) and a .pot file is provided. You can produce localised (l10n).po and .mo files in your language using a translation tool such as Poedit http://poedit.net.
Yes, FAQ Concertina supports both featured images (also known as post thumbnails) and images embedded in the content of the answers.
Yes. As of version 1.4.4 FAQ Concertina provides hooks before and after each FAQ category and before and after each individual FAQ. Developers can extend FAQ Concertina by adding additional content or HTML at the relevant points in FAQ Concertina’s output.
FAQs and FAQ Categories are available in the WordPress REST-API for consumption by client-side JavaScript in “headless” WordPress installations.
A fully illustrated 20 page .pdf manual is included with each FAQ Concertina download, or you can download it directly from http://www.zyriab.co.uk/faqconc/.
If you are not happy with FAQ Concertina after trying it out you can deactivate it and delete it. FAQ Concertina plays nicely with your WordPress installation when it is deleted and cleans up after itself by removing all data and settings leaving no trace of its former existence in your WordPress database.
Changelog
1.4.8
Added user requested feature: support for featured images (post thumbnails).
Compatible with WordPress 5.9.
1.4.7
Metaboxes compatible with both classic editor and block editor
1.4.6
Adds support for revisions
1.4.5
JavaScript bug fix
1.4.4
Added the following developer features.
FAQ Custom Post Type and Custom Taxonomy now show in REST-API. Usage:
* http://example.com/wp-json/wp/v2/faqconc/
* http://example.com/wp-json/wp/v2/faqconc_cat/
Added Action Hooks:
* faq_conc_before_faqs
* faqconc_after_faqs
Added Filter Hooks:
* faqconc_before_faq
* faqconc_after_faq
1.4.3
Added the category to the ID. If more than one category of FAQs is included in a single page or post HTML validators will no longer produce a Duplicate ID error.
Removed the .. tags around the question. If the question is required in bold text style .faq_q in css/faq-concertina-styles.css.
Added support for shortcodes in the answers. The shortcode will be parsed and the generated content included as part of the answer.
1.4.2
Ensured that all text strings are translation ready, and updated .pot file.
1.4.1
Fixed bug that prevented access to more than one FAQ category on a page when navigating with the keyboard or assistive technologies – with thanks to Tim Kaye for this fix.
1.4.0
WAI-ARIA compliance added for accessibility (with thanks to Tim Kaye for JavaScript contributions)
1.3.2
Rewrite of JavaScript file that fixes a bug which caused show/hide indicators to behave inconsistently.
1.3.1
Fixed bug that prevented links in answers from opening.
1.3.0
Added an option to the Settings page to hide the previously opened answer when a new answer is opened, i.e. the option to have only one answer visible at a time.
1.2.3
Minor code tweaks. Confirmed compatibility with WordPress 4.5.
1.2.2
Fixed a bug that would load styles if the text ‘faq-concertina’ appeared in a page or post even if it wasn’t a shortcode.
1.2.1
Minor code tweaks.
1.2.0
Added colorpicker fields to Settings page for custom colour selection.
1.1.3
Fixed bugs (i) Undefined variable: faq_css (ii) Trying to get property of non-object
1.1.2
FAQs are now publicly queryable – FAQ content now counts toward SEO. Category column in list view is now sortable.
1.1.1
Fixed problem with images
1.1
Added user-requested features:
i. The option to order the FAQs alphabetically, chronologically, or numerically.
ii. The option to add show/hide indicators to the questions.
1.0.2
Changed i18n text domain.
Removed extraneous duplication of files caused by SVN error.
1.0.1
Updates to .pot file and to .pdf manual.
1.0
Initial release.