PHPackages                             hschottm/faqextensions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. hschottm/faqextensions

ActiveContao-bundle

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.

4.6.0(3y ago)22351[3 issues](https://github.com/hschottm/faqextensions/issues)[1 PRs](https://github.com/hschottm/faqextensions/pulls)LGPL-3.0+PHPPHP ^7.4 || ^8.0

Since Nov 23Pushed 3y ago2 watchersCompare

[ Source](https://github.com/hschottm/faqextensions)[ Packagist](https://packagist.org/packages/hschottm/faqextensions)[ RSS](/packages/hschottm-faqextensions/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (6)Dependencies (5)Versions (7)Used By (0)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c23a78d5d2d12dc9a98d76d3df1fb98ebebbe9512eaef2046e0507a9800b283f/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f687363686f74746d2f666171657874656e73696f6e732e7376673f7374796c653d666c6174)](https://packagist.org/packages/hschottm/faqextensions)[![Installations via composer per month](https://camo.githubusercontent.com/a312c59a98d659f12867585f4c971f66b8779909cefaa634bbedef56802c1975/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f687363686f74746d2f666171657874656e73696f6e732e7376673f7374796c653d666c6174)](https://packagist.org/packages/hschottm/faqextensions)[![Installations via composer total](https://camo.githubusercontent.com/1bea2000cc802f03d6a346852db4576d5d109b9881b66b8d300917f3c40badf2/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f687363686f74746d2f666171657874656e73696f6e732e7376673f7374796c653d666c6174)](https://packagist.org/packages/hschottm/faqextensions)

faqextensions
=============

[](#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
-------------------------------------------

[](#extension-of-existing-data-container-arrays)

### tl\_faq

[](#tl_faq)

The `tl_faq` dca has been extended with some new database fields.

#### viewcount

[](#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)

`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 ''"
);
```

[![faqextensions_expert_settings](https://user-images.githubusercontent.com/873113/48935073-a01e9080-ef06-11e8-83dd-26d129117d02.png)](https://user-images.githubusercontent.com/873113/48935073-a01e9080-ef06-11e8-83dd-26d129117d02.png)

#### helpful, nothelpful, showhelpful

[](#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 ''"
);
```

[![faqextensions_expert_settings](https://user-images.githubusercontent.com/873113/48935073-a01e9080-ef06-11e8-83dd-26d129117d02.png)](https://user-images.githubusercontent.com/873113/48935073-a01e9080-ef06-11e8-83dd-26d129117d02.png)

Modules
-------

[](#modules)

### Most frequently viewed FAQ list

[](#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.

[![faqexentensions_mostfrequent_list](https://user-images.githubusercontent.com/873113/48936106-1ec8fd00-ef0a-11e8-9ece-c2246dbc9d5e.png)](https://user-images.githubusercontent.com/873113/48936106-1ec8fd00-ef0a-11e8-9ece-c2246dbc9d5e.png)

### Recommended FAQ 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.

[![faqextensions_recommended_list](https://user-images.githubusercontent.com/873113/48936109-1f619380-ef0a-11e8-9307-b373a2acfd92.png)](https://user-images.githubusercontent.com/873113/48936109-1f619380-ef0a-11e8-9307-b373a2acfd92.png)

### Helpful FAQ list

[](#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.

[![faqextensions_helpful_list](https://user-images.githubusercontent.com/873113/48936107-1ec8fd00-ef0a-11e8-86e0-5cde37ed8ff5.png)](https://user-images.githubusercontent.com/873113/48936107-1ec8fd00-ef0a-11e8-86e0-5cde37ed8ff5.png)

### Recent FAQ list

[](#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.

[![faqextensions_recent_list](https://user-images.githubusercontent.com/873113/48936108-1ec8fd00-ef0a-11e8-8684-8194f70791e4.png)](https://user-images.githubusercontent.com/873113/48936108-1ec8fd00-ef0a-11e8-8684-8194f70791e4.png)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~335 days

Total

5

Last Release

1385d ago

PHP version history (2 changes)4.4.0PHP &gt;=5.6.0

4.6.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/3daa3e16ba2d9038e401e58eab590d06f1dcaa15417091e8414c2ed4d9460cc3?d=identicon)[hschottm](/maintainers/hschottm)

---

Top Contributors

[![hschottm](https://avatars.githubusercontent.com/u/873113?v=4)](https://github.com/hschottm "hschottm (53 commits)")

---

Tags

extensionmodulecontaoFAQhelpful

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/hschottm-faqextensions/health.svg)

```
[![Health](https://phpackages.com/badges/hschottm-faqextensions/health.svg)](https://phpackages.com/packages/hschottm-faqextensions)
```

###  Alternatives

[hschottm/tags

tags is a Contao extension that provides an architecture to tag any Contao element.

1215.0k](/packages/hschottm-tags)[dma/dma_simple_grid

Contao Extension for simple multiple grid-support

1020.0k](/packages/dma-dma-simple-grid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
