{"id":131622,"date":"2020-11-23T16:51:32","date_gmt":"2020-11-23T16:51:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/faq-with-categories\/"},"modified":"2025-12-03T10:23:18","modified_gmt":"2025-12-03T10:23:18","slug":"faq-with-categories","status":"publish","type":"plugin","link":"https:\/\/kea.wordpress.org\/plugins\/faq-with-categories\/","author":17247799,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.5.1","stable_tag":"1.5.1","tested":"6.9.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"FAQ with categories","header_author":"Joeri van Veen","header_description":"Easy to maintain FAQ and answer plugin with categories.","assets_banners_color":"ffffff","last_updated":"2025-12-03 10:23:18","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_donations&business=hallo@ruigehond.nl&lc=US&item_name=FAQ+with+categories+plugin&no_note=0&cn=¤cy_code=EUR&bn=PP-DonationsBF:btn_donateCC_LG.gif:NonHosted","header_plugin_uri":"https:\/\/github.com\/joerivanveen\/faq-with-categories","header_author_uri":"https:\/\/wp-developer.eu","rating":0,"author_block_rating":0,"active_installs":20,"downloads":2793,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.3.0":{"tag":"1.3.0","author":"ruigehond","date":"2024-02-27 10:11:30"},"1.3.1":{"tag":"1.3.1","author":"ruigehond","date":"2024-03-03 12:22:40"},"1.4.0":{"tag":"1.4.0","author":"ruigehond","date":"2024-07-05 21:04:15"},"1.5.0":{"tag":"1.5.0","author":"ruigehond","date":"2024-07-24 08:17:13"},"1.5.1":{"tag":"1.5.1","author":"ruigehond","date":"2025-12-03 10:23:18"}},"upgrade_notice":{"1.5.0":"

