Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/modoboa/modoboa-contacts

Address book for Modoboa
https://github.com/modoboa/modoboa-contacts

contacts django modoboa vuejs2

Last synced: 4 days ago
JSON representation

Address book for Modoboa

Awesome Lists containing this project

README

        

Address book plugin for Modoboa
===============================

|gha| |codecov|

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

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

$ pip install modoboa-contacts

Edit the settings.py file of your modoboa instance and apply the following modifications:

- add ``modoboa_contacts`` 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_contacts',
)

- Add the following at the end of the file::

from modoboa_contacts import settings as modoboa_contacts_settings
modoboa_contacts_settings.apply(globals())

Finally, run the following commands to setup the database tables::

$ cd
$ python manage.py migrate
$ python manage.py collectstatic
$ python manage.py load_initial_data

For developers
---------------

The frontend part of this plugin is developed with `VueJS 2 `_ and
requires `nodejs `_ and `webpack `_.

Once nodejs is installed on your system, run the following commands::

$ cd frontend
$ npm install
$ npm run serve

To update dist files (the ones that will be distributed with the plugin), run::

$ npm run build

.. |gha| image:: https://github.com/modoboa/modoboa-contacts/actions/workflows/plugin.yml/badge.svg
:target: https://github.com/modoboa/modoboa-contacts/actions/workflows/plugin.yml

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