Table of Contents

• Quick Integration
• Adding LibAboutPanel-2.0 via .pkgmeta
• Ace3 Example Usage
• API Usage
• Supported ToC Fields
  • Category vs X-Category
• Features
• Troubleshooting
• Contributing
• Full Documentation

LibAboutPanel-2.0

LibAboutPanel-2.0 is a World of Warcraft Lua library for displaying addon metadata in the Interface Options panel or AceConfig-3.0 options tables. It works with Classic Era, Classic, and Retail.

Quick Integration

1. Dependencies:

   • Requires: LibStub, CallbackHandler-1.0, AceConfig-3.0
   • Add these to your .toc and .pkgmeta files.

2. Embedding:

   • With Ace3: local MyAddon = LibStub("AceAddon-3.0"):NewAddon("MyAddon", "LibAboutPanel-2.0")
   • Without Ace3: LibStub("LibAboutPanel-2.0"):Embed(MyAddon)
   • Or use as a standalone library: local LAP = LibStub("LibAboutPanel-2.0")

3. API Usage:

   • :CreateAboutPanel(addon, parent) — Adds an About panel to Blizzard's settings.
   • :AboutOptionsTable(addon) — Returns an AceConfig-3.0 options table for About info.
   • Both APIs auto-detect and display metadata from your .toc file, including localized fields.

Supported ToC Fields

• Author, Title, Notes (all languages)
• Version, X-Date, X-ReleaseDate, X-Revision
• X-Author-Guild, X-Author-Faction, X-Author-Server
• X-Website, X-Email, X-Localizations, X-Credits, Category or X-Category
• X-License, X-Copyright

Category vs X-Category

AddOn authors should use ## Category: based on Blizzard's official AddOn Categories.

## X-Category: and ## X-Category-<locale> are still supported for backward compatibility but are considered legacy metadata.

You may specify a single category from the Blizzard list, or multiple categories separated by commas.

Localized categories must be explicitly declared in the .toc (e.g. ## Category-deDE:). If no localized field exists, the base ## Category: value will be used.

## Category: Action Bars, Auctions
## Category-deDE: Aktionsleisten, Auktionen
## Category-esES: Barras de acción, Subastas

Features

• Automatic localization for faction, locale, and common strings
• Embedded API for easy integration
• AceConfig-3.0 support for flexible UI placement
• Shared editbox for copying fields (email, website)

Troubleshooting

• Ensure all dependencies are listed in your .toc and loaded before LibAboutPanel-2.0
• For bug reports, provide:
  • Addon name, LAP version, WoW version/build, language
  • Steps to reproduce, error logs (BugSack, Swatter, etc), screenshots

Contributing

• Help translate or verify localization at CurseForge
• Report bugs or request improvements via the GitHub issue tracker

Adding LibAboutPanel-2.0 via .pkgmeta

To include LibAboutPanel-2.0 in your addon using CurseForge packaging, add the following to your .pkgmeta file:

externals:
  Libs/LibStub: https://repos.curseforge.com/wow/libstub/trunk
  Libs/CallbackHandler-1.0: https://repos.curseforge.com/wow/callbackhandler/trunk/CallbackHandler-1.0
  Libs/AceConfig-3.0: https://repos.curseforge.com/wow/ace3/trunk/AceConfig-3.0
  Libs/LibAboutPanel-2.0:
    url: https://github.com/Myrroddin/libaboutpanel-2.0/LibAboutPanel-2.0
    curse-slug: libaboutpanel-2-0

• The url points to the GitHub repository for the library.
• The curse-slug ensures proper packaging and updates via CurseForge.

See also: WIKI.md for full documentation and API reference.

For full API details and examples, see the wiki.