If you use a single FAQ template, you can now get the faq_page_id<\/code> from the options (get_option( &#039;ruigehond010&#039; )[ &#039;faq_page_id&#039; ]<\/code>) if you want, to link to the overview page.<\/p>","1.3.0":"

IMPORTANT if you target FAQ elements with CSS, the following elements have changed, because multiple lists are now possible on the same page:\n- #ruigehond010_faq<\/code> -> .ruigehond010.faq<\/code>\n- #ruigehond010_more<\/code> -> .ruigehond010.more<\/code>\n- #ruigehond010_no_results_warning<\/code> -> .ruigehond010.no-results-warning<\/code>\nIn addition, the choose-category<\/code> select list dropped the faq<\/code> class, you can now target it with .ruigehond010.choose-category<\/code>\nIf you use a single and \/ or archive template, you may need to update the id\u2019s to classes there as well.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2894793,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2894793,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2894793,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2894793,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.3.0","1.3.1","1.4.0","1.5.0","1.5.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2894793,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2894793,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2894793,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":2894793,"resolution":"4","location":"assets","locale":""}},"screenshots":{"1":"

Default view on the frontend with a search bar<\/p>","2":"

ruigehond010_faq post-type lets you easily manage the faqs<\/p>","3":"

Customize the plugin using the options<\/p>","4":"

The categories can be coupled to a page, and you can order them as well<\/p>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[5614,7945,1643,7944,5613],"plugin_category":[57],"plugin_contributors":[172862],"plugin_business_model":[],"class_list":["post-131622","plugin","type-plugin","status-publish","hentry","plugin_tags-answers","plugin_tags-asked","plugin_tags-faq","plugin_tags-frequently","plugin_tags-questions","plugin_category-taxonomy","plugin_contributors-ruigehond","plugin_committers-ruigehond"],"banners":{"banner":"https:\/\/ps.w.org\/faq-with-categories\/assets\/banner-772x250.png?rev=2894793","banner_2x":"https:\/\/ps.w.org\/faq-with-categories\/assets\/banner-1544x500.png?rev=2894793","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/faq-with-categories\/assets\/icon-128x128.png?rev=2894793","icon_2x":"https:\/\/ps.w.org\/faq-with-categories\/assets\/icon-256x256.png?rev=2894793","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/faq-with-categories\/assets\/screenshot-1.png?rev=2894793","caption":"

Default view on the frontend with a search bar<\/p>"},{"src":"https:\/\/ps.w.org\/faq-with-categories\/assets\/screenshot-2.png?rev=2894793","caption":"

ruigehond010_faq post-type lets you easily manage the faqs<\/p>"},{"src":"https:\/\/ps.w.org\/faq-with-categories\/assets\/screenshot-3.png?rev=2894793","caption":"

Customize the plugin using the options<\/p>"},{"src":"https:\/\/ps.w.org\/faq-with-categories\/assets\/screenshot-4.png?rev=2894793","caption":"

The categories can be coupled to a page, and you can order them as well<\/p>"}],"raw_content":"\n

FAQs are great for your visitors and when implemented correctly also for SEO.<\/p>\n\n

This simple FAQ plugin creates a new post-type. This is straightforward and flexible: you can now create and manage FAQs like any other post type in WordPress.<\/p>\n\n

The FAQs can be summoned using shortcodes, the default for the central FAQ page is [faq-with-categories]. More options are explained below and on the settings page.<\/p>\n\n

FAQs are always sorted by published-date descending, so newest entries are first (you can manipulate the published date of each post).<\/p>\n\n

You can choose a taxonomy, the default is \u2018category\u2019, to attach your FAQ posts to. You can now summon FAQs for a specific category (including sub categories) on a page. The plugin also uses it to filter the FAQs if you place the filter on your central FAQ page.<\/p>\n\n

If you want some FAQs in other locations that do not appear on the central page you can use an \u2018exclusive\u2019 tag.<\/p>\n\n

When there are many entries, a \u2018Show more\u2019 button appears automatically (configurable in the settings)<\/p>\n\n

Pros<\/h4>\n\n
    \n

  • Easy to manage the FAQs<\/p><\/li>\n

  • Tidy accordion display and smooth filtering \/ searching<\/p><\/li>\n

  • The \u2018exclusive\u2019 short_code and the central FAQ page output FAQ snippet schema data as ld+json in the head<\/p><\/li>\n

  • Supports direct linking to pre-select the filters (faq-page?category=name%20of%20category)<\/p><\/li>\n

  • Automatically follows (chosen) taxonomy hierarchy (infinite depth) with added option to order the categories<\/p><\/li>\n<\/ul>\n\n

    Cons<\/h4>\n\n
      \n

    • Only 1 central FAQ list is supported (though you can display subsets of the FAQs anywhere you want)<\/p><\/li>\n

    • Currently only with shortcodes, no widgets<\/p><\/li>\n

    • Filtering and searching the FAQs only work with javascript enabled (but then again, so does most of WordPress)<\/p><\/li>\n<\/ul>\n\n

      Short codes<\/h4>\n\n

      You may use the following shortcodes, of course certain combinations do not make sense and may produce erratic behaviour.<\/p>\n\n

      [faq-with-categories]<\/strong> produces the default list with all the faqs and outputs FAQ snippets schema in the head. Use only ONCE for central FAQ page, and on pages that are linked to a taxonomy (category) in the plugin.<\/p>\n\n

      [faq-with-categories-filter]<\/strong> produces a filter menu according to the chosen taxonomy using the specified order (only works when default shortcode is also on that page).<\/p>\n\n

      [faq-with-categories-search]<\/strong> produces a search box that will perform client-side lookup through the faqs (only works when default shortcode is also on that page).<\/p>\n\n

      [faq-with-categories quantity=\"5\"<\/strong>] (1)<\/em> limits the quantity of the faqs to 5, or use another number. Can be combined with the other settings.<\/p>\n\n

      [faq-with-categories category=\"category name\"<\/strong>] (1)<\/em> display only faqs for the specified category (case-insensitive). This will NOT output FAQ snippets schema in the head.<\/p>\n\n

      [faq-with-categories exclusive=\"your tag\"<\/strong>] (1)<\/em> (use only ONCE for every tag) any tag you specified under a faq entry in the box, will gather all faqs with that tag for display.<\/p>\n\n

      [faq-with-categories title-only=\"any value\"<\/strong>] outputs the list as links rather than as an accordion.<\/p>\n\n

      (1)<\/em> NOTE: only a limited number of faqs will be present on the page, searching and filtering will be limited to those.<\/p>\n\n

      Template<\/h4>\n\n

      The post-type is called ruigehond010_faq, so you can create a single-ruigehond010_faq.php and archive-ruigehond010_faq.php template should you want to format the display in more detail.<\/p>\n\n

      Have fun. Let me know if you have a question!<\/p>\n\n\n

        \n

      1. Install the plugin by clicking \u2018Install now\u2019 below, or the \u2018Download\u2019 button, and put the faq-with-categories folder in your plugins folder.<\/p><\/li>\n

      2. Activate it on the plugins page<\/p><\/li>\n

      3. Click on FAQ in your admin menu to create your first FAQ.<\/p><\/li>\n<\/ol>\n\n

        Upon uninstall FAQ with categories removes its own options and taxonomy sorting table. However, it leaves the FAQ posts in the database currently. If you are positive you don\u2019t need the FAQ posts anymore, bulk-delete them before uninstalling the plugin.<\/p>\n\n\n

        1.5.1: prevent upgrade statement to run for every admin request<\/p>\n\n

        1.5.0: expose FAQ page id in code and allow author + excerpt for FAQ post type<\/p>\n\n

        1.4.0: control output schema in settings, add option to not open first FAQ in list<\/p>\n\n

        1.3.1: prevent error during activation or uninstalling<\/p>\n\n

        1.3.0: allow multiple lists on one page, best practices security fixes<\/p>\n\n

        1.2.0: only show filter options where there are actual faq items<\/p>\n\n

        1.1.8: fix updating ordering table when rows are missing<\/p>\n\n

        1.1.7: allow editors to manage the faq post type<\/p>\n\n

        1.1.6: automatic deploy, no functional changes<\/p>\n\n

        1.1.5: improved accordion handling, removed animation<\/p>\n\n

        1.1.4: added screenshots, released on wordpress.org<\/p>\n\n

        1.1.3: plugin determines max-height of faq posts on client itself, fix apply_filters would sometimes not work the first time<\/p>\n\n

        1.1.2: you can now decide which html tag is used for the header of each faq on the faq page, fix ordering taxonomy would delete coupled page<\/p>\n\n

        1.1.1: small fixes and updated translation, added admin warning message for duplicate short codes<\/p>\n\n

        1.1.0: added page linking to taxonomy for automatic selection of the corresponding faqs on them, option to output faq snippet on single pages<\/p>\n\n

        1.0.7: added no results warning message<\/p>\n\n

        1.0.6: fixed faq display with limited quantity and \/ or title-only could register as the main faq page<\/p>\n\n

        1.0.5: improved accordion, added option to only use the \u2018more\u2019 button on the central faq page, improved explanations + translations<\/p>\n\n

        1.0.4: updated translations<\/p>\n\n

        1.0.3: refactored javascript to OOP so it works more reliably with less code, you can specify button text + max in settings<\/p>\n\n

        1.0.2: updated link on plugins page, updated readme<\/p>\n\n

        1.0.1: short_code \u2018category\u2019 now selects posts the same way as querystring (specifically also all the posts belonging to children)<\/p>\n\n

        1.0.0: Release<\/p>","raw_excerpt":"Easy to manage FAQ with categories, including accordion, filter, search and show more functionality.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/131622","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=131622"}],"author":[{"embeddable":true,"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ruigehond"}],"wp:attachment":[{"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=131622"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=131622"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=131622"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=131622"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=131622"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/kea.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=131622"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}