Releases for faq

Changes since DRUPAL-6--1-6:

• #254334 - fixed issue with line breaks in the strings
• #249656 - fixed issue where a couple of strings weren't in t() calls.
• #268433 - applied patch provided by btsukuda which splits the layouts into different include files
• #257614 - fixed issue with categorized question layouts causing problems in some themes due to a missing closing div.
• #254334 - updated de.po translation file provided by rastatt
• Tidied up js code (ran through jsLint)
• Added check_markup() around term descriptions.
• Updated translation template file.

Changes since DRUPAL-5--2-10:

• #254516 - fix for error appearing when no faq nodes configured.
• #254334 - fixed issue with line breaks in the strings
• #249656 - fixed issue where a couple of strings weren't in t() calls.
• #267793 - solution for "clear-block" div problems in some themes.
• #268433 - modification for D5 of patch provided by btsukuda which splits the layouts into different include files
• Tidied up js code (ran through jsLint)
• Added check_markup() around term descriptions.
• Updated translation template file.

Changes since DRUPAL-5--2-9:

• #224910 - added in a new option to prevent the question text from being links to the faq nodes.
• #199726 - changed class name of question listing at top of list when categories are enabled for the "Clicking on question brings user to answer further down the page" layout.
• #228939 - fixed typo in description text
• #235614 - implemented hook_term_path to change "taxonomy/term/xxx" to "faq/xxx" automatically, patch supplied by nancyw.
• #231209 - added in the ability to automatically sort the new faq nodes by creation date descending / ascending when no weight is specified.
• #185680 - added support to view image_attach images on faq nodes in the faq node
  listing, patch supplied by nancyw
• #214284 - it's now possible to view the node links on the faq pages using a configurable option.
• #248917 - anchor links were incorrect for normal node pages which include a call to faq_page().
• updated taxonomy_image_display api calls
• changed term_node table alias from t to tn so as to be consistent
• latest version of the site_map module (1.2) calls one of the faq functions directly. Since the faq module also implements hook_site_map(), the faq section of the site map was appearing twice. I've commented out the faq_site_map() function to prevent this error.
• removed duplicate menu entry
• changed "true" and "false"to uppercase, now using count() instead of strlen(), explode() instead of preg_split() and strpos() instead of strstr() where appropriate.
• Re-structured the readme text.
• Re-structured the faq module so as to reduce code duplication between similar functions and to make it easier to maintain.
• Renamed some variables and tweaked some documentation.
• added in missing t() calls
• Fixed translation string issue
• Updated translation template file

Changes since DRUPAL-6--1-5:

• #224908 - back to top links weren't using anchors any more, due to a change in the api
• #245131 - fix for modified question text getting lost on preview. Also some menu changes for Drupal 6.2.
• #226490 - faq module wasn't joining on new vid column in term_node table, thereby incorrectly handling node revisions.
• #224910 - added in a new option to prevent the question text from being links to the faq nodes.
• #199726 - changed class name of question listing at top of list when categories are enabled for the "Clicking on question brings user to answer further down the page" layout.
• #228939 - fixed typo in description text
• #235614 - implemented hook_term_path to change "taxonomy/term/xxx" to "faq/xxx" automatically, patch supplied by nancyw.
• #231209 - added in the ability to automatically sort the new faq nodes by creation date descending / ascending when no weight is specified.
• #185680 - now supporting image_attach images on FAQ nodes
• #214284 - it's now possible to view the node links on the faq pages using a configurable option.
• #248917 - anchor links were incorrect for normal node pages which include a call to faq_page().
• Added in some commenting of closing divs to make it easier to debug
• updated taxonomy_image_display api calls
• fixed issue with faq_tax_image class typo
• latest version of the site_map module (1.2) calls one of the faq functions directly. Since the faq module also implements hook_site_map(), the faq section of the site map was appearing twice. I've commented out the faq_site_map() function to prevent this error.
• changed "true"and "false" to uppercase
• now using count() instead of strlen(), explode() instead of preg_split() and strpos() instead of strstr() where appropriate.
• Re-structured the readme text.
• Re-structured the faq module so as to reduce code duplication between similar functions and to make it easier to maintain.
• Renamed some variables and made the documentation clearer.
• Fixed bug with categorized questions top layout
• Added in missing t() calls
• Fixed translation stuff.
• Updated translation template file

Changes since DRUPAL-5--2-8:

• #224359 - Critical bug fix for array_diff_key() not being in PHP4

Changes since DRUPAL-6--1-4:

