aa-fleetpings (Alliance Auth Fleet Pings)

3.9.4 verified Mon Apr 27 auth: no python

A Fleet Ping Tool for Alliance Auth that enables sending pings via Discord webhooks when fleet operations are created. Current version 3.9.4 supports Python 3.10–3.13 and requires Alliance Auth >=4.9.0. Released monthly or bimonthly since 2021.

pip install aa-fleetpings

Common errors

error ModuleNotFoundError: No module named 'fleetpings' ↓

cause The app is not installed or not added to INSTALLED_APPS.

fix

Run 'pip install aa-fleetpings' and add 'fleetpings' to INSTALLED_APPS in settings.py.

error django.core.exceptions.ImproperlyConfigured: Fleetpings webhook URL is not configured ↓

cause No webhook URL set in admin or environment variable.

fix

Go to Django admin > Fleetpings > FleetPings Settings and set a Discord webhook URL, or set FLEETPINGS_WEBHOOK_URL environment variable.

error AttributeError: module 'fleetpings' has no attribute 'admin' ↓

cause Incorrect import path; some users try 'from fleetpings import admin'.

fix

Use correct import: from fleetpings.admin import FleetPingsSettingsForm

Warnings

breaking As of v3.7.0, the minimum Alliance Auth version is 4.9.0. Older versions will break. ↓

fix Upgrade Alliance Auth to >=4.9.0 before upgrading this app.

gotcha Webhook pings only work if a valid Discord webhook URL is set in admin; no error is shown if missing. ↓

fix Ensure 'EXTERNAL_WEBHOOK_URL' is configured in Fleetpings settings in Django admin.

deprecated The 'eveuniverse' dependency was removed in v3.9.4. Scripts relying on it will need refactoring. ↓

fix Remove any imports from 'eveuniverse' and use built-in Fleetpings helpers instead.

gotcha The 'allianceauth-app-utils' dependency was removed in v3.9.0. If you use those utilities, install them separately. ↓

fix If you need app-utils, install with: pip install allianceauth-app-utils

Imports

FleetPingsSettingsForm
```
from fleetpings.admin import FleetPingsSettingsForm
```
Used to configure webhooks in Django admin.
webhook_send
```
from fleetpings.utils import webhook_send
```
Core function; ensure Discord webhook URL is set.

Quickstart

Basic setup: add 'fleetpings' to INSTALLED_APPS, migrate, and configure webhook in admin.

# settings.py
INSTALLED_APPS += [
    'fleetpings',
]

# Run migrations
# python manage.py migrate fleetpings

# In admin panel, add a Discord webhook URL under Fleetpings settings.