Package: aa-standingssync
Standings SyncAlliance Auth app for cloning alliance standings and war targets to alts.ContentFeaturesScreenshotHow it worksInstallationUpdatingSettingsPermissionsAdmin FunctionsFeedbackChange LogFeaturesThe main purpose of this app is to enable non-alliance characters to have the same standings view of other pilots in game as their alliance main. This e.g. allows non-alliance scouts to correctly report blues and non-blues. Or JF pilots can see which other non-alliance characters on grid not blues and therefore a potential threat.Here is an high level overview of the main features:Synchronize alliance contacts to chosen non-alliance charactersSupports coalition usage with multiple alliances in the same Alliance Auth installationSynchronize alliance war targets as contacts with terrible standingAutomatically deactivates synchronization when a user ceases to be eligible (e.g. main left the alliance)ScreenshotHere is a screenshot of the main screen.How it worksTo enable non-alliance members to use alliance standings the personal contact of that character are replaced with the alliance contacts.InstallationStep 1 - Check PreconditionsPlease make sure you meet all preconditions before proceeding:Standings Sync is a plugin forAlliance Auth. If you don't have Alliance Auth running already, please install it first before proceeding. (see the officialAA installation guidefor details)Standings Sync needs the appdjango-eveuniverseto function. Please make sure it is installed, before continuing.Step 2 - Install appInstall into AA virtual environment with PIP install from PyPI:pipinstallaa-standingssyncStep 3 - Update Eve Online appUpdate the Eve Online app used for authentication in your AA installation to include the following scopes:esi-characters.read_contacts.v1
esi-characters.write_contacts.v1
esi-alliances.read_contacts.v1Step 4 - Configure AA settingsConfigure your AA settings (local.py) as follows:Add'standingssync'toINSTALLED_APPSAdd these lines add to bottom of your settings file:# settings for standingssyncCELERYBEAT_SCHEDULE['standingssync.run_regular_sync']={'task':'standingssync.tasks.run_regular_sync','schedule':crontab(minute=0,hour='*/2')}Please also see thesettingssection for more configuration options. For example a setting is required to enable syncing war targets.Step 5 - Finalize installation into AARun migrations & copy static filespythonmanage.pymigrate
pythonmanage.pycollectstatic--noinputRestart your supervisor services for AAStep 6 - Setup permissionsNow you can access Alliance Auth and setup permissions for your users. See section "Permissions" below for details.Step 7 - Setup alliance characterFinally you need to set the alliance character that will be used for fetching the alliance contacts / standing. Just click on "Set Alliance Character" and add the requested token. Note that only users with the appropriate permission will be able to see and use this function.Once an alliance character is set the app will immediately start fetching alliance contacts. Wait a minute and then reload the page to see the result.That's it. The Standing Sync app is fully installed and ready to be used.UpdatingTo update your existing installation of Alliance Freight first enable your virtual environment.Then run the following commands from your AA project directory (the one that containsmanage.py).pipinstall-Uaa-standingssyncpythonmanage.pymigratepythonmanage.pycollectstatic--noinputFinally restart your AA supervisor services.SettingsHere is a list of available settings for this app. They can be configured by adding them to your AA settings file (local.py). If they are not set the defaults are used.NameDescriptionDefaultSTANDINGSSYNC_ADD_WAR_TARGETSWhen enabled will automatically add or set war targets  with standing = -10 to synced characters.FalseSTANDINGSSYNC_CHAR_MIN_STANDINGMinimum standing a character needs to have in order to get alliance contacts. Any char with a standing smaller than this value will be rejected. Set to0.0if you want to allow neutral alts to sync.0.1STANDINGSSYNC_REPLACE_CONTACTSWhen enabled will replace contacts of synced characters with alliance contacts.TrueSTANDINGSSYNC_STORE_ESI_CONTACTS_ENABLEDWether to store contacts received from ESI to disk. This is for debugging.FalseSTANDINGSSYNC_SYNC_TIMEOUTDuration in minutes after which a delayed sync for managers and characters is reported as down. This value should be aligned with the frequency of the sync task.180STANDINGSSYNC_WAR_TARGETS_LABEL_NAMEName of EVE contact label for war targets. Needs to be created by the user for each synced character. Required to ensure that war targets are deleted once they become invalid. Not case sensitive.WAR TARGETSPermissionsThis app only uses two permission. One for enabling this app for users and one for enabling users to add alliances for syncing.NamePurposeCodeCan add synced characterEnabling the app for a user. This permission should be enabled for everyone who is allowed to use the app (e.g. Member state)add_syncedcharacterCan add alliance managerEnables adding alliances for syncing by setting the character for fetching alliance contacts. This should be limited to users with admins / leadership privileges.add_syncmanagerAdmin functionsAdmins will find a "Standings Sync" section on the admin page. This section provides the following features:See a list of all setup alliances with their sync statusSee a list of all enabled characters with their current sync statusManually remove characters / alliances from syncManually start the sync process for characters / alliancesFeedbackIf you encounter any bugs or would like to request a new feature please open an issue in this gitlab repo.