Ultimate FAQ

(2022-12-08) = - Update to remove warning notice that was sometimes displaying on the FAQ search page if certain parameters were not defined.

(2022-12-08) = - Updated an incorrect link URL in the admin. - Plus the following from 2.2.0: - Added new tutorial videos to the settings pages that explain and show what each option does. - Added quick links to the admin about page to re-run the walk-through, view tutorial videos and suggest a feature. - Added new parameters to the Display FAQs block and the ultimate-faqs shortcode that let you enable/disable FAQ accordion and category accordion. - Updated dropdown block parameters to have a default value. - Accessibility updates (e.g. for the Expand button and the FAQ search label). - Tested with PHP 8.1. - Updated the export class for PHP 8 compatibility.

(2022-12-08) = - Added new tutorial videos to the settings pages that explain and show what each option does. - Added quick links to the admin about page to re-run the walk-through, view tutorial videos and suggest a feature. - Added new parameters to the Display FAQs block and the ultimate-faqs shortcode that let you enable/disable FAQ accordion and category accordion. - Updated dropdown block parameters to have a default value. - Accessibility updates (e.g. for the Expand button and the FAQ search label). - Tested with PHP 8.1. - Updated the export class for PHP 8 compatibility.

(2022-10-13) = - Fixed an issue in which, if the include_category attribute was used in the search shortcode, multiple categories would display if some of the FAQs matching that category were in multiple categories.

(2022-08-22) = - Updating a condition to make sure the new block patterns do not cause an error on WordPress installations using a version of WordPress older than 5.5.

(2022-08-12) = - Introducing new block patterns, which can be used to integrate FAQs directly into your block-based theme templates. - Added a parameter to the Display FAQs block, as well as an attribute to the ultimate-faqs shortcode, that lets you enable/disable grouping FAQs by category for that specific instance. - Added a Tags column to the main admin FAQs overview/table. - Updated the success/failure/validation messaging for the submit question form and added labelling options for these.

(2022-06-10) = - Fixed an issue in which FAQs were sometimes showing on archive pages for other custom post types if there was nothing selected for the FAQ Page setting.

(2022-05-20) = - Tested with WordPress 6.0.

(2022-05-17) = - Added previews for Gutenberg blocks (i.e. when, on the page edit screen, you add the block, it will show a preview).

(2022-05-04) = - Added a setting to choose/set an FAQ page (as an alternative option to manually putting the block or shortcode on a page). - Implemented an option to highlight the search term in the results. - Multiple admins can now be emailed on question submission (comma-separated). - The "No Results Found" text is now wrapped in a selector, so you can style it separately, if desired. - FAQ Category Toggle now has a title attribute. It also has a tabindex="0" attribute so that the toggle div can be selected via the keyboard. - Added a small delay before fetching search results, so that, if someone is typing a query, less requests are being sent to the server. - Updated the X button that clears the search field, so that it sets the display back to no FAQs or all FAQs, depending on which option you have specified. - Fixed an issue causing date and datetime custom fields to show an incorrect input type on the FAQ edit screen. - FAQs set to Private now display on the front end when you are logged in to the site. - Removed some extra blank spaces that were showing in textarea edit fields.

(2022-03-01) = - Fixed an issue causing invalid schema (structured data).

(2022-02-23) = - Updated WPForms integration, so you can now specify a minimum character count before matching FAQs show. - Removed Gutenberg block code from the output of the post body in the structured data. - Fix for structured data not output on FAQ search page. - Fix for issue in which, when using the ordering table, editing the FAQ that was at the top would send it to the bottom.

(2022-02-01) = - Fixed compatibility issue when using block-based themes.

(2022-01-26) = - Updated escaping function to correct issue with the widget output.

(2022-01-19) = - Added a new filter (ewd_ufaq_kses_allowed_html) to specify allowed tags for the FAQ answer/body.

(2022-01-05) = - Fixed an issue causing the YouTube block to not output on the front end in an FAQ post.

(2022-01-04) = - Updated class naming issues. - Fixed a few styling issues with the walk-through.

(2021-12-29) = - Updated sanitizing and escaping.

(2021-12-24) = - Updated sanitizing and escaping. - Added stable tag.

(2021-12-23) = - Updating nonce and capability checks for AJAX calls. - Updating sanitization and escaping.

