Skip to main content

Improved SRP Module for Alliance Auth

Project description

AA SRP

Badge: Version Badge: License Badge: Supported Python Versions Badge: Supported Django Versions Badge: pre-commit Badge: pre-commit.ci status Badge: Code Style: black Badge: Support Discord Badge: Automated Tests Badge: Code Coverage Badge: Translation Status Badge: Contributor Covenant

Badge: Buy me a coffee

SRP Module for Alliance Auth



Overview

Features

  • Overview of SRP links
  • Overview of your own SRP requests and their status
  • Accepting kill mails from zKillboard, EveTools Killboard and EVE-Kill
  • SRP Request administration is mostly done via ajax and without page reloads
  • Use modern DataTables with filters where ever they're useful
  • Tables fully searchable and sortable
  • Mandatory reason on SRP reject
  • Notifications in AA with detailed information on SRP rejection
  • Discord notification via PM to the user on SRP request approval or rejection, if either AA-Discordbot, Discord Notify or Discord Proxy is installed
  • Notify your SRP team (optional) in their Discord channel about new SRP requests, if AA-Discordbot or Discord Proxy is installed

Screenshots

Dashboard

Image: AA SRP Dashboard

Dashboard (View All)

Image: AA SRP Dashboard (View All)

Your SRP Requests

Image: Your SRP Requests View

SRP Requests Overview

Image: SRP Requests Overview

SRP Request Details

Image: SRP Request Details

Installation

Prerequisites

[!IMPORTANT]

Please make sure you meet all prerequisites before you proceed!

  • AA SRP is a plugin for Alliance Auth. If you don't have Alliance Auth running already, please install it first before proceeding. (see the official Alliance Auth installation guide for details)
  • AA SRP needs at least Alliance Auth v4.6.0
  • AA SRP needs Eve Universe to function. Please make sure it is installed, before continuing.

Step 1: Install the Package

Make sure you're in the virtual environment (venv) of your Alliance Auth installation Then install the latest release directly from PyPi.

pip install aa-srp

Step 2: Configure Alliance Auth

This is fairly simple, just add the following to the INSTALLED_APPS of your local.py

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

  • Add "eveuniverse", to INSTALLED_APPS
  • Add "aasrp", to INSTALLED_APPS

Step 3: Finalizing the Installation

Run static files collection and migrations

python manage.py collectstatic
python manage.py migrate

Restart your supervisor services for Auth

Step 4: Preload Eve Universe Data

AA SRP utilizes the EveUniverse module, so it doesn't need to ask ESI for ship information. To set this up, you now need to run the following command.

python manage.py aasrp_load_eve

Step 5: Setting up Permissions

Now it's time to set up access permissions for your new SRP module. You can do so in your admin backend in the AA SRP section. Read the Permissions section for more information about the available permissions.

Step 6: (Optional) Import From Built-in SRP Module

This step is only needed when you have been using the built-in SRP module until now.

Make sure you don't have any open SRP requests before. All SRP links in the built-in module will be closed during the import process, to make sure to not import any duplicates.

The import process can be done at any given time and doesn't necessarily have to be during the installation.

To import your SRP information from the built-in SRP module, run the following command.

python manage.py aasrp_migrate_srp_data

Step 7: (Optional) Settings for Discord Proxy (If Used)

If you are using Discord Proxy to send Discord messages, you can configure the host and port in your local.py settings.

Name Description Default
DISCORDPROXY_HOST Hostname used to communicate with Discord Proxy. localhost
DISCORDPROXY_PORT Port used to communicate with Discord Proxy. 50051

Permissions

ID Description Notes
basic_access Can access the AA SRP module Your line members should have this permission.
create_srp Can create new SRP links Your FCs should have this permission.
manage_srp Can manage SRP Users with this permission can manage the AA SRP Module. Like changing and removing SRP links and requests.
manage_srp_requests Can manage SRP requests Users with this permission can manage the SRP requests. Like changing and removing SRP requests.

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


Release history Release notifications | RSS feed

Download files

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

Source Distribution

aa_srp-2.9.2.tar.gz (303.4 kB view details)

Uploaded Source

Built Distribution

aa_srp-2.9.2-py3-none-any.whl (403.3 kB view details)

Uploaded Python 3

File details

Details for the file aa_srp-2.9.2.tar.gz.

File metadata

  • Download URL: aa_srp-2.9.2.tar.gz
  • Upload date:
  • Size: 303.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for aa_srp-2.9.2.tar.gz
Algorithm Hash digest
SHA256 24f10eeaa643e541d3849ea078344fdb098fdd684ce82afa08b2444bc53bd491
MD5 e91ca1182f87dc5f6f267366e0fe4c67
BLAKE2b-256 efe1b0acd56ac0e33f2cd39565b9f8d2ef9b6f8d03fb9d60d27b8641360af2f3

See more details on using hashes here.

File details

Details for the file aa_srp-2.9.2-py3-none-any.whl.

File metadata

  • Download URL: aa_srp-2.9.2-py3-none-any.whl
  • Upload date:
  • Size: 403.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for aa_srp-2.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 36eb25eda32142e1abb462e9c50e5e4ee87fdc4bfd7616ded3dbc4775fa99869
MD5 a506a2224fd76ec342c5ee358e0d9dbc
BLAKE2b-256 51e8eb15f9eb2230a7c548c018c249b033a0f743916161bed965397d9e5a5357

See more details on using hashes here.

Supported by

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