AA Contacts

0.11.1 verified Mon Apr 27 auth: no python

A contacts management plugin for Alliance Auth that synchronizes EVE Online contacts from ESI. Current version: 0.11.1. Released on an irregular cadence, with active maintenance.

pip install aa-contacts

Common errors

error ModuleNotFoundError: No module named 'aa_contacts' ↓

cause The package is not installed or the app is not in INSTALLED_APPS.

fix

Run pip install aa-contacts and add 'aa_contacts' to your INSTALLED_APPS setting.

error django.core.exceptions.ImproperlyConfigured: App with label aa_contacts could not be found ↓

cause Typo in INSTALLED_APPS or missing migration.

fix

Double-check that INSTALLED_APPS contains 'aa_contacts' and run ./manage.py migrate.

Warnings

breaking v0.11.0 removed dependency on `allianceauth-app-utils`. If you use `aa-charlink`, you must upgrade to `aa-charlink>=1.13.0`. Earlier versions will not display contacts via charlink. ↓

fix Upgrade aa-charlink to >=1.13.0.

breaking v0.10.0 dropped support for Python 3.9. Ensure your environment uses Python 3.10+. ↓

fix Upgrade Python to 3.10 or higher.

gotcha The new frontend (React) is default from v0.9.0. The 'Update' button triggers an asynchronous task and does not wait for completion. This is different from the old UI's synchronous behavior. ↓

fix Expect the update to happen in the background; check back later.

Imports

Contacts
```
from aa_contacts.models import Contacts
```
Correct import path for the main model
update_contacts_for_character
```
from aa_contacts.tasks import update_contacts_for_character
```
A task used to trigger contact updates

Quickstart

Basic setup for AA Contacts in an Alliance Auth project

# Add 'aa_contacts' to INSTALLED_APPS in your Alliance Auth settings
INSTALLED_APPS += ['aa_contacts']

# Then run migrations
# ./manage.py migrate

# In your urls.py
from django.urls import path, include
urlpatterns += [path('contacts/', include('aa_contacts.urls'))]