hschottm / faqextensions
Extends the FAQ bundle in Contao. The bundle allows you to highlight very popular FAQ articles or your personal recommendations in the Contao frontend. It also introduces voting support for FAQ articles.
Installs: 228
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 3
Forks: 1
Open Issues: 4
Type:contao-bundle
Requires
- php: ^7.4 || ^8.0
- contao/core-bundle: ~4.13
- contao/faq-bundle: ~4.13
Requires (Dev)
- contao/manager-plugin: ^2.3.1
- phpunit/phpunit: ^9.3
- symfony/phpunit-bridge: ^5.4
Conflicts
- contao/manager-plugin: <2.0 || >=3.0
This package is auto-updated.
Last update: 2024-10-24 16:12:41 UTC
README
faqextensions
faqextensions extends the FAQ bundle support in Contao. The extension allows you to highlight very popular FAQ entries or your personal recommendations in the Contao frontend to make your FAQ section even better. This Contao bundle brings you the following improvements to the FAQ bundle:
- FAQ list module: Most viewed - lists your FAQs by the most viewed FAQ articles, includes optional pagination
- FAQ list module: Most recent - lists your FAQs by the most recent added FAQ articles, includes optional pagination
- FAQ list module: Recommended - lists all your recommended FAQ articles, includes optional pagination and custom sort orders
- FAQ list module: Most helpful - lists your FAQs by the most helpful articles based on a helpful vote by the users, includes optional pagination
The faqextensions bundle adds a viewcount
counter for each FAQ that increases with every view in the frontend. Each FAQ article gets a Recommended
checkbox to make the article as recommended in the backend. Each FAQ article gets a Show helpful
checkbox to show the helpful vote at the end of an article in the frontend to allow the users to vote an article up or down.
Extension of existing Data Container Arrays
tl_faq
The tl_faq
dca has been extended with some new database fields.
viewcount
viewcount
adds an integer counter to each FAQ article. Each time an entry will be viewed in the frontend, the counter is increased by 1 containing the abolute number of views for this FAQ article. A new module Most frequently viewed FAQ list lists FAQ entries ordered by the number of their absolute view count to present the most viewed FAQ entries.
$GLOBALS['TL_DCA']['tl_faq']['fields']['viewcount'] = array( 'sql' => "int(10) unsigned NOT NULL default '0'" );
recommended
recommended
is a boolean field that can be checked in the backend for each FAQ article to mark it as recommended or important. A new module Recommended FAQ list lists all FAQ articles which are marked as recommended.
$GLOBALS['TL_DCA']['tl_faq']['fields']['recommended'] = array( 'label' => &$GLOBALS['TL_LANG']['tl_faq']['recommended'], 'exclude' => true, 'filter' => true, 'eval' => array('tl_class'=>'w50 m12'), 'inputType' => 'checkbox', 'sql' => "char(1) NOT NULL default ''" );
helpful, nothelpful, showhelpful
showhelpful
is a boolean field that can be checked in the backend for each FAQ article to show a helpful vote in the frontend for that article. Each helpful vote will increase the integer value of the helpful
integer field, each not helpful vorte will increase the value of the nothelpful
integer field. The module Helpful FAQ list lists all FAQ entries ordered by their helpful votes.
$GLOBALS['TL_DCA']['tl_faq']['fields']['helpful'] = array( 'sql' => "int(10) unsigned NOT NULL default '0'" ); $GLOBALS['TL_DCA']['tl_faq']['fields']['nothelpful'] = array( 'sql' => "int(10) unsigned NOT NULL default '0'" ); $GLOBALS['TL_DCA']['tl_faq']['fields']['showhelpful'] = array( 'label' => &$GLOBALS['TL_LANG']['tl_faq']['showhelpful'], 'exclude' => true, 'filter' => true, 'eval' => array('tl_class'=>'w50 m12'), 'inputType' => 'checkbox', 'sql' => "char(1) NOT NULL default ''" );
Modules
Most frequently viewed FAQ list
This module creates a list of the most frequently viewed FAQ articles ordered by their view count. You can limit the number of entries and use pagination for this list. The order of the FAQ articles is always descending by viewcount
so the most fequently viewed entry is on top of the list.
Recommended FAQ list
This module creates a list of all FAQ articles marked as recommended. You can limit the number of entries and use pagination for this list and you can set the sorter order for the entries to alphabetical by FAQ title or by creation date of the FAQ entry, both ascending and descending.
Helpful FAQ list
This module creates a list of the most helpful FAQ articles, odered by their helpful vote. You can limit the number of entries and use pagination for this list. The order of the FAQ articles is always descending by their helpfulness calculated by the sum of the helpful and not helpful votes. The not helpful votes count as negative values.
Recent FAQ list
This module creates a list of all FAQ articles ordered descending by the most recently added article using the tstamp
field of each article. You can limit the number of entries and use pagination for this list.