• #224359 - Critical bug fix for array_diff_key() not being in PHP4

Changes since DRUPAL-5--2-7:

• #224059 - fix for not loading based on version id too and now returning the $node object from faq_load(), patch provided by hutch. This was causing problems with the display of the questions and answers - main cause for another release so soon after the last!
• #224248 - changed toggle() to slideToggle()

Changes since DRUPAL-6--1-3:

• updated hook_access() with new parameter added in D6
• #224059 - fix for not loading based on version id too and now returning the $node object from faq_load(), patch provided by hutch. This was causing problems with the display of the questions and answers - main cause for another release so soon after the last!
• #224248 - changed toggle() to slideToggle()

Changes since DRUPAL-5--2-6:

• #199148 - changed taxonomy term links to point at faq pages when categorisation is enabled.
• #203817 - changed the weight form and the FAQ categories block to only show FAQ
  terms which are associated with an actual FAQ node.
• #209908 - fixed issue where links in the category/term description weren't working when the "open/hide answer under question"layout was chosen.
• #214281 - now allowing html chars in "more link" text
• #205507 - support for longer question text
• #214873 - can now prevent terms from specific vocabularies from appearing in faq listings, etc. Original patch provided by bardaqani.
• #212762 - added order by fields to select list to prevent psql errors.
• #222329 - manually inserting faqs using faq_page() call in a page, overrode the page title. This is now fixed.
• added documentation based on andrei.ruse's work for the D6 version in #200879
• changed some 'hidden' form elements to be 'value' as recommended by the drupal FAPI.
• Updated language translation template file
• Removed needless watchdog function calls.
• Fixed $Id$ line.
• Removed trailing whitespace.

Changes since DRUPAL-6--1-2:

• #199148 - changed taxonomy term links to point at faq pages when categorisation is enabled.
• #203817 - changed the weight form and the FAQ categories block to only show FAQ
  terms which are associated with an actual FAQ node.
• #214281 - now allowing html chars in "more link" text
• #205507added in support for longer question text.
• #214873 - can now prevent terms from specific vocabularies from appearing in
  faq listings, etc. Original patch provided by bardaqani for D5 version. Also fixed issue with faq_link_alter() function.
• #212762 - added order by fields to select list to prevent psql errors
• #222329 - manually inserting faqs using faq_page() call in a page, overrode the
  page title. This is now fixed.
• #200879 - documentation patch provided by andrei.ruse.
• added "faq" to theme function names that were missing them
• #202811 - applied fix for undefined variable warning.
• #201082 - GHOP task to modify 4 of the theme functions in the FAQ module to be done by templates instead. All this excellent work was done by cwgordon7, so many thanks to cwgordon7.
• #205113 - the faq categorized theme layouts have now been ported to template files by mwrochna - thanks for your hard work on this patch.
• #205092 - schema was missing column and table descriptions.
• Fix for #198386 where teaser text was being lost.
• #200560 - prevent faq terms which have no faq nodes from appearing in the lists
• #205099 - patch for php warnings, provided by kwikone.
• #209908 - fixed issue where links in the category/term description weren't working when the "open/hide answer under question" layout was chosen.
• changed some 'hidden' form elements to be 'value' as recommended by the drupal FAPI.
• Updated language translation template file
• Removed needless watchdog function calls.
• Fixed $Id$ line.
• Removed trailing whitespace.

Changes since DRUPAL-6--1-1:

• fixed for typo reported in #185117 - caused sub categories to not always be displayed.
• fix for #181149 - there was a problem showing the faq count when the question/answer text contained a %
• changes for #188516 - added support for taxonomy images. The taxonomy image module hasn't been ported to D6 yet, so assuming the API won't change. Will have to test this feature once taxonomy image for D6 is released.
• change for #189504 - changed submit button labels
• fixed issue with node type help text
• now using db_placeholders() in db_query() calls where necessary.
• removed use of deprecated function menu_set_location(), now using drupal_set_breadcrumb()

Changes since DRUPAL-5--2-5:

• fixed for typo reported in #185117 - caused sub categories to not always be displayed.
• fix for #181149 - there was a problem showing the faq count when the question/answer text contained a %
• changes for #188516 - added support for taxonomy images
• change for #189504 - changed submit button labels
• fixed issue with node type help text

Changes since DRUPAL-6--1-0:

