Pinax is an open-source platform built on the Django Web Framework. It is an ecosystem of reusable Django apps, themes, and starter project templates. This collection can be found at http://pinaxproject.com.
pinax-forums
is an extensible forums app for Django and Pinax. It is focused
on core forum functionality and hence is expected to be combined with other
Pinax apps for broader features.
Django \ Python | 2.7 | 3.4 | 3.5 | 3.6 |
---|---|---|---|---|
1.11 | * | * | * | * |
2.0 | * | * | * |
To install pinax-forums:
$ pip install pinax-forums
Add pinax.forums
to your INSTALLED_APPS
setting:
INSTALLED_APPS = [
# other apps
"pinax.forums",
]
Add pinax.forums.urls
to your project urlpatterns:
urlpatterns = [
# other urls
url(r"^forums/", include("pinax.forums.urls", namespace="pinax_forums")),
]
Allow changes for up to PINAX_FORUMS_EDIT_TIMEOUT
seconds after creating a post.
Once this period has expired the post is no longer editable.
The templates referenced by pinax-forums code must be supplied by the user.
Place template files in a pinax/forums/
subfolder in your project template search path.
category.html
forum.html
forums.html
post_create.html
post_edit.html
reply_create.html
subscribe.html
thread.html
thread_updates.html
unsubscribe.html
pinax-forums
was originally built by Eldarion and
called agora
. It incorporates code and ideas from various client projects.
The clients were kind enough to allow Eldarion to open source the app and
contribute it to Pinax.
For an overview on how contributing to Pinax works read this blog post and watch the included video, or read our How to Contribute section. For concrete contribution ideas, please see our Ways to Contribute/What We Need Help With section.
In case of any questions we recommend you join our Pinax Slack team and ping us there instead of creating an issue on GitHub. Creating issues on GitHub is of course also valid but we are usually able to help you faster if you ping us in Slack.
We also highly recommend reading our blog post on Open Source and Self-Care.
In order to foster a kind, inclusive, and harassment-free community, the Pinax Project has a code of conduct. We ask you to treat everyone as a smart human programmer that shares an interest in Python, Django, and Pinax with you.
For updates and news regarding the Pinax Project, please follow us on Twitter @pinaxproject and check out our Pinax Project blog.
Copyright (c) 2012-2019 James Tauber and contributors under the MIT license.