Skip to main content

A reusable Django app that allows to attach Q&As to any Django model instance

Project description

A reusable Django app that allows to attach Q&As to any Django model instance.

Currently the app provides the models for adding translated questions and answers as well as a template tag to render them from a default template, you can of course override and customize according to your needs.

Future updates might include forms, that allow users to send their own questions, but it is currently not implemented. Contributions are welcome =)


To get the latest stable release from PyPi

pip install django-object-faq

To get the latest commit from GitHub

pip install -e git+git://

Add object_faq to your INSTALLED_APPS


Before your tags/filters are available in your templates, load them by using

{% load object_faq_tags %}

Don’t forget to migrate your database

./ migrate object_faq


In your django admin, you can create the Entry objects with questions and answers to be rendered on the page. position is the default ordering of the queryset.

Additionally you can setup a GlobalObjectDescription object per model instance. This will render a general title and description, you might want to use as introductory text for the object’s FAQ or just as general object description.

Then you only need to add the template tag for the object in the context. .. code-block:: html

{% load object_faq_tags %}

{% render_faq_for_object myobject %}

This will automatically render the tempalte located at object_faq/partials/object_faq.html.


If you want to contribute to this project, please perform the following steps

# Fork this repository
# Clone your fork
mkvirtualenv -p python2.7 django-object-faq
make develop

git co -b feature_branch master
# Implement your feature and tests
git add . && git commit
git push -u origin feature_branch
# Send us a pull request for your feature branch

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-object-faq, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size django-object-faq-0.1.tar.gz (9.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page