GitLocker: The Coding Marketplace

Description:

asmekauthcogs 1.3.1

asmek-authcogs
Alliance Auth cogs for Astrum Mechanica
This is built to replace some functionality of some of the AA-Discordbot as well as add other features.
This will not work without https://apps.allianceauth.org/apps/detail/allianceauth-discordbot installed!

Warning
This is built for ASMEK specifically. If you aren't us, you probably shouldn't use this. There will be no warning of updates or changes!
However it is slowly being modified to contain less hardcoded values so personal use isn't off the table.

Current cogs

Cog
Description

about
about the authbot

auth
links to various areas in the auth(HARDCODED to specific areas and some statements, should tie them to installed modules)

links
links to various useful sites, cuz we forget them all the time.

hr
thread based recuritment. Various commands to sync characters

siege
region status alert indicator thing!

Future cogs and features

Cog
Purpose

price check
price check in trade hubs and null hubs. base discord bot cog only checks jita and amarr

Incorporate adming page access
move recruit messages to database
perms for HR cog??

Install

Ensure you have installed and configured the Alliance Auth DiscordBot, https://apps.allianceauth.org/apps/detail/allianceauth-discordbot
Install the app with your venv active

pip install asmek-authcogs

Add 'asmek_authcogs', to your INSTALLED_APPS list in local.py.
Add the below lines to your local.py settings file, adjust for which cogs you want. Settings for specific cogs are found in cog setup.

## Settings for Asmek Authcogs
ASMEK_AUTHCOGS_COGS = [
"asmek_authcogs.cogs.about", # make sure to remove the about cog from aadiscordbot if using this
"asmek_authcogs.cogs.auth",
"asmek_authcogs.cogs.links",
"asmek_authcogs.cogs.siege",
"asmek_authcogs.cogs.hr",
]

Run migrations python manage.py migrate
Gather your static files python manage.py collectstatic (There should be none from this app)
Restart your auth

Cog setup and usage
About Cog
Accessed using /about

Add the below lines to your local.py settings file, adjusting for your usage.

ASMEK_BOT_NAME = "ASMEK Authbot: The Omnissiah" # name to show up in about
ASMEK_BOT_DESCRIPTION = "Some spooky watching you description" # description for about

All settings are currently hardcoded
Auth Cog

Add the below lines to your local.py settings file, adjusting for your usage.

ASMEK_ALLIANCE_ID = "123"
ASMEK_ALLIANCE_NAME = "alliance name"
ASMEK_ALLIANCE_URL = "alliance url"

Those will create the link for /auth alliance
Accessed using /auth followed by one of the below
Hardcoded links:
Audit - Character audit (not member audit)
Buyback - The buyback module
Fittings - The fittings Module
Home - Do i really need to explain??
Wiki - The simplewiki module ( NOT WIKIJS)

This cog still needs some work to make it more customizable and generate links based on individual setups

Links Cog
A group needs to be given the link.manage_links perm in order to manage links
This cog conatins 2 seperate commands
/links is used to manage links, and /link is used to display a link
/Links
Add - you will be brought to a pop up to add a name, url, description, and optional image for a link
Edit - you will be brought to a popup to edit a link (current links will populate in menu)
Delete - you will be asked to delete a link (current links will populate in menu)
List - will list all current links
/Link
will generate a list of all your links and upon making a selection will return the information
HR Cog
Recruit channel, corp roleid, hr roleid, and recruit msg 1 are all required!
Additional recruit messages are optional and technically unlimited.
Messages below are what asmek uses as an example, a few points to note when modifying.

the 2 pairs of {} in msg 1 are mandatory. The first set is to ping the recruit, the second set is to ping the HR team, in order to pull them into the thread.

the messages must be enclosed in quotes ""

\n is used for line breaks

Discord formatting can be added

Add the below lines to your local.py settings file, adjusting for your usage.