• fix for #178699 - wasn't possible to translate customised FAQ page titles
• fix for #178699 - multilingual faq descriptions
• changes for #179285 - now no longer use <dd> and <dt> tags, using divs instead
• fixed problem with new "random faq" block
• fix for #176900 - removed unneeded call to node_type_delete()
• moved hook_schema() into install file
• fixed t() usage
• fix for #176991 - couldn't change the order of questions for subcats

Changes since DRUPAL-5--2-4:

• added in new feature where it is possible to label the questions and answers in the 'questions inline' layout
• fixed javascript that broke due to the renaming of some form elements. Also added in changes for the label sections of the questions form.
• fixed issue with faq descriptive text filter
• change for #176104 - after changing the weights of categorized questions, the user is returned to the "choose a category to order" screen.
• change for size of question weight box for #176104
• changes for #176628 - allow answer teasers for "hide_answer" layout
• changes for #177993 - there is now a new "random faqs" block.
• fix for #178699 - wasn't possible to translate customised FAQ page titles
• fix for #178699 - multilingual faq descriptions
• changes for #179285 - now no longer use <dd> and <dt> tags, using divs instead
• fixed t() usage
• fixed #176991 - weight ordering wasn't working for sub cats on the main cat page

Dev version for 5.x-2.x

Changes since DRUPAL-5--2-4:

• first go at drupal 5.x to drupal 6.x port
• added in new feature where it is possible to label the questions and answers in the "questions inline" layout
• added in calls to variable_del() for the new label variables
• fixed javascript that broke due to the renaming of some form elements. Also added in changes for the label sections of the questions form.
• fixed problem with faq descriptive text filter
• change for size of question weight box for #176104
• changes for #176628 - allow answer teasers for "hide_answer" layout
• patch for #176848 - "faq_weights" table install prob
• changes for #177993 - provided a new "random FAQs" block

Changes since DRUPAL-4-7--2-0:

• fixed styling and added in a patch for #178685 - added in {faq} notation for accessing db tables.

First version of converting faq module to Drupal 6.x. There are no new features in this release.

Changes since DRUPAL-5--2-3:

• added in a faq_site_map() hook for #138767
• removed version line as recommended
• made "questions listing style" and "categories listing style" form elements help text clearer - #152797
• corrected spacing, etc for coding standards as reported in #156713
• patch for #155143 which controls which faq nodes appear on the faq page according to the individual faq node permissions.

Changes since DRUPAL-5--2-2:

New features

• added in 2 functions, faq_get_faq_list() and faq_get_terms() for returning lists of FAQ nodes / terms for the site_map module as suggested in #138767
• added in new function for ordering the faq nodes on the weighting form by date asc / desc
• It's now possible to configure whether you would like to have the number of faq questions in a category be displayed beside the category name in the listings. It's also possible to reset the list of faq nodes on the weighting form so that they're sorted by creation date desc / asc.

Bug fixes, code maintenance

• Partial fix for multi-lingual issue reported in #137869
• added in proper support for theming functions
• added changes as suggested by Gurpartap Singh in #138929. Also fixed issue with categorised questions at the top of the page, which was introduced when fixing the theming
• faq.install - added variable_del() calls for new variables added as a result of #138929
• faq.js - added some disabling features for the new ordered/unordered select box which was added arising out of #138929
• fixed t() calls for "back to top" and "more" links
• now handling lists correctly - i.e. using theme("item_list")
• removed commented out code, renamed internal function
• added theming to the lists returned by faq_get_terms() and faq_get_faq_list()
• added in variable_del() on new "faq_count" variable
• Added patch from #140848 which was provided by Gurpartap Singh (user/41470). It does some alteration to the settings forms, but no real new functionality.
• tidied up faq_menu()
• changed all sql queries that had "select n.title, n.nid" to be "select n.nid, n.title". This was a problem with some versions of MySQL after db_rewrite_sql() changes the sql query to have DISTINCT() around the n.nid.
• removed watchdog msg for install() function

Changes since DRUPAL-5--2-1-1:

• fix for issue creating the faq_weights table in postgres as reported in #137691
• fix for issue #137522 - was searching on n.status = 2 rather than 1
• fix for the replace sql issue in postgres as reported in issue #137806
• added in style for faq_arrow class

Changes since DRUPAL-5--2-1:

• patch for issue #136129
• fixed issue #136983 - patch provided by Shiny

• Added in new javascript functions for ordering of the faq nodes
• Added in faq_weights table to the install file

Changes since DRUPAL-5--1-2-1:

