{% extends 'faq/base.html' %} {% load i18n %} {% block details %} {% include 'faq/settings_nav.html' %}

{% translate "BigBrotherConfig Fields" %}

{% blocktrans %}The core BigBrother behaviour lives in BigBrotherConfig. These options handle activation, hostile lists, webhooks, and background schedulers. Adjust them from Django admin → BigBrother → BigBrotherConfig.{% endblocktrans %}

{% translate "Installation & Identity" %}

{% translate "Field" %} {% translate "Description" %}
main_corporation_id / main_corporation {% translate "Populated automatically from the first superuser character detected during the scheduled update task. Identifies your primary corporation." %}
main_alliance_id / main_alliance {% translate "Automatically captured alliance counterpart. Both fields are read-only snapshots managed by the updater." %}
is_active {% translate "Managed by the updater. Turns false if the corporation/alliance is not authorised." %}

{% translate "Access Control" %}

{% translate "Field" %} {% translate "Description" %}
bb_guest_states {% translate "AllianceAuth states treated as guests. Recruiter-level users only see pilots in these states." %}
bb_member_states {% translate "States that count as full members for BigBrother and CorpBrother checks." %}
member_corporations / member_alliances {% translate "Comma-separated IDs that should be considered members even if they sit outside the primary corp/alliance." %}
ignored_corporations {% translate "Corporation IDs excluded from CorpBrother dropdowns and compliance checks." %}

{% translate "Hostile & Whitelist Lists" %}

{% translate "Field" %} {% translate "Description" %}
hostile_alliances / hostile_corporations {% translate "Comma-separated IDs that flag alliances or corporations as hostile. Cards, mails, and transactions look here to colour results red." %}
whitelist_alliances / whitelist_corporations {% translate "IDs that should never be flagged, even if they appear in default hostile data sets." %}

{% translate "aa-contacts Integration" %}

{% translate "Field" %} {% translate "Description" %}
auto_import_contacts_enabled {% translate "When enabled, BigBrother will periodically import standings from aa-contacts and merge them into the member/hostile/whitelist lists." %}
contacts_source_alliances {% translate "Alliances whose aa-contacts standings should be imported. Positive standings become members; negative become hostile; neutral handling is controlled below." %}
contacts_handle_neutrals {% translate "Controls how neutral (0) standings are treated: handle as hostile, whitelist/ignore, or do nothing." %}
contacts_import_cache {% translate "Internal cache of imported IDs so removals from aa-contacts can be pruned without touching manually maintained lists." %}

{% translate "Discord Notifications" %}

{% translate "Field" %} {% translate "Description" %}
pingroleID / pingroleID2 {% translate "Discord role IDs to mention when selected message types fire. Use raw numeric IDs." %}
pingrole1_messages / pingrole2_messages {% translate "Choose which MessageType entries ping each role." %}
here_messages / everyone_messages {% translate "Message types that should ping @here or @everyone through the configured webhook." %}
webhook / loawebhook / dailywebhook / optwebhook1-5 {% translate "Discord webhook destinations for core alerts, LoA notices, daily digests, and up to five optional channels." %}
stats_webhook {% translate "Discord webhook used for recurring stats posts (when enabled)." %}

{% translate "ESI Scope Enforcement" %}

{% translate "Field" %} {% translate "Description" %}
character_scopes / corporation_scopes {% translate "Comma-separated scope requirements. Missing scopes surface in the Compliance card and related alerts." %}

{% translate "Scheduling & Feature Toggles" %}

{% translate "Field" %} {% translate "Description" %}
dailyschedule / optschedule1-5 {% translate "Celery beat schedules used for daily and optional webhook messages." %}
stats_schedule {% translate "Celery beat schedule used for recurring stats posts." %}
are_recurring_stats_active {% translate "Master switch for recurring stats posts." %}
is_loa_active / is_paps_active {% translate "Toggle the integrated LoA and PAP modules. Restart AllianceAuth after changing." %}
is_warmer_active {% translate "Enables the cache warmer that preloads contract/mail/transaction streams. Disable only if your gunicorn timeout in supervisor config is set to 0." %}
are_daily_messages_active / are_opt_messages1-5_active {% translate "Master switches for daily and optional message delivery. Turn off to pause alerts without removing schedules or webhooks." %}
loa_max_logoff_days {% translate "Maximum days a user may stay logged off without an LoA before reminders escalate." %}

{% blocktrans %}Fields not listed above are read-only helpers populated by automation. Leave them unchanged unless instructed by the maintainer.{% endblocktrans %}

{% endblock %}