(2021-12-22) = - Fixed an issue in which the defaults were not being correctly set for a few options.

(2021-12-21) = - Changed how premium settings areas are previewed. - CSS styling update for the FAQ Details area on the FAQ edit screen.

(2021-12-13) = - Added a notice pertaining to the requirement of the premium helper plugin to access premium settings and content.

(2021-11-03) = - Updates the SAP library to version 2.6.1 - Updates setting's so that a number display only conditionally on other settings' values - Fix for the 'X' in the search box not re-triggering the AJAX search

(2021-10-07) = - Adds in error handling for when the display_faq isn't defined - Adds in additional checks to prevent a console errors when the plugin JS files are loaded without the default localization data being defined.

(2021-09-17) = - Updated how secondary assets are conditionally enqueued. - Adds in a check to prevent a console error when the plugin JS files are loaded without the default localization data being defined.

(2021-09-08) = - Updated the settings page library. - Made FAQ search input field type search, so it includes functionality such as the clear event. - Updated the conditional enqueuing of assets. - Update to the integration with the Ultimate WP Mail plugin for the submitted FAQ thank-you email. - Added ID to the category headings (when grouping FAQs by category), so you can anchor link directly to one. - Added a check on FAQ import for the post type, so you can't accidentally overwrite an existing post if you mistakenly specify a post ID that already exists for a post in another post type.

(2021-08-12) = - Updated deprecated block_categories.

(2021-07-21) = - Updating a condition to account for a possible notice create by a rare use of the_content filter.

(2021-06-24) = - Fixed an issue in which FAQs that were imported would not display on the front end until manually updated.

(2021-06-21) = - Fixed an issue with incorrect permalinks in search results. - Fixed an issue in which emails from Ultimate WP Mail were not available for selection. - Fixed an issue in which

(2021-05-14) = - Fixed an issue causing the AJAX dynamic search results to not automatically show when typing when auto complete was disabled. - Fixed a conflict between multiple shortcodes listed on the search page. Please, you still should not have any extra shortcodes on your search page other than the one search shortcode! - Fixed issue with incorrect tag and category links on single post page.

(2021-05-10) = - Fixed an issue in which the wrong URL was being generated for tag links when pretty permalink was enabled. - Added an option to disable front-page canonical redirects if you are using your homepage as your FAQ page.

(2021-05-05) = - Fixed an issue in which the "FAQs per page" wasn't populating subsequent pages when "Group FAQs by Category" was enabled.

(2021-04-29) = - Fixed an issue causing it to sometimes take two clicks to open an FAQ when accordion was enabled and you were using a reveal effect. - Set the default sort order for the popular-faqs shortcode to descending.

(2021-04-23) = - Fixed an issue in which permalinks were not correctly redirecting if you had the destination set to the main FAQ page and pretty permalinks enabled.

(2021-04-22) = - Added workaround for missing formatting when using Elementor due to the way they filter the content. - Removed "Expand All" button from single FAQs. - Fixed a display issue, where "Expand All" was displaying instead of "Collapse All" when display_all_faqs was being used. - Eliminated a notice.

(2021-04-20) = - Fixed incorrect URL for category links in FAQ search result - Fixed link type custom fields not abiding the Hide Blank setting - Fixed issue with link type custom fields not being formatted as a link on the front end

(2021-04-19) = - Corrected console JS error on admin Dashboard page. - Updated admin enqueuing conditions.

(2021-04-15) = - Fix for fatal error happening on plugin update. - If you are updating from a pre-2.0.0 version of the plugin, you may have to manually re-activate the plugin after running the update.

(2021-04-14) = - Workaround for infinite loop issue caused by SiteOrigin Page Builder's application of content filtering.

(2021-04-14) = - Fixed the duplicate entry on the Plugins screen - Fixed an issue with the FAQ Elements Order setting/table that was causing a warning and for it to sometimes not display the correct order

(2021-04-14) = - Fix for the plugin deactivating when updating from pre-2.0.0

(2021-04-13) = - Fixed an issue where, when a single FAQ is linked to, the plugin was no longer scrolling to it. - Fixed incorrect path for loading plugin text domain. - Added the ability for the display_all_answers and group_by_category settings, for the View.FAQs class, to be filtered. This will allow you to override the default settings, to (among other things) do something like make an FAQ start closed even if it's the only one displaying. You can see the following for an example: https://pastebin.com/gZXFcmtw

