Get an Epic Experience with Premium

LibAlts-1.0

See All
Libraries Login to Add Favorites
  • 0 Likes
  • World of Warcraft
  • 274 Monthly Downloads
  • Supports: 4.3
  • 79,439 Total Downloads
  • Updated 11/29/2011
  • Created 10/21/2008
  • 21 Favorites
  • Project Site
  • Release Type: Mature
  • License: MIT License
  • Newest File: 2.0
or

About LibAlts-1.0

Overview

LibAlts provides an API to register and retrieve alternate identity information between addons. It maintains main-alt relationships. A given character can be defined as a main with one or more alts.

Basic API

  • :SetAlt(main, alt, source) - Associate a main name with an alt name. An optional source can be specified. If no source is specified, it is added the user-defined source.
  • :GetAlts(main) - Get a list of alts for a given name.
  • :GetMain(alt) - Get the main character associated with a given name.
  • :GetAllMains() - Get a list of all main characters.
  • :IsMain(main) - Is the given name a main character.
  • :IsAlt(alt) - Is the given name an alternate character.
  • :DeleteAlt(main, alt, source) - Delete the main-alt relationship. An optional source can be specified. If no source is specified, it is deleted from the user-defined source.
  • :TitleCase(name) - Return the name in title case. The first letter is capitalized and the rest are lower case.

Sources

Sources are a way to differentiate the data entered into LibAlts. User-defined data will have no source (i.e., the source is nil). Sources provide a solution to problems such as automated guild imports. If the information pushed into LibAlts from guild notes is placed into the same area as user-defined notes, then re-importing it later is problematic. If the guild data has its own area, it is easy to wipe that data and re-import it.

When adding data from automated sources, the source name needs to be unique. As a convention, data added for a guild should have the GUILD_PREFIX constant prepended to the guild name returned from the GetGuildInfo() API call. Data from an addon should have the ADDON_PREFIX prepended to the addon name.

LibAlts will merge data from all sources when answering queries, unless you use one of the *ForSource functions that allows you to query a particular source.

  • :GetAltsForSource(main, source) - Get a list of alts for a given name for the given source.
  • :GetMainForSource(alt, source) - Get the main character associated with a given name for the given source.
  • :GetAllMains(source) - Get a list of all main characters for the given source.
  • :IsMainForSource(main, source) - Is the given name a main character.
  • :IsAltForSource(alt, source) - Is the given name an alternate character.
  • :RemoveSource(source) - Remove all data for the given source.
  • GUILD_PREFIX - A constant to prepend to source names for imported guild data.
  • ADDON_PREFIX - A constant to prepend to source names for addon automated data.

Callbacks

  • LibAlts_SetAlt - Fired after SetAlt() is called.
  • LibAlts_RemoveAlt - Fired after DelAlt() is called
  • LibAlts_RemoveSource - Fired after RemoveSource() is called.

LuaDoc: http://www.wowace.com/projects/libalts-1-0/pages/api/lib-alts-1-0/

------------------------------------------------------------------------
r47 | talryn1 | 2011-11-29 19:57:23 +0000 (Tue, 29 Nov 2011) | 1 line
Changed paths:
   A /tags/2.0 (from /trunk:46)

Tagging as 2.0.  Updated TOC for 4.3.
------------------------------------------------------------------------
r46 | talryn1 | 2011-11-29 19:42:14 +0000 (Tue, 29 Nov 2011) | 1 line
Changed paths:
   M /trunk/LibAlts-1.0.toc

Updating TOC for 4.3
------------------------------------------------------------------------

First Previous Next Last
File Name Release Type Game Version Downloads Date
2.0 Release4.321,90411/29/2011
2.0-nolib Release4.32,85211/29/2011
1.9-nolib Release4.21,16606/28/2011
1.9 Release4.210,78106/28/2011
1.8-nolib Release4.0.61,16204/26/2011
1.8 Release4.0.610,09504/26/2011
1.7-nolib Release4.0.12,02011/03/2010
1.7 Release4.0.123,06611/03/2010
1.6 Release4.0.18,46610/13/2010
1.6-nolib Release4.0.149010/13/2010
1.5 Release4.0.110009/29/2010
1.5-nolib Release4.0.12009/29/2010
1.4 Release3.3.58508/08/2010
1.4-nolib Release3.3.5908/08/2010
1.3 Release3.3.06812/11/2009
1.3-nolib Release3.3.01412/11/2009
1.2 Release3.2.04808/04/2009
1.2-nolib Release3.2.0508/04/2009
1.1 Release3.1.023604/14/2009
1.1-nolib Release3.1.031904/14/2009
1.0 Release3.0.83902/08/2009
1.0-nolib Release3.0.83102/08/2009
1.0b1 Beta3.0.82401/31/2009
1.0b1-nolib Beta3.0.8901/31/2009
First Previous Next Last

Addon Packs Containing This...

Get a head start with Addon Packs

Browse now

Top Downloads

  1. Deadly Boss Mods
    Combat, PvP, and Boss Encounters
    1,129,948 Monthly Downloads
  2. Bagnon
    Bags & Inventory
    498,005 Monthly Downloads
  3. Deadly Boss Mods - Burning Crusade and Vanilla mods
    Combat and Boss Encounters
    335,742 Monthly Downloads
  4. Recount
    Combat
    323,867 Monthly Downloads
  5. HealBot Continued
    Healer and Unit Frames
    297,532 Monthly Downloads
See More
Login to Curse

Don't have an account? Create One.

Get an epic experience with Curse Premium
  • Faster addon downloads
  • Premium-Only Beta Giveaways
  • Ad-Free Curse experience
  • Premium Curse Client
  • and many More Features
  • Learn More »

Infinite Crisis NA

Get Your Preferred Access Code!