aa-contacts 0.3.0

Contacts tool for AllianceAuth

AllianceAuth Contacts

This is a plugin for AllianceAuth that lets alliances and corporations track and manage their contacts (i.e. standings).

Overview

Tracking an Alliance or Corporation

Users with the right permission can add an alliance or corporation just by clicking on the + button in the index page.

Viewing Contacts

The index page shows all the alliances and corporations that have been added and are available for that user, that means every alliance or corporation in which the user has a character. Superusers can see all the alliances and corporations.

In every alliance or corporation view, the user can see the contacts and their standings. If it has the right permissions, the user can see and edit notes or trigger a manual update of the contacts.

Secure Groups integration

If the Secure Groups plugin is installed, a new smart filter will appear in the admin panel of AA Contacts. It allows to filter users by the standings a corporation or alliance has set for them or their groups.

Note: when multiple corporations/alliances are set, the logic applies an OR condition, i.e. it is sufficient that at least 1 corp/alliance meets the requirement for the filter to pass. If you want to apply an AND condition, you need to create one filter per condition and put them together in the smart group.

Installation

1. Install the package. If you have a traditional installation, run the following command in your terminal:

   pip install aa-contacts
   

   If you have a Docker installation instead, add to your requirements.txt file:

   aa-contacts==x.y.z
   

   with the desired version and rebuild the Docker stack.

2. Add 'aa_contacts', to your INSTALLED_APPS in local.py.

3. Run migrations and collectstatic:

   python manage.py migrate
   python manage.py collectstatic
   

   or, if you are on docker:

   auth migrate
   auth collectstatic
   

4. Add the update task at the end of the local.py:

   # AA Contacts
   CELERYBEAT_SCHEDULE['aa_contacts_update_all_contacts'] = {
       'task': 'aa_contacts.tasks.update_all_contacts',
       'schedule': crontab(minute='24'),
   }
   

5. Restart Supervisor if you are on a traditional install or the docker stack if you are on docker.

Permissions

Permission	Description
manage_alliance_contacts	Can add tokens for the alliance and trigger manual updates
manage_corporation_contacts	Can add tokens for the corporation and trigger manual updates
view_alliance_notes	Can view contact notes for alliance contacts. If combined with manage_alliance_contacts, can also edit notes.
view_corporation_notes	Can view contact notes for corporation contacts. If combined with manage_corporation_contacts, can also edit notes.