Django application that provides a simple and modern forum board software for your Django website.
Project description
PunkwebBB
PunkwebBB is a Django application that provides a simple and modern forum board software for your Django website.
Check out punkweb.net for documentation, support and a live demonstration of the software.
Built with
Requirements
- Python 3.9+
- Django 4.0+
It may work with older versions of Python and Django, but it has not been tested.
BBCode or Markdown?
PunkwebBB supports both BBCode and Markdown. You'll want to decide before installing which parser you want to use, as switching between them will cause existing threads, posts, signatures, etc. to render incorrectly! Switching will not affect the database schema, but it will affect the content.
BBCode is the default parser, but you can switch to Markdown by setting the following in your Django settings module:
PUNKWEB_BB = {
"PARSER": "markdown",
}
Installation
pip install punkweb-bb
Add punkweb_bb
to your INSTALLED_APPS
in your Django settings module:
INSTALLED_APPS = [
...
"punkweb_bb",
]
Add the following context processor to your TEMPLATES
setting:
TEMPLATES = [
{
...
"OPTIONS": {
"context_processors": [
...
"punkweb_bb.context_processors.punkweb_bb",
],
},
},
]
Add the following URL pattern to your urls.py
:
from django.urls import path, include
urlpatterns = [
...
path("forum/", include("punkweb_bb.urls")), # or any other path you want
]
And finally, install the models:
python manage.py migrate
Configuration
These are the default settings for PunkwebBB, which can be overridden in your Django settings module:
PUNKWEB_BB = {
"SITE_NAME": "PUNKWEB",
"SITE_TITLE": "PunkwebBB",
"PARSER": "bbcode", # "bbcode" or "markdown"
"FAVICON": "punkweb_bb/favicon.ico",
"OG_IMAGE": None, # Used for Open Graph meta tags, must be a full URL!
"SHOUTBOX_ENABLED": True,
"DISCORD_WIDGET_ENABLED": False,
"DISCORD_WIDGET_THEME": "dark",
"DISCORD_SERVER_ID": None, # Found under Server Settings > Widget > Server ID
}
Testing
Report:
coverage run && coverage report
HTML:
coverage run && coverage html
Found 59 test(s).
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
...........................................................
----------------------------------------------------------------------
Ran 59 tests in 8.994s
OK
Destroying test database for alias 'default'...
Name Stmts Miss Cover
------------------------------------------------------------------
punkweb_bb/__init__.py 0 0 100%
punkweb_bb/admin.py 42 0 100%
punkweb_bb/admin_forms.py 34 0 100%
punkweb_bb/apps.py 6 0 100%
punkweb_bb/bbcode.py 82 68 17%
punkweb_bb/context_processors.py 3 0 100%
punkweb_bb/forms.py 47 0 100%
punkweb_bb/guests.py 13 0 100%
punkweb_bb/middleware.py 14 0 100%
punkweb_bb/mixins.py 11 0 100%
punkweb_bb/models.py 153 1 99%
punkweb_bb/pagination.py 11 4 64%
punkweb_bb/response.py 3 0 100%
punkweb_bb/settings.py 11 0 100%
punkweb_bb/signals.py 9 0 100%
punkweb_bb/templatetags/__init__.py 0 0 100%
punkweb_bb/templatetags/can_delete.py 5 0 100%
punkweb_bb/templatetags/can_edit.py 5 0 100%
punkweb_bb/templatetags/can_post.py 5 0 100%
punkweb_bb/templatetags/humanize_int.py 9 5 44%
punkweb_bb/templatetags/render.py 28 7 75%
punkweb_bb/templatetags/styled_group_name.py 7 1 86%
punkweb_bb/templatetags/styled_username.py 6 0 100%
punkweb_bb/tests.py 418 0 100%
punkweb_bb/urls.py 4 0 100%
punkweb_bb/utils.py 42 23 45%
punkweb_bb/views.py 304 118 61%
punkweb_bb/widgets.py 16 0 100%
------------------------------------------------------------------
TOTAL 1288 227 82%
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for punkweb_bb-0.4.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8de323fa0bc334a2af95fc98d0bddf50171e91d769ad4d6e17045fed1cafd90e |
|
MD5 | 279125a2b9dff96a474126cc7d2d04ae |
|
BLAKE2b-256 | 880e29104234e662993a63785fd1fe6ae0f74a255f9f23170f494f42e4d750b4 |