(2021-04-12) = - Update to the structured data to make it so that, if you have multiple instances of the shortcode on the same page, it will combine the data from all of them and output only one FAQPage schema. - Fixes an issue with filtered FAQ content being displayed on archive pages.

(2021-04-09) = - Disables group-by-category if there's only a single FAQ, which rectifies issue of duplicates showing on single post page.

(2021-04-08) = - When using the "include_category" attribute while having "Group FAQs by Category" enabled, FAQs that are included in multiple categories will only be displayed in the categories specified in the "include_category" attribute. - Generated a new .pot file.

(2021-04-07) - Please double check after updating to see if the plugin was automatically re-activated. If not, you just need to manually click the Activate button. - Fixed an issue causing the "Share" label to show when it shouldn't - Fixed an issue causing new FAQs to not display in the order table - Fixed an issue causing the order set in the order table to not apply on the front end - Changed default slug base back to the correct "ufaqs" - Removed the border that was now appearing by default around the toggle symbol

(2021-04-06) - This update includes quite a big change to the construction of the plugin, so please take caution and test before updating on a live site (or wait a few days before updating in case some minor corrective updates need to be released). - Rebuilt the plugin, from the ground up, to be object oriented. - Updated the structure of the settings pages. - Fixed an issue with the WooCommerce integration causing other tabs to not display. - Fixed an issue with reveal effects not working. - Fixed issues with custom field importing. - If there's only a single FAQ being displayed, it will automatically display opened - CSS/styling updates, including for columns and WP Forms integration. - Updates to several styling options. - Updates to several option descriptions, to clarify them. - Updated the conditional loading of CSS and JS assets. - Added labelling option. - Cleaning up/removing unnecessary code and files. - Eliminating notices. - JS localization. - Updated .pot file. (If you have created a translation based on the old version, you might need to just update your .po file for this new version.)

• Fixing an issue in which tabs and content from other sources were not showing in WooCommerce tabs

• Updated .pot file for translations.
• Update to plugin name and description to clarify purpose and use.

• Further update for the feedback notice due to user who seems to still not be able to dismiss it.

• Corrects recent issue causing the feedback notice to not dismiss correctly

• Updated plugin documentation to take into account features that have been modified and added recently, and to more accurately reflect the current version of the plugin.

• CSS updates for the admin
• Updating plugin and author links to the current correct URLs
• Small change in the name to make purpose of plugin more clear

• Adding labelling option

• Correcting/eliminating several PHP notices
• Updating the version of FPDF used to 1.82

• Update to correct a potential minor XSS vulnerability

• CSS update for the admin styling options page layout
• Clarifying the purpose of the plugin in the name

• Small CSS update for admin options page layout

• Added extra security to the import feature.

• Added a new feature to integrate with WP Forms. Now you can set a field in your WP Forms contact form to automatically suggest and display FAQs when someone starts typing their message.
• Corrected an issue where the FAQ search was sometimes not working when the auto complete option was disabled.
• Corrected an issue where sometimes the post count did not return correctly if the same post matched for multiple words.

• Added in an option to use your own custom image for the FAQ ratings
• Added in the ability to reset the view count for FAQs
• Added an include_tag attribute for the shortcode
• Added in the ability to update FAQs via spreadsheet
• Updated the toggle feature with accessibility features
• Fixed an issue with the pagination in search results
• Fixed an issue with Expand All/Collapse All in search results
• Fixed the error that was happening when you tried to save a page in the admin that the submit-question shortcode or block is on
• Fixed the issue where accented letters weren't showing correctly in an exported PDF
• Fixed an issue in which the main FAQ menu item might still show for a user whose role was below that set with the "Set Access Role" option
• Removing notices related to undeclared variables

• Small update to the sanitization of an FAQ URL parameter

• Update for the admin dashboard

• Correcting issue with Set Access Role option

• Changing the way the schema is included to the new JSON-LD format
• Adding an option to disable the schema

• Removing placeholder text from the admin

• Adds in extra verifications for the import and export forms

• Correcting notices

• Correcting issue with not being able to import

• Fixes a minor possible XSS issue

