Apps

Mostly a Marketplace controller, but has some other functions for interacting with the frontend. Most functions require an AOS (Administer Online Services) URL. If you don't have one, use one of ours. Learn more, or find an Administer Software-hosted node...

Apps.AddAppDrawerButton

Adds a button to the App Drawer. Before making the button visible, Administer checks to see if the app can be used by a rank.

Annotation

Apps.AddAppDrawerBttton(
    Config: {
        ButtonID: string,
        AppName: string,
        Description: string,
        Icon: string,

        MainButtonClick: () -> ()?,
        MainButtonFrame: Frame | CanvasGroup?,

        SubIcons: {
            {
                Name: string,
                Icon: string,
                Click: () -> (),
                Frame: Frame | CanvasGroup
            }?
        }
    }
)

Example (single page)

Apps.AddAppDrawerButton({
	AppName = "Homepage",
	Description = "Administer Homepage",
	Icon = Utilities.Icon "home",
	ButtonID = "AdmHomepage",

	MainButtonClick = function() 
        print("Opening the homepage..")
    end,
	MainButtonFrame = Var.MainFrame.Home,

	SubIcons = {}
})

Example (Multiple pages)

Apps.AddAppDrawerButton({
	AppName = t("Apps.MainFrame.Config.Title"),
	Description = t("Apps.MainFrame.Config.Desc"),
	Icon = Utilities.Icon "media",
	ButtonID = "AdmConfiguration",

	SubIcons = {
		{
			Name = t("Configuration.MenuBar.New.AInfoPage.HeaderLabel"),
			Icon = Utilities.Icon "info",
			Click = function() end,
			Frame = Var.MainFrame.Configuration.InfoPage,
			ButtonID = "Information"
		},
		{
			Name = Utilities.ToSentenceCase( t("Configuration.Apps.Content.Template.Settings.HeaderLabel") ),
			Icon = Utilities.Icon "gear",
			Click = function() end,
			Frame = Var.MainFrame.Configuration.Settings,
			ButtonID = "Settings"
		},
		{
			Name = Utilities.ToSentenceCase( t("Header.AppDrawer.HeaderLabel") ),
			Icon = Utilities.Icon "grid",
			Click = Apps.LoadAppList,
			Frame = Var.MainFrame.Configuration.Marketplace,
			ButtonID = "Marketplace"
		},
		{
			Name = t("Configuration.Admins.Container.Admins.Header.TLabel"),
			Icon = Utilities.Icon "user-clip",
			Click = function() end,
			Frame = Var.MainFrame.Configuration.Admins,
			ButtonID = "AdminConfig"
		}
	}
})

Apps.GetVersionLabel

Compares an API version and returns a formatted string.

Annotation

Apps.GetVersionLabel(Version: number): string

Example

script.Parent.RichText = true
script.Parent.Text = Apps.GetVersionLabel(2.0)

Apps.Show

Shows a modal with an app, theme, icon pack, or component inside of it, generally used for the marketplace. Requires an AOS Instance and an Asset ID on it.

Annotation

Apps.Show(
    ServerURL: string,
    ID: string,
    DisplayedBecause: string,
): ()

Example

Apps.Show(
    "https://aos-us-1.admsoftware.org"
    "org.admsoftware.Reporter",
    "You searched for it"
)

Apps.Clear

Used to reset the marketplace's content.

Annotation

Apps.Clear(): ()

Example

Apps.Clear()

Apps.Search

Performs a search from a given AOS URL.

Annotation

Apps.Search(
    Query: string,
    ServerURL: string
): { 
    Success: boolean, 
    Data: {
        {
            Type: "card" | "text",
            Value: string | { any }
        }
    },
    AOSProcessedInfo: string
 }

Example

print(Apps.Search(
    "Player Management",
    "aos-us-1.admsoftware.org"
).Data)

Apps.LoadAppList

Takes in an optional list of apps, or performs an AOS search based on the currently active page. (Var.Marketplace.ActivePageType)

Annotation

Apps.LoadAppList(
    List: {}?
): ()

Example

Apps.LoadAppList()

Apps.LoadLibrary

Loads the Library page.

WARNING

This does not return anything and is probably not useful for you. Instead, hook into the GetAppServers and/or GetList

Annotation

Apps.LoadLibrary(): ()

Example

Apps.LoadLibrary()

Apps.Init

Enables the Sidebar and changes text labels.

WARNING

This does not return anything and is probably not useful for you, it is used for Administer to launch the Marketplace at runtime.

Annotation

Apps.Init(): ()

Example

Apps.Init()