Skip to main content

Fleet Ping Tool for Alliance Auth supporting pings via webhooks to Discord.

Project description

AA Fleet Pings

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

ko-fi

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



Installation

[!NOTE]

AA Fleet Pings needs at least Alliance Auth v4.0.0!

Please make sure to update your Alliance Auth instance before you install this module or update to the latest version, otherwise an update to Alliance Auth will be pulled in unsupervised.

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.

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

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

Step 4: Setting up Permission

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.

Step 5: Setting up the App

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

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 -U aa-fleetpings

python manage.py collectstatic
python manage.py migrate

Finally, restart your AA supervisor services.

Screenshots

View in Alliance Auth

View in Alliance Auth

Discord Ping Example

Discord Ping Example

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)

Project details


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-3.0.0b1.tar.gz (134.2 kB view hashes)

Uploaded Source

Built Distribution

aa_fleetpings-3.0.0b1-py3-none-any.whl (206.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page