• Updated reference variable that was causing a notice in FAQ comments

• Added in before_title and after_title for the widget titles

• Corrected an issue that was causing the "Skip All" button to not work in the tutorial that displays on plugin activation.

• Fixed an incorrect post_type reference in the new walkthrough.

• Missing files didn't actually get added in, in the last update. They're there now.

• Added in a new guided setup on plugin activation
• Updated the review ask pop-up

• Corrected issue in which the number of columns setting reverted back to default if you deactivated and reactivated the plugin

• Corrected issue in which category and tag styling options were not saving
• Corrected a formatting issue that was affecting certain option screens

• Added a skip button to the tutorial that shows when the plugin is first activated
• Added in a few missing images in the plugin admin area
• Corrected issue that was causing the review request to pop back up even after a review had been left or feedback sent.

• Corrected issue with Gutenberg blocks not displaying in new WordPress 5.0

• Updated enqueued JS version number to help with any issues related to the frequency of the request for feedback

• Added in missing call go to global version number variable for enqueued files

• Added version number to enqueued files

• Update to fix class conflict with PHPSpreadsheet if using more than one of our plugins

• Update to fix same-page permalinks
• Update to fix sidebar misalignment issue when Group By Category is enabled

• Made the request for feedback less intrusive

• Another minor update for the rewite_rules issue

• Removed an extra set of quotation marks that was causing flush_rewrite_rules to sometimes be called unnecessarily on init
• Fixed a styling option that wasn't working correctly for setting the category heading type

• Fixes a notice about trying to get property of a non-object

• This is a big update with many new features, corrections, revised admin styling, etc., so please take caution and test before updating on a live site
• Added in easy-to-use Gutenberg blocks for ultimate-faqs, ultimate-faq-search, submit-faq, recent-faqs and popular-faqs shortcodes
• Added in Gutenberg compatibily for the FAQ post create/edit screen
• The Options pages have a brand new and easy-to-use design!
• Added in new labelling options
• Added in a feature to display FAQs in multiple columns
• Added in option to set a default category for submitted questions
• Added in option to choose the number of FAQs that display per page (pagination), with options for distinct pages, a load more button or infinite scroll
• Made block styling options apply to border block theme as well
• Added in styling option for category headings
• Added in functionality for FAQ search, when "show on load" isn't being used, to have all FAQ results clear again when the search bar is cleared
• Added in option for the permalink to display just the text or just the icon
• Switched from using PHPExcel to the new PHPSpreadsheet for importing and exporting
• Made permalink text also a link (not just the icon)
• Corrected some alignment and styling issues with the FAQ Details meta box on the FAQ post create/edit screen
• Corrected issue with question/title styling not applying if you chose something other than H4 for FAQ Heading Type
• Updated comment label for FAQs that have comments enabled
• Minor styling changes to the FAQ display, including alignment of labels and corresponding fields
• Removed Color Block option from FAQ Display Style. (With the current Toggle Symbol styling options, it was redundant. If you had this option chosen, nothing will change, as it will automatically switch you to the Default option and keep any color changes you had made using the Toggle Symbol styling as well as your choice for the Color Block Shape.)
• Generated new .pot file

• Made the review ask pop up conditional on having JavaScript enabled and error-free

• Added in an option to highlight the search term in the FAQ question and answer when using the search shortcode

• Updated the free trial button

• Added an explanation for why "file" type custom fields cannot be included in a user-submitted FAQ
• Fixed a small admin CSS conflict with Gravity Forms

• Added the ability to include a "Post Date" and any custom fields when importing or exporting FAQs to a spreadsheet
• Added an attribute so that only FAQ posts in a parent category is displayed instead of all of the FAQ posts in child categories as welll
• Added UTF-8 support for PDF exports
• Fixed a problem where only the top category could be opened if the FAQ shortcode was included twice on a page
• Fixed an issue where the menu bar wasn't displayed on the edit FAQ screen
• Fixed an error where blank lines could be imported via spreadsheet as blank FAQs
• "File" type custom field labels no longer display on the submit FAQ form

• Small update to fix the broken dashboard image links

• We're doing a big FAQ admin area styling update, first up is the dashboard!
• Clarified the 'file' field type restriction for the submit FAQ shortcode

