AnnounceTheFollowing

AnnounceTheFollowing
Automatically aleart a channel when you follow someone

As of May 20, 2009: This addon is unsupported for the time being. AddOn authoring was only a hobby of mine. Mike-N-Go is not currently playing WoW, thus not creating or maintaining mods for WoW. If someone wishes to submit a patch for one of my mods to WoWInterface, you may within the bounds of the license bundled with the mod.


Recent Changes and Important Information:
Version: 30400-0.1.01
Last update: 1-14-09
Updates: Point your browser to http://www.wowinterface.com under "InstanceMinion"
Donate with PayPal at [email protected]

Brief Description:
Want to alert your friend or party that you are following them? Or simply add some RP flare to something you already do? This mod is for you! Based off of a macro I once made, I thought, "Why not make it without the macro, why not make it trigger off of the following events so the user does not have to press the macro each time he follows?" And this mod was born.

Use:
Log in, and follow. It is defaulted to the channel emote, and you can change it to say, whisper, party, or raid. Also, the 'auto' channel will try raid, party, and say, in that order. You can set the message to something custom.

If you wish to adjust any settings, they can be accessed from the /atf or /announcethefollowing slash menu. Accepted commands are {help|toggle|on|off|set||current|up|update|}. You may key /atf help in game for more information.

For example, you can set it to the auto channel with a custom whisper by keying '/atf set auto I say this when I am following %s.&&I say this when I stop following %s.' Note how && separates the follow and stop follow message, and %s will get replaced to whatever the name of the person is who you did the action on. If the two parts (separated by the &&) are not included when you key this command, it will resort to the default messages in this order: Last thing you set (emote/whipser/other) to, or the original defaults, if you key /atf set say defaults; it will try in that order. Note, that you are currently only allowed one %s per string; one per the start message, one for the end message.

Defaults:
Emote: "is following %s." / "has stopped following %s."
Whisper: "I am currently auto-following you." / "I have stopped auto-following you."
Other (auto, say, party, raid): "I am currently auto-following %s." / "I have stopped auto-following %s."

The mod may also be toggled on/off. /atf toggle or /atf on or /atf off

Additional information in game, key /atf help.

Installation:
After you decompress the file, copy the AnnounceTheFollowing folder into your Interface/AddOns folder under your World of Warcraft Installation Directory.

A note to my fellow authors:
If anyone wishes to use more then a few lines of my code, I request you credit me by saying, "This product includes software developed by MikeNGo" somewhere as a comment, or in your documentation. I also hope that anyone who would take the time to read my code, would take the time to send me an e-mail of what you think, or what can otherwise be improved.

Caveats, Known Bugs, etc.:
• Not currently working via whisper to players from another server in BGs; but what good is this mod in BGs anyway?
• Only one %s is currently a

Future expansion, additions, planed features, etc:
• Multiple channels alerted at the same time
• GUI for toggling, setting the channel/message
• A channel to announce to 'self' only
• Color things like 'on' 'off' and other things in the slash commands to help them better find the eye
• Support for multiple caches of messages
• Support to only do the emote some of the time
• Make help more.. helpful
• Save messages per-character

About the Version Numbers:
Version: xxxxx-x.x.xx ([interface number]-[major version].[sub version].[current release])
Interface number: Version of the interface the addon was most recently updated for, this number and the version number have no linear relationship with the latter clauses.
Major version: When the mod evolves to a state that is vastly different from the first distribution of the prior major version, this will be updated.
Sub version: Whenever the mod has new features added, or many minor tweaks, this number might advance.
Current release: The current reversion of the sub version, changed every time a new version of the mod is submitted to WoWInterface.com

About the Author:
Macintosh operator
[email protected]
If you would like to talk to me, I hang out at irc.freenode.net. In #norganna and #wowi-lounge, User Mike-N-Go.