https://github.com/ppfeufer/aa-discord-announcements
Discord Announcements via Alliance Auth (https://gitlab.com/allianceauth/allianceauth). Write announcements and manage who can write announcements on your corporation or alliance Discord through Alliance Auth.
https://github.com/ppfeufer/aa-discord-announcements
allianceauth discord
Last synced: about 1 month ago
JSON representation
Discord Announcements via Alliance Auth (https://gitlab.com/allianceauth/allianceauth). Write announcements and manage who can write announcements on your corporation or alliance Discord through Alliance Auth.
- Host: GitHub
- URL: https://github.com/ppfeufer/aa-discord-announcements
- Owner: ppfeufer
- License: gpl-3.0
- Created: 2022-08-07T21:14:50.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-07T18:22:36.000Z (about 2 months ago)
- Last Synced: 2025-04-07T19:23:56.202Z (about 2 months ago)
- Topics: allianceauth, discord
- Language: Python
- Homepage:
- Size: 1.18 MB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
[](https://pypi.org/project/aa-discord-announcements/)
[](https://github.com/ppfeufer/aa-discord-announcements/blob/master/LICENSE)
[](https://pypi.org/project/aa-discord-announcements/)
[](https://pypi.org/project/aa-discord-announcements/)
[](https://results.pre-commit.ci/latest/github/ppfeufer/aa-discord-announcements/master)
[](http://black.readthedocs.io/en/latest/)
[](https://discord.gg/zmh52wnfvM)
[](https://github.com/ppfeufer/aa-discord-announcements/actions/workflows/automated-checks.yml)
[](https://codecov.io/gh/ppfeufer/aa-discord-announcements)
[](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)
[](https://github.com/ppfeufer/aa-discord-announcements/blob/master/CODE_OF_CONDUCT.md)
[](https://ko-fi.com/N4N8CL1BY)
Discord Announcements via [Alliance Auth](https://gitlab.com/allianceauth/allianceauth)
Write announcements and manage who can write announcements on your corporation or
alliance Discord through Alliance Auth.
______________________________________________________________________
- [Installation](#installation)
- [Bare Metal Installation](#bare-metal-installation)
- [Step 1: Install the App](#step-1-install-the-app)
- [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings)
- [Step 3: Finalizing the Installation](#step-3-finalizing-the-installation)
- [Docker Installation](#docker-installation)
- [Step 1: Add the App](#step-1-add-the-app)
- [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings-1)
- [Step 3: Build Auth and Restart Your Containers](#step-3-build-auth-and-restart-your-containers)
- [Step 4: Run Migrations and Collect Static Files](#step-4-run-migrations-and-collect-static-files)
- [Common Installation Steps](#common-installation-steps)
- [Setting up Permission](#setting-up-permission)
- [Setting up the App](#setting-up-the-app)
- [Changelog](#changelog)
- [Translation Status](#translation-status)
- [Contributing](#contributing)
______________________________________________________________________
> [!NOTE]
>
> **AA Discord Announcements >=2.0.0 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.
>
> The last version compatible with Alliance Auth v3 is `1.4.2`.
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](https://allianceauth.readthedocs.io/en/latest/installation/allianceauth.html) for details)
> [!NOTE]
>
> You also want to make sure that you have the
> [Discord service](https://allianceauth.readthedocs.io/en/latest/features/services/discord.html)
> installed, configured and activated before installing this app.
Make sure you're in the virtual environment (venv) of your Alliance Auth installation.
Then install the latest version:
```shell
pip install aa-discord-announcements
```
#### Step 2: Update Your AA Settings
Configure your AA settings (`local.py`) as follows:
- Add `"aa_discord_announcements",` to `INSTALLED_APPS`
#### Step 3: Finalizing the Installation
Copy static files and run migrations
```shell
python manage.py collectstatic
python manage.py migrate
```
Restart your supervisor services for AA
Add the app to your `conf/requirements.txt`
```text
aa-discord-announcements==2.4.1
```
#### Step 2: Update Your AA Settings
Configure your AA settings (`conf/local.py`) as follows:
- Add `"aa_discord_announcements",` to `INSTALLED_APPS`
#### Step 3: Build Auth and Restart Your Containers
```shell
docker compose build
docker compose --env-file=.env up -d
```
#### Step 4: Run Migrations and Collect Static Files
```shell
docker compose exec allianceauth_gunicorn bash
auth collectstatic
auth migrate
```
Now you can set up permissions in Alliance Auth for your users.
Add `aa_discord_announcements | general | Can access this app` to the states and/or
groups you would like to have access.
In your admin backend you'll find a new section called `Discord Announcements`.
This is where you set all your stuff up, like the webhooks you want to ping and who
can ping them. It's pretty straight forward, so you shouldn't have any issues. Go nuts!
See [CHANGELOG.md](https://github.com/ppfeufer/aa-discord-announcements/blob/master/CHANGELOG.md)
[](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)
Do you want to help translate this app into your language or improve the existing
translation? - [Join our team of translators][weblate engage]!
Do 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)
[contribution guidelines]: https://github.com/ppfeufer/aa-discord-announcements/blob/master/CONTRIBUTING.md "Contribution Guidelines"
[weblate engage]: https://weblate.ppfeufer.de/engage/alliance-auth-apps/ "Weblate Translations"