statusboard
===========
`|Build Status| <https://travis-ci.org/edigiacomo/django-statusboard>`_
`|Pypi| <https://pypi.python.org/pypi/django-statusboard/>`_
Status page application.
Installation
------------
Install the package
::
pip install django-statusboard
Add the following applications to your Django projects
::
INSTALLED_APPS += [
'django.contrib.humanize',
'rest_framework',
'statusboard',
]
Update your urlconf:
::
# myproject/urls.py
urlpatterns += [
url(r'^statusboard/$', include('statusboard.urls')),
]
Update your database
::
./manage migrate
Configuration
-------------
You can configure the app using the dict ``STATUSBOARD`` in
``settings.py``:
::
STATUSBOARD = {
INCIDENT_DAYS_IN_INDEX: 7,
OPEN_INCIDENT_IN_INDEX: True,
}
- ``INCIDENT_DAYS_IN_INDEX``: number of days to show in index (1 =
today).
- ``OPEN_INCIDENT_IN_INDEX``: show not fixed incidents in index.
Customize pages
---------------
The following blocks are customizable in ``statusboard/base.html``:
- ``title``: title of the page
- ``branding``: branding in fixed navbar
- ``bootstrap_theme``: bootstrap theme
- ``header``: header of the page
- ``userlinks``: links in the header
- ``footer``: footer div
- ``style``: ``CSS`` files
- ``script``: JavaScript files
Example: change branding and title
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Django 1.8
^^^^^^^^^^
Copy ``statusboard/templates/statusboard/base.html`` in one of your
templates dir and edit the file.
Django >= 1.9
^^^^^^^^^^^^^
In Django >= 1.9, the templates can be extended recursively (see
https://docs.djangoproject.com/en/1.10/releases/1.9/).
Create a ``statusboard/base.html`` in one of your templates dir:
::
{% extends `statusboard/base.html %}
{% block title %}
ACME, Inc.
{% endblock %}
{% block branding %}
<a class="navbar-brand" href="{% url 'statusboard:index' %}">ACME status</a>
{% endblock %}
.. |Build
Status| image:: https://travis-ci.org/edigiacomo/django-statusboard.svg?branch=master
.. |Pypi| image:: https://img.shields.io/pypi/v/django-statusboard.svg
===========
`|Build Status| <https://travis-ci.org/edigiacomo/django-statusboard>`_
`|Pypi| <https://pypi.python.org/pypi/django-statusboard/>`_
Status page application.
Installation
------------
Install the package
::
pip install django-statusboard
Add the following applications to your Django projects
::
INSTALLED_APPS += [
'django.contrib.humanize',
'rest_framework',
'statusboard',
]
Update your urlconf:
::
# myproject/urls.py
urlpatterns += [
url(r'^statusboard/$', include('statusboard.urls')),
]
Update your database
::
./manage migrate
Configuration
-------------
You can configure the app using the dict ``STATUSBOARD`` in
``settings.py``:
::
STATUSBOARD = {
INCIDENT_DAYS_IN_INDEX: 7,
OPEN_INCIDENT_IN_INDEX: True,
}
- ``INCIDENT_DAYS_IN_INDEX``: number of days to show in index (1 =
today).
- ``OPEN_INCIDENT_IN_INDEX``: show not fixed incidents in index.
Customize pages
---------------
The following blocks are customizable in ``statusboard/base.html``:
- ``title``: title of the page
- ``branding``: branding in fixed navbar
- ``bootstrap_theme``: bootstrap theme
- ``header``: header of the page
- ``userlinks``: links in the header
- ``footer``: footer div
- ``style``: ``CSS`` files
- ``script``: JavaScript files
Example: change branding and title
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Django 1.8
^^^^^^^^^^
Copy ``statusboard/templates/statusboard/base.html`` in one of your
templates dir and edit the file.
Django >= 1.9
^^^^^^^^^^^^^
In Django >= 1.9, the templates can be extended recursively (see
https://docs.djangoproject.com/en/1.10/releases/1.9/).
Create a ``statusboard/base.html`` in one of your templates dir:
::
{% extends `statusboard/base.html %}
{% block title %}
ACME, Inc.
{% endblock %}
{% block branding %}
<a class="navbar-brand" href="{% url 'statusboard:index' %}">ACME status</a>
{% endblock %}
.. |Build
Status| image:: https://travis-ci.org/edigiacomo/django-statusboard.svg?branch=master
.. |Pypi| image:: https://img.shields.io/pypi/v/django-statusboard.svg
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
django-statusboard-0.3.29.tar.gz
(207.7 kB
view details)
File details
Details for the file django-statusboard-0.3.29.tar.gz.
File metadata
- Download URL: django-statusboard-0.3.29.tar.gz
- Upload date:
- Size: 207.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5ec4c26c733fd74d8c5e979973ea10b8149460f57eedb194dd5b1989fd0ab1b2
|
|
| MD5 |
c405345640aa58f4641acd6bfe00492a
|
|
| BLAKE2b-256 |
ecbb90eeb726ba9a086a030f34c8b032afcb4a8ee4d05272dc9b3489bc600002
|
