Documentation for FAQ U! module v1.5 & v1.6

Use your FTP client (ex: filezilla) and connect to your FTP domain. Unzip the file faq-u-module.zip and upload in the "modules" folder of your Prestashop root.



Once finished, don't forget to activate the module by clicking on the "Install" green button in the w4wfaq module block. This is only needed when installing. Upgrade will just overwrite the needed files and your modules will already be activated.

Go in the module section in your Prestashop Back-Office, click on the "Add a new module" button on the top right of the page, then choose your faq-u-module.zip and upload.



Once finished, don't forget to activate the module by clicking on the "Install" green button in the w4wfaq module block. This is only needed when installing. Upgrade will just overwrite the needed files and your modules will already be activated.

If your install process went OK you should see a new tab entry at the bottom of the "Preferences" main tab.



Otherwise, click on "Configure" in your FAQ-U block module in the modules list.

Once in the configuration page, choose a CMS page to hook the module. The module is appended at the bottom of the page, so you can customize the top part as you wish.



Don't forget to previously add a new CMS page if you want a dedicated URL for your FAQ.
To do so click on the "CMS" tab in "Preferences", and add a new CMS page.

Add a category by clicking on "New category".



Enter the name, choose the language if activated and save.



You can move, delete and edit your categories by clicking on the corresponding icons like shown on the picture below.

Add a new entry by clicking on "New entry" in the corresponding block of your category.



Write your question/title in the fisrt field, your answer/text in the text area, choose whether or not if you want to display the question answered button.
Finally you can choose the category and save.



You can move, edit and delete your category by clicking on the corresponding icons.

As we saw in the previous panel, you can choose to display this button as shown below.



By default it will display a link to your contact page, in the appropriate language.
You can choose to add a phone number by checking "Show Phone Number" at the top of the page. Don't forget to enter it in the field beneath the checkbox and save.

Now you can add Font Awesome icons in front of both your entries and categories titles.
Just pick an icon as shown below and it will display in your front page.

Some of you guys asked many times that feature. Now you can disable the collapsed effect on entries by choosing between the two options as shown in the picture below. Don't forget to save your choice.

You have the possibility to add a custom css file that will override all css styles.
Just create a file named "w4wfaq.custom.css" in the css folder of your module. It will be automatically detected.

By default FAQ U! module is translated in french and english.
Feel free to modify the texts via the translation feature in Prestashop
Go to Localization >> Translations and select the options as shown below and click on "Modify".



Look for "w4wfaq" module at the bottom of the page and modify your translations as you wish. The "Simple" section contains the whole translations for the Front Office. The rest of the translations is for the Back Office.

FAQ-U Module needs to override a core PrestaShop controller (CmsController) in order to work and hook the FAQ to a CMS page
PrestaShop's way of overriding core for modules has a limitation : two modules can't override the same method of a given class/controller
If you have another module overriding the CmsController, it will not work. A popular module that is in this case is "smartshortcode".
To fix this issue, you have to "merge" both overrides. Check the comment page on CodeCanyon to see fixes proposed to users that had this issue.
It might look complicated but it really is not.
In a nutshell, this is what you have to do :

  1. Get the CmsController.php file from the override/controllers/front/ folder at the root of your prestashop install. We'll call it root file. Make sure you backup it somewhere.
  2. Get the CmsController.php file from the override/controllers/front/ folder inside the zip archive of FAQ-U module (or in the modules/w4wfaq/ folder of your prestashop install). We'll call it module file.
  3. Figure out how to include the content of module file into root file
    This should be pretty obvious. In module file there is a if block that contains four lines, you basicly want to copy paste the if block and its contents into the root file, preferably at the very end of the initContent() function, or at the very least after the parent::initContent(); line.
  4. Once you're done with it, you can reupload the modified root file where you took it from.
  5. Go to the modules/w4wfaq/override/controllers/front/ folder of your prestashop and delete the CmsController.php file. If you later need this file again, take it from the zip you got from codecanyon
  6. Install FAQ-U module
  7. (optionnal) If things don't seem to work, you can delete the class_index.php file that is in the cache/ folder at the root of your prestashop install. This file is automaticly generated if it's missing.

Warning : When you do this, it will work but there's a caveat. If you uninstall the other module that had the override, FAQ-U will stop working (since the needed code in CmsController.php is gone). To fix this, just get the CmsController.php file of the override/controllers/front/ folder in the zip you got from codecanyon's FAQ-U module, and put it back in the root override/controllers/front/. If necessary, do the class_index.php deletion again. This should fix. You also should put that CmsController.php back into modules/w4wfaq/override/controllers/front so that it properly goes away if you uninstall. The code is error-proof so it's no big deal if you leave it there.

If this fails, post a comment on the module's page and we'll give you a hand

Several points to check :

  • The module is Installed AND Enabled
  • You can Access the "Faq Administration" Page in the back office (preferences menu)
  • In this Page, you have hooked the FAQ to a CMS page (in the first combo box)
  • You can see that CMS Page on front office
  • You have not disabled overrides in 1.6+ only : Back Office > Advanced Parameters > Performance > Disable all overrides must be on "NO"

If all of this is correct, feel free to contact us on the comments page of the module on codecanyon

This is most likely because you forgot to put the translations for your FAQ categories/entries in the language you're trying to see them on. Go the FAQ Administration, and make sure by editing the entries/categories AND switching the language next to the text fields that everything is okay