An alternative to using the AceGUI container BlizOptionsGroup to create entries in the Blizzard options panel. All entries created use the same frame objects allowing for minimal memory use. An entry can be created and an options table assigned to it later allowing for LOD options. The library monitors for AceConfigDialog-3.0, AceConfigRegistry-3.0, and AceGUI-3.0 to be loaded before using them to further facilitate LOD behavior.
-- In main module (myAddon):
myAddon.config = LibStub('LibOptionsAssist-1.1').AddEntry("myAddon", nil, "myAddon_Config")
myAddon.config:SetInfo(format("Version: %s", GetAddOnMetadata("myAddon", 'Version')))
-- In LOD module (myAddon_Config):
Add an entry to Blizzard's interface options panel under the AddOns tab.
name - (string) The text to appear in the Blizzard options panel under the AddOns tab.
parent - (string) If this is to be a child entry then this should be the name that was used to create the parent entry.
loadOnDemand - (function or string) If a function is given then that function will be run the first time the entry is selected, passing entry as it's only argument. If a string is given, or if the function returns a string, an addon with that name will be loaded if it isn't already. If the string is "parent" then the load on demand behavior of the parent will be invoked instead.
key - (any) A value used to prevent the Recycle method from removing the metatable from the entry.
entry - (table) A table with the required fields to work with the Blizzard options panel (see Entries below).
index, entry = lib.HasEntry(name [, parent])
Determines if an entry is in Blizzard's interface options panel under the AddOns tab.
name - (string) The name of the entry to check for.
parent - (string) The name of the parent entry if a child is being looked for.
index - (number) Index of the entry or nil if it doesn't exist.
entry - (table) The table for the entry or nil if it doesn't exist.
for index, entry in lib.IterateEntries([parent]) do
Acts as a special case ipairs for Blizzard's INTERFACEOPTIONS_ADDONCATEGORIES table.
parent - (string) If a string is provided then all entries returned will be children of that parent, otherwise only entries with no parent are returned.
index - (number) Index of the entry.
entry - (table) The table for the entry.
loaded, reason = lib.LoadModule(name)
Loads an addon even if it, or a dependency, is disabled.
name - (string) The addon's name as it appears in the Interface\AddOns folder.
loaded - (boolean) Whether or not the addon is loaded.
reason - (string) If the addon is not loaded then this will be the reason why.
lib.RemoveEntry(name [, parent])
Removes an entry, and any children, from Blizzard's interface options panel under the AddOns tab.
name - (string) The name of the entry to remove.
parent - (string) The name of the parent entry if a child is being removed.
Any entry created by lib.AddEntry() is a normal table that emulates certain frame methods to allow it to work in the Blizzard options panel. A metatable provides the following frame-like methods: ClearAllPoints, GetScript, HasScript, Hide, IsShown, IsVisible, SetAllPoints, SetParent, SetPoint, SetScript, SetShown, and Show. The only scripts supported by an entry are OnHide and OnShow. The metatable also provides a dummy function for the fields: cancel, defaults, okay, and refresh.
The entry may also be treated like a function, with entry() being the same as InterfaceOptionsFrame_OpenToCategory(entry). Entries also have the following additional methods:
entry:AssignOptions(name [, ...])
Set the AceConfigRegistry-3.0 table to be used to display options when the entry is selected.
name - (string) A name as from an AceConfigRegistry-3.0 RegisterOptionsTable call.
... - Zero or more table keys that lead to a sub-table.
Cancel any pending load on demand behavior for the entry.
desc = entry:GetDesc()
Get the value currently set to be displayed for the entry's description text.
desc - (string) The current value of the description text.
info = entry:GetInfo()
Get the value currently set to be displayed for the entry's information text.
info - (string) The current value of the information text.
title = entry:GetTitle()
Get the value currently set to be displayed for the entry's title text.
title - (string) The current value of the title text.
Removes the entry, and any children, from Blizzard's options panel. May also optionally remove the metatable from entry as well as removing all internal references so that it may be be garbage collected.
key - (any) This value must match what was provided via AddEntry or SetKey to remove the metatable and allow garbage collection.
Force a display update of the assigned options.
Set the description text to be displayed. This text is small, left-aligned, and below the title.
desc - (string) The text to be displayed.
Set the information text to be displayed. This text is small, right-aligned, and opposite the title.
info - (string) The text to be displayed.
success = entry:SetKey(newKey, oldKey)
Set the value needed to completely Recycle entry.
newKey - (any) The value that key should be set to.
oldKey - (any) The current value needed to fully Recycle entry.
success - (boolean or nil) True if the key was changed, nil otherwise.
Set the title text to be displayed. This text is large, left-aligned, and anchored in the upper-left corner. When an entry is first created with lib.AddEntry() the title is automatically set to the name given.
title - (string) The text to be displayed.
Version 1.1 (10/14/2014)
- Updated for 6.0
- Changed the library API to use function calls vice method calls
Version 1.0.5 (05/01/2014)
- Added library method RemoveEntry
- Added entry methods Recycle, SetKey, SetShown
- Library method AddEntry now takes an optional parameter, the parameter "loadOnDemand" now has special meaning for "parent", and child entries should be placed with their parent/siblings if a child of another entry has the same name as the parent.
- Library method HasEntry has an additional return
- Library method LoadModule is more robust and can will load an addon that currently has disabled dependencies.
Version 1.0.4 (12/25/2013)
- Put in a temp fix for the Blizzard bug that prevents opening directly to an option panel the first time
Version 1.0.3 (06/13/2013)
- Fixed a logic flow issue with LoD
Version 1.0.2 (05/18/2010)
- Fixed a couple display issues
- Info text no longer requires the title text to be shown
- Added description text
- Extended the LOD support
Version 1.0.1 (07/05/2009)
- Added MMOUI Minion support to TOC file (X-WoWI-ID)
- Fixed a display bug when hiding an entry