Announcement Hooks

This hook allows the issues opened on your application repository to be displayed on the alliance auth front page to administrators.

To register an AppAnnouncementHook class, you would do the following:

from allianceauth import hooks
from allianceauth.services.hooks import AppAnnouncementHook

@hooks.register('app_announcement_hook')
def announcement_hook():
    return AppAnnouncementHook("Your app name", "USERNAME/REPOSITORY_NAME", AppAnnouncementHook.RepositoryKind.GITLAB)

The AppAnnouncementHook class will

.. autoclass:: allianceauth.services.hooks.AppAnnouncementHook
  :members: __init__
  :undoc-members:

Parameters

app_name

The name of your application.

repository_namespace

Here you should enter the namespace of your repository. The structure stays the same for both GitHub and GitLab repositories.
A repository with the url https://gitlab.com/username/appname will have a namespace of username/appname.

repository_kind

This variable is an enumeration of the class AppAnnouncemementHook.RepositoryKind

.. autoclass:: allianceauth.services.hooks.AppAnnouncementHook.RepositoryKind
  :members: GITLAB, GITHUB
  :undoc-members:

label

The label that will determine if issues should be seen as an announcement. This value is case-sensitive and the default value is "announcement".

1.4 KiB Raw Blame History