# SFN Easy FAQ Manager #

**Contributors:** curtismchale, norcross

**Tags:** frequently asked questions, FAQ, shortcodes, custom post types

**Requires at least:** 4.0

**Requires PHP:** 8.0

**Tested up to:** 6.9

**Stable tag:** 2.0.4.4

**License:** GPLv2 or later

**License URI:** <http://www.gnu.org/licenses/gpl-2.0.html>

## Description ##

Uses custom post types and taxonomies to manage an FAQ section for your site. Includes a set of custom taxonomies to organize, and shortcode options for different display configurations. [See the FAQ section](http://wordpress.org/plugins/wordpress-faq-manager/faq "See the FAQ section")  for complete setup options.

## Installation ##

This section describes how to install the plugin and get it working.

1. Upload the 'wordpress-faq-manager' folder to the `/wp-content/plugins/` directory or install via the WP admin panel
1. Activate the plugin through the 'Plugins' menu in WordPress
1. That's it.

## Frequently Asked Questions ##

### What does this do? ###

It uses the custom post type feature to create a dedicated FAQ section in your WordPress site, including categories and tags exclusive to them.

### How Do I Use It? ###

Each FAQ acts like a "post". You can assign your own categories (called topics) or tags and organize as you see fit. You can also use shortcodes to place them on any page as follows:

* For the complete list:
 place `[faq]` on a post / page

* For a single FAQ:
 place `[faq faq_id="ID"]` on a post / page

* List all from a single FAQ topic category:
 place `[faq faq_topic="topic-slug"]` on a post / page

* List all from a single FAQ tag:
 place `[faq faq_tag="tag-slug"]` on a post / page

* List all from multiple FAQ tags:
 place [faq faq_tag="tag-slug-1, tag-slug-2"] on a post / page

* List all from both FAQ topics and FAQ tags:
 place [faq faq_topic="topic-slug-1" faq_tag="tag-slug-2"] on a post / page

The list will show 10 FAQs based on your sorting (if none has been done, it will be in date order).

* To display only 5:
 place `[faq limit="5"]` on a post / page

* To display ALL:
 place `[faq limit="-1"]` on a post / page

* For a list with a title and link to full FAQ:
 place `[faqlist]` on a post / page

* For a list with a group of titles that link to complete content later in page:
 place `[faqcombo]` on a post / page

* For a list of taxonomies (topics or tags) with a link to their respective archive page:
 place `[faqtaxlist type="topics"]` or `[faqtaxlist type="tags"]` on a post / page

* For a list of taxonomies (topics or tags) with their description:
 place `[faqtaxlist type="topics (or tags)" desc="true"]` on a post / page

## Screenshots ##

### 1. The "Add New FAQ" area

###

[missing image]

### 2. Example of collapsed FAQs

###

[missing image]

### 3. Example of expanded FAQs

###

[missing image]

## Changelog ##

### 2.0.4.4 ###

* got more strict about how we add our CPT to the main feed as we were overwriting other post types

### 2.0.4.1 ###

* fixed a spelling mistake in readme
* changed name after advice from plugin team

### 2.0.4 ###

* more relaxed version of PHP supported to maintain backwards compatability a bit better## 2.0.3 ###

### 2.0.3 ###

* updated Tested version
* fixing direct file access
* removed wpfaq_taxlist_shortcode_args filter as it was used in a deprecated way with get_terms
* fixed internationalizaton strings
* updated data sanitization for sorting FAQ save function
* hardened escaping in widgets and instructions page
* fixed a bunch of AJAX calls
* fixed direct database calls to use built in WP functions

### 2.0.2 ###

* fixed a bug where the rest route location changed so we defined the old way
  and it works again

### 2.0.1 ###

* adding rest support back for custom post types and taxonomies

### 2.0.0 ###

* total refactoring. I mean, totally.

### 1.331 ###

* added German language support. Props @PowieT

### 1.330 ###

* added French language support. Props @straw94

### 1.329 ###

* replaced custom function with native admin columns for FAQ taxonomies
* removed 'answers' from FAQ table due to translation issues
* tweaked CSS to include FAQ icon in all related areas.

### 1.328 ###

* small bugfix on markup for shortcode combo

### 1.327 ###

* added optional 'back to top' link for combo FAQ list

### 1.326 ###

* added option to redirect all FAQ content to a single FAQ page

### 1.325 ###

* added option to disable content_filter on output (added on 1.324)

### 1.324 ###

* applying filters to content output for shortcodes, etc
* beginning internationalization support
* moved widgets into a separate file for organization

### 1.323 ###

* minor bugfix for conflicts with certain commerical forms plugins

### 1.322 ###

* fixed RSS inclusion bug

### 1.321 ###

* fixed IE9 expand / collapse bug
* added version number to CSS and JS files

### 1.32 ###

* added optional inclusion of permalink below expanded entries

### 1.31 ###

* added ability to change single FAQ slugs

### 1.30 ###

* added taxonomy list shortcode
* revamped settings and instructions page
* CSS cleanup

### 1.29 ###

* modified expand / collapse to close all other FAQs when one is opened
* added expand / collapse speed option

### 1.283 ###

* added standard post classes for taxonomy archives

### 1.282 ###

* added standard post classes for themes with narrow CSS

### 1.281 ###

* bugfix on plugin page menu links

### 1.28 ###

* added optional jQuery smooth scrolling effect for FAQ Combo shortcode
* added links to settings and instructions page on plugin table

### 1.27 ###

* fixed bug in Random FAQ widget and and added variable for 'see more' text and number. Props @jupiterwise

### 1.26 ###

* added `faqcombo` shortcode to allow for a list of FAQ titles that inner-link to the content on the page

### 1.25 ###

* added CSS for printing to auto-expand FAQs (does not affect screen)
* fixed jQuery expand bug that was causing FAQs to be collapsed at all times.

### 1.24 ###

* removed the 'public' option (it was misleading)
* added SEO options (noindex, nofollow, and noarchive)

### 1.23 ###

* bugfix with URL source of files (for reals this time)
* Search widget to search just FAQs

### 1.22 ###

* bugfix with URL source of files
* added a user permissions filter `faq-cap` to all related admin menu pages. [See the Codex](http://codex.wordpress.org/Plugin_API/Filter_Reference/user_has_cap "See the Codex") on `user_has_cap` filter to adjust.

### 1.21 ###

* updated FAQ sort page to match user permissions of settings page

### 1.2 ###

* MAJOR code cleanup
* converted code base to OOP
* serialized settings storage in DB
* consolidated widgets

### 1.14 ###

* Added fallbacks if user doesn't save settings

### 1.13 ###

* Removed version number for script and CSS enqueues for better cache setup
* New icon

### 1.12 ###

* Code cleanup for 3.3

### 1.11 ###

* Added FAQ slug as title anchor
* Optional H type selector (H1, H2) for better theme compatibility

### 1.1 ###

* Included optional jQuery AJAX pagination (thanks to @JohnPBloch and @DanDenney for the help)

### 1.043 ###

* Slight markup change (switching a span class to a div)
* Cleaned up function to include optional jQuery collapse

### 1.042 ###

* Restored the single FAQ title on the "Random FAQ" widget

### 1.041 ###

* bug fix where markup in post editor screen would break layout on admin panel.

### 1.04 ###

* added 3 additional widgets
* code cleanup via suggestions by @Yoast
* Included wpautop function to display line breaks / lists / etc.

### 1.03 ###

* included optional jQuery collapse / expand
* added second shortcode option [faqlist]
* added instructions page within FAQ submenu

### 1.02 ###

* added option to control number of FAQs displayed via shortcode. See the How To section of the readme for more info

### 1.01 ###

* Fixed path for CPT icon
* Updated user documentation

### 1.0 ###

* Initial release

## Upgrade Notice ##

### 2.0.0 ###

* All the settings are now gone and replaced via filter. However, there is a legacy file that will check for your existing settings and use those values if they exist.

### 1.3 ###

* All the markup changed from using underscores to dashes, i.e. `<div class="faq_list">` to `<div class="faq-list">`. If you have any custom CSS, you will need to update it.

### 1.2 ###

* Note: you MUST re-save your settings based on changed made.

### 1.01 ###

* Fixed query for number of FAQs displayed

### 1.01 ###

* No fundamental changes

## Potential Enhancements ##

* Got a bug? Something look off? Hit me up.