• Added an option to change who has access to the FAQ admin area

• Added in an option to have the category toggles accordion

• Added in a option to let users submit custom fields along with their questions when using the submit question shortcode

• Fixed a deprecated function issue for PHP 7.2 users

• Added in Ultimate WP Mail integration for the submit shortcode

• Re-running the set options operation for those who had updated to version 1.6.10

• Fixed an issue where new users were getting blank FAQs

• Added in the option to re-order the elements of an FAQ (body, date/author, categories, etc.)

• Fixed a conflict with other plugins that use CSSTidy for CSS sanitization
• Added the ability to link to the search shortcode with a term preloaded

• Fixed the settings page for those using PHP7
• Fixed the faq_id attribute of the select-faq shortcode

• Added in a captcha option for the submit question shortcode
• Fixed an HTML validation error

• Updated color select sanitizing function

• Removed unnecessary code from AJAX processing file
• Improved admin data processing

• Added a nonce field to the settings form

• Minor performance enhancement

• Added in a new FAQ style, contemporary
• Fixed an apply_filters issue with the_title
• Internationalized a few strings

• Fixed a number of minor styling issues

• Maintenance update (notices removed, pageload speed enhancements, small CSS fixes, etc.)

• Added spacing and a span for category post counts

• Fixed an error with the "Main FAQ page" permalink setting

• Minor admin styling update

• Changed the menu icon
• Added missing filters for the title
• Made it possible to change the email address that submitted question notifications get sent to
• Add an Italian translation (Thanks to Nimbaweb)
• Fixed an error where custom CSS wasn't being applied to the search shortcode

• Added an option to display the number of FAQs in a category, when FAQs are grouped by category

• Updated the text domain of the plugin, to use the improved WordPress standard

• Minor admin CSS update

• Fixed a small admin CSS issue

• Minor CSS styling updates

• Fixed an error where a number of widget titles weren't displaying correctly in the admin area

• Updated some PHPExcel files for increased import/export compatibility with PHP7

• Added an option for a title on a number of the FAQ widgets

• Made a number of changes to speed up page loads for longer FAQs
• Fixed an issue with the "Random FAQ" widget where an FAQ would be displayed multiple times if it was in multiple categories

• Made a number of changes to speed up page loads for longer FAQs
• Fixed an issue with the "Random FAQ" widget where an FAQ would be displayed multiple times if it was in multiple categories

• Fixed a missing slash on the WooCommerce FAQs tab in the admin area

• Added a "Random FAQ" widget
• Added in options to change the toggle icon size and color
• Fixed a couple of small issues with the AJAX search

• Small admin CSS and typo correction in relation to previous update

• Split the basic and premium options into a few sub-sections, to make it easier to find the right option

• Added a new, simpler way to select which FAQs to display on a product page, directly from the edit product screen

• Minor admin area update

• Removed a number of notices

• Removed a number of notices

• Replaced the version of PHPExcel used, so that the spreadsheet uploads will be compatible with PHP7
• Minor Dashboard fix

• Fixed a small Dashboard error that a number of users were experiencing

• Minor Dashboard update

• Fixed an error where using the trial in this plugin reset the trials for a number of our other plugins

• Introducing a free new premium 7-day trial feature, which users can choose to test out before buying the premium version

• Added an "Expand/Collapse All" optional set of controls
• Added in a "Retrieving Results" label for the search shortcode
• Added a "Link" custom field type
• Added in helper text when you're editing a category, to show the shortcode required to display only the selected category of FAQs
• Fixed a problem with sharing an FAQ on Facebook

• Fixed an error where permalinks weren't displaying

• Added labelling options

• Added in a pre-built shortcode display on the edit FAQ page, to display a single FAQ
• Fixed an error where the upgrade box was displayed on multiplate tabs

• Fixed an issue where the ratings buttons weren't working using the AJAX search feature

• Fixed minor dashboard and attribute errors

• Added in a new admin notification option for when questions are received
• Added in two new shortcode attributes, 'include_category_ids' and 'exclude_category_ids', to let users include categories by ID instead of only by slug
• Fixed two typos in the labelling area of the backend

• Fixed an issue where the most viewed FAQ stat was being sorted as a string

• Fixed a labelling issue for the submit FAQ shortcode

