Usage

Status bar

To turn the status bar on, login as a sysadmin and head to the system configuration page. There, just set the ckanext.status.message config option. To deactivate it, just remove the contents of the text box.

This extension adds content to the {% block skip %} section of page.html. To add it elsewhere:

{% if h.status_get_message() %}
    {% resource 'ckanext-status/main' %}
    <p id="status-bar">{{ h.status_get_message() }}</p>
{% endif %}

Status page

The status page can be found at /status, or the JSON response can be accessed from the API at /api/3/action/status_list. By default it only contains one status report: the number of queues with pending items. Additional status report items come from other CKAN extensions implementing the IStatus interface.

To add status report items in another extension, add the modify_status_reports method of the IStatus interface in plugin.py:

from ckan.plugins import SingletonPlugin, implements
from ckanext.status.interfaces import IStatus

class ExamplePlugin(SingletonPlugin):
    implements(IStatus)

    def modify_status_reports(self, status_reports):
        status_reports.append({
            'label': 'Example status',
            'value': 'connected',
            'group': 'Examples',  # can be omitted
            'help': 'A description of what this means',
            'state': 'good'  # valid values: good, ok, bad, neutral
        })

        return status_reports