Symfony FAQ bundle

v1.0.7 2017-04-24 09:34 UTC


The GenjFaqBundle allows you to display a FAQ on your website, with the questions being grouped in categories. Features:

  • Questions are grouped into Categories
  • Categories can be deactivated
  • Can show all information at once, or collapse questions/categories for big FAQs that is basically up to you - how you are handling this in the template
  • Collapsed mode generates SEO friendly URLs


see composer.json


Add this to your composer.json:

    "require": {
        "gedmo/doctrine-extensions": ">=2.4.10",
        "genj/faq-bundle": "dev-master"

Then run composer update. After that is done, enable the bundle in your AppKernel.php:

# app/AppKernel.php
class AppKernel extends Kernel
    public function registerBundles() {
        $bundles = array(
            new Genj\FaqBundle\GenjFaqBundle()

Add the routing rules to your routing.yml:

# app/config/routing.yml
    resource: "@GenjFaqBundle/Resources/config/routing.yml"

Finally, update your database schema:

php bin/console doctrine:schema:update --dump-sql

use the --force option to actually execute the DB update.

And you're done. You should now be able to reach the bundle under the URL if you did add at least one category in your DB.

Optional: loading fixtures

If you use the doctrine-fixtures bundle, you can load fixtures like this:

php bin/console doctrine:fixtures:load --fixtures=vendor/genj/faq-bundle/src/Genj/FaqBundle/DataFixtures/


You can optionally include the configuration below into your config.yml:

    select_first_category_by_default: false
    select_first_question_by_default: false

Both configuration will open the first category and/or question by default if the user has not chosen a category and/or question yet. The default for both values is 'false', so set them to 'true' if you want this behaviour.

Note that it is also required to have the Sluggable and Timestampable behaviours configured for gedmo/doctrine-extensions (see


As soon you want more than the default category listing with all questions + answers you shouldn't import the bundle route, but copy only the part you are actualy using.

e.g. if you want single pages for each question use the genj_faq_question_show route.

For further examples see


  • How do I add this to SonataAdmin?

You can use the GenjFaqAdminBundle: or just create your own admin class.