ASMEK_RECRUIT_CHANNEL = "123"
ASMEK_CORP_ROLEID = "123"
ASMEK_HR_ROLEID = "123"
ASMEK_RECRUIT_MSG_1 = "Welcome {}! \n\nThis is your private thread for moving through the recruitment process with Astrum Mechanica. We are excited to have you here! \n\nThe {} is here and can assist with any questions you may have during the process.\n\nA few important points to note before you continue with the application process:\n- We are apart of the LAWN alliance and a member of the IMPERIUM coalition\n- A full ESI caracter audit needs to be completed for **ALL** of your toons\n- A voice interview must be completed as part of the application process\n- You must be able to communicate via voice comms\n- We have a **2 Million** skill point minimum\n- We do not have a specialty, we participate in all aspects of EVE\n\nIf you wish to continue with your application, please follow the instructions below!\n\n****Step 1 - Login to Auth:****\n1) Proceed to <https://asmek.space>\n2) Login using your **MAIN** character\n3) Enter your email address\n\nYou should now be on the main dashboard page.\n\n Click the :white_check_mark: below to continue to step 2 of 4."
ASMEK_RECRUIT_MSG_2 = "****Step 2 - Register Characters & ESI Tokens:****\n1) Click on **Character Audit** on the left-hand menu.\n2) Click on the **Blue +** in the top right corner\n3) Login and allow the requested token\n4) Repeat step #3 for **ALL** of your characters\n5) Once you have completed step #4, if any characters are yellow push the green refresh icon in the top right corner.\n\nYou should now see all of your characters displayed as green and the various navigation areas will populate with your information.\n\n Click the :white_check_mark: below to continue to step 3 of 4."
ASMEK_RECRUIT_MSG_3 = "****Step 3 - Link your Auth and Discord accounts:****\n1) Click on **Services** on the left-hand menu.\n2) On the **Discord** row that is displayed, click the chekmark button under **Action**.\n3) If you're not already logged into Discord in your browser,you'll be asked to log in.\n4) Once logged in, you'll be presented with a screen asking you to authorize ASMEK Authbot to have limited access to your Discord account. Click **Authorize**.\n\nOnce that's done, your Auth and Discord acounts should be fully linked.\n\n Click the :white_check_mark: below to continue to step 4 of 4."
ASMEK_RECRUIT_MSG_4 = "****Step 4 - Fill out an application:****\n1) Click on **Applications** on the left-hand menu.\n2)Click **Create Application** in the top right of the page.\n3) Click the **Astrum Mechanica** button in the middle of the page.\n4) Answer the questions contained in the application, then click **Submit** at the bottom of the page.\n\n When done, click the :white_check_mark: below."
ASMEK_RECRUIT_MSG_5 = "**Thank you for considering joining us and submitting your application!\n\nThe HR team has been alerted of your completed application, and should review it shortly. Please allow atleast **24 hours** for someone to look over your application and submitted characters. If there are any questions or concerns, someone will reach out to you in this thread.\n\nThe HR team will reach out to schedule an interview, if they choose to continue your application."

Siege Cog

Add the below lines to your local.py settings file, adjusting for your usage.

ASMEK_SIEGE_CHANNEL = "123" #channel for siege status

The channel used for this should have permission set for no typing only viewing. You might have to set this from server owner.
The channel should be completely empty with no existing chat.

You can change the status, along with the channel name, by typing /siege in any channel and choosing a corresponding colour(not color). It also includes preset messages but you can optionally type in a message as well(ie 30 man gang!).
We have this set as a role all on its own and give it out as needed.
In general the images are self explanatory, however we keep the beehive information partially opsec. See brackets below for how we explain it to general line members.
Recommended usage for imperium:

Green: Beehive is up! All caps can be out. (General line members: you are as safe as humanly possible)
Amber: Beehive is down! Only rorqs should be out. (General line members: its nullsec pay attention)
Red: Everyone should dock up! (General line members: dock the fuck up!)

Settings (local.py)

Setting
Default
Description

ASMEK_ALLIANCE_ID

alliance id

ASMEK_ALLIANCE_NAME

alliance name to display on embeds

ASMEK_ALLIANCE_URL

URL for alliances auth system

ASMEK_SIEGE_CHANNEL

Discord channel id for siege alerts

ASMEK_RECRUIT_CHANNEL

Discord channel id for recruitment threads

ASMEK_CORP_ROLEID

Discord Role id for corp members, this prevents members from trying to apply (Should preferably be the 'members' role)

ASMEK_HR_ROLEID

Discord Role id for HR team, or the role to ping for recruits and also who can use the HR commands(not sure why i don't have the ability to use it tied to perms but meh)

ASMEK_RECRUIT_MSG_1

The first message to send in the private thread. REQUIRED

ASMEK_RECRUIT_MSG_#

Additional message to send upon clicking the check mark. Sequentially numbered.

Permissions

Perm
Description

link.manage_links
Can manage links in the links cog

general.siege_control
Can use siege commands