• Fixed a labelling issue for the submit FAQ shortcode

• Added in a message if no FAQs are found in search, and a label for that message in the back-end

• Added in a new premium option to change the toggle icon to one of 15 different sets of icons
• Added in microdata support, to help with SEO
• FAQs can now be included for an entire WooCommerce category instead of being added for products one at a time
• Fixed a URL issue when a category or tag was selected, and a visitor tried to select another one

• Fixed a number of insufficient permission errors

• Added in a new set of tutorials for new users
• Centralized the plugin dashboard and menu

• Added a premium styling option for the toggle indicator to adjust the height

• Minor update to take out a debugging message

• Added two new FAQ display styles, minimalist and border block
• Added in support for comments directly in the FAQs if enabled
• Added two new premium features, FAQ ratings and FAQ custom fields
• Added a premium styling option to let users select which heading the FAQ and comment titls have (h1, h2, etc.)

• Fixed a font-family error

• Fixed an error where if WooCommerce FAQs were set to "Yes", and not category had been created, all FAQs would show

• Fixed an error where scroll to top would take a visitor to the first instance of an FAQ if it was on the page twice

• Fixed an error where view count wasn't being counted when FAQs were clicked to expand

• Fixed a JS error that was preventing the new shortcode helper from working with other plugins that modify the visual editor

• Added a feature that has been requested by a number of users, an FAQ shortcode helper, which lets you build shortcodes without having to remember and manually input the attributes. This feature can be turned off via the settings page, if you'd like to keep your tinyMCE button bar free of extra buttons
• Fixed an error where category titles were no longer displaying

• Global post variable is now reset after the FAQs query loop

• Should make the plugin compatible with a couple of page builder plugins

• If there are no tags or categories for a particular FAQ, they should now be hidden

• Added an attribute, show_on_load, which will show all FAQs when the page first loads and then refresh the results when a visitor adds a search term

• Fixed an error where same page permalinks weren't opening the posts

• Fixed a broken link
• Added extra information about the premium version

• Fixed an error where FAQs on the same page as the search shortcode couldn't be clicked at times

• Added in WPML support for the main shortcodes
• Fixed an error with a missing ID tag

• Added the ability to have multiple widgets or shortcodes on a page
• Fixed a small error with the popular FAQs shortcode

• Fixed a missing file error

• Added in a new premium feature: WooCommerce FAQs tab, which lets you add a different list of FAQs on the product page for each WooCommerce product

• Added another set of labeling options

• Minor CSS update

• Added anumber of extra labeling options

• Minor CSS update

• CSV files can now be used for FAQ imports

• Fixed a parent-child issue, where if a parent category was added in the include_category attribute, it was possible to end up with unexpected categories when an FAQ was in multiple categories

• Fixed a number of PHP notices

• Fixed a missing div error that could come up with certain options selected

• Minor CSS update

• Added a "Category Toggle" options for users who group their FAQs by category
• Cleaned up some of the code dealing with options

• Fixed a scrolling error with non-FAQ links

• Should fix small problems with the "select-faq" shortcode and the "FAQ ID List" widget

• Removed blank categories from FAQ search results
• Added in a "Permalink Type" option, which lets you decide between linking to the post in the main page and the individual post page

• Fixed a problem with FAQ permalinks not opening in the list

• Fixed a conflict with WooCommerce, where a UFAQ script was keeping product information tabs open

• Fixed a problem where links inside of a toggable FAQ weren't clickable

• Added a color picker to the color fields on the styling options area

• Added new premium display styles
• Added an autocomplete titles option for the AJAX search shortcode
• Added more styling options to customize new display styles
• Added an option to add a 'Back to Top' link to each FAQ post
• Fixed a reveal error with non-accordion display and no effect selected

• Added some CSS classes in preparation for an upcoming large CSS/styling update

• Added a unique identifier to each FAQ so that if it is repeated on the same page, the correct post should open

• Minor CSS update

• Fixed an issue where new users weren't able to update ordering even after upgrading to premium

• Minor CSS update

• Fixed a status error message

• Added in widgets to display a number of popular or recently created faqs

• CSS update for the ordering table in the admin area

• Fix for the FAQ ordering bug

• Premium version release, check out our website for all of the details http://www.etoilewebdesign.com/ultimate-faq/