Metadata-Version: 2.1
Name: modoboa-stats
Version: 1.4.1
Summary: Graphical statistics for Modoboa
Home-page: http://modoboa.org/
Author: Antoine Nguyen
Author-email: tonio@ngyn.org
License: MIT
Keywords: email
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django :: 1.11
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Dist: modoboa (>=1.12.0)
Requires-Dist: lxml
Requires-Dist: rrdtool (>=0.1.11)

modoboa-stats
=============

|travis| |codecov| |landscape|

Graphical statistics for Modoboa.

Installation
------------

Install this extension system-wide or inside a virtual environment by
running the following command::

  $ pip install modoboa-stats

Since this extension relies on the ``rrdtool`` package, you may
need to install additional libraries in order to compile it. On a
Debian system, you will require the following packages::

  $ apt-get install librrd-dev

Edit the settings.py file of your modoboa instance and add
``modoboa_stats`` inside the ``MODOBOA_APPS`` variable like this::

    MODOBOA_APPS = (
      'modoboa',
      'modoboa.core',
      'modoboa.lib',
      'modoboa.admin',
      'modoboa.relaydomains',
      'modoboa.limits',
      'modoboa.parameters',
      # Extensions here
      # ...
      'modoboa_stats',
    )

Run the following commands to setup the database tables::

  $ cd <modoboa_instance_dir>
  $ python manage.py collectstatic
  $ python manage.py load_initial_data

Finally, restart the python process running modoboa (uwsgi, gunicorn,
apache, whatever).

Additional documentation is available on `ReadTheDocs <http://modoboa-stats.readthedocs.io/en/latest/>`_.

.. |landscape| image:: https://landscape.io/github/modoboa/modoboa-stats/master/landscape.svg?style=flat
   :target: https://landscape.io/github/modoboa/modoboa-stats/master
   :alt: Code Health

.. |travis| image:: https://travis-ci.org/modoboa/modoboa-stats.svg?branch=master
   :target: https://travis-ci.org/modoboa/modoboa-stats

.. |codecov| image:: https://codecov.io/gh/modoboa/modoboa-stats/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/modoboa/modoboa-stats


