Skip to main content

AA Fleet Pings

Version License Python Django pre-commit pre-commit.ci status Code Style: black Checks codecov Translation status Contributor Covenant Discord Alliance Auth Compatibility

ko-fi

App for Alliance Auth that can format your fleet pings and ping for you to Discord.



Screenshots

View in Alliance Auth

View in Alliance Auth

Discord Ping Examples

Pre-Ping

Discord Ping Example: Pre-Ping

Formup: NOW

Discord Ping Example: Formup NOW

Installation

This app is a plugin for Alliance Auth. If you don't have Alliance Auth running already, please install it first before proceeding. (See the official AA installation guide for details)

[!NOTE]

You also want to make sure that you have the Discord service installed, configured and activated before installing this app.

Bare Metal Installation

Step 1: Install the App

Make sure you're in the virtual environment (venv) of your Alliance Auth installation. Then install the latest version:

pip install aa-fleetpings==4.1.1

Step 2: Update Your AA Settings

Configure your AA settings (local.py) as follows:

  • Add 'fleetpings', to INSTALLED_APPS

Step 3: Finalizing the Installation

Copy static files and run migrations

python manage.py collectstatic
python manage.py migrate

Restart your supervisor services for AA

Continue with the common setup steps below.

Docker Installation

Step 1: Add the App

Add the app to your conf/requirements.txt:

aa-fleetpings==4.1.1

Step 2: Update Your AA Settings

Configure your AA settings (conf/local.py) as follows:

  • Add 'fleetpings', to INSTALLED_APPS

Step 3: Build Auth and Restart Your Containers

Run the following commands from your AA project directory (the one that contains docker-compose.yml):

docker compose build --no-cache
docker compose --env-file=.env up -d

Step 4: Finalizing the Installation

Copy static files and run migrations

docker compose exec allianceauth_gunicorn bash

auth collectstatic
auth migrate

Continue with the common setup steps below.

Common Setup Steps

Permission Setup

Now you can set up permissions in Alliance Auth for your users. Add fleetpings | aa fleetpings | Can access this app to the states and/or groups you would like to have access.

App Setup

In your admin backend you'll find a new section called Fleet Pings. This is where you set all your stuff up, like the webhooks you want to ping and who can ping them, fleet types, comms, formup locations, and so on. It's pretty straight forward, so you shouldn't have any issues. Go nuts!

Updating

Bare Metal Installation

To update your existing installation of AA Discord Ping Formatter, first enable your virtual environment.

Then run the following commands from your AA project directory (the one that contains manage.py).

pip install aa-fleetpings==4.1.1

python manage.py collectstatic
python manage.py migrate

Finally, restart your AA supervisor services.

Docker Installation

To update your existing installation of AA Fleet Pings, all you need to do is to update the respective line in your conf/requirements.txt file to the latest version.

aa-fleetpings==4.1.1

Now rebuild your containers:

docker compose build --no-cache
docker compose --env-file=.env up -d

After that, run the following commands to update your database and static files:

docker compose exec allianceauth_gunicorn bash

auth collectstatic
auth migrate

Configuration

The following settings are available in the Django Admin Backend under /admin/fleetpings/setting/:

Use Default Fleet Types

Enable or disable the default fleet types (Roaming, Home Defense, StratOP, and CTA) that are shown in the fleet type dropdown in addition to your own.

Default: True

Use Default Ping Targets

Enable or disable the default ping targets (@everyone and @here) that are shown in the ping target dropdown in addition to your own.

Default: True

Use Doctrines From Fittings Module

If you have the Fittings and Doctrines module installed, and your doctrines configured there, you don't have to re-build your doctrine list for this module. You can simply use the doctrines you already have configured in the Fittings and Doctrines module.

Default: True

Webhook Verification

If you require your pings to be sent to a webhook, that is not a standard discord webhook.

When disabling webhook verification and using non-Discord webhooks, it is up to you to make sure your webhook understands a payload that is formatted for Discord webhooks.

Default: True

Default Embed Color