• Changed way of passing arguments to db_query()
• Tidied up code and added better handling of nested categories which have no nodes themselves but whose sub-categories do.
• Split out the configuration page into 4 pages using tabs
• Added new jquery functions for disabling parts of the configuration forms depending on which options are selected.
• Added in changes for feature request #129886 - there's now a different way of viewing sub-categories.
• Removed some stray tab characters
• Now including the category header in the FAQ title as suggested by nancyw
• Added in changes for feature request #131116. Breadcrumbs are now implemented on the individual FAQ node pages and the FAQ pages. Taxonomy terms are used in the breadcrumbs if the Taxonomy module is enabled and if there is a taxonomy term associated with it.
• Final change for disabling a checkbox suggested in #sub_cats_handler
• Fixed issue reported in #132504 - title of page in menu was different.
• Now only display categories if they have children
• Changed the faq node type in sql queries from 'FAQ' to 'faq' so as to be consistent.
• Fixed issue reported in #134501 - extra space was appearing when no "back to top" link text was configured.
• Added multi-lingual support, was reported as not working in #134057
• Added sorting of faq nodes as requested in #133788 and #126667
• Change for #131464 and #135165 - updated path to settings config page

Changes since DRUPAL-4-7--1-1:

• added in multi-lingual support, as reported not working in issue #134057

changes for #129886

Changes since DRUPAL-5--1-2:

• added patch supplied by LUTi from issue #129089 plus some fixes.
• fixed typo in html syntax - was causing broken links in the non-categorized 'questions top' layout

Changes since DRUPAL-5--1-1:

• fixed issue reported in #128036 - only the first 10 FAQs were shown when categories was used due to the fact that taxonomy_select_nodes() only returns 10 nodes even when not using paging.
• applied patch from #127831, provided by pearcec, thanks.
• changes for #126380 - based on patch provided by pearcec
• added in new variables to remove
• changed the calls to the caching functions - patch provided by nancyw in #126380
• changed some of the text and added in paragraph tags around the descriptions as suggested by nancyw in #126380.
• patch for #128413
• fixed issue reported in #128497
• added in variable_del() on faq_description_format
• added in an input filter on the general FAQ description text.

Changes since DRUPAL-4-7--1-0-2:

• fixed psql bug reported in #128554
• fix for #128413
• fix for #128744

Changes since DRUPAL-4-7--1-0-1:

• added in input format for issue #66771
• changed the module so the 'view faq' access level is required instead of 'access content' when viewing FAQs requested in #125785

Changes since DRUPAL-5--1-0:

• Fixed bug - 'back to top' link was not working correctly on the individual category pages.
• changes for issue #125598
• changed css class names
• patch for issue #125719
• removed .faq_more_link class settings
• fixed version in faq.info file
• changed the access required to view the faq page from 'access content' to 'view faq'
• made the question and answer views themeable
• ported the 2 faq blocks from the drupal 4.7 version. There are now 'FAQ Categories' and 'Recent FAQs' blocks.
• added ability to configure the number of FAQs that appear in the 'Recent FAQs' block
• updated info on blocks
• added in fix for issue #125802
  added in code for feature request #125962
• added some css contributed by nancyw in #125802
• Now only display 'more' link in teaser views when the teaser text is shorter than the full text, as requested in #125962. Code similar to that provided by nancyw was used.
• Changed 'span' tags to 'p' tags for the 'back to top' links as suggested by nancyw in #125802.
• Fixed bug - 'back to top' link was not working correctly on the individual category pages.

This module allows you to manage and display Frequently Asked Questions nodes. It uses Drupal's taxonomy module to classify questions and provides FAQ-friendly output.

Note the function theme_faq_highlights(), which shows the top five recently-created FAQs. This is called in one of the two blocks this module ships with but can also be called in a php-filtered node if desired.

This is a completely rewritten version of the faq module for DRUPAL-5. If anyone needs some of the features from the old module, please let me know. Likewise if anyone wants a DRUPAL-4.7 version of this module, let me know and I'll see what I can do.

Description
============
The Frequently Asked Questions (faq) module allows users with the 'administer faq' permission to create question and answer pairs which they want displayed on the 'faq' page. The 'faq' page is automatically generated from the FAQ nodes configured and the layout of this page can be modified on the settings page. Users will need the 'access content' permission to view the 'faq' page.

Configuration
=============
Once the module is activated, you can create your question and answer pairs by creating FAQ nodes (Create content >> FAQ). This allows you to edit the question and answer text. In addition, if the 'Taxonomy' module is enabled and there are some terms configured for the FAQ node type, it will also be possible to put the questions into different categories when editing.