The default highlight for the embed, that is used when no other highlight color is defined.

Default: #FAA61A

Changelog

See CHANGELOG.md

Translation Status

Translation status

Do you want to help translate this app into your language or improve the existing translation? - Join our team of translators!

Contributing

You want to contribute to this project? That's cool!

Please make sure to read the Contribution Guidelines.
(I promise, it's not much, just some basics)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aa_fleetpings-4.1.1.tar.gz (163.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aa_fleetpings-4.1.1-py3-none-any.whl (262.0 kB view details)

Uploaded Python 3

File details

Details for the file aa_fleetpings-4.1.1.tar.gz.

File metadata

  • Download URL: aa_fleetpings-4.1.1.tar.gz
  • Upload date:
  • Size: 163.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aa_fleetpings-4.1.1.tar.gz
Algorithm Hash digest
SHA256 9ce36ae08bb7b77221815d1ea7c79ace61ed21643f3494c7998301b7f3c7348c
MD5 c808c220980a6f18abda8cec197a9ed6
BLAKE2b-256 9e074d407fc93d947bdb3ecfd6dce57dbb571324a6d07ffd27eed2ae6fb773c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for aa_fleetpings-4.1.1.tar.gz:

Publisher: release.yml on ppfeufer/aa-fleetpings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aa_fleetpings-4.1.1-py3-none-any.whl.

File metadata

  • Download URL: aa_fleetpings-4.1.1-py3-none-any.whl
  • Upload date:
  • Size: 262.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aa_fleetpings-4.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 34a5798e28f5ec090cc3d5d29fe5ae0820194e6c1433847c542f064b14825708
MD5 f9d63755a4e18cb085f2aedc9c41b188
BLAKE2b-256 5ad37aac94fad6888a65f8fcf0c61f9ac7b386c4c05d849bacedf66acaa61603

See more details on using hashes here.

Provenance

The following attestation bundles were made for aa_fleetpings-4.1.1-py3-none-any.whl:

Publisher: release.yml on ppfeufer/aa-fleetpings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

4.1.1 This release

2 files

4.1.0

2 files

4.0.1

2 files

4.0.0

2 files

3.10.0

2 files

3.9.5

2 files

3.9.4

2 files

3.9.3

2 files

3.9.2

2 files

3.9.1

2 files

3.9.0

2 files

3.8.3

2 files

3.8.2

2 files

3.8.1

2 files

3.8.0

2 files

3.7.2

2 files

3.7.1

2 files

3.7.0

2 files

3.6.2

2 files

3.6.1

2 files

3.6.0

2 files

3.5.5

2 files

3.5.4

2 files

3.5.3

2 files

3.5.2

2 files

3.5.1

2 files

3.5.0

2 files

3.4.3

2 files

3.4.2

2 files

3.4.1

2 files

3.4.0

2 files

3.3.0

2 files

3.2.0

2 files

3.1.2

2 files

3.1.1

2 files

3.1.0

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

2.26.3

2 files

2.26.2

2 files

2.26.1

2 files

2.26.0

2 files

2.25.0

2 files

2.24.4

2 files

2.24.3

2 files

2.24.2

2 files

2.24.1

2 files

2.24.0

2 files

2.23.0

2 files

2.22.2

2 files

2.22.1

2 files

2.22.0

2 files

2.21.0

2 files

2.20.0

2 files

2.19.0

2 files

2.18.0

2 files

2.17.0

2 files

2.16.0

2 files

2.15.0

2 files

2.14.1

2 files

2.14.0

2 files

2.13.2

2 files

2.13.1

2 files

2.13.0

2 files

2.12.0

2 files

2.11.0

2 files

2.10.1

2 files

2.10.0

2 files

2.9.0

2 files

2.8.0

2 files

2.7.0

2 files

2.6.0

2 files

2.5.5

2 files

2.5.4

2 files

2.5.3

2 files

2.5.2

2 files

2.5.1

2 files

2.5.0

2 files

2.4.4

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.0

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.0

